Como criar e implantar uma API REST com IA no Adios

Ajude-me a planejar uma API REST estruturada para produção neste espaço de trabalho Adios. Não edite arquivos ainda.

A API:
- Nome: [NOME DA API]
- Consumidor: [APLICAÇÃO WEB, APLICATIVO MÓVEL, FERRAMENTA INTERNA OU PARCEIRO]
- Recurso principal: [RECURSO]
- Ações principais: [CRIAR, LISTAR, LER, ATUALIZAR OU OUTRAS AÇÕES]
- Autenticação: [NENHUMA PARA UMA DEMONSTRAÇÃO PÚBLICA, TOKEN DE USUÁRIO OU CHAVE API DE SERVIÇO]
- Banco de dados: [BANCO ATUAL DO PROJETO OU POSTGRES]

Antes de propor mudanças, examine o repositório, o framework atual, o gerenciador de pacotes, os testes, a rota de saúde, a configuração de ambiente e adios.yaml.

Retorne:
1. a tabela de rotas com métodos e códigos de resposta;
2. os formatos de requisição e resposta;
3. o comportamento da validação e dos erros;
4. o modelo de dados e a abordagem de migrações;
5. os limites de autenticação e autorização;
6. considerações sobre limites de requisições ou abusos;
7. testes automatizados e exemplos manuais com curl; e
8. a configuração necessária no Adios de ambiente de execução, saúde, banco de dados e segredos.

Prefira a stack existente. Explique qualquer nova dependência. Aguarde minha aprovação antes de editar.

Crie a API REST a partir do plano que aprovei.

Requisitos:
- Mantenha a linguagem, o framework, o gerenciador de pacotes e os arquivos de implantação Adios existentes.
- Preserve um endpoint de saúde leve e sem autenticação, que não exponha dados privados.
- Valide todas as entradas externas e retorne um único formato consistente de erro JSON.
- Aplique autenticação e autorização no servidor quando o plano exigir.
- Use acesso parametrizado ao banco de dados pela camada de dados já estabelecida no projeto.
- Adicione migrações reversíveis se este repositório usar migrações.
- Nunca inclua credenciais diretamente no código. Faça referência aos valores de banco de dados e autenticação pelo nome da variável de ambiente.
- Adicione documentação concisa da API e exemplos de requisição executáveis.
- Adicione testes para o fluxo normal, entradas inválidas, registros ausentes, acesso não autorizado e um cenário de falha do banco de dados que possa ser testado com segurança.
- Execute o formatador, o linter, os testes e o comando de compilação de produção já usados pelo projeto.

Ao terminar, forneça a tabela de rotas, os arquivos alterados, os resultados dos testes, a configuração Adios necessária e os comandos exatos que posso executar em Preview. Não implante em produção.

Revise esta API como se um cliente desconhecido fosse chamá-la. Corrija apenas problemas verificados e não implante.

Verifique:
- as rotas usam os métodos HTTP e códigos de status previstos;
- entradas malformadas, ausentes, grandes demais e inesperadas são recusadas com segurança;
- a autenticação não pode ser contornada e um cliente não pode acessar os dados protegidos de outro;
- respostas de erro não expõem stack traces, segredos, detalhes do banco de dados ou caminhos internos;
- requisições repetidas se comportam com segurança quando a idempotência é necessária;
- gravações no banco de dados e migrações são consistentes;
- a documentação da API e os exemplos de requisição correspondem à implementação;
- as verificações de saúde continuam leves;
- os logs são úteis sem registrar credenciais ou corpos de requisição sensíveis; e
- todas as verificações de formatação, lint, testes e compilação passam.

Retorne uma tabela de verificações e evidências, as requisições exatas que devo executar em Preview e qualquer risco restante.

Prepare esta API para uma revisão de implantação Adios. Não implante até que eu aprove.

Confirme o comando de inicialização, o host e a porta de escuta, o caminho de saúde, os nomes das variáveis de ambiente necessárias, a dependência do banco de dados, o comando de migração e a rota pública esperada. Compare tudo com adios.yaml e informe qualquer divergência.

Depois, forneça:
1. os resultados finais das verificações automatizadas;
2. cinco requisições seguras de teste básico para a URL de Preview;
3. uma nota de reversão ou recuperação para uma migração em falha;
4. os segredos que devo configurar pelo Adios, fora do código-fonte; e
5. uma verificação após a implantação cobrindo saúde, logs, autenticação e um ciclo de gravação e leitura.

Pare para obter minha aprovação antes da implantação em produção.