Files
Khaemhat/docs/wiki/Modello-dati.md
T
Alby96andClaude Opus 5.5 f38b5894ce
CI / Build and test (SQLite) (pull_request) Successful in 3m51s
CI / PostgreSQL 16 integration (pull_request) Skipped
CI / PostgreSQL 17 integration (pull_request) Skipped
CI / YAML check (pull_request) Successful in 5s
CI / Docker image (pull_request) Successful in 1m22s
docs: close M8 with treasury wiki, screenshots and screen fixes (#69 #70 #71 #72 #73)
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>
2026-11-13 09:59:57 +01:00

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