Parties, items and the CRM archives need codes given by the system without
duplicates, and the address and bank fields should fill themselves; this adds
both before the party and item screens that use them.
- CodeMask ({seq:0000}, {anno}, {categoria}) and code_sequences (migration
015): one sequence per rule, year and category, taken under a lock in the
transaction that saves the record, skipping codes written by hand
- CodeRuleService: rules in company settings with the masks of SPEC 11.12,
validation, preview of the next code, manual code allowed or not
- AutoFillService: municipality from postal code and back, personal tax code,
VIES, bank and BIC from the IBAN, delivery date on working days, options
that can be switched off (the ECB job honours its option)
- IBankDirectory.ReadIban gives ABI and CAB even without the ABI list; the
Italian pack now registers the directory
- Company preferences page (mockup 074) at /tabelle/preferenze, in the menu
- aria-checked now renders true/false on switch rows and profile radios
- ADR 0027, wiki, CHANGELOG, STATUS, DATA-MODEL
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.