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>
31 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 |
| Assets | ASSET | Contabilità | Cespiti | M10 |
| Finance | FIN | Contabilità (proposta) | Scadenzario | M8 |
| EInvoicing | EINV | SDI/e-invoicing; E-mail/PEC | Fatturazione-elettronica | M9 (dichiarazioni d'intento: M10) |
| 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, AccrualDeferral, ClosingRun(+Step), FinancialStatementLine, RecurringEntryTemplate |
| Servizi | JournalService, PostingEngine, LedgerPoster, PeriodLockService, LedgerQueries, PartitarioService, WithholdingService, AccrualDeferralService, ClosingProcedure, TrialBalanceService, FinancialStatementsService, RecurringEntriesService, ExchangeDifferenceService, ChartOfAccountsImportService |
| 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; proposte: ledger.entry.read, ledger.entry.write, ledger.entry.reopen, ledger.account.write, ledger.closing.run |
| Log | Contabilità |
| Wiki | Contabilita |
| 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, IntentDeclaration, IntrastatDeclaration(+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, vat.intrastat.export |
| 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. Proposta: i servizi stanno in Vat, le maschere sono raggiungibili dal
menu Fatturazione elettronica se EINV è attivo e da Contabilità se è attivo solo ACCT. Da fissare con ADR.
3.9 Assets — Cespiti
| Voce | Contenuto |
|---|---|
| Licenza | ASSET |
| Responsabilità | categorie con coefficienti ministeriali, registro beni ammortizzabili, piano di ammortamento (primo anno 50%, limiti autovetture, beni < €516,46), dismissioni con plus/minusvalenza (TD26), rivalutazioni, piano simulato, contabilizzazione annuale |
| Entità | FixedAsset, FixedAssetCategory, FixedAssetMovement |
| Servizi | FixedAssetService, DepreciationService; DepreciationCalculator (Core), FixedAssetRulesIt, MinisterialCoefficients |
| Maschere e mockup | registro cespiti e piano di ammortamento (048, FixedAssetsPage) |
| Permessi | proposte: 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à | generazione e validazione XML FatturaPA (FPR12/FPA12/FSM10), lettura passive e P7M, notifiche SDI, quattro canali (PEC integrata, SdICoop, Intermediario A, Intermediario B) con instradamento, cruscotto, inbox, export per la conservazione, autofatture da inviare |
| Entità | EInvoice, SdiNotification, EInvoiceInboxFile, SdiChannel, SdiRoutingRule, ConservationPackage |
| Servizi | EInvoiceService, EInvoiceExportService, SdiChannelService, SdiInboxService, SdiNotificationImportService, PurchaseInvoiceImportService, ConservationExportService; nel pacchetto paese FatturaPaWriter, FatturaPaValidator, FatturaPaReader, SdiRouter, i quattro ISdiTransport |
| Maschere e mockup | cruscotto SDI (058, EInvoiceDashboard), canali SDI (059, SdiChannelsPage), bollo virtuale (060, StampDutyPage), dichiarazioni d'intento e plafond (061, IntentDeclarationsPage) |
| Permessi | proposte: einvoicing.invoice.generate, einvoicing.invoice.send, einvoicing.channel.write, einvoicing.inbox.import |
| Log | SDI/e-invoicing; invio e lettura PEC in E-mail/PEC; intermediari in Integrazioni |
| Wiki | Fatturazione-elettronica |
| Milestone | M9 v0.9.0 (con seed demo completo); 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.