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

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