Prepare everything needed before development starts on Khaemhat, the ERP + CRM for Italian SMEs: - docs/SPEC.md: the original project specification, unchanged, plus CLAUDE.md with operational rules and amendments (Gitea instead of GitHub/GHCR, Docker image as the only deliverable). - ADR 0001-0011 for the baseline decisions. - Mockups: 22 high-resolution screens, the full gallery, 88 thumbnails cropped from it, mockup.css and an index. - Technical docs (architecture, data model, modules, API, MCP, deploy, security, development process, status with open spec questions). - Full draft wiki in docs/wiki (already published to the Gitea wiki). - Icons in assets/ and deploy files for Docker Compose and Unraid, pointing to the Gitea package registry. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1.3 KiB
1.3 KiB
ADR 0001 — Stack: C# 14 su .NET 10, un solo processo
- Stato: accettata
- Data: 2026-11-10
- Fonte: SPEC §1.1, §2, §3
Contesto
Khaemhat è un gestionale per PMI distribuito come singola immagine Docker, gestito da chi ha un server domestico o aziendale (anche Unraid). Serve una piattaforma con supporto lungo, buone prestazioni su un solo nodo e la possibilità di scrivere in casa ciò che di solito arriva da librerie esterne.
Decisione
- C# 14 su .NET 10 (LTS), unico linguaggio lato server. JavaScript solo come interop minimo in
wwwroot/js, senza framework né bundler. - ASP.NET Core 10 su Kestrel, un processo per istanza che serve più aziende; nessuno scale-out orizzontale.
- Soluzione a livelli (SPEC §3):
Web→Application→Fiscal.Abstractions/Data/Infrastructure→Core, conFiscal.Italyche implementa le astrazioni fiscali. Le dipendenze sono verificate da un test di architettura. Nullable,TreatWarningsAsErrors, analyzer di piattaforma,.editorconfig; versione SemVer dai tag git.
Conseguenze
- Il container contiene solo il runtime
aspnet:10.0e pochi strumenti di sistema. - Con un solo processo, cache, scheduler e lock possono stare in memoria; Redis resta opzionale (ADR 0006).
- Il passaggio a una futura LTS sarà una decisione esplicita con un nuovo ADR.