A04 · Cliente de API tipado, autenticação e tratamento de erros #51

Contexto

Um único jeito de falar com a API, com tipos gerados do contrato OpenAPI do Scramble.

Escopo

• Gerar tipos e cliente a partir do OpenAPI (openapi-typescript ou equivalente) com script pnpm api:gen
• Camada de serviços por módulo, sem chamadas diretas de componentes
• Interceptor que injeta o token Bearer, renova ou desloga em 401 e propaga X-Request-Id
• Tradução do envelope de erro da API em mensagens de campo e avisos
• Armazenamento do token em cookie httpOnly via rota do servidor Nuxt, não em localStorage
• Composable useEdition() com a edição atual

Critérios de aceite

• Mudança no contrato da API quebra o typecheck do front
• Token nunca fica acessível a JavaScript do navegador
• Erros de validação aparecem ao lado do campo correto

Notas técnicas

• Se o token precisar estar no cliente, justificar em ADR

Depende de

• A01 · Bootstrap do front-admin com base_nuxt_modular #49
• B04 · Convenções da API: versionamento, erros, paginação e Scramble #6

Definição de pronto

• Testes passando na CI
• Lint e análise estática sem erros
• Documentação atualizada (OpenAPI via Scramble no backend, ou README do módulo no front)
• Revisado por pelo menos uma pessoa