Architettura

• Server: un’unica app Hono costruita da createApp(deps), senza dipendenze dalla piattaforma. Due punti di ingresso: Node (Docker) e Cloudflare Workers.
• Porte e adattatori: l’app dipende da interfacce (src/server/ports.ts); gli adattatori le implementano per ogni ambiente (libsql su Node, D1 su Cloudflare, cifratura AES-GCM, verifica dei JWT di Access).
• Database: SQLite con Drizzle ORM; le stesse migrazioni su libsql e D1. Le scritture con più istruzioni usano db.batch.
• Validazione: schemi Zod condivisi fra client, server, import e generatore del prompt.
• Client: SPA Vite + React con TanStack Query, PWA con Workbox e Dexie per l’uso senza rete.
• Test: Vitest; i test del contratto API girano due volte, su Node e nel runtime dei Worker.

Le regole di progetto, per persone e agenti, sono in AGENTS.md.