# ADR 0004 — Micro-ORM interno e migrazioni in C# - **Stato:** accettata - **Data:** 2026-11-10 - **Fonte:** SPEC §5.1-§5.3 ## Contesto Senza ORM esterni (ADR 0002) e con due motori (SQLite e PostgreSQL), l'accesso ai dati deve essere tipizzato, sicuro contro l'iniezione SQL e prevedibile nelle prestazioni. ## Decisione - `Khaemhat.Data`: mappe esplicite per entità (`EntityMap`), `QueryBuilder` con traduzione di un sottoinsieme sicuro di espressioni, `Repository` con concorrenza ottimistica (`row_version`), `UnitOfWork` con transazioni esplicite, SQL sempre parametrizzato. - Un provider per dialetto (`Khaemhat.Data.Sqlite`, `Khaemhat.Data.PostgreSql`): tipi, paginazione, upsert, lock. - Migrazioni in C# (`[Migration(yyyymmdd_nnn, "name")]`) con DDL generato per dialetto, catalogo di sistema e aziendale, tabella `schema_version` con checksum, nessun downgrade. - Decimali `numeric(19,6)` su PostgreSQL e interi scalati x10⁶ su SQLite. ## Conseguenze - Nessun codice sopra lo strato dati conosce il motore; i test girano su entrambi. - Le query pesanti (report, partitari) possono usare SQL scritto a mano per dialetto, sempre parametrizzato. - `docs/DATA-MODEL.md` si genera dalle mappe (`scripts/gen-datamodel.sh`).