# Documentazione di dominio (DAGM)

Questa cartella raccoglie testi su **prodotto**, **motore**, **framework**, **dataset** e **ricerca**. Sono documenti di riferimento lungo il ciclo di vita del modello, non necessariamente aggiornati ad ogni commit di codice.

**Per l’uso del repository DAGM6** (struttura, setup, avvio, API): partire da [`../docs/README.md`](../docs/README.md).

| File | Argomento |
|------|-----------|
| `dev.md` | Sviluppo, storage, principi |
| `product.md` | Proposta di valore, filosofia |
| `engine.md` | Motore |
| `framework.md` | Governance / prelievi |
| `research.md` | Ricerca |
| `dagm_sandbox_full_spec.md` | Specifica sandbox |
| `LEGACY_DAGM6_UMBREL.md` | Convivenza Umbrel: container DAGM6 (sandbox) vs API DAGM V2; Manage ST deprecata ma operativa finché non rimossa in piano |
| `DAGM_engine_validation_appendix.md` | Validazione |
| [`lifecycle_horizon.md`](lifecycle_horizon.md) | Lifecycle horizon (EN): shared definition, DARVA ↔ DAGM |
| [`references_spendable_capital_flag.md`](references_spendable_capital_flag.md) | Spendable-capital flag (GK/SWR/CPW): spec in MD (EN); exported PDF [`references_spendable_capital_flag.pdf`](references_spendable_capital_flag.pdf) for UI link |
| [`references_spendable_capital_overview.md`](references_spendable_capital_overview.md) | Sintesi IT: flag, PDF, UI Sandbox, pytest `references_spendable_session`, tabella confronto λ×flag e CSV campione |
| `Datasets_*` | Fonti e costruzione dataset |
| `Retail Overlay.md` | Overlay retail |
| `Reference/` | PDF di riferimento (letteratura practitioner / case study) usati anche per la §9 del paper v1.6 |

PDF e CSV di supporto sono nella stessa cartella o in `documentation/data_sources/` dove applicabile.