# Rollback e Observabilidade do Piloto

## Objetivo

Definir o minimo operacional antes de migrar o primeiro consumidor externo.

## Estrategia de rollback

Regra principal:

- nao criar contratos paralelos permanentes como estrategia de seguranca

Se o piloto falhar:

- antes do merge: revert da branch
- depois do merge ou deploy: revert da entrega do host

O rollback nao deve significar "manter legado e novo coexistindo indefinidamente".

## O que observar

Endpoints e superficies principais:

- `/schemas/filtered`
- `/schemas/catalog`
- `/schemas/surfaces`
- `/schemas/actions`
- `/capabilities`

Headers e sinais importantes:

- `ETag`
- `X-Schema-Hash`
- `X-Data-Version`
- `Location` em `POST`

## Sintomas de regressao

- `schemaUrl` nao resolvendo
- `resourceKey` incoerente
- `surface` ou `action` aparecendo no catalogo errado
- `capabilities` divergindo dos catalogos dedicados
- `@Valid` deixando de responder `400`
- `update` canonico sendo contaminado por workflow-like mapping

## Resposta minima a incidente

1. confirmar se a regressao esta no starter ou no host
2. isolar o recurso piloto
3. reverter a entrega se houver impacto de contrato
4. registrar o desvio antes de reabrir a migracao