Files
Khaemhat/docs/adr/0001-stack-dotnet-10-csharp-14.md
T
Alby96andClaude Opus 5.5 e746d99dab docs: add specification, design docs, mockups, wiki and deploy files
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>
2026-11-10 22:26:58 +01:00

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, con Fiscal.Italy che 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.0 e 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.