Gitea flags en dash, multiplication sign, minus sign and single angle quotes as confusable characters, which put a warning on most pages; use plain equivalents (docs/SPEC.md stays untouched). STATUS.md now lists the issue numbers per milestone, the items waiting for the owner and the open specification questions tracked by issue #114. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1.2 KiB
1.2 KiB
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<T>),QueryBuilder<T>con traduzione di un sottoinsieme sicuro di espressioni,Repository<T,TKey>con concorrenza ottimistica (row_version),UnitOfWorkcon 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, tabellaschema_versioncon 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.mdsi genera dalle mappe (scripts/gen-datamodel.sh).