Gitea flags en dash, multiplication sign, minus sign and single angle quotes as confusable characters, which put a warning on most pages; use plain equivalents (docs/SPEC.md stays untouched). STATUS.md now lists the issue numbers per milestone, the items waiting for the owner and the open specification questions tracked by issue #114. 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 e aging, incassi e pagamenti con abbuoni e differenze cambio, insoluti, distinte RiBa (CBI), SDD (pain.008), bonifici SEPA (pain.001), riconciliazione bancaria (CSV/CBI/CAMT.053), solleciti a livelli con interessi di mora, flusso di cassa 90 giorni |
| Entità | OpenItem, Payment(+Line), Remittance(+Line), SddMandate, BankStatement(+Line), BankMatchRule, DunningRun(+Line), DunningLevel |
| Servizi | OpenItemService, PaymentService, RemittanceService, SddMandateService, BankStatementImportService, BankReconciliationService, DunningService, CashFlowForecastService, AgingReportService, InstallmentPoster |
| Maschere e mockup | partite e aging (053, OpenItemsPage), registra incasso (054, PaymentDialog), distinte (055, RemittancePage), solleciti (056, DunningPage), riconciliazione (057, BankReconciliationPage) |
| Permessi | proposte: finance.open_item.read, finance.payment.write, finance.remittance.write, finance.dunning.run, finance.reconciliation.write |
| Log | Contabilità (proposta: SPEC §9.5 non ha una sezione "Tesoreria"); invio solleciti in E-mail/PEC |
| Wiki | Scadenzario |
| Milestone | M8 v0.8.0 |
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.