Pilot Readiness Checklist

Status do documento

Checklist histórico de prontidão para abrir o primeiro consumidor externo do baseline resource + surfaces + actions + capabilities.

Ele permanece útil como registro do gate de migração, mas não substitui a documentação canônica atual do starter.

Go / No-Go antes do primeiro consumidor externo

Marque todos os itens abaixo antes de abrir a migracao do piloto.

Baseline do starter

• Fases 1 a 6 formalmente encerradas no starter
• piloto interno em src/test verde
• fixture E2E H2 verde no recorte oficial
• QA independente recente concluido

Recurso piloto escolhido

• recurso pequeno e com escopo congelado
• sem necessidade imediata de compatibilidade paralela
• fronteira entre resource, surface e action decidida

Contrato

• @ApiResource(value = ..., resourceKey = ...) definido
• DTOs separados de response, create, update e filter
• @ResourceIntent usado apenas onde a operacao continua sendo manutencao do recurso
• @UiSurface usado apenas para discovery semantico
• @WorkflowAction usado apenas para comando de negocio explicito

Discovery

• /schemas/filtered validado
• /schemas/catalog validado
• /schemas/surfaces validado
• /schemas/actions validado
• GET /{resource}/capabilities validado
• GET /{resource}/{id}/capabilities validado

Testes e validacao

• suite focal do host verde
• validacao de @Valid com 400 Validation error
• sem payload inline em surfaces, actions ou capabilities

Operacao

• rollback definido
• observabilidade minima definida
• responsavel tecnico pelo piloto definido

Pode ficar fora do primeiro piloto

• e2e-pg do starter
• stress mais agressivo de concorrencia/caches lazy
• suite integral do modulo do starter