Cómo crear y desplegar una API REST con IA en Adios

Ayúdame a planificar una API REST con estructura de producción en este espacio de trabajo de Adios. No edites archivos todavía.

La API:
- Nombre: [API NAME]
- Consumidor: [WEB APP, MOBILE APP, INTERNAL TOOL, OR PARTNER]
- Recurso principal: [RESOURCE]
- Acciones principales: [CREATE, LIST, READ, UPDATE, OR OTHER ACTIONS]
- Autenticación: [NONE FOR A PUBLIC DEMO, USER TOKEN, OR SERVICE API KEY]
- Base de datos: [CURRENT PROJECT DATABASE OR POSTGRES]

Antes de proponer cambios, inspecciona el repositorio, el framework actual, el gestor de paquetes, las pruebas, la ruta de salud, la configuración del entorno y adios.yaml.

Devuelve:
1. la tabla de rutas con métodos y códigos de respuesta;
2. los formatos de solicitudes y respuestas;
3. la validación y el comportamiento de errores;
4. el modelo de datos y el enfoque de migración;
5. los límites de autenticación y autorización;
6. las consideraciones sobre límites de solicitudes o abuso;
7. las pruebas automatizadas y los ejemplos manuales de curl; y
8. la configuración necesaria de entorno de ejecución, salud, base de datos y secretos en Adios.

Prefiere el stack existente. Explica cualquier dependencia nueva. Espera mi aprobación antes de editar.

Crea la API REST a partir del plan que he aprobado.

Requisitos:
- Conserva el lenguaje, el framework, el gestor de paquetes y los archivos de despliegue de Adios existentes.
- Conserva un endpoint de salud ligero sin autenticación que no exponga datos privados.
- Valida cada entrada externa y devuelve un formato JSON de error coherente.
- Aplica la autenticación y la autorización en el servidor cuando el plan las requiera.
- Usa acceso parametrizado a la base de datos mediante la capa de datos establecida del proyecto.
- Añade migraciones reversibles si este repositorio utiliza migraciones.
- Nunca escribas credenciales directamente en el código. Referencia los valores de base de datos y autenticación por el nombre de la variable de entorno.
- Añade documentación concisa de la API y solicitudes de ejemplo ejecutables.
- Añade pruebas del recorrido correcto, entradas inválidas, registros ausentes, acceso no autorizado y un recorrido de fallo de base de datos que se pueda probar de forma segura.
- Ejecuta el formateador, el linter, las pruebas y el comando de compilación de producción que ya utiliza el proyecto.

Al terminar, dame la tabla de rutas, los archivos modificados, los resultados de las pruebas, la configuración necesaria en Adios y los comandos exactos que puedo ejecutar contra la vista previa. No despliegues en producción.

Revisa esta API como si fuera a llamarla un cliente desconocido. Corrige solo problemas verificados y no despliegues.

Comprueba:
- que las rutas usen los métodos HTTP y códigos de estado previstos;
- que las entradas malformadas, ausentes, demasiado grandes e inesperadas fallen de forma segura;
- que no se pueda eludir la autenticación y que un cliente no pueda acceder a los datos protegidos de otro;
- que las respuestas de error no expongan trazas de pila, secretos, detalles de base de datos ni rutas internas;
- que las solicitudes repetidas se comporten de forma segura cuando se requiera idempotencia;
- que las escrituras de base de datos y las migraciones sean coherentes;
- que la documentación de la API y las solicitudes de ejemplo coincidan con la implementación;
- que las comprobaciones de salud sigan siendo ligeras;
- que los registros sean útiles sin registrar credenciales ni cuerpos de solicitudes sensibles; y
- que pasen todas las comprobaciones del formateador, lint, pruebas y compilación.

Devuelve una tabla de comprobaciones y pruebas, las solicitudes exactas que debo ejecutar en la vista previa y cualquier riesgo pendiente.

Prepara esta API para una revisión de despliegue en Adios. No despliegues hasta que lo apruebe.

Confirma el comando de inicio, el host y puerto de escucha, la ruta de salud, los nombres necesarios de variables de entorno, la dependencia de base de datos, el comando de migración y la ruta pública esperada. Compáralos con adios.yaml e informa de cualquier discrepancia.

Después dame:
1. los resultados finales de las comprobaciones automatizadas;
2. cinco solicitudes seguras de prueba de humo para la URL de vista previa;
3. una nota de reversión o recuperación para una migración fallida;
4. los secretos que debo configurar mediante Adios en lugar de incluirlos en el código fuente; y
5. una comprobación posterior al despliegue que cubra salud, registros, autenticación y un ciclo de escritura y lectura.

Detente para obtener mi aprobación antes del despliegue en producción.