The owner confirmed that no further high-resolution mockups exist, gave up the preloaded ABI/CAB bank list and set aside real SDI intermediaries, SdICoop accreditation and a test PEC mailbox. ADR 0044 records this so the next milestones stop waiting on that material: thumbnail-only screens are designed from the thumbnail and the existing UI, bank name and BIC come from a company account or are typed once, and #78 moves to the backlog. CLAUDE.md E4, the mockup index, related ADRs, status, changelog and the user guide are updated accordingly. Closes #35 Closes #45 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
49 KiB
Changelog
Tutte le modifiche rilevanti di Khaemhat sono annotate in questo file.
Il formato segue Keep a Changelog e le versioni seguono
Semantic Versioning. Ogni versione corrisponde a un tag git vX.Y.Z e a
un'immagine gitea.encke-hake.ts.net/balbosoft/khaemhat:X.Y.Z.
[Unreleased]
Changed
- Decisioni del titolare (ADR 0044): le schermate con sola miniatura si disegnano dalla miniatura e dalla grafica del gestionale, senza attendere altri PNG (#35); nessun elenco ABI/CAB precaricato, nome della banca e BIC dal conto dell'azienda o a mano (#45); intermediari reali, accreditamento SdICoop e PEC di prova rimandati (#78). La guida Fatturazione elettronica spiega quale canale usare.
[0.10.0] - 2026-11-13
M10 - Cespiti, Intrastat, chiusura, bilancio. I beni ammortizzabili hanno il loro registro con il piano civilistico e fiscale; gli elenchi Intrastat nascono dalle fatture con il file per le Dogane; le dichiarazioni d'intento hanno un registro e il plafond è controllato quando si conferma la fattura; a fine anno ratei, risconti e una chiusura guidata in nove passi portano al bilancio CEE con riclassificato, indici ed export per il commercialista.
Added
- Cespiti (#82, ADR 0041, mockup 048): categorie con i coefficienti del DM 31/12/1988 (Categorie standard), conti e aliquote civilistica e fiscale; registro con piano di ammortamento per anno, movimenti, beni già in uso con i fondi iniziali; ammortamenti dell'anno registrati per categoria e annullabili finché non definitivi; dismissioni totali e parziali con plusvalenza o minusvalenza; stampa del registro dei beni ammortizzabili.
- Intrastat (#83, ADR 0042, mockup 049): elenchi di cessioni e acquisti generati da fatture e note confermate (beni
raggruppati, servizi per fattura, rettifiche), righe manuali che sopravvivono alla rigenerazione, controlli di
nomenclatura, massa, partita IVA e codice CPA, periodicità dovuta dalle soglie dei quattro trimestri precedenti,
file
SCAMBI.CEEe invio registrato con il protocollo. - Dichiarazioni d'intento (#83, ADR 0042, mockup 061): registro cronologico delle dichiarazioni ricevute ed emesse con protocollo telematico, plafond, utilizzato ricalcolato dalle vendite in N3.5, avviso dal 90 %, revoca e stampa; la conferma di una fattura in N3.5 è rifiutata senza dichiarazione valida o oltre il plafond.
- Ratei e risconti (#84): inserimento con calcolo per giorni, proposta dei risconti dalle fatture di acquisto sui costi tipicamente a cavallo dell'anno, differenze di cambio al 31/12 sulle partite in valuta.
- Chiusura guidata (#85, ADR 0043, mockup 050): controlli, ammortamenti, ratei e risconti, rimanenze al costo medio ponderato, accantonamenti (svalutazione crediti 0,5 %, TFR), chiusura dei conti economici e patrimoniali, apertura dell'esercizio successivo con lo storno dei ratei, stampe definitive (libro giornale, registri IVA, registro cespiti, bilancio); ogni passo si ripete o si annulla fino alle stampe; blocco dell'esercizio.
- Bilancio (#86, ADR 0043, mockup 051): schede CEE, Riclassificato e Indici nella pagina Bilancio; schema ordinario, abbreviato e micro con l'anno precedente e la variazione, dettaglio dei conti di ogni voce, avviso dei conti senza voce, stato patrimoniale finanziario e conto economico a valore aggiunto, undici indici, stampa PDF ed export ZIP per il commercialista (cinque CSV).
- Dati di esempio di fine anno (#87): apertura dei conti al 1° gennaio con cespiti, rimanenze, banca e capitale, quattro cespiti, un risconto, la dichiarazione d'intento in uso e una cessione intracomunitaria; prova di integrazione che chiude l'anno demo dal passo 1 al blocco su SQLite e PostgreSQL.
- Permessi
assets.asset.read,assets.asset.write,assets.depreciation.post,intrastat.list.read,intrastat.list.write,intrastat.list.export,sales.intent.read,sales.intent.write,ledger.year.close,reports.accountant.export. - Tabelle
fixed_asset_categories,fixed_assets,fixed_asset_movements,accruals,closing_runs,closing_steps,closing_prints,intrastat_lists,intrastat_list_lines,intent_declarations(migrazionecreate_year_end). - ADR 0041, 0042 e 0043; pagine wiki Cespiti, Intrastat, Dichiarazioni d'intento e Chiusura e bilancio con le schermate.
Changed
- Menu Contabilità con Ratei e risconti e Chiusura esercizio; menu Cespiti con Categorie; Intrastat e Dichiarazioni d'intento attivi nel menu Fatturazione elettronica.
- La dichiarazione d'intento nei dati fiscali del cliente è lo specchio di quella corrente del registro; quelle scritte prima della 0.10 entrano nel registro alla prima lettura.
- Il pacchetto fiscale espone le regole di cespiti, chiusura, Intrastat, dichiarazioni d'intento e lo schema del bilancio CEE.
Known issues
- Il file
SCAMBI.CEEnon è ancora stato verificato con il software di controllo delle Dogane: controllarlo prima del primo invio. - Le differenze di cambio usano il residuo attuale della partita; il TFR della chiusura è una stima.
[0.9.0] - 2026-11-13
M9 - Fatturazione elettronica. Le fatture emesse diventano file FatturaPA controllati prima dell'invio con i codici dello SDI e partono dal canale scelto dalle regole di instradamento (PEC, SdICoop o due intermediari); le notifiche aggiornano da sole file e documenti, gli scarti si correggono e si rigenerano, le fatture dei fornitori arrivano in una casella da registrare e i file di un periodo si esportano per la conservazione.
Added
- File FatturaPA (#74, ADR 0039):
FatturaPaWriterscriveFPR12,FPA12eFSM10v1.2 con nomeIT<identificativo>_<progressivo>.xmle progressivo in base 36 mai riusato; il modello del documento viene daEInvoiceBuilder(cedente, cessionario, ritenute, cassa, bollo, sconti, riferimenti, DDT, riepilogo IVA, pagamenti, allegati). - Controllo prima dell'invio (#74):
FatturaPaValidatorripete offline i controlli dello SDI con lo stesso codice (00305-00473) e le tolleranze delle specifiche 1.9.1, più la struttura contro uno schema incorporato; Controlla senza generare sul cruscotto. - Notifiche SDI (#75):
SdiReceiptReaderlegge RC, NS, MC, NE, DT, AT, SE e MT; ogni notifica è conservata una sola volta, abbinata al file e applicata al file e al documento nella stessa transazione; import manuale di XML, P7M e ZIP del portale; pagina Notifiche SDI con filtri e download. - Canali (#76, #77): PEC con SMTP e un client IMAP e un lettore MIME scritti in casa (primo invio a
sdi01@pec.fatturapa.it, poi l'indirizzo appreso dallo SDI, cartella di archivio), SdICoop SOAP/MTOM con certificato client, Intermediario A (chiave API) e Intermediario B (utente e password) dietro lo stesso contrattoIEInvoiceTransport(ADR 0040); prova di connessione, pausa, segreti cifrati. - Instradamento (#77): regole Sempre, Cliente PA, Cliente specifico, Tipo documento e Volume giornaliero
con canale di riserva (
SdiRouter); pagina Canali di trasmissione (mockup 059). - Lettura dei canali (#76): attività
einvoice.pollogni 15 minuti e Leggi i canali ora; un messaggio si conferma solo quando tutti i suoi file sono salvati. Ricezione push di SdICoop suPOST /sdicoop/{azienda}con la chiave di ricezione nell'intestazioneX-Khaemhat-SdiCoop-Keye il certificato reciproco sul reverse proxy. - Cruscotto SDI (#74, #75, mockup 058): sei contatori, viste Emesse, Autofatture e Da fare, filtri e
ricerca, documenti da generare, Genera + invia, Invia, Correggi, Segna come inviata, download dell'XML,
storico del file con le versioni sostituite, esito della trasmissione; avvisi sulla Home per scarti e file da
inviare (
EInvoiceFeedSource). - Copia di cortesia (#74): il PDF del documento con il file FatturaPA allegato (
/AF). - Fatture ricevute (#79): casella delle fatture dei fornitori dai canali o caricate (XML, P7M, metadati, ZIP) senza doppioni, registrazione singola o in blocco con l'import del ciclo passivo, scarto e ripristino, download.
- Conservazione (#79): pacchetto ZIP di un periodo (fino a due anni) con
emesse/,ricevute/,notifiche/,indice.csvcon SHA-256 eLEGGIMI.txt, e l'elenco dei pacchetti preparati. - Fatturazione elettronica nei dati di esempio con il modulo EINV (#80): canale PEC in pausa, Intermediario A disattivato, tre regole, i file delle fatture demo con consegne, uno scarto corretto, una mancata consegna e file in attesa, tre fatture di fornitori da registrare.
- Rimozione dei dati di esempio (#80, ADR 0040):
DemoDataRemoverguidato dallo schema delle migrazioni elimina le righeis_demoe quelle che appartengono loro in una transazione e si ferma se dati dell'utente vi fanno riferimento;scripts/seed.sh --remove-demo [--company CODICE]; il seed stampa il tempo impiegato. - Permessi
einvoice.document.read,einvoice.document.send,einvoice.inbox.read,einvoice.inbox.import,einvoice.channel.manage; testi inResources/it-IT/EInvoicing.json. - Tabelle
e_invoices,e_invoice_notifications,e_invoice_inbox,e_invoice_channels,e_invoice_routing,e_invoice_conservation(migrazioneM20261113_004). - ADR 0039 e 0040; pagina wiki Fatturazione elettronica completa con le schermate (#81).
Changed
- Il menu Fatturazione elettronica ha le voci Cruscotto SDI, Fatture ricevute, Notifiche SDI, Conservazione e Canali di trasmissione, ognuna con il suo permesso; Dichiarazioni d'intento resta in M10.
- Una fattura scartata dallo SDI torna modificabile e si rigenera con un nuovo file.
- I seeder dimostrativi marcano come demo anche le righe scritte dai servizi per loro (registrazioni, partite, pagamenti, mandati, estratti conto).
- Il modello delle fatture ricevute è condiviso con quello delle emesse (
EInvoice*nelle astrazioni fiscali).
[0.8.0] - 2026-11-13
M8 - Scadenzario e tesoreria. Le partite aperte di clienti e fornitori si chiudono con incassi e pagamenti che si contabilizzano da soli; distinte RiBa, SDD e bonifici SEPA con il file per l'home banking, presentazione, accredito e insoluti; riconciliazione dell'estratto conto con abbinamento automatico; solleciti con interessi di mora e flusso di cassa.
Added
- Scadenzario (#69, ADR 0038): partite aperte di clienti e fornitori dalla contabilità con stati, aging in cinque fasce, filtri, modifica di scadenza, metodo, banca e contestazione, estratto conto della controparte con gli interessi di mora, export CSV.
- Incassi e pagamenti (#69): su più partite della stessa controparte, totali o parziali, con abbuoni, spese bancarie,
differenze cambio e note di credito; registrazione
INCoPAGnella stessa transazione; annullamento con storno; la ritenuta d'acconto di una parcella diventa dovuta quando la fattura è saldata. Elenchi Incassi e Pagamenti. - Distinte (#70): RiBa nel tracciato CBI (
RibaCbiWriter), SDD core e B2B inpain.008.001.08e bonifici SEPA inpain.001.001.09(SepaXmlWriter); candidati con controllo di IBAN, ABI/CAB e mandato; bozza, file, presentazione su Effetti all'incasso o con anticipo salvo buon fine, accredito, insoluto con riapertura della partita e spese come nuova partita del cliente. - Mandati SDD (#70) con riferimento univoco, schema core o B2B, firma, revoca, sequenza FRST/RCUR.
- Riconciliazione bancaria (#71): import di estratti CSV (colonne riconosciute dall'intestazione), CBI e CAMT.053
senza doppioni (impronta dei movimenti); proposte con confidenza da partite, incassi e pagamenti registrati, F24,
accrediti e insoluti di distinte e regole salvate (
BankMatcher); conferma singola o di tutte le proposte dal 90%; abbinamento manuale, registrazione su conto con regola, Ignora, Annulla abbinamento; saldo banca, saldo contabile e differenza. - Solleciti (#72): tre livelli modificabili con giorni, modello, canali (e-mail, PEC, lettera PDF), interessi di
mora, avviso all'agente e blocco del cliente; proposta di invio che esclude PA, partite contestate e in distinta;
anteprima PDF, invio con la coda di posta, lettere in un PDF unico, registro degli invii; attività programmata
finance.dunningnei giorni feriali alle 7:00 per i livelli automatici. - Interessi di mora del D.Lgs. 231/2002 nel pacchetto italiano (
LatePaymentRulesIt): tasso BCE del semestre più 8 punti, 10,15% nel primo semestre 2026 e 10,40% nel secondo. - Flusso di cassa (#72) a 30-365 giorni per settimana o mese da partite, effetti presentati, ordini non fatturati, registrazioni ricorrenti e F24, con le fonti selezionabili e il punto più basso.
- Scadenze di incassi e pagamenti e crediti scaduti sulla Home (
TreasuryFeedSource). - Menu Scadenzario con otto voci; testi in
Resources/it-IT/Treasury.json; permessifinance.schedule.*,finance.payment.*,finance.bank.reconcile. - Tesoreria nei dati di esempio con il modulo FIN (#73): banca, versamento dei soci, incassi e pagamenti, distinta accreditata con un insoluto, distinta s.b.f. in bozza, mandato, estratto CSV da riconciliare con una regola, primo sollecito.
- Tabelle
payments,payment_lines,remittances,remittance_lines,sdd_mandates,bank_statements,bank_statement_lines,bank_match_rules,dunning_levels,dunning_letters; nuove colonne digl_open_itemsebank_accounts.creditor_id(migrazioneM20261113_003). - Conti Perdite su cambi, Utili su cambi e Interessi di mora attivi nel piano dei conti PMI standard (240 conti).
- ADR 0038; pagina wiki Scadenzario completa con le schermate.
Changed
- La rettifica della registrazione di un documento mantiene le partite già incassate o pagate.
- Il menu Fatturazione elettronica mostra M9 come milestone.
Fixed
- Le strisce di riepilogo non si schiacciano più nelle pagine più alte della finestra.
[0.7.0] - 2026-11-13
M7 - Contabilità generale e IVA. Ogni fattura, nota e autofattura si contabilizza da sola nella stessa transazione, con le righe IVA nel suo registro, le partite aperte e la ritenuta; la prima nota in partita doppia con registrazioni provvisorie, definitive e storni; registri IVA, liquidazione periodica con F24 e LIPE, ritenute, bollo virtuale, partitari, mastrini e bilancio di verifica.
Added
- Piano dei conti a tre livelli (#62, ADR 0036): mastro, conto e sottoconto (
MM.CC.SSS), natura, tipo, voce CEE, partitario, rilevanza IVA; modello italiano PMI standard di 237 conti nel pacchetto fiscale (ItalianLedgerTemplate), albero con ricerca, scheda e mastrino con saldo progressivo e stampa. - Causali contabili con righe proposte, registro IVA, apertura delle partite e causale di storno (#62):
FV,NCV,FA,NCA,AFRC,CORR,INC,PAG,RIT,RITS,LIQ,F24,GIRO,SPB,STOe altre. - Prima nota (#63): registrazioni in partita doppia con cliente o fornitore sui conti con partitario, centro di costo e righe IVA; bozza, registrata (numero per anno) e definitiva (numero del libro giornale) con Rendi definitive; storno; Chiudi lo sbilancio; filtri e paginazione.
- Registrazioni ricorrenti (#63): copia di una registrazione modello mensile, trimestrale, semestrale o annuale fino
a una data, job di sistema
ledger.recurringogni giorno alle 5:00 e Genera ora. - Contabilizzazione automatica dei documenti (#64, ADR 0037): fatture, note di debito, parcelle, note di credito,
fatture e note fornitore, autofatture e integrazioni scrivono la registrazione alla conferma (
PostingEngine,LedgerPoster), la riscrivono con lo stesso numero alla modifica e la tolgono o la stornano all'annullamento; scissione dei pagamenti, IVA indetraibile sul costo, rivalsa cassa e bollo; Contabilizza documenti per i documenti confermati prima. - Registri IVA vendite, acquisti, autofatture e corrispettivi (#65) con riepilogo per aliquota, stampa di prova e definitiva con numerazione delle pagine.
- Liquidazione IVA mensile o trimestrale (#65): IVA a debito e a credito, pro rata, credito e debito riportati,
interessi trimestrali, minimo di versamento, acconto di dicembre (storico, previsionale, effettivo); conferma con la
registrazione
LIQ, il blocco dei periodi e il versamento F24; riapertura; file della comunicazione LIPE (IVP18) e dati F24. Regole e codici tributo nel pacchetto italiano (VatSettlementRulesIt). - Ritenute d'acconto operate e subite (#66): da versare quando la fattura del professionista è pagata, registrazioni
RITeRITS, codice 1040 al 16 del mese dopo; dati della certificazione unica in CSV. - Bollo virtuale per trimestre (#66) con soglia dei 5.000 euro, codici 2521-2524 e scadenze.
- Prospetto F24 per scadenza (#66) con export dei dati e registrazione del pagamento
F24sulla banca dell'azienda. - Partitari clienti e fornitori con estratto conto e partite aperte, bilancio di verifica per mastri, conti e sottoconti con centro di costo e risultato del periodo, libro giornale di prova e definitivo in PDF (#67).
- Menu Contabilità; testi in
Resources/it-IT/Ledger.json; permessiledger.account.*,ledger.entry.*,vat.register.read,vat.settlement.*. - Contabilità nei dati di esempio (#68): documenti contabilizzati, fattura del professionista pagata, noleggio mensile della stampante come ricorrente, liquidazioni dei mesi passati confermate e F24 scaduti pagati.
- Tabelle
gl_accounts,gl_journal_templates,gl_journal_template_lines,gl_entries,gl_entry_lines,gl_entry_vat,gl_open_items,gl_recurring_entries,vat_registers,vat_register_prints,vat_settlements,vat_settlement_lines,tax_payments,withholdings(migrazioneM20261113_002). - ADR 0036 e 0037; pagine wiki Contabilità, IVA e Fiscalità italiana complete con le schermate.
Changed
- Bollo virtuale passa dal menu Fatturazione elettronica al menu Contabilità.
- Il seed di base e Aggiorna da tabelle base aggiungono piano dei conti, causali e registri IVA alle aziende esistenti.
[0.6.0] - 2026-11-12
M6 — Acquisti e Magazzino. Il ciclo passivo dall'ordine al fornitore alla fattura protocollata, le fatture elettroniche ricevute importate in bozza, le autofatture con la loro scadenza e un magazzino che si aggiorna da solo con i documenti: giacenze per deposito, costo medio, inventario, riordino e valorizzazione.
Added
- Movimenti di magazzino dai documenti (#59, ADR 0035): alla conferma DDT, fatture immediate e accompagnatorie, note,
DDT e fatture fornitore, note di credito fornitore e movimenti
MMscrivono i loro movimenti nella stessa transazione (inventory_entries,inventory_entry_lines); l'annullamento li toglie. La causale del tipo documento decide carico, scarico o trasferimento; la fattura di un DDT non muove di nuovo la merce, la nota di credito la muove all'inverso. Tabellaitem_balancescon giacenza per deposito, impegnato (ordini clienti) e ordinato (ordini fornitore). - Costo medio ponderato per articolo ricalcolato dalla storia dei movimenti a ogni modifica, anche per documenti con data passata; ultimo costo e date di ultimo carico e scarico; il prezzo della fattura fornitore corregge il costo dei carichi che fattura.
- Documenti del ciclo passivo nelle maschere dei documenti (#55, #56, #58): ordini fornitori, ricevimenti merce (DDT fornitore con il numero e la data del fornitore), fatture e note di credito fornitore con protocollo IVA alla conferma e rifiuto del doppio numero del fornitore nello stesso anno, autofatture e movimenti di magazzino con causale e depositi. Menu Acquisti e Magazzino.
- Controllo dei prezzi: sulla fattura fornitore un avviso elenca le righe con un prezzo diverso dall'ordine o dal ricevimento e la differenza totale.
- Autofatture e integrazioni: il pacchetto italiano (
SelfInvoiceRulesIt) riconosce dalla fattura del fornitore l'integrazione dovuta (TD16, TD17, TD18, TD19, TD28) e la scadenza; la fattura lo mostra con Crea autofattura, che prepara la bozza con l'aliquota ordinaria; Acquisti → Autofatture elenca le integrazioni da emettere. TipiAF20-AF29nelle tabelle di base. - Lettura delle fatture elettroniche ricevute (#57):
FatturaPaReader(FPR12, FPA12, FSM10, lotti, allegati) e lettore CMS/CAdES dei file.p7mcon verifica dell'impronta e della firma, scritti in casa. - Import delle fatture passive (#57): Acquisti → Importa fatture legge XML, P7M e ZIP, trova o crea il fornitore,
segnala doppioni, tipi non d'acquisto, totali diversi e firme non verificate, e registra in bozza fatture (TD01,
TD02, TD03, TD05, TD06, TD24-TD27) e note di credito (TD04, TD08) con articoli abbinati per codice del fornitore,
EAN e codice, codice IVA per aliquota e natura, sconti di riga e file allegato. Le regole TD stanno nel pacchetto
fiscale (
IncomingInvoiceRulesIt). - Giacenze e disponibilità (#60): indicatori, filtri per deposito, categoria e stato (Disponibile, Da riordinare, Sottoscorta, Esaurito), movimenti di un articolo con saldo progressivo.
- Inventario fisico (#60): apertura per deposito, data e categoria con la giacenza contabile congelata, conteggi
scritti o importati dal file del lettore, rettifiche
INVPeINVNalla data del conteggio; tabellestock_takesestock_take_lines. - Proposta di riordino (#60): articoli sotto il punto di riordino o la scorta minima, quantità dal lotto o dalla soglia con il minimo d'ordine del fornitore, fornitore preferito con prezzo e arrivo previsto, ordini fornitore in bozza uno per fornitore.
- Valorizzazione a data con costo medio, ultimo costo o costo standard e classi ABC; ricostruzione del magazzino da
interfaccia con avanzamento e come job di sistema
inventory.rebuildogni domenica alle 2:15. - Widget Sottoscorta della dashboard con i dati veri.
- Dati di esempio di acquisti e magazzino (#61): esistenze iniziali, ordini ricevuti per intero e in parte, fatture con una differenza di prezzo e una integrazione AF18 da emettere, un inventario in conteggio.
- ADR 0035; pagine wiki Acquisti e Magazzino complete con le schermate, guida all'uso aggiornata.
Changed
- Import Giacenze iniziali: non è più solo verifica, scrive e conferma un movimento
APEper deposito. - I documenti confermati senza numero interno (DDT fornitore) si presentano come Senza numero invece di Bozza.
- Tipi documento: fattura immediata, fattura e nota di credito fornitore ricevono la causale di magazzino (
SCA,CAR,RESF); la migrazione la assegna anche nelle aziende esistenti dove manca. I tipiAF20-AF29mancanti si aggiungono con Aggiorna da tabelle base oscripts/seed.sh --base.
[0.5.0] - 2026-11-12
M5 — Motore documenti e Vendite. Un solo motore per tutti i documenti, con numerazione, totali, scadenze e collegamenti riga per riga, e le maschere del ciclo attivo: dal preventivo alla fattura stampata e inviata per e-mail, con un anno di vendite nei dati di esempio e una guida all'uso nella wiki.
Added
-
Motore documenti (#47, ADR 0032): un solo motore per vendite, acquisti e magazzino. Ogni tipo documento ha un genere (17: preventivo, ordine cliente, DDT, fatture immediate, accompagnatorie, differite e di acconto, note di credito e di debito, parcella, pro forma, autofattura, ordine fornitore, DDT fornitore, fattura e nota di credito fornitore, movimento di magazzino) che ne decide famiglia, ciclo di vita, effetti, righe ammesse, documenti evadibili e permessi. Tabelle
sale_quotations,sale_orders,sale_documents,purchase_orders,purchase_documents,inventory_documentscon le righe edocument_links. -
Stati e azioni ammesse per stato (
DocumentStateMachine): ciclo documento (bozza, confermato, evaso in parte, evaso, chiuso, annullato), fattura (bozza, emessa, XML generato, inviata, consegnata, scartata, non consegnata, annullata) e semplice; fattura emessa immutabile, annullamento con motivo solo prima dell'invio allo SDI. -
Numerazione alla conferma dentro la transazione e sotto il lock del numeratore (advisory lock su PostgreSQL, lock di scrittura su SQLite): nessun numero doppio, un rollback restituisce il numero, controllo della data fuori sequenza sui numeratori senza buchi, numeratore dell'anno nuovo creato da solo, elenco dei numeri mancanti.
-
Evasione riga per riga: copia e trasformazione dei documenti con le quantità residue, collegamenti registrati alla conferma e tolti all'annullamento, stato evaso/evaso in parte calcolato dalle righe, chiusura e riapertura del residuo. Servizio generico
DocumentService<THeader, TLine>per famiglia eDocumentCopyService. -
Totali dei documenti (#48, ADR 0033): importo di riga con sconti a cascata, spese e righe di sconto, sconto di piede sulle merci, prezzi IVA compresa scorporati per aliquota, castelletto IVA per codice con imposta sul totale del gruppo, esigibilità (immediata, differita, split payment), bollo sopra 77,47 euro di operazioni senza IVA (addebitato al cliente o no), cassa previdenza con la sua IVA, ritenuta d'acconto (anche sul 50% o 20% per gli agenti), ENASARCO, netto a pagare. Scadenze dalle condizioni di pagamento con fine mese, giorno fisso, mesi esclusi del cliente, IVA sulla prima rata e arrotondamento sull'ultima. Tabelle
document_tax_summariesedocument_installments, ricalcolate a ogni salvataggio. -
Copia di più documenti della stessa controparte in uno solo (
MergeAsync), con una riga di riferimento per ognuno: la base della fatturazione differita. Le note di credito e di debito ricordano la fattura che correggono. -
Maschere delle vendite (#49, #50): radar di preventivi, ordini, DDT, fatture e note con ricerca, filtri per tipo, stato e anno; un'unica maschera documento con intestazione, righe (articolo con F4, sconti a cascata, righe descrittive, di spesa e di sconto), Testata, Trasporto per DDT e fatture accompagnatorie, Totali, Scadenze, Note, Allegati, Collegamenti e Storico; azioni Conferma, Emetti, Duplica, Chiudi, Riapri, Annulla con motivo, Segna come rifiutato per i preventivi e Crea … con la scelta delle righe e delle quantità residue.
-
Fatturazione differita guidata (#51): DDT confermati e non fatturati del periodo, per tutti i clienti o uno, una fattura differita TD24 per cliente o per DDT, in bozza o già emessa, con i riferimenti ai DDT nelle righe.
-
Stampa dei documenti (#52, ADR 0034): anteprima di stampa A4 e PDF disegnati dallo stesso modello (dati dell'azienda e logo, controparte, campi, righe, riepilogo IVA, scadenze, totali, trasporto con le firme, diciture e filigrane), generatore Stampa del documento in PDF con versioni negli allegati, documento segnato come stampato.
-
Invio per e-mail (#52, ADR 0034): destinatari, oggetto e testo proposti dal modello con i campi
{{Numero}},{{Cliente}}…, PDF allegato e salvato come nuova versione, coda in background con tre tentativi, client SMTP scritto in casa (STARTTLS, TLS, AUTH PLAIN e LOGIN) configurato daKHAEMHAT_SMTP_*, esito nel log E-mail/PEC. -
Log, sezione Documenti (#53): conferme ed emissioni con il numero, chiusure, riaperture, annullamenti ed eliminazioni delle bozze.
-
Dati di esempio (#53): profilo dell'azienda demo e un anno di vendite costruite con il motore (6 preventivi, 4 ordini, 5 DDT, 8 fatture e pro forma, 1 nota di credito) in tutti gli stati, idempotenti.
-
Wiki: pagina Guida all'uso con il percorso completo e le schermate; Vendite riscritta con le schermate reali; schermate dell'accesso in Primi passi.
Changed
README.mdè ora la guida di installazione per chi sviluppa (prerequisiti, avvio, test, migrazioni, immagine).- L'emissione di una fattura o di una nota richiede il codice IVA su ogni riga (non descrittiva).
- Tipi documento: nuovo campo obbligatorio Genere (i tipi di base lo ricevono dalla migrazione); Numeratori: nuovo campo Data dell'ultimo numero.
- Clienti, condizioni di vendita: mesi esclusi (due mesi senza scadenze e il giorno del mese dopo in cui slittano).
Fixed
scripts/run-dev.shsotto Git Bash su Windows scriveva i dati in una cartellabsul disco invece che in.data/dev.
[0.4.0] - 2026-11-12
M4 — Tabelle, anagrafiche, articoli. Il pacchetto fiscale italiano, il profilo e le tabelle dell'azienda con i dati di base (province, comuni e CAP compresi), clienti, fornitori e contatti, articoli e listini, i codici automatici, l'import/export guidato e i dati di esempio: le prime maschere gestionali vere.
Added
- Pacchetto fiscale (ADR 0025):
IFiscalPackcon codici IVA, motore delle imposte e calendario fiscale, più funzioni facoltative per paese;FiscalPackCatalogsceglie il pacchetto dal paese dell'azienda. Il pacchetto italiano (IT 2026.2) porta nature IVA N1-N7, codici IVA di base, code list FatturaPA (specifiche 1.9.1: TD, MP, TP, RF, ritenute, casse previdenziali), castelletto IVA con arrotondamento sul totale per aliquota, regola del bollo, scadenze IVA mensili e trimestrali con slittamenti di agosto e dei festivi, ritenute, regole di base dei cespiti e codici tributo F24. - Controlli degli identificativi: IBAN (mod 97 e lunghezza per paese), codici a barre EAN/GTIN, e-mail; partita IVA
italiana, codice fiscale con calcolo, lettura dei dati e omocodia, codice destinatario SDI per azienda, PA, privato
ed estero;
ViesClientper la verifica delle partite IVA comunitarie (esito valida, non valida o servizio non disponibile). - Tabelle azienda (ADR 0026): 26 tabelle codificate (codici IVA, modalità e condizioni di pagamento con le rate,
banche, valute, tipi documento, numeratori, listini, sconti, agenti, depositi, causali di magazzino, unità di misura,
vettori, porto, trasporto, causali di trasporto, aspetto dei beni, rese, nazioni, province, comuni, categorie,
centri di costo, commesse) con un'unica maschera a
/tabelle/<tabella>: elenco con filtro attive/disattivate, dettaglio con errori e avvisi, disattivazione al posto dell'eliminazione per le righe usate, export e import CSV tutto o niente, storico e cache condivisa fra istanze. Indice delle tabelle a/tabellee voci nel menu. - Profilo azienda a schede (dati societari, fiscale e SDI, banche, stampa, esercizi, trasmittente e intermediario) con i controlli del pacchetto fiscale; esercizi e mesi con blocco e sblocco; cambi BCE giornalieri (attività di sistema) e cambi manuali.
- Dati di base aggiunti alla creazione dell'azienda e a ogni avvio, solo per i codici mancanti: paesi, valute, unità
di misura, codici IVA, pagamenti, tipi documento, numeratori, causali, trasporti, deposito, listino ed esercizio in
corso. Versione salvata nelle impostazioni dell'azienda (
IT 2026.3). - Province e comuni dall'elenco ISTAT dei codici dei comuni al 26/02/2026 (ADR 0028, CC BY 4.0): 110 province e
7.894 comuni con codice catastale, provincia, regione e codice ISTAT, nei dati di base del pacchetto italiano
(
IT 2026.3), con i CAP di GeoNames (CC BY 4.0) per 7.750 comuni; i mancanti si completano nella tabella Comuni.tools/Khaemhat.PlacesToolrigenera i due elenchi dai file scaricati. scripts/seed.sh --base [--company CODICE], incluso nell'immagine in/app/scripts/.- Codici automatici (ADR 0027): maschere per clienti, fornitori, lead, articoli, cespiti, opportunità, ticket,
contratti e interventi con
{seq:0000},{anno}e{categoria}, anteprima del prossimo codice, codice manuale ammesso o no, progressivi incode_sequencesassegnati nella transazione del salvataggio (nessun doppione, nessun numero perso se il salvataggio fallisce, codici già presenti saltati). - Compilazione automatica: comune, provincia e regione dal CAP e CAP dal comune, codice fiscale, verifica VIES, ABI,
CAB, banca e BIC dall'IBAN, data di consegna sul calendario lavorativo; ogni opzione si spegne nelle preferenze, e
il job dei cambi BCE salta le aziende che l'hanno spento. Pagina Preferenze azienda (
/tabelle/preferenze). - Anagrafiche (ADR 0029): clienti, fornitori, prospect e lead in un solo archivio, con tre radar
(
/anagrafiche/clienti,/fornitori,/contatti) con ricerca, filtri rapidi, disattivazione e riattivazione di più righe, e la scheda a otto schede: dati principali, indirizzi, contatti, condizioni di vendita e di acquisto, fiscale e SDI (fatturazione elettronica, regime IVA, ritenute e casse, dichiarazione d'intento), banche, note e allegati, storico. Controlli del pacchetto fiscale su partita IVA, codice fiscale, codice destinatario e paese, con avvisi che non bloccano (P.IVA doppia, privato senza codice fiscale); codice destinatario proposto per privati ed esteri; verifica VIES al salvataggio e su richiesta; calcolo del codice fiscale; CAP e comune compilati a vicenda. Converti in cliente per prospect e lead (nuovo codice, il vecchio resta come codice precedente) e per i fornitori (diventano anche clienti con lo stesso codice). Un'anagrafica usata da altri dati si disattiva invece di cancellarsi. - Dati di esempio delle anagrafiche con
KHAEMHAT_SEED_DEMO=true: 3 agenti, 12 clienti di ogni tipo soggetto, 5 fornitori, 2 prospect e 2 lead, con numeri inventati ma formalmente validi. - Articoli (ADR 0030): radar
/anagrafiche/articolicon ricerca anche per codice a barre, filtri per tipo, categoria, magazzino e stato, disattivazione e riattivazione; scheda con dati principali, UM alternative, codici alternativi, listini e prezzi netti dei clienti, fornitori con il fornitore abituale, sostitutivi, note e allegati, storico. Codice dalla maschera per categoria, verifica EAN con duplicati bloccati o segnalati secondo le preferenze, NC8, solo le merci a magazzino; costi visibili solo conitems.cost.reade conservati per chi non li vede; un articolo usato si disattiva invece di cancellarsi. - Listini (ADR 0030): prezzi con data di validità e storico, listino base, listini derivati con ricarico e
arrotondamento, griglia
/anagrafiche/listiniarticoli x listini con modifica in cella, prezzi netti di un cliente, margine e aggiornamento massivo con anteprima; ricerca del prezzo per i documenti (netto, listino del documento o del cliente, base, articolo) con la fonte e gli sconti del cliente a cascata. - Scheda Articoli e codici delle anagrafiche: i codici con cui un cliente o un fornitore chiama i tuoi articoli, trovati dalla ricerca nei suoi documenti.
- 120 articoli di esempio con listini Pubblico e Rivenditori, prezzi dell'anno precedente, fornitori, UM e
codici alternativi, sostitutivi e prezzi netti di un cliente;
scripts/seed.sh --demo [--scale N]carica i dati di esempio da riga di comando e moltiplica il catalogo per le prove di prestazione. - Import/export guidato (ADR 0031) in Amministrazione → Import / export dati: CSV (separatore e codifica dedotti),
XLSX (lettore interno, primo foglio) e JSON per clienti, fornitori, articoli e prezzi di listino e netti cliente;
mappatura automatica delle colonne con alias, validazione riga per riga con le regole della scheda, esiti nuovo,
aggiorna, avviso, errore, opzioni per codici esistenti o mancanti, VIES e comune da CAP, report errori CSV,
esito nel log. Export con le stesse colonne dell'import e modelli vuoti. Giacenze iniziali e piano dei conti (tracciato
codice;descrizione;livello;padre;natura;tipo;voce_cee;riclassifica;flagekhaemhat-coa.json) si verificano già, la scrittura arriva con M6 e M7.
Changed
- Tabella Listini: nuovi campi Listino base (uno solo) e Derivato da; la migrazione marca come base il listino
BASEesistente. - Il componente dei passi verticali mette il dettaglio di ogni passo su una riga propria.
Known issues
- L'azienda demo creata da
KHAEMHAT_SEED_DEMOha il profilo vuoto (indirizzo, partita IVA): va compilato prima dei documenti (M5). - Mancano le banche ABI/CAB nei dati di base: non c'è ancora una fonte con licenza compatibile (#45).
[0.3.0] - 2026-11-11
M3 — Framework UI. La shell dell'applicazione, la libreria di componenti Kh* con griglie, radar e pagine record, la
dashboard a widget, le preferenze dell'utente, ricerca, aiuto e notifiche, allegati e anteprima di stampa, tutto
provato su un documento di sviluppo in attesa delle maschere vere (da M4).
Added
- Libreria di componenti
Kh*(ADR 0024): campi con numeri e date all'italiana (T,F,I,+n, cifre senza separatori) e calcolo=10*3, messaggi accanto al campo e riepilogo che porta al campo, pannelli, tessere, badge, chip, importi, schede conAlt+1…Alt+9, passi, finestre di dialogo, pannelli laterali e messaggi a comparsa. KhIconToolbarsu una riga con il menu…,KhDocHeada tre blocchi e le basiRecordPage,DocumentPage,MasterDataPagecon comandi standard, conferme e scorciatoieCtrl+S,Ctrl+N,Ctrl+P,Ctrl+Canc,F9.- Liste con un solo modello di richiesta (
ListQuery,ListFields): la stessa descrizione dei campi diventa SQL o filtra righe in memoria.KhGridvirtualizzata (100.000 righe) con ordinamento, selezione, tastiera, modifica in riga, totali, menu di riga, colonne salvate ed esportazione CSV/XLSX;KhRadarcon ricerca, filtri rapidi, costruttore di filtri e filtri salvati; finestra radar per la ricercaF4;KhLinesGridper le righe dei documenti. - Il mio profilo: dati personali, cambio password che chiude le altre sessioni, attivazione e disattivazione della verifica in due passaggi con codici di recupero.
- Catalogo dei componenti e documento di prova per gli sviluppatori (
/sviluppo/componenti,/sviluppo/documento, solo in sviluppo). - Primi screenshot reali nella wiki (
docs/wiki/img/): finestra, menu compresso, ricerca, notifiche, aiuto, dashboard, profilo, tema scuro, documento, allegati, storico, anteprima di stampa, telefono. - Shell (mockup 004, 007, 013): barra superiore con marchio e versione, cambio azienda per gli account di istanza,
ricerca, recenti, notifiche, tema rapido, aiuto e menu utente; menu laterale per sezioni con voci filtrate da
licenza e permessi, compresso a sole icone con sottomenu a comparsa (
Ctrl+B, stato ricordato per utente, compresso sotto i 1100 px); barra di stato con azienda, esercizio, utente, latenza, cache e versione. - Schede tenute in vita: ogni pagina aperta resta com'era passando da una scheda all'altra, pallino delle modifiche, conferma alla chiusura, massimo 12 schede (si chiude la meno usata senza modifiche) (ADR 0020).
- Scorciatoie da tastiera in un'unica tabella, con le varianti
Alt+W,Alt+PagGiù/Alt+PagSu,Alt+Nper le combinazioni che i browser tengono per sé; ricerca rapidaCtrl+Kdi pagine e comandi;F1apre la pagina wiki della maschera. - Testi dell'interfaccia in
Resources/it-IT/*.jsonletti daITexts, formati italiani per importi e date; test che vietano i testi letterali nei componenti e controllano che ogni chiave esista. - Il mio profilo: aspetto (tema automatico, chiaro, scuro, alto contrasto; otto accenti; densità; dimensione del testo; menu; numeri tabellari, animazioni ridotte, suggerimenti, evidenza della riga) con anteprima dal vivo, pagina iniziale, sessioni attive con chiusura, elenco delle scorciatoie.
- Preferenze salvate per utente in
sys_user_settings(account di istanza) euser_settings(utenti aziendali); il tema è già nella pagina inviata dal server. - Aiuto in app (mockup 011):
F1e?aprono in una scheda la pagina wiki della maschera dalla copia della wiki contenuta nell'immagine (/aiuto, funziona senza Internet), con indice, Apri nel wiki e Segnala un problema; Markdown convertito in casa; nuova variabile facoltativaKHAEMHAT_HELP_URLper la wiki online (ADR 0023). - Pannello notifiche (mockup 010): filtri Tutte e Non lette, segna come letta, Segna tutte come lette,
conteggio aggiornato ogni minuto; le notifiche per tutti si segnano lette per ciascun utente (tabelle
sys_notification_readsenotification_reads). - Ricerca globale a fornitori (
GlobalSearchService,ISearchProvider): oltre a pagine e comandi trova le pagine e le sezioni dell'aiuto; prefissi#documenti e@persone pronti per i moduli successivi. - Allegati nell'interfaccia (mockup 024):
KhAttachmentListcon caricamento, anteprima, download, blocco, cestino con ripristino, versioni precedenti, Scarica tutto (ZIP) e Genera file / Rigenera; anteprima di PDF e immagini nel browser, di XML e testo come testo, di CSV e XLSX come griglia (lettore XLSX scritto in casa). - Anteprima di stampa (mockup 025):
KhPrintPreviewcon foglio A4 in HTML e CSS, Stampa del solo foglio, PDF da aprire o scaricare e Salva come allegato; prova sul documento di sviluppo conCtrl+P. - Storico di un record:
AuditTrailServicelegge il registro delle modifiche eKhAuditListmostra chi ha cambiato cosa, con i valori prima e dopo. - Indirizzi
/files/{id},/files/zipe/files/generateper scaricare gli allegati, tutti gli allegati di un record e un file generato al volo; solo PDF e immagini si aprono nel browser, con una politica di sicurezza propria che permette l'anteprima dentro Khaemhat. - Con la dashboard spenta, Home con licenza, moduli, azienda e aree disponibili; le aree delle prossime versioni aprono una pagina che dice con quale milestone arrivano.
- Dashboard a widget (mockup 004-006, ADR 0022): Da fare oggi, Fatto oggi, Scadenze 30 giorni, Promemoria personali, Scorciatoie e Stato del sistema con dati veri; i widget dei moduli futuri si possono già accendere e dicono da quale versione arrivano i dati. Pannello Personalizza con pagina iniziale, interruttore della dashboard, widget da accendere, ordinare e dimensionare, trascinamento sulla griglia e pulsanti equivalenti da tastiera, Ripristina e layout predefinito per ruolo. Le liste raccolgono le righe da sorgenti che ogni modulo registra.
- Impostazioni dell'azienda nella tabella
company_settings, scritte con il permessocompany.settings.write. - Token, temi e classi dei mockup in
css/tokens.cssecss/components.css, sprite di icone proprie, stampa sempre in chiaro.
Changed
Escchiude anche un pannello laterale aperto quando il focus non è in un campo.- Su telefono la barra superiore mostra solo le icone e la barra di stato solo connessione, cache e versione.
Fixed
- L'etichetta Totale documento dell'intestazione era tagliata: prendeva lo stile della timeline (
.tl). - Le schede dei temi e dei colori nel profilo andavano in colonna: la classe
.kh-choicesdel radar le ridefiniva; il gruppo di scelte del radar ora si chiama.kh-radio-set. - Pagine di accesso, errori e riconnessione con i testi localizzati e i colori del tema.
[0.2.0] - 2026-11-11
M2 — Sistema e sicurezza. L'istanza si avvia da sola, crea super utente e prima azienda, e si entra con password e verifica in due passaggi.
Added
- Avvio guidato dalle variabili
KHAEMHAT_*(anche_FILE): tutte le variabili sbagliate elencate insieme e uscita con codice 2; migrazioni del sistema e delle aziende all'avvio, super utente e prima azienda al primo avvio, pagina "Avvio in corso" e/health/readya 503 finché non è pronto (ADR 0019). - Account di istanza (super utente, amministratori) e utenti aziendali, password PBKDF2-SHA256 con storico, blocco dopo 5 errori, limite di 10 accessi al minuto per indirizzo IP.
- Pagine di accesso (mockup 001-003): scelta dell'azienda, cambio password obbligatorio, attivazione e verifica in
due passaggi (TOTP, RFC 6238) con 10 codici di recupero; uscita con
POST /logout. - Sessioni nel database con token salvato come hash, rigenerato a ogni passo, revocabili, riverificate dal circuito
Blazor ogni minuto; audit di sicurezza in
sys_security_auditcon catena di hash. - Ruoli predefiniti, permessi
modulo.area.azionecon override per utente, attributi[RequirePermission],[RequireLevel],[RequireModule]. - Licenze: trial di 60 giorni, file
.khlfirmati ECDSA P-256, codici di attivazione dei moduli, modalità test con i codici fittizi, limite di aziende e di utenti contemporanei; strumentotools/Khaemhat.LicenseTool. - Chiavi DataProtection nel database di sistema, cifrate con la chiave di istanza.
- Cache in memoria o su Redis (client RESP scritto in casa,
KHAEMHAT_REDIS), con ritorno alla memoria se Redis non risponde. - Log su database (
sys_log) per sezioni, con identificativo di traccia (X-Trace-Id), utente e azienda; query lente nella sezione Prestazioni; esito delle migrazioni nella sezione Migrazioni. - Attività programmate: cron a 5 campi con fuso orario, lock, timeout, tentativi, storico; job di sistema per pulizia sessioni, controllo licenza e retention del log.
- Storico dei record (
audit_logaziendale) con i soli campi cambiati. - Aziende: creazione e collegamento, stati attiva / manutenzione / sola lettura / disattivata, contesto azienda per
pagine e API (
X-Company), risposta 503 per le aziende in manutenzione. - Header di sicurezza su tutte le risposte (CSP senza script inline,
X-Frame-Options,nosniff,Referrer-Policy,Permissions-Policy). - Tabelle di sistema e aziendali di M2, documentate in
docs/DATA-MODEL.md(rigenerato).
Changed
- La home richiede l'accesso: senza sessione porta a
/login. - I database SQLite in memoria restano disponibili per tutta la vita del processo.
[0.1.0] - 2026-11-11
M1 — Strato dati. Nessuna funzione visibile nell'interfaccia: è il motore su cui si appoggiano tutte le milestone successive.
Added
- Micro-ORM interno in
Khaemhat.Data(ADR 0004, ADR 0018): mappe espliciteEntityMap<T>, query tipizzateQuery.For<T>().Where(...)con un sottoinsieme sicuro di espressioni,SqlFragmentcon valori sempre parametrizzati,IUnitOfWorkcon transazioni,IRepository<T,TKey>con colonne di audit e concorrenza ottimistica surow_version(ConcurrencyException), tentativi automatici sugli errori transitori. - Provider SQLite (tabelle
STRICT, WAL, decimali esatti come interi scalati x10^6, LIKE senza distinzione di maiuscole anche per le lettere accentate, scritture serializzate) e PostgreSQL 16+ (numeric(19,6),timestamptz,jsonb,ILIKE, lock di transazione, creazione ed eliminazione dei database aziendali, informazioni sul server). - Configurazione dei database da URL
postgres://esqlite://(DatabaseUrl), con la password mai mostrata nei messaggi. - Migrazioni in C#: cataloghi di sistema e aziendale,
schema_versioncon checksum in ogni database, una migrazione per transazione sotto lock, rifiuto delle versioni sconosciute; prime tabelle di sistemasys_companiesesys_settings. - Registro delle aziende (
CompanyRegistry) con la posizione del database cifrata e risoluzioneDatabaseScope.System/DatabaseScope.Company(codice)inIUnitOfWorkFactory. - Cifratura dei segreti a riposo con AES-256-GCM e chiave derivata da
KHAEMHAT_SECRET_KEY(SecretProtector, formatokhs1), con il mattone della rotazione delle chiavi. scripts/new-migration.shescripts/gen-datamodel.sh(contools/Khaemhat.DataModelTool): la sezione Schema attuale didocs/DATA-MODEL.mdè generata dalle migrazioni e un test ne verifica l'aggiornamento.- Test su SQLite e PostgreSQL (tipi, decimali, paginazione, upsert, LIKE, ordinamento temporale, CRUD, concorrenza, transazioni, input ostile, migrazioni, registro, cifratura) e misure di riferimento delle prestazioni.
[0.0.1] - 2026-11-11
Prima versione: M0 — Bootstrap. Nessuna funzione gestionale ancora; c'è lo scheletro su cui costruirle.
Added
- Soluzione
Khaemhat.slncon i progetti di SPEC §3 e i relativi progetti di test (MSTest); regole di build comuni, warning come errori, analyzer,.editorconfig, Central Package Management con l'allowlist dei pacchetti. - Test architetturali: riferimenti fra progetti ammessi da SPEC §3 e pacchetti ammessi da SPEC §1.2;
scripts/check-packages.shfa lo stesso controllo prima di ogni build. - Pagina "in costruzione" in italiano con marca, icone e versione; pagine di errore e 404.
- Endpoint di salute
/health/live,/health/readye/healthcon stato e versione (ADR 0012). - Variabili
KHAEMHAT_URLSeKHAEMHAT_LOG_LEVEL; log JSON su stdout fuori dallo sviluppo. - Immagine Docker
gitea.encke-hake.ts.net/balbosoft/khaemhat: multi-stage, utente non root conPUID/PGID(ADR 0013),pg_dump17,HEALTHCHECK, etichette OCI e Unraid,restore-system.shincluso (ADR 0017). deploy/docker-compose.yml(PostgreSQL 17, Redis facoltativo) edeploy/docker-compose.sqlite.yml(demo); versione dell'immagine scelta conKHAEMHAT_VERSION.- Gitea Actions:
ci.yml(build, test, immagine con smoke test, PostgreSQL 16/17 sui tag, controllo YAML),release.yml(immagine e release dal tag, ADR 0015),wiki.yml(pubblicazione della wiki). - Script
build.sh,test.sh,run-dev.sh,publish-image.sh,publish-wiki.she stub delle milestone successive. - Configurazioni di Visual Studio Code per debug, attività ed estensioni consigliate (
.vscode/). - ADR 0012-0017 sui punti aperti di M0 (salute, utente, varianti
_FILE, tag e pubblicazione, icona versionata, script di ripristino).
Changed
- I file di
deploy/puntano alla versione0.0.1e all'icona non versionata fino alla 1.0 (ADR 0016).
Preparazione - 2026-11-10
Documentazione e pianificazione, nessun codice e nessun tag.
Added
- Specifica di progetto in
docs/SPEC.mded emendamenti inCLAUDE.md(Gitea al posto di GitHub, solo Docker). - ADR 0001-0011 sulle decisioni di base.
- Mockup: 22 schermate in alta risoluzione, galleria, 88 miniature,
mockup.css, indice. - Icone in
assets/; file di deploy per Docker Compose e Unraid indeploy/. - Wiki completa in bozza (
docs/wiki/) e documentazione tecnica (docs/*.md). - Pianificazione su Gitea: etichette, milestone M0-M14, issue con checklist, progetti Khaemhat 1.0 — Sviluppo e Khaemhat 1.1+ — Fase 2.