API

Ogni operazione è dichiarata nel codice con @hono/zod-openapi e pubblicata in docs/api/openapi.json (OpenAPI 3.1, generato).

Ogni operazione porta:

• x-milestone: la tappa in cui arriva;
• x-status: planned finché non è montata sul server, poi implemented;
• x-auth: public, bootstrap, member o service;
• per le scritture, la regola di proprietà (chi può modificare cosa).

Gli esempi di richiesta e risposta di ogni operazione sono in fixtures/api/: l’interfaccia li usa come dati finti finché il server non è pronto.

Tutte le richieste passano da Cloudflare Access (o dal suo emulatore in locale); l’unica pubblica è GET /api/health.