Files
Khaemhat/docs/MODULES.md
T
Alby96andClaude Opus 5.5 88de272b3e docs: avoid ambiguous Unicode and record Gitea planning in STATUS
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>
2026-11-10 22:44:14 +01:00

356 lines
31 KiB
Markdown

# 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](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`.
## 2. Riepilogo
| Modulo | Licenza | Sezione di log | Pagina wiki | Milestone |
|---|---|---|---|---|
| Company | CORE | Sistema (proposta) | [Tabelle-azienda](wiki/Tabelle-azienda.md) | M4 (esercizi e periodi: M7) |
| Parties | CORE | Documenti (proposta); VIES in Integrazioni | [Anagrafiche](wiki/Anagrafiche.md) | M4 |
| Items | CORE | Magazzino (proposta) | [Articoli-e-listini](wiki/Articoli-e-listini.md) | M4 |
| Sales | CORE | Documenti | [Vendite](wiki/Vendite.md) | M5 |
| Purchases | CORE | Documenti | [Acquisti](wiki/Acquisti.md) | M6 |
| Inventory | CORE | Magazzino | [Magazzino](wiki/Magazzino.md) | M6 |
| Ledger | ACCT | Contabilità | [Contabilita](wiki/Contabilita.md) | M7, M10 |
| Vat | ACCT, INTRA | Contabilità | [IVA](wiki/IVA.md), [Intrastat](wiki/Intrastat.md) | M7, M10 |
| Assets | ASSET | Contabilità | [Cespiti](wiki/Cespiti.md) | M10 |
| Finance | FIN | Contabilità (proposta) | [Scadenzario](wiki/Scadenzario.md) | M8 |
| EInvoicing | EINV | SDI/e-invoicing; E-mail/PEC | [Fatturazione-elettronica](wiki/Fatturazione-elettronica.md) | M9 (dichiarazioni d'intento: M10) |
| Crm | CRM | CRM | [CRM](wiki/CRM.md) | M11 |
| Services | SVC | CRM (proposta) | [Servizi](wiki/Servizi.md) | M14 (fase 2) |
| Channels | CHAN | Integrazioni | [Canali-e-commerce](wiki/Canali-e-commerce.md) | M14 (fase 2) |
| Reports | CORE, REPORT | Documenti (proposta) | [Report](wiki/Report.md) | 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](wiki/Preferenze-utente.md), [Dashboard](wiki/Dashboard.md) | M3 |
| Automation | AUTO (codici automatici: CORE) | Automazioni | [Automazioni](wiki/Automazioni.md) | 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](wiki/Tabelle-azienda.md) |
| 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](wiki/Anagrafiche.md) |
| 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](wiki/Articoli-e-listini.md) |
| 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](wiki/Vendite.md), [Allegati-e-file](wiki/Allegati-e-file.md) |
| 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](wiki/Acquisti.md) |
| 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](wiki/Magazzino.md) |
| 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](wiki/Contabilita.md) |
| 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](wiki/IVA.md), [Intrastat](wiki/Intrastat.md), [Fiscalita-italiana](wiki/Fiscalita-italiana.md) |
| 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](wiki/Cespiti.md) |
| 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](wiki/Scadenzario.md) |
| 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](wiki/Fatturazione-elettronica.md) |
| 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](wiki/CRM.md) |
| 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](wiki/Servizi.md) |
| 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](wiki/Canali-e-commerce.md) |
| 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](wiki/Report.md) |
| 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](wiki/Istanza-e-database.md), [Licenze-e-moduli](wiki/Licenze-e-moduli.md), [Utenti-e-permessi](wiki/Utenti-e-permessi.md), [Attivita-programmate](wiki/Attivita-programmate.md), [Backup-e-ripristino](wiki/Backup-e-ripristino.md), [Log](wiki/Log.md), [Impostazioni](wiki/Impostazioni.md), [Stato-sistema](wiki/Stato-sistema.md), [API-e-MCP](wiki/API-e-MCP.md), [Import-Export](wiki/Import-Export.md), [Dati-di-base-e-esempio](wiki/Dati-di-base-e-esempio.md) |
| 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](wiki/Preferenze-utente.md), [Dashboard](wiki/Dashboard.md), [Interfaccia-e-scorciatoie](wiki/Interfaccia-e-scorciatoie.md) |
| 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](wiki/Automazioni.md), [Tabelle-azienda](wiki/Tabelle-azienda.md) (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](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](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](API.md) e [MCP.md](MCP.md).
7. Sezione di log; pagina wiki con `HelpLink`; questa scheda aggiornata; `CHANGELOG.md`.