Start development with the skeleton every later milestone builds on, so that code, image and release path exist and are verified from day one. - Khaemhat.sln with the ten projects of SPEC section 3 and six MSTest projects; shared build rules with warnings as errors, analyzers and Central Package Management restricted to the allowlist. - Architecture tests and scripts/check-packages.sh fail on any project reference or package that SPEC does not allow. - Khaemhat.Web serves an Italian "under construction" page with the official icons and version, plus /health/live, /health/ready and /health (ADR 0012); honours KHAEMHAT_URLS and KHAEMHAT_LOG_LEVEL. - docker/Dockerfile (non-root app user aligned to PUID/PGID by the entrypoint, pg_dump 17, healthcheck, OCI and Unraid labels) and compose files for PostgreSQL and a standalone SQLite demo. - Gitea Actions: ci.yml (build, tests, image smoke test, PostgreSQL 16/17 on tags, YAML check), release.yml (image and release from a vX.Y.Z tag, skipping versions already published) and wiki.yml. - Development scripts, VS Code launch/tasks for debugging, and ADR 0012-0017 deciding the M0 open points of docs/STATUS.md. Closes #1, #2, #3, #4, #5, #114 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Khaemhat
Gestionale ERP + CRM per piccole e medie imprese italiane, scritto da zero in C# 14 su .NET 10 con interfaccia Blazor Server, PostgreSQL (o SQLite per demo e test) e nessuna libreria esterna. Si installa solo con Docker: l'unico artefatto distribuito è l'immagine nel registro pacchetti di Gitea.
Stato: sviluppo avviato. M0 (struttura, immagine Docker, CI) consegna la versione 0.0.1 con una pagina "in costruzione"; le funzioni arrivano milestone dopo milestone. Vedi
docs/STATUS.mde la Roadmap.
Il nome viene da Khaemhat (Mahu), scriba reale e sovrintendente al doppio granaio dell'Alto e del Basso Egitto sotto Amenhotep III: un contabile e un magazziniere dell'antichità. Vedi Origine del nome.
Cosa farà
- Anagrafiche, articoli, listini, tabelle; vendite e acquisti con motore documenti unico; magazzino.
- Contabilità generale, IVA, F24, LIPE, ritenute, bollo, cespiti, Intrastat, chiusura e bilancio CEE.
- Scadenzario, incassi e pagamenti, RiBa/SDD/SEPA, riconciliazione bancaria, solleciti.
- Fatturazione elettronica FatturaPA con canali SDI (PEC integrata, SdICoop, intermediari).
- CRM (lead, pipeline, attività, campagne, ticket), automazioni, API REST e server MCP.
- Più aziende sulla stessa istanza (un database di sistema + un database per azienda), moduli attivabili con licenza, temi chiaro/scuro, dashboard a widget.
Installazione
docker pull gitea.encke-hake.ts.net/balbosoft/khaemhat:<versione>
- Qualunque host Docker:
deploy/docker-compose.yml(con PostgreSQL) edeploy/.env.example; per una prova velocedeploy/docker-compose.sqlite.yml. - Unraid: template
deploy/unraid/khaemhat.xmlodeploy/docker-compose.unraid.ymlcondeploy/.env.example. - Guide: Installazione Unraid · Installazione Docker · Primi passi.
Sviluppo
Serve l'SDK .NET 10 (global.json); Docker solo per costruire e provare l'immagine.
scripts/build.sh # allowlist dei pacchetti + build con warning come errori
scripts/test.sh # tutti i test (PostgreSQL con KHAEMHAT_TEST_PG, Redis con KHAEMHAT_TEST_REDIS)
scripts/run-dev.sh # avvio locale su http://localhost:5080 con SQLite in .data/dev
docker build -f docker/Dockerfile -t khaemhat:dev .
Processo, rami e Definition of Done in docs/DEVELOPMENT.md.
Documentazione
| Cosa | Dove |
|---|---|
| Wiki (guida utente e amministratore) | https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/wiki (sorgente in docs/wiki/) |
| Specifica normativa | docs/SPEC.md |
| Regole operative ed emendamenti | CLAUDE.md |
| Processo di sviluppo | docs/DEVELOPMENT.md |
| Architettura, dati, moduli, API, MCP | docs/ARCHITECTURE.md, docs/DATA-MODEL.md, docs/MODULES.md, docs/API.md, docs/MCP.md |
| Installazione e sicurezza | docs/DEPLOY.md, docs/SECURITY.md |
| Decisioni architetturali | docs/adr/ |
| Mockup | docs/mockups/ |
| Novità | CHANGELOG.md |
Pianificazione
Il lavoro è organizzato in issue raggruppate per milestone (M0-M14) e nei progetti Khaemhat 1.0 — Sviluppo e Khaemhat 1.1+ — Fase 2.