Rewrite the Scadenzario wiki page from the real screens and services, add ADR 0038, the 0.8.0 changelog, STATUS, MODULES and the regenerated data model, and update the pages that still pointed to M8. The browser check found a few screen defects, fixed here: reminder channels are flags, so they show as "e-mail + PEC" and are edited with check boxes; icon buttons in grids stay on one row; the summary strip no longer collapses on long pages; the customers/suppliers switch uses the right style; the cash flow bars scale between the lowest and highest balance. The late payment rate of the second half of 2026 is 2.40 (MEF, GU 163 of 16 July 2026), now covered by tests, and the mapping test knows the ten treasury tables. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
5.7 KiB
Modello dati
Stato: bozza · Ultima revisione: 2026-11-11 · Versione software: 0.1.0 (strato dati, M1); le tabelle funzionali arrivano con le milestone successive Specifica: SPEC §5, §11, §13, §14
Come Khaemhat organizza i dati, in sintesi. L'elenco completo di tabelle e colonne è in docs/DATA-MODEL.md. La sua sezione Schema attuale è generata automaticamente dalle migrazioni del programma, quindi è sempre allineata a ciò che il programma crea davvero nei database; le altre sezioni descrivono le tabelle pianificate, che compaiono nello schema attuale man mano che le milestone le realizzano.
Due tipi di database
| Database | Nome | Contenuto |
|---|---|---|
| Sistema | khaemhat_system |
aziende collegate, super utente e amministratori, licenze, impostazioni, attività programmate, backup, log, registro di sicurezza |
| Azienda | khaemhat_<codice> (es. khaemhat_demo) |
profilo azienda, tabelle, anagrafiche, articoli, documenti, magazzino, contabilità, scadenzario, fatture elettroniche, CRM, utenti e preferenze, allegati, storico modifiche |
Le tabelle del database di sistema hanno il prefisso sys_. Nelle tabelle aziendali non c'è un campo "azienda":
ogni azienda ha il suo database, quindi i dati non possono mescolarsi. Gli allegati veri e propri (i file) stanno nel
volume /data/files/<azienda>; nel database c'è la loro scheda (nome, tipo, dimensione, impronta, versione).
Le aree principali del database aziendale
| Area | Esempi di tabelle | Pagina |
|---|---|---|
| Profilo e tabelle | company_profile, fiscal_years, tax_codes, payment_methods, warehouses, document_numerators |
Tabelle-azienda |
| Anagrafiche | parties (clienti, fornitori, prospect, lead), indirizzi, contatti, condizioni, dati fiscali |
Anagrafiche |
| Articoli e listini | items, item_prices, price_lists |
Articoli-e-listini |
| Documenti | sale_quotations, sale_orders, sale_documents, purchase_orders, purchase_documents, ciascuno con righe, castelletto IVA e rate; document_links per l'evasione |
Vendite, Acquisti |
| Magazzino | inventory_entries e righe, item_balances (giacenza, impegnato, ordinato per articolo e deposito) |
Magazzino |
| Contabilità e IVA | gl_accounts, gl_entries e righe, vat_registers, vat_settlements |
Contabilita, IVA |
| Scadenzario | gl_open_items (partite), payments e righe, remittances e righe, sdd_mandates, bank_statements e righe, bank_match_rules, dunning_levels, dunning_letters |
Scadenzario |
| CRM | crm_leads, crm_opportunities, crm_activities, crm_campaigns, crm_tickets |
CRM |
| Canali | sales_channels, channel_orders |
Canali-e-commerce |
| Utenti e sicurezza | users, roles, role_permissions, user_sessions, api_keys |
Utenti-e-permessi |
| Servizi trasversali | attachments, audit_log, notifications, user_settings |
Allegati-e-file |
Regole che valgono per tutti i dati
- Storico delle modifiche. Ogni tabella registra chi ha creato e modificato il record e quando; anagrafiche, documenti, registrazioni e impostazioni hanno anche lo Storico dettagliato con le differenze.
- Nessuna sovrascrittura silenziosa. Ogni record ha un numero di versione: se due persone modificano lo stesso record, la seconda viene avvisata invece di cancellare il lavoro della prima.
- Importi esatti. Importi e quantità sono numeri decimali con 6 cifre dopo la virgola, mai approssimati; anche su SQLite vengono conservati come interi per non perdere precisione.
- Date. Le date di documento sono date pure; gli orari sono salvati in UTC e mostrati nell'ora italiana.
- Dati riservati cifrati. Password di PEC, SMTP, cloud, intermediari e connessioni ai database sono cifrate con la chiave dell'istanza.
- Dati di esempio riconoscibili. I record creati dai dati dimostrativi sono marcati e si possono rimuovere in blocco (Dati-di-base-e-esempio).
- Niente cancellazioni che rompono la storia. Un cliente con documenti si disabilita, non si cancella; una fattura emessa non si modifica, si rettifica con una nota di credito.
Crescita del database
Le tabelle che crescono di più sono le righe contabili, le righe di magazzino, lo storico delle modifiche e il log. Su PostgreSQL sono predisposte per essere suddivise per anno quando superano i 50 milioni di righe; il log ha una durata di conservazione diversa per livello (errori un anno, avvisi sei mesi, informazioni tre mesi, debug una settimana).
Aggiornamenti dello schema
Quando una nuova versione cambia la struttura dei dati, Khaemhat applica da solo le migrazioni: il database di sistema all'avvio, le aziende all'avvio o dal pannello Amministrazione → Istanza e database, mettendo l'azienda in manutenzione per il tempo necessario. Ogni migrazione è applicata per intero o per niente, e più copie del programma avviate insieme non la applicano due volte. Non è possibile tornare a una versione precedente dello schema: se il database contiene una migrazione che il programma non conosce (per esempio dopo aver rimesso un'immagine più vecchia) Khaemhat si rifiuta di partire invece di rischiare i dati. Per questo prima di ogni aggiornamento conviene un backup (Aggiornamento, Backup-e-ripristino).
Pagine correlate
Architettura · Istanza-e-database · Import-Export · Glossario