Come creare e distribuire un'API REST con l'IA su Adios

Aiutami a pianificare un'API REST strutturata per la produzione in questo spazio di lavoro Adios. Non modificare ancora i file.

L'API:
- Nome: [NOME DELL'API]
- Utilizzatore: [APP WEB, APP MOBILE, STRUMENTO INTERNO O PARTNER]
- Risorsa principale: [RISORSA]
- Azioni principali: [CREAZIONE, ELENCO, LETTURA, AGGIORNAMENTO O ALTRE AZIONI]
- Autenticazione: [NESSUNA PER UNA DEMO PUBBLICA, TOKEN UTENTE O CHIAVE API DEL SERVIZIO]
- Database: [DATABASE ATTUALE DEL PROGETTO O POSTGRES]

Prima di proporre modifiche, esamina il repository, il framework attuale, il gestore di pacchetti, i test, la route del controllo di integrità, la configurazione dell'ambiente e adios.yaml.

Forniscimi:
1. la tabella delle route con metodi e codici di risposta;
2. le strutture di richieste e risposte;
3. la validazione e la gestione degli errori;
4. il modello di dati e l'approccio alle migrazioni;
5. i confini di autenticazione e autorizzazione;
6. le considerazioni sui limiti di richieste e sugli abusi;
7. i test automatizzati e gli esempi manuali con curl;
8. la configurazione necessaria in Adios per l'ambiente di esecuzione, i controlli di integrità, il database e i segreti.

Preferisci lo stack esistente. Spiega ogni nuova dipendenza. Attendi la mia approvazione prima di modificare i file.

Crea l'API REST dal piano che ho approvato.

Requisiti:
- Mantieni linguaggio, framework, gestore di pacchetti e file di distribuzione Adios esistenti.
- Conserva un endpoint leggero di integrità senza autenticazione che non esponga dati privati.
- Valida ogni input esterno e restituisci errori JSON con una struttura coerente.
- Applica autenticazione e autorizzazione sul server quando il piano le richiede.
- Usa accesso parametrizzato al database tramite il livello dati già adottato dal progetto.
- Aggiungi migrazioni reversibili se il repository usa migrazioni.
- Non inserire mai credenziali direttamente nel codice. Referenzia i valori del database e dell'autenticazione tramite i nomi delle variabili di ambiente.
- Aggiungi documentazione API concisa e richieste di esempio eseguibili.
- Aggiungi test per il caso ideale, input non validi, record mancanti, accesso non autorizzato e un caso di errore del database testabile in sicurezza.
- Esegui il formattatore, il linter, i test e il comando di build o compilazione di produzione già usati dal progetto.

Al termine, fornisci tabella delle route, file modificati, risultati dei test, configurazione Adios necessaria e comandi esatti da eseguire su Preview. Non distribuire in produzione.

Rivedi questa API come se dovesse essere chiamata da un client sconosciuto. Correggi solo i problemi verificati e non distribuire.

Controlla che:
- le route usino i metodi HTTP e i codici di stato previsti;
- gli input malformati, mancanti, troppo grandi o inattesi vengano rifiutati in modo sicuro;
- l'autenticazione non possa essere aggirata e un chiamante non possa accedere ai dati protetti di un altro;
- le risposte di errore non espongano tracce dello stack, segreti, dettagli del database o percorsi interni;
- le richieste ripetute vengano gestite in modo sicuro dove è richiesta l'idempotenza;
- le scritture nel database e le migrazioni siano coerenti;
- la documentazione dell'API e le richieste di esempio corrispondano all'implementazione;
- i controlli di integrità restino leggeri;
- i log siano utili senza registrare credenziali o contenuti sensibili delle richieste;
- tutti i controlli di formattazione, lint, test, compilazione o build vadano a buon fine.

Forniscimi una tabella dei controlli e delle prove, le esatte richieste da eseguire in Preview e gli eventuali rischi residui.

Prepara questa API per una revisione della distribuzione su Adios. Non distribuire finché non l'ho approvata.

Verifica il comando di avvio, l'host e la porta di ascolto, il percorso del controllo di integrità, i nomi delle variabili d'ambiente richieste, la dipendenza dal database, il comando di migrazione e la route pubblica prevista. Confrontali con adios.yaml e segnala ogni incongruenza.

Poi forniscimi:
1. i risultati finali dei controlli automatizzati;
2. cinque richieste sicure per test di funzionamento essenziali sull'URL di Preview;
3. una nota sul ripristino della versione precedente o sul recupero dopo una migrazione non riuscita;
4. i segreti che devo configurare tramite Adios anziché nel codice sorgente;
5. un controllo dopo la distribuzione che includa integrità, log, autenticazione e un ciclo di scrittura e lettura.

Fermati e attendi la mia approvazione prima della distribuzione in produzione.