Files
Khaemhat/docs/MODULES.md
T
Alby96andClaude Opus 5.5 51007d68ca
CI / Build and test (SQLite) (pull_request) Successful in 4m35s
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 1m24s
feat: fixed assets, Intrastat, intent declarations, year-end closing and statements (#82 #83 #84 #85 #86 #87)
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>
2026-11-13 19:31:26 +01:00

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 standard read, 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 file Permissions.cs del modulo.
  • Mockup: numero della schermata in docs/mockups/ (PNG ad alta risoluzione se disponibile, altrimenti miniatura in thumbs/).
  • 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.

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

  1. Cartella Modules/<Nome>/ con la struttura di ARCHITECTURE.md §4 e la classe <Nome>Module.
  2. Codice licenza esistente in ModuleCode; registrazione statica in ModuleRegistry.
  3. Permessi in Permissions.cs, voci in Menu.cs, testi in Resources/it-IT/*.json.
  4. Migrazioni nel catalogo giusto; aggiornamento di DATA-MODEL.md (generato da M1).
  5. Seeder base e demo; quadrature verificate dal test end-to-end del seed.
  6. Endpoint in Api/ e tool in Mcp/ se previsti; aggiornamento di API.md e MCP.md.
  7. Sezione di log; pagina wiki con HelpLink; questa scheda aggiornata; CHANGELOG.md.