The rest of the product needs tax codes, natures, code lists and VAT rules without knowing the country. IFiscalPack exposes the parts every country has (tax code catalog, tax engine, calendar) and optional features by type, so a module can tell a missing feature from a broken one. FiscalPackCatalog finds the pack by country; only the composition root names the Italian pack, as an architecture test now checks. The Italian pack carries the FatturaPA 1.9.1 code lists, VAT natures and base tax codes with their rules, summary rounding on the total per rate, the stamp duty rule, VAT deadlines with the August and holiday shifts, withholding kinds, basic depreciation rules and F24 codes. ADR 0025 records the design. 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.