The milestone's Definition of Done asks for complete wiki pages with real screenshots, a changelog for everything delivered, an image that builds locally and a SQLite demo that starts from zero. Ten screenshots taken on a fresh demo instance now sit next to the mockups; Anagrafiche, Articoli e listini and Tabelle azienda are complete, Import-Export and Dati di base are complete for M4, and the preference tabs still to come say which milestone brings them. The changelog gains its 0.4.0 section, and STATUS, Roadmap, Changelog and Home point at 0.4.0 and M5. The screenshots showed that the import preview pushed the outcome column off the right edge, so its reasons could not be read: the outcome now follows the line number and the table scrolls sideways. The warnings for values filled from the postal code no longer repeat the column name. 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.