Files
Khaemhat/docs/adr/0004-micro-orm-interno.md
T
Alby96andClaude Opus 5.5 88de272b3e docs: avoid ambiguous Unicode and record Gitea planning in STATUS
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>
2026-11-10 22:44:14 +01:00

27 lines
1.2 KiB
Markdown

# 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`), `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`).