Files
Khaemhat/docs/adr/0010-solo-docker-nessun-installer.md
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.4 KiB

ADR 0010 — Distribuzione solo Docker, nessun installer

  • Stato: accettata
  • Data: 2026-11-10
  • Rafforza: SPEC §1.5, §16

Contesto

La specifica prevede già la distribuzione in Docker. Il titolare del progetto ha precisato che è ammesso solo Docker: niente setup né installer, ma solo il pacchetto nel gestore pacchetti di Gitea.

Decisione

  • L'unico artefatto distribuito è l'immagine container gitea.encke-hake.ts.net/balbosoft/khaemhat:<versione>.
  • Non si producono installer, setup, .msi, .exe, .deb, .rpm, pacchetti NuGet/npm, binari self-contained, ZIP con l'applicazione, servizi Windows o systemd.
  • Le release Gitea contengono solo le note di rilascio (dal CHANGELOG.md) e il riferimento all'immagine.
  • L'installazione si fa con i file di deploy/ (compose generico, compose SQLite demo, compose Unraid, template Community Applications); la configurazione iniziale solo da variabili d'ambiente.
  • Gli strumenti accessori (tools/Khaemhat.LicenseTool, scripts/*.sh) restano nel repository per chi sviluppa e non vengono distribuiti.

Conseguenze

  • Il Dockerfile multi-stage è l'unico percorso di build di produzione; la build locale (dotnet run) serve solo allo sviluppo.
  • La documentazione utente non descrive installazioni "native".
  • Eventuali richieste di installer vanno respinte o portate all'utente come nuova decisione.