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>
27 lines
1.2 KiB
Markdown
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`).
|