M10 gives the ledger its year end. Fixed assets get categories with the ministerial coefficients, a civil and a fiscal plan, depreciation posted per category and undoable, disposals with gain or loss and the register print (ADR 0041). Intrastat lists are generated from confirmed invoices with the due periodicity and the SCAMBI.CEE file; declarations of intent get their own register and the N3.5 ceiling is checked when an invoice is confirmed (ADR 0042). Accruals, deferrals and exchange differences feed a nine-step guided closing that can repeat or undo its last step until the final prints, reopens the next year and locks the closed one; the CEE statements (ordinary, abbreviated, micro), the reclassified statements, the ratios and the accountant export read the year's balances (ADR 0043). The demo seed now opens the year with assets, stock, bank and capital, so the integration test closes the demo year from the checks to the lock on SQLite and PostgreSQL. Docs: wiki pages with screenshots, ADR 0041-0043, MODULES, STATUS, DATA-MODEL and the 0.10.0 changelog. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
32 KiB
Moduli applicativi
Stato: bozza · Revisione 2026-11-10 · Fonte: SPEC §3, §4, §7.2, §8, §9.5, §10.1.1, §11, §12, §15, §20, §21
Ogni modulo vive in src/Khaemhat.Application/Modules/<Nome>/ e implementa IModule (vedi
ARCHITECTURE.md §4). Questo file elenca, per ciascun modulo: codice di licenza, responsabilità,
entità, servizi, maschere e mockup, permessi, sezione di log, pagina wiki e milestone di consegna.
Convenzioni usate nelle schede:
- Permessi: formato
modulo.entità.azione(SPEC §7.2) con azioni standardread,write,delete,post/issue/finalize,reopen,export,print,override_*. I codici in grassetto sono citati letteralmente in SPEC; gli altri sono proposte coerenti con la convenzione, da confermare in sviluppo nel filePermissions.csdel modulo. - Mockup: numero della schermata in
docs/mockups/(PNG ad alta risoluzione se disponibile, altrimenti miniatura inthumbs/). - Sezione di log: valore di
LogSection(SPEC §9.5). Dove SPEC non prevede una sezione dedicata è indicata una proposta. - Milestone: da SPEC §20; tag in parentesi.
1. Codici di licenza (SPEC §8.1)
| Codice | Modulo | Contenuto | Moduli applicativi coinvolti | Codice di test (§8.3) |
|---|---|---|---|---|
CORE |
Base | anagrafiche, articoli e listini, preventivi/ordini/DDT/fatture, acquisti base, magazzino, tabelle, report base, amministrazione, allegati | Company, Parties, Items, Sales, Purchases, Inventory, Reports (base), Admin, UserSettings | KH-TEST-CORE-0000-0001 |
ACCT |
Contabilità | piano dei conti, causali, prima nota, partitari, registri IVA, liquidazioni, LIPE/F24 dati, ritenute e casse, bollo, chiusura esercizio, bilancio CEE | Ledger, Vat | KH-TEST-ACCT-0000-0002 |
ASSET |
Cespiti | registro beni ammortizzabili, ammortamenti, dismissioni | Assets | KH-TEST-ASSET-0000-0003 |
FIN |
Tesoreria | scadenzario, incassi/pagamenti, RiBa/SDD/SEPA, riconciliazione bancaria, solleciti, flusso di cassa | Finance | KH-TEST-FIN-0000-0004 |
EINV |
Fatturazione elettronica | XML attivo/passivo, canali SDI, notifiche, autofatture, dichiarazioni d'intento, bollo virtuale | EInvoicing | KH-TEST-EINV-0000-0005 |
INTRA |
Intrastat | elenchi cessioni/acquisti e file Agenzia Dogane | Vat (parte Intrastat) | KH-TEST-INTRA-0000-0006 |
CRM |
CRM | lead, pipeline/opportunità, attività e agenda, campagne, ticket | Crm | KH-TEST-CRM-0000-0007 |
SVC |
Servizi | contratti di assistenza, squadre, interventi, rapportini | Services | KH-TEST-SVC-0000-0008 |
CHAN |
Canali e-commerce | connettore generico, ordini web, sincronizzazione giacenze/prezzi | Channels | KH-TEST-CHAN-0000-0009 |
AUTO |
Automazioni | regole quando→se→allora, procedure pianificabili oltre quelle di sistema | Automation | KH-TEST-AUTO-0000-0010 |
API |
Integrazioni | API REST, MCP, webhook, chiavi API | Admin (chiavi), Web (Api/, Mcp/), tutti i moduli per i propri endpoint |
KH-TEST-API-0000-0011 |
MULTI |
Multi-azienda | aziende oltre la prima sulla stessa istanza | Admin (CompanyService) |
KH-TEST-MULTI-0000-0012 |
REPORT |
Report avanzati | margini, analisi, report pianificati, export per il commercialista | Reports | KH-TEST-REPORT-0000-0013 |
Codici di test aggiuntivi: tutti i moduli KH-TEST-ALL-0000-9999 (usato dai test automatici), 25 utenti
concorrenti KH-TEST-USERS-0025-0014, proroga trial 60 giorni KH-TEST-TRIAL-0060-0015. Valgono solo con
KHAEMHAT_LICENSE_MODE=test; in produzione sono rifiutati con license_test_only. Senza licenza l'istanza è in
Trial (CORE + ACCT, 3 utenti, 60 giorni, banner).
Senza modulo attivo: voci di menu nascoste, API/MCP del modulo non registrati, procedure non eseguibili, dati
conservati; ogni accesso residuo risponde module_not_licensed.
2. Riepilogo
| Modulo | Licenza | Sezione di log | Pagina wiki | Milestone |
|---|---|---|---|---|
| Company | CORE | Sistema (proposta) | Tabelle-azienda | M4 (esercizi e periodi: M7) |
| Parties | CORE | Documenti (proposta); VIES in Integrazioni | Anagrafiche | M4 |
| Items | CORE | Magazzino (proposta) | Articoli-e-listini | M4 |
| Sales | CORE | Documenti | Vendite | M5 |
| Purchases | CORE | Documenti | Acquisti | M6 |
| Inventory | CORE | Magazzino | Magazzino | M6 |
| Ledger | ACCT | Contabilità | Contabilita | M7, M10 |
| Vat | ACCT, INTRA | Contabilità | IVA, Intrastat | M7, M10 (Intrastat) |
| YearEnd | ACCT (chiusura, bilancio), INTRA (Intrastat), CORE (dichiarazioni d'intento) | Contabilità | Chiusura-e-bilancio, Dichiarazioni-d-intento | M10 |
| Assets | ASSET | Contabilità | Cespiti | M10 |
| Finance | FIN | Contabilità (proposta) | Scadenzario | M8 |
| EInvoicing | EINV | SDI/e-invoicing; E-mail/PEC | Fatturazione-elettronica | M9 |
| Crm | CRM | CRM | CRM | M11 |
| Services | SVC | CRM (proposta) | Servizi | M14 (fase 2) |
| Channels | CHAN | Integrazioni | Canali-e-commerce | M14 (fase 2) |
| Reports | CORE, REPORT | Documenti (proposta) | Report | con i moduli; pianificazione M12 |
| Admin | CORE, API, MULTI | Sistema, Autenticazione, Database, Migrazioni, Backup, Attività programmate, API/MCP | pagine di amministrazione (vedi §3.16) | M2, M12 |
| UserSettings | CORE | UI/circuiti | Preferenze-utente, Dashboard | M3 |
| Automation | AUTO (codici automatici: CORE) | Automazioni | Automazioni | M4 (codici), M12 (regole e procedure) |
3. Schede dei moduli
3.1 Company — Azienda e tabelle di base
| Voce | Contenuto |
|---|---|
| Licenza | CORE |
| Responsabilità | profilo azienda, esercizi e periodi, tabelle di base (paesi, comuni, valute, UM, codici IVA, pagamenti, banche, agenti, trasporti, numeratori, depositi, categorie, listini, tipi documento, centri di costo, commesse) |
| Entità | CompanyProfile, FiscalYear, FiscalPeriod, Country, Province, Municipality, Currency, ExchangeRate, UnitOfMeasure, TaxCode, PaymentMethod, PaymentTerm(+Line), BankAccount, Salesperson, Carrier, ShippingTerm, TransportMean, GoodsAppearance, DeliveryTerm, TransportReason, DocumentNumerator, InventoryReason, Warehouse, ItemCategory, PartyCategory, PriceList, DiscountPolicy, DocumentType, CostCenter, Job |
| Servizi | CompanySettingsService, PeriodLockService (condiviso con Ledger), DocumentNumberingService, seeder di base (BaseDataSeeder) |
| Maschere e mockup | profilo azienda (075, CompanyProfilePage), codici IVA (076, TaxCodesPage), esercizi e periodi (052, FiscalYearsPage), una maschera per tabella sul modello 012 + 076 (MasterDataPage<T>) |
| Permessi | company.users.manage; proposte: company.profile.write, company.tables.write, company.fiscal_year.write |
| Log | Sistema (proposta: SPEC §9.5 non ha una sezione "Tabelle") |
| Wiki | Tabelle-azienda |
| Milestone | M4 v0.4.0 (tabelle, Fiscal.Italy con codici IVA, nature, code list, comuni); esercizi/periodi e blocco con la contabilità in M7 |
3.2 Parties — Anagrafiche
| Voce | Contenuto |
|---|---|
| Licenza | CORE |
| Responsabilità | clienti, fornitori, prospect e lead come PartyKind; indirizzi, contatti, banche, condizioni di vendita e acquisto, dati fiscali e SDI, dichiarazioni d'intento, codici articolo del cliente/fornitore; validazioni P.IVA, CF, IBAN, VIES |
| Entità | Party, PartyAddress, PartyContact, PartyBankAccount, PartySalesTerms, PartyPurchaseTerms, PartyFiscal, PartyItemCode, IntentDeclaration |
| Servizi | servizio anagrafiche del modulo, AutoFillService (CAP, CF, VIES, BIC da IBAN), CodeSequenceService, Party360Service (con CRM), ImportWizardService |
| Maschere e mockup | radar clienti (012, 013), scheda cliente (014), fiscale/SDI/dichiarazione d'intento (015), fornitore (016); PartyPage, SupplierPage |
| Permessi | proposte: parties.party.read, parties.party.write, parties.party.delete, parties.party.export |
| Log | Documenti (proposta); chiamate VIES nella sezione Integrazioni |
| Wiki | Anagrafiche |
| Milestone | M4 v0.4.0 |
3.3 Items — Articoli e listini
| Voce | Contenuto |
|---|---|
| Licenza | CORE |
| Responsabilità | articoli (merce, servizio, spesa, testo, cespite), UM alternative, barcode, prezzi, fornitori, sostituti; listini con aggiornamento massivo, arrotondamenti, validità, listini derivati, prezzi netti per cliente |
| Entità | Item, ItemUom, ItemBarcode, ItemPrice, ItemSupplier, ItemSubstitute, PriceList |
| Servizi | servizio articoli e listini del modulo; regole PriceResolver, DiscountResolver, UomConverter (Core) |
| Maschere e mockup | scheda articolo con prezzi, riordino e giacenze (017, ItemPage), listini (018, PriceListPage), hotlink articolo F4 (023) |
| Permessi | items.cost.read; proposte: items.item.read, items.item.write, items.price_list.write |
| Log | Magazzino (proposta) |
| Wiki | Articoli-e-listini |
| Milestone | M4 v0.4.0 |
3.4 Sales — Vendite
| Voce | Contenuto |
|---|---|
| Licenza | CORE |
| Responsabilità | preventivi con revisioni e collegamento CRM, ordini clienti (impegnato, blocco fido/scaduto con override, CIG/CUP), DDT, fatture immediate/accompagnatorie/differite, pro-forma, acconti, NC/ND, parcelle, semplificate, TD26, TD27, corrispettivi manuali; report di vendita |
| Entità | SaleQuotation(+Line,+Revision), SaleOrder(+Line), SaleDocument(+Line,+TaxSummary,+Installment), DocumentLink |
| Servizi | DocumentService<,>, Sale*Service, DocumentFlowService, DocumentFlowWizard, DeferredInvoicingService, DocumentNumberingService, DocumentStateMachine, DocumentPostingService, DocumentPrintService, DocumentMailService, FileGenerationService |
| Maschere e mockup | fattura righe/testata (020, 021, 022), hotlink F4 (023), allegati e file (024), anteprima PDF (025), preventivo (026), ordine (027), DDT (028), nota di credito TD04 (029), fatturazione differita (030); SaleDocumentPage, QuotationPage, SaleOrderPage, DeliveryNotePage, CreditNotePage, DeferredInvoicingWizard |
| Permessi | sales.invoice.issue, attachments.delete; proposte: sales.quotation.write, sales.order.write, sales.order.override_credit, sales.delivery_note.write, sales.invoice.write, sales.invoice.print |
| Log | Documenti |
| Wiki | Vendite, Allegati-e-file |
| Milestone | M5 v0.5.0 (motore documenti + vendite); allegati e generazione file sul primo documento in M3 |
3.5 Purchases — Acquisti
| Voce | Contenuto |
|---|---|
| Licenza | CORE |
| Responsabilità | ordini fornitori (anche da proposta di riordino), DDT di carico con controllo quantità, fatture di acquisto con protocollo e conti/centri di costo per riga, ritenute, NC fornitore, import XML/P7M, autofatture e integrazioni TD16-TD29, fatture da forfettari |
| Entità | PurchaseOrder(+Line), PurchaseDocument(+Line,+TaxSummary,+Installment), DocumentLink |
| Servizi | Purchase*Service, PurchaseInvoiceImportService, SelfInvoiceService, DocumentFlowService, DocumentPostingService |
| Maschere e mockup | ordine fornitore (031), DDT di carico (032), fattura di acquisto (033), import XML/P7M (034), autofattura/integrazione (035); PurchaseOrderPage, GoodsReceiptPage, PurchaseDocumentPage, PurchaseInvoiceImportPage, SelfInvoicePage |
| Permessi | proposte: purchases.order.write, purchases.receipt.write, purchases.invoice.write, purchases.invoice.post, purchases.self_invoice.issue |
| Log | Documenti |
| Wiki | Acquisti |
| Milestone | M6 v0.6.0 |
3.6 Inventory — Magazzino
| Voce | Contenuto |
|---|---|
| Licenza | CORE |
| Responsabilità | movimenti e trasferimenti, giacenze e disponibilità per deposito, inventario fisico, costo medio ponderato (FIFO/LIFO predisposti), rimanenze finali, proposta di riordino, valorizzazione a data, ABC, ricostruzione |
| Entità | InventoryEntry(+Line), InventoryDocument(+Line), ItemBalance, StockTake(+Line), InventoryReason, Warehouse |
| Servizi | Inventory*Service, InventoryPoster, RebuildService; regola StockEffectMatrix |
| Maschere e mockup | giacenze (036, InventoryBalancesPage), movimento manuale (037, InventoryEntryPage), inventario fisico (038, StockTakePage), proposta di riordino (039, ReorderProposalPage) |
| Permessi | inventory.entry.post; proposte: inventory.entry.write, inventory.stock_take.write, inventory.balance.read |
| Log | Magazzino |
| Wiki | Magazzino |
| Milestone | M6 v0.6.0 |
3.7 Ledger — Contabilità generale
| Voce | Contenuto |
|---|---|
| Licenza | ACCT |
| Responsabilità | piano dei conti (precaricato e importabile CSV/XLSX/JSON), causali, prima nota con quadratura, contabilizzazione automatica, partitari e mastrini, registrazioni ricorrenti e in valuta, ritenute e casse, ratei/risconti, chiusura e apertura, libri definitivi, bilancio di verifica, CEE e riclassificati, export per il commercialista |
| Entità | GlAccount, JournalTemplate(+Line), GlEntry, GlEntryLine, GlEntryVat, WithholdingTax, SocialSecurityCharge, RecurringEntryTemplate; dalla M10 (cartella YearEnd) AccrualDeferral, ClosingRun, ClosingStep, ClosingPrint |
| Servizi | JournalService, PostingEngine, LedgerPoster, PeriodLockService, LedgerQueries, PartitarioService, WithholdingService, TrialBalanceService, RecurringEntriesService, ChartOfAccountsImportService; dalla M10 AccrualService (ratei, risconti, differenze di cambio), ClosingService (nove passi, stampe, blocco), FinancialStatementsService (CEE, riclassificati, indici, export); nel pacchetto paese ClosingRulesIt, CeeSchemaIt |
| Maschere e mockup | prima nota (040, 041), piano dei conti e mastrino (042), causali (043), partitario/estratto conto (044), ritenute e F24 (047), chiusura esercizio (050), bilancio CEE (051), esercizi e periodi (052) |
| Permessi | ledger.entry.finalize, ledger.entry.read, ledger.entry.write, ledger.account.write; dalla M10 ledger.year.close (ratei e risconti, chiusura, blocco) e reports.accountant.export |
| Log | Contabilità |
| Wiki | Contabilita, Chiusura-e-bilancio |
| Milestone | M7 v0.7.0 (piano dei conti, causali, prima nota, partitari, ritenute, bilancio di verifica); M10 v0.10.0 (ratei/risconti, chiusura/apertura, libri definitivi, bilancio CEE, export commercialista) |
3.8 Vat — IVA, adempimenti e Intrastat
| Voce | Contenuto |
|---|---|
| Licenza | ACCT; parte Intrastat INTRA |
| Responsabilità | registri IVA con protocollo e stampe definitive, liquidazione periodica (differita, per cassa, pro-rata, acconto, interessi, minimo), dati F24 e LIPE XML, bollo virtuale (dati per F24), dichiarazioni d'intento, elenchi Intrastat |
| Entità | VatRegister, VatSettlement(+Line), StampDutyEntry; dalla M10 IntentDeclaration, IntrastatList(+Line) |
| Servizi | VatRegisterService, VatSettlementService, StampDutyService, IntentDeclarationService, IntrastatService; nel pacchetto paese VatSettlementRules, VatAdvanceCalculator, LipeWriter, F24Exporter, IntrastatExporterIt |
| Maschere e mockup | registri IVA (045, VatRegistersPage), liquidazione IVA/F24/LIPE (046, VatSettlementPage), Intrastat (049, IntrastatPage) |
| Permessi | vat.settlement.confirm; proposte: vat.register.print, vat.register.finalize, vat.settlement.read; dalla M10 intrastat.list.read, intrastat.list.write, intrastat.list.export, sales.intent.read, sales.intent.write |
| Log | Contabilità |
| Wiki | IVA, Intrastat, Fiscalita-italiana |
| Milestone | M7 v0.7.0 (registri, liquidazione, F24, LIPE, bollo); M10 v0.10.0 (Intrastat, dichiarazioni d'intento) |
Nota: SPEC elenca bollo virtuale e dichiarazioni d'intento sia in ACCT sia in EINV (§8.1), e le loro maschere
(060, 061) sotto Fatturazione elettronica. Deciso in M10 (ADR 0042): le dichiarazioni d'intento sono nel modulo base
CORE perché riguardano la normale fatturazione, Intrastat in INTRA; entrambe le pagine stanno nel menu
Fatturazione elettronica come nei mockup, i servizi in Khaemhat.Application/YearEnd.
3.9 Assets — Cespiti
| Voce | Contenuto |
|---|---|
| Licenza | ASSET |
| Responsabilità | categorie con coefficienti ministeriali, registro beni ammortizzabili, piano di ammortamento civilistico e fiscale (primo anno 50%, limiti autovetture, beni < €516,46), dismissioni totali e parziali con plus/minusvalenza, registrazione annuale per categoria annullabile, stampa del registro |
| Entità | FixedAsset, FixedAssetCategory, FixedAssetMovement |
| Servizi | FixedAssetService; DepreciationCalculator (Core); nel pacchetto paese le regole dei cespiti e MinisterialCoefficients (ADR 0041) |
| Maschere e mockup | registro cespiti e piano di ammortamento (048, AssetsPage), ammortamenti (DepreciationPage), categorie (CategoriesPage) |
| Permessi | assets.asset.read, assets.asset.write, assets.depreciation.post |
| Log | Contabilità |
| Wiki | Cespiti |
| Milestone | M10 v0.10.0 |
3.10 Finance — Scadenzario e tesoreria
| Voce | Contenuto |
|---|---|
| Licenza | FIN |
| Responsabilità | partite aperte (le gl_open_items della contabilità) e aging, incassi e pagamenti con abbuoni, spese e differenze cambio, insoluti, distinte RiBa (CBI), SDD (pain.008.001.08), bonifici SEPA (pain.001.001.09), mandati, riconciliazione bancaria (CSV/CBI/CAMT.053), solleciti a livelli con interessi di mora, flusso di cassa 30-365 giorni, scadenze sulla Home |
| Entità | OpenItem (Ledger), Payment(+Line), Remittance(+Line), SddMandate, BankStatement(+Line), BankMatchRule, DunningLevel, DunningLetter |
| Servizi | ScheduleService, PaymentService, RemittanceService, MandateService, BankReconciliationService, DunningService (+ job finance.dunning), CashFlowService, TreasuryFeedSource, DemoTreasurySeeder; nel core AgingCalculator, PaymentAllocator, BankMatcher, SepaXmlWriter, CsvStatementReader, Camt053Reader; nel pacchetto italiano RibaCbiWriter, CbiStatementReader, LatePaymentRulesIt (ADR 0038) |
| Maschere e mockup | partite e aging (053, SchedulePage), registra incasso (054, PaymentDialog), incassi e pagamenti (PaymentsPage), distinte (055, RemittancesPage), mandati (MandatesPage), solleciti (056, DunningPage), riconciliazione (057, ReconciliationPage), flusso di cassa (CashFlowPage) |
| Permessi | finance.schedule.read, finance.schedule.write, finance.payment.read, finance.payment.write, finance.bank.reconcile |
| Log | Contabilità (proposta: SPEC §9.5 non ha una sezione "Tesoreria"); invio solleciti in E-mail/PEC |
| Wiki | Scadenzario |
| Milestone | M8 v0.8.0 (consegnata) |
3.11 EInvoicing — Fatturazione elettronica
| Voce | Contenuto |
|---|---|
| Licenza | EINV |
| Responsabilità | file FatturaPA (FPR12/FPA12/FSM10) con controlli offline e codici dello SDI, quattro canali (PEC, SdICoop, Intermediario A, Intermediario B) con instradamento e canale di riserva, lettura dei canali programmata e push SdICoop, notifiche, correzione degli scarti, copia di cortesia PDF con l'XML allegato, fatture ricevute da registrare, pacchetti per la conservazione, autofatture da inviare, rimozione dei dati di esempio |
| Entità | EInvoice (e_invoices), EInvoiceNotification (e_invoice_notifications), EInvoiceInboxFile (e_invoice_inbox), EInvoiceChannelSetting (e_invoice_channels), SdiRoutingRule (e_invoice_routing), ConservationExport (e_invoice_conservation) |
| Servizi | EInvoiceService, EInvoiceChannelService, EInvoicePollingService (+ job einvoice.poll), SdiPushService (endpoint POST /sdicoop/{azienda}), SdiInboxService, ConservationExportService, EInvoiceFeedSource, DemoEInvoiceSeeder, DemoDataRemover; nel core SdiRouter, EInvoiceStates; nel pacchetto italiano FatturaPaWriter, FatturaPaValidator, FatturaPaReader, SdiReceiptReader, PecSdiTransport, SdiCoopTransport, IntermediaryATransport, IntermediaryBTransport, SdiCoopPushReader (ADR 0039, 0040) |
| Maschere e mockup | cruscotto SDI (058, EInvoiceDashboardPage), canali e instradamento (059, EInvoiceChannelsPage), fatture ricevute (EInvoiceInboxPage), notifiche (EInvoiceNotificationsPage), conservazione (ConservationPage); dichiarazioni d'intento e plafond (061) in M10; bollo virtuale (060) in IVA dalla 0.7 |
| Permessi | einvoice.document.read, einvoice.document.send, einvoice.inbox.read, einvoice.inbox.import, einvoice.channel.manage |
| Log | SDI/e-invoicing; invio e lettura PEC in E-mail/PEC; intermediari in Integrazioni |
| Wiki | Fatturazione-elettronica |
| Milestone | M9 v0.9.0 (consegnata); dichiarazioni d'intento in M10 |
3.12 Crm — CRM
| Voce | Contenuto |
|---|---|
| Licenza | CRM |
| Responsabilità | lead con punteggio e conversione, pipeline e fasi, opportunità (kanban, previsione), attività e agenda condivisa, campagne e segmenti, ticket con SLA collegati agli interventi, scheda controparte a 360°, import lead da CSV/API |
| Entità | Lead, Pipeline, PipelineStage, Opportunity, CrmActivity, Campaign(+Member), Ticket, EmailTemplate, Segment |
| Servizi | LeadService, OpportunityService, PipelineService, ActivityService, CampaignService, TicketService, Party360Service, CrmDashboardService, SalesForecastService; LeadScoring (Core) |
| Maschere e mockup | dashboard (062), lead (063), pipeline kanban (064), opportunità (065), agenda (066), ticket (067), campagne (068); CrmDashboard, LeadsPage, PipelineBoard, OpportunityPage, AgendaPage, TicketsPage, CampaignsPage |
| Permessi | crm.opportunity.write; proposte: crm.lead.write, crm.activity.write, crm.campaign.write, crm.ticket.write |
| Log | CRM |
| Wiki | CRM |
| Milestone | M11 v0.11.0 |
3.13 Services — Servizi
| Voce | Contenuto |
|---|---|
| Licenza | SVC |
| Responsabilità | contratti di assistenza (validità, rinnovo tacito, canone e periodicità, impianti e matricole), squadre e tecnici, interventi (programmato, a chiamata, garanzia) con ore, materiali, rapportino e firma, interventi periodici, fatturazione dei rapportini tramite il motore documenti |
| Entità | ServiceContract(+Line), ServiceTeam, ServiceTechnician, ServiceIntervention(+Line) |
| Servizi | ContractService, InterventionService, InterventionSchedulingService, ServiceBillingService |
| Maschere e mockup | contratto e interventi (069, ServiceContractPage), agenda condivisa con il CRM (066) |
| Permessi | proposte: services.contract.write, services.intervention.write, services.intervention.close, services.billing.run |
| Log | CRM (proposta: SPEC §9.5 non ha una sezione "Servizi") |
| Wiki | Servizi |
| Milestone | M14 v1.1.0+ (fase 2) |
3.14 Channels — Canali e-commerce
| Voce | Contenuto |
|---|---|
| Licenza | CHAN |
| Responsabilità | canali di vendita con credenziali cifrate e mappature, connettore generico (JSON/CSV + POST /api/v1/channels/{code}/orders), import ordini web, sincronizzazione giacenze/prezzi in uscita; connettori dedicati come implementazioni successive di IChannelConnector |
| Entità | SalesChannel, ChannelItem, ChannelOrder, ChannelCustomer |
| Servizi | IChannelConnector, GenericChannelConnector, ChannelOrderImportService, ChannelSyncService |
| Maschere e mockup | ordini web importati e connettori (070, ChannelOrdersPage) |
| Permessi | proposte: channels.channel.write, channels.order.import, channels.sync.run |
| Log | Integrazioni |
| Wiki | Canali-e-commerce |
| Milestone | M14 v1.1.0+ (fase 2) |
3.15 Reports — Report
| Voce | Contenuto |
|---|---|
| Licenza | CORE (report base); REPORT (margini, analisi, report pianificati, export per il commercialista) |
| Responsabilità | ReportDefinition con parametri, query per dialetto, colonne, totali e raggruppamenti; resa con KhGrid + grafico; export CSV/XLSX/PDF, stampa, pianificazione come attività programmata (invio e-mail, salvataggio come allegato) |
| Entità | nessuna tabella propria prevista (le pianificazioni sono ScheduledTask di sistema) |
| Servizi | ReportDefinition, ReportRunner, ReportCatalog, ScheduledReportService |
| Maschere e mockup | fatturato per cliente con export e pianificazione (071, ReportPage) |
| Permessi | proposte: reports.report.read, reports.report.export, reports.report.schedule; i report con costi e margini richiedono anche items.cost.read |
| Log | Documenti (proposta: SPEC §9.5 non ha una sezione "Report"); esecuzioni pianificate in Attività programmate |
| Wiki | Report |
| Milestone | ogni modulo consegna i propri report nella sua milestone; pianificazione con le attività programmate in M12; export per il commercialista in M10 |
3.16 Admin — Amministrazione
| Voce | Contenuto |
|---|---|
| Licenza | CORE; chiavi API, MCP e webhook richiedono API; aziende oltre la prima richiedono MULTI |
| Responsabilità | istanza e database (crea, collega, clona, elimina, migra, manutenzione), licenze e moduli, utenti a tre livelli, ruoli e permessi, attività programmate, backup e ripristino, log, stato sistema e controllo aggiornamenti dal registro Gitea, impostazioni (SMTP, PEC, sicurezza, cloud, rotazione segreti), chiavi API/MCP/webhook, dati di base ed esempio, import/export |
| Entità | Company, SystemUser, License, LicenseActivation, SystemSetting, DataProtectionKey, LogEntry, SecurityAuditEntry, ScheduledTask, JobRun, BackupSet, BackupPolicy, SystemNotification, SystemSession, LoginAttempt; per azienda User, Role, Permission, RolePermission, UserRole, UserPermissionOverride, UserSession, ApiKey, Webhook, Notification, AuditEntry |
| Servizi | SystemUserService, UserService, RoleService, PermissionService, SessionService, LicenseService, ModuleActivationService, CompanyService, MaintenanceModeService, DatabaseMaintenanceService, IntegrityCheckService, RebuildService, ScheduledTaskService, BackupService, RestoreService, SystemSettingsService, SecretRotationService, LogQueryService, LogAlertService, SystemStatusService, UpdateCheckService, ApiKeyService, WebhookService, ImportWizardService, OpeningBalancesImportService, DemoDataRemover |
| Maschere e mockup | accesso, 2FA e cambio password (001-003), import/export (077), istanza e database (078), dettaglio database e backup (079), licenze e moduli (080), utenti (081), ruoli e permessi (082), attività programmate (083), log (084), stato sistema (085), impostazioni sicurezza/SMTP (086), cloud e copie remote (087), chiavi API/MCP/webhook (088), dati di base ed esempio (089); Admin*Page, LoginPage, TwoFactorPage, ChangePasswordPage |
| Permessi | livelli SuperUser / Administrator ([RequireLevel]) per le funzioni di istanza; company.users.manage per la gestione utenti di un'azienda da parte di un utente standard |
| Log | Sistema, Autenticazione, Database, Migrazioni, Backup, Attività programmate, API/MCP |
| Wiki | Istanza-e-database, Licenze-e-moduli, Utenti-e-permessi, Attivita-programmate, Backup-e-ripristino, Log, Impostazioni, Stato-sistema, API-e-MCP, Import-Export, Dati-di-base-e-esempio |
| Milestone | M2 v0.2.0 (DB di sistema, super utente, amministratori, aziende crea/collega, utenti, ruoli, login/2FA, licenze con codici test, cache, scheduler base, log, audit, notifiche); M4 (import/export); M12 v0.12.0 (clona/elimina/manutenzione, attività da UI, backup/ripristino, impostazioni, rotazione segreti, stato sistema e aggiornamenti, chiavi API, REST + OpenAPI, MCP, webhook) |
3.17 UserSettings — Preferenze e dashboard
| Voce | Contenuto |
|---|---|
| Licenza | CORE |
| Responsabilità | preferenze utente (tema, accento, densità, dimensione testo, menu, pagina iniziale, dashboard, layout griglie, filtri salvati, scorciatoie, notifiche), profilo personale (password, 2FA, sessioni), dashboard a widget personalizzabile e disattivabile, layout predefinito per ruolo |
| Entità | UserSetting, DashboardLayout |
| Servizi | UserSettingsService, DashboardService, WidgetCatalog; aggregatori TodoAggregator, DoneAggregator, DeadlineAggregator (Core) |
| Maschere e mockup | dashboard (004, 005, 006), menu compresso (007), preferenze tema e colori (008, ProfilePage), ricerca globale (009), notifiche (010), aiuto F1 (011) |
| Permessi | nessun permesso specifico: ogni utente gestisce le proprie preferenze; layout per ruolo riservato agli amministratori |
| Log | UI/circuiti |
| Wiki | Preferenze-utente, Dashboard, Interfaccia-e-scorciatoie |
| Milestone | M3 v0.3.0 |
3.18 Automation — Automazioni, procedure e codici automatici
| Voce | Contenuto |
|---|---|
| Licenza | AUTO per regole e procedure oltre quelle di sistema; codici automatici e compilazione automatica fanno parte del CORE (sono usati da anagrafiche e articoli in M4) |
| Responsabilità | codici automatici (CodeRule, maschere C{seq:000000} …), compilazione automatica, regole quando → se → allora con eventi, condizioni e azioni (incluso webhook), log esecuzioni, catalogo procedure idempotenti eseguibili a mano, da regola o da attività programmata |
| Entità | CodeRule, CodeSequence, AutomationRule, AutomationRun, Webhook |
| Servizi | CodeRuleService, CodeSequenceService, AutoFillService, RuleEngine, TriggerCatalog, ConditionEvaluator, ActionExecutor, ProcedureCatalog, IProcedure, ProcedureRunner |
| Maschere e mockup | regole (072, AutomationRulesPage), catalogo procedure (073, ProceduresPage), codici automatici e compilazione (074, CompanyPreferencesPage) |
| Permessi | proposte: automation.rule.write, automation.procedure.run, company.code_rules.write |
| Log | Automazioni |
| Wiki | Automazioni, Tabelle-azienda (codici automatici) |
| Milestone | M4 v0.4.0 (codici automatici); M12 v0.12.0 (regole, procedure, webhook) |
Nota: SPEC §4 non elenca Modules/Automation/ (il motore sta in Application/Automation/); serve comunque un
IModule con codice AUTO per menu e licenza. Da fissare con ADR in M12.
4. Eventi per le automazioni
Eventi che i moduli espongono a TriggerCatalog (SPEC §11.12):
| Evento | Modulo che lo emette |
|---|---|
DocumentCreated, DocumentConfirmed, DocumentIssued, DocumentCancelled |
Sales, Purchases (motore documenti) |
SdiNotificationImported |
EInvoicing |
OpenItemOverdue |
Finance |
StockBelowReorder |
Inventory |
LeadCreated, OpportunityStageChanged, TicketOpened |
Crm |
InterventionClosed |
Services |
Schedule |
Automation (pianificazione) |
5. Checklist per un nuovo modulo
- Cartella
Modules/<Nome>/con la struttura di ARCHITECTURE.md §4 e la classe<Nome>Module. - Codice licenza esistente in
ModuleCode; registrazione statica inModuleRegistry. - Permessi in
Permissions.cs, voci inMenu.cs, testi inResources/it-IT/*.json. - Migrazioni nel catalogo giusto; aggiornamento di DATA-MODEL.md (generato da M1).
- Seeder base e demo; quadrature verificate dal test end-to-end del seed.
- Endpoint in
Api/e tool inMcp/se previsti; aggiornamento di API.md e MCP.md. - Sezione di log; pagina wiki con
HelpLink; questa scheda aggiornata;CHANGELOG.md.