diff --git a/CHANGELOG.md b/CHANGELOG.md index 6c52d8c..c9aa925 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,12 @@ un'immagine `gitea.encke-hake.ts.net/balbosoft/khaemhat:X.Y.Z`. ## [Unreleased] +### Changed +- Decisioni del titolare (ADR 0044): le schermate con sola miniatura si disegnano dalla miniatura e dalla grafica del + gestionale, senza attendere altri PNG (#35); nessun elenco ABI/CAB precaricato, nome della banca e BIC dal conto + dell'azienda o a mano (#45); intermediari reali, accreditamento SdICoop e PEC di prova rimandati (#78). La guida + *Fatturazione elettronica* spiega quale canale usare. + ## [0.10.0] - 2026-11-13 M10 - Cespiti, Intrastat, chiusura, bilancio. I beni ammortizzabili hanno il loro registro con il piano civilistico e diff --git a/CLAUDE.md b/CLAUDE.md index 617c526..57e7200 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -76,8 +76,9 @@ validi. `docs/mockups/png/` più la galleria completa `000-galleria-mockup.png`; per **tutte le 88** esiste una miniatura 401x241 ritagliata dalla galleria in `docs/mockups/thumbs/`. Per le schermate senza PNG ad alta risoluzione si lavora da miniatura + `mockup.css` + descrizione in SPEC §10-§12, scegliendo i mattoni della schermata più simile -in alta risoluzione (§10.1 regola 4). I PNG mancanti vanno chiesti all'utente quando servono, senza bloccare il -lavoro (issue con etichetta `Status/In attesa utente`). +in alta risoluzione (§10.1 regola 4). Il titolare ha confermato il 2026-11-16 che altri PNG non esistono +(ADR [0044](docs/adr/0044-schermate-senza-png-banche-e-canali-sdi.md)): la miniatura è la specifica finale e i dettagli +che non mostra si decidono seguendo la grafica del gestionale già costruita, senza chiederli. **E5 — Avvio dello sviluppo.** La specifica (§0, §23) dice di lavorare in autonomia senza chiedere conferme. Vale, **dopo** il via esplicito dell'utente: la documentazione e la pianificazione su Gitea sono state preparate il diff --git a/docs/STATUS.md b/docs/STATUS.md index d5a9651..d787dd5 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -2,11 +2,12 @@ > Punto di ripresa per ogni sessione. Aggiornare a fine sessione. -**Ultimo aggiornamento:** 2026-11-13 +**Ultimo aggiornamento:** 2026-11-16 **Milestone corrente:** M11 — CRM e servizi (issue #88-#91), da iniziare. M10 chiusa: PR in `main`, tag `v0.10.0`, immagine e release. -**Prossimo passo:** M11 dall'issue #88. #35 (PNG ad alta risoluzione) resta aperta e non blocca; #45 resta aperta solo -per le banche ABI/CAB (manca una fonte con licenza compatibile). +**Prossimo passo:** M11 dall'issue #88. Decisioni del titolare del 2026-11-16 (ADR 0044): le schermate senza PNG si +disegnano dalla miniatura e dalla grafica del gestionale (#35 chiusa); niente elenco banche ABI/CAB precaricato (#45 +chiusa); intermediari, SdICoop e PEC reale rimandati (#78 nel backlog). Da recuperare: misure di riferimento su PostgreSQL in `docs/DATA-MODEL.md` §6.1; indicatore di robustezza della password (mockup 003); schede *Layout salvati* e *Notifiche* del profilo; rinomina e filtro predefinito nei radar; logo PNG nel PDF (oggi solo JPEG, ADR 0034); coda della posta persistente e modelli e-mail per azienda (M12). @@ -17,7 +18,7 @@ bilancio dal file `khaemhat-coa.json`; libro inventari (M13); IVA per cassa (fas Da M8: tracciati CBI e SEPA da provare con un home banking reale; tabella semestrale dei tassi di mora da aggiornare a gennaio e luglio (ADR 0038); blocco per fido su ordini e documenti; report di tesoreria in *Report* (M12). Da M9: schema XSD ufficiale FatturaPA al posto di quello scritto in casa (serve il permesso di scaricarlo); -intermediari reali e accreditamento SdICoop (#78, ADR 0040); conformità PDF/A-3 dichiarata della copia di cortesia; +intermediari reali e accreditamento SdICoop (#78 nel backlog, ADR 0040 e 0044); conformità PDF/A-3 dichiarata della copia di cortesia; pulsanti *Carica* e *Rimuovi dati di esempio* nell'interfaccia (M12). Da M10: file `SCAMBI.CEE` da verificare con il software di controllo delle Dogane prima del primo invio (ADR 0042); differenze di cambio calcolate sul residuo attuale della partita (ADR 0043); TFR stimato (retribuzioni / 13,5); @@ -138,8 +139,6 @@ Rilevato il 2026-11-11 sulla macchina di sviluppo (Windows 11, Git Bash per gli ## In attesa del titolare -- PNG ad alta risoluzione delle 66 schermate disponibili solo come miniatura (issue #35, non bloccante). -- Scelta degli intermediari SDI e accreditamento SdICoop (issue #78, non bloccante). - Prova del template su Unraid (issue #106). - Un contatto privato per la segnalazione di vulnerabilità (vedi `SECURITY.md`). diff --git a/docs/adr/0011-organizzazione-documentazione.md b/docs/adr/0011-organizzazione-documentazione.md index b85b351..c5b39d5 100644 --- a/docs/adr/0011-organizzazione-documentazione.md +++ b/docs/adr/0011-organizzazione-documentazione.md @@ -28,6 +28,7 @@ - Per le schermate con sola miniatura valgono SPEC §10.1 regola 4 (comporre con i mattoni della più simile) e le descrizioni testuali; se un dettaglio non è ricostruibile si chiede il PNG all'utente con un'issue - `Status/In attesa utente`, senza fermare il resto. + `Status/In attesa utente`, senza fermare il resto. *Aggiornato dall'ADR 0044:* altri PNG non esistono, i dettagli + mancanti si decidono seguendo la grafica del gestionale. - Quando arrivano gli screenshot reali dell'applicazione sostituiscono progressivamente i mockup nella wiki (`docs/wiki/img/`), come da SPEC §17. diff --git a/docs/adr/0026-tabelle-azienda-e-dati-di-base.md b/docs/adr/0026-tabelle-azienda-e-dati-di-base.md index 32e81fd..f04e59a 100644 --- a/docs/adr/0026-tabelle-azienda-e-dati-di-base.md +++ b/docs/adr/0026-tabelle-azienda-e-dati-di-base.md @@ -37,6 +37,8 @@ grandi (8.000 comuni, decine di migliaia di sportelli) che non sono nel reposito via dell'utente al download. Fino ad allora le tabelle si riempiono a mano o con l'import CSV. *Aggiornato dall'ADR 0028:* province e comuni ISTAT, con i CAP di GeoNames, sono nei dati di base dalla versione `IT 2026.3`; le banche restano fuori. + *Aggiornato dall'ADR 0044:* il titolare rinuncia all'elenco precaricato delle banche; nome e BIC si scrivono a mano + o vengono da un conto dell'azienda presso la stessa banca. 7. **Riga di comando.** `scripts/seed.sh --base [--company CODICE]` esegue la sequenza di avvio senza servire pagine (migrazioni, prima azienda) e aggiunge i dati di base a un'azienda o a tutte quelle attive. Nel container lo script è in `/app/scripts/` e passa da `entrypoint.sh` con il verbo `seed`; in sviluppo usa `dotnet run`. diff --git a/docs/adr/0028-elenco-istat-di-province-e-comuni.md b/docs/adr/0028-elenco-istat-di-province-e-comuni.md index 68beba5..12f1b92 100644 --- a/docs/adr/0028-elenco-istat-di-province-e-comuni.md +++ b/docs/adr/0028-elenco-istat-di-province-e-comuni.md @@ -41,6 +41,7 @@ caricati dopo il via dell'utente. Il via è arrivato il 2026-11-12 per due fonti 6. **Strumento di rigenerazione.** `tools/Khaemhat.PlacesTool` (non distribuito, solo framework) legge il foglio ISTAT e `IT.zip` e riscrive `Data/province.csv` e `Data/comuni.csv`; i file scaricati restano fuori dal repository. 7. **Banche ABI/CAB** restano fuori finché non c'è una fonte aperta con licenza chiara (ADR 0026, ADR 0027 punto 6). + Il titolare ha rinunciato ai dati precaricati (ADR 0044). ## Conseguenze diff --git a/docs/adr/0040-intermediari-e-dati-di-esempio.md b/docs/adr/0040-intermediari-e-dati-di-esempio.md index a9f6e37..64901a8 100644 --- a/docs/adr/0040-intermediari-e-dati-di-esempio.md +++ b/docs/adr/0040-intermediari-e-dati-di-esempio.md @@ -24,6 +24,7 @@ scritta a mano avrebbe dovuto essere aggiornata ogni volta. derivata; servizi, instradamento, interfaccia e test di integrazione restano uguali. 2. **Prima l'accreditamento.** SdICoop e intermediari sono scritti e provati con server finti nei test, ma si attivano in produzione solo dopo accreditamento o contratto (#78). La PEC è il canale che funziona subito. + *Aggiornato dall'ADR 0044:* la scelta dei fornitori e l'accreditamento sono rimandati; #78 resta nel backlog. 3. **Rimozione guidata dallo schema.** `DemoDataRemover` legge dalle migrazioni le tabelle con la colonna `is_demo` e le chiavi esterne: elimina le righe marcate e quelle delle tabelle senza marca che appartengono loro (righe di documento, giacenze), in ordine di dipendenza e in **una transazione**. Se una riga dell'utente si riferisce a una diff --git a/docs/adr/0044-schermate-senza-png-banche-e-canali-sdi.md b/docs/adr/0044-schermate-senza-png-banche-e-canali-sdi.md new file mode 100644 index 0000000..ab9a361 --- /dev/null +++ b/docs/adr/0044-schermate-senza-png-banche-e-canali-sdi.md @@ -0,0 +1,54 @@ +# ADR 0044 - Schermate senza PNG, banche senza elenco, canali SDI rimandati + +- **Stato:** accettata +- **Data:** 2026-11-16 +- **Modifica:** emendamento E4 di `CLAUDE.md`; ADR 0011, 0026, 0027 punto 6, 0028 punto 7, 0040; issue #35, #45, #78 + +## Contesto + +Tre issue aspettavano qualcosa dal titolare: + +- **#35:** i PNG ad alta risoluzione delle 66 schermate che hanno solo la miniatura. +- **#45:** una fonte con licenza compatibile per l'elenco delle banche ABI/CAB. +- **#78:** la scelta degli intermediari SDI, l'accreditamento SdICoop e una casella PEC di prova. + +Il 2026-11-16 il titolare ha risposto su tutte e tre: + +- **#35:** il materiale consegnato è tutto quello che esiste. Sono 22 schermate ad alta risoluzione più la galleria, + e nessun'altra fonte (repository, cartella privata, allegati delle issue) ne contiene altre. +- **#45:** rinuncia ai dati precaricati delle banche. Indicherà una fonte se e quando la troverà. +- **#78:** intermediari, SdICoop e PEC reale sono lasciati da parte per ora. + +## Decisione + +1. **Le miniature sono la specifica finale delle schermate senza PNG.** Nessun PNG ad alta risoluzione verrà + aggiunto alle 66 schermate *solo miniatura*. Le schermate si disegnano in base a tre fonti: + - la miniatura, che fissa disposizione, gruppi e colonne; + - SPEC §10-§12; + - i componenti dell'applicazione già costruiti, con i token di `mockup.css` e i mattoni della schermata più + simile (SPEC §10.1 regola 4). + + Dove la miniatura non basta, decide chi sviluppa seguendo lo stile del gestionale, senza chiedere un PNG. + I dettagli scelti così vanno nella pagina wiki della schermata. +2. **Banche senza elenco precaricato.** I dati di base non contengono l'elenco ABI/CAB e `ItalianBankDirectory` + resta vuoto. Dall'IBAN si leggono sempre ABI e CAB. Nome della banca e BIC vengono da un conto dell'azienda + presso la stessa banca, oppure si scrivono a mano (ADR 0027 punto 6). Se il titolare indicherà una fonte con una + licenza che permette di ridistribuirla in un repository pubblico, l'elenco entrerà come nuova versione dei dati di + base, solo in aggiunta (ADR 0026 punto 3). +3. **Canali SDI reali rimandati.** Lo sviluppo continua con i canali simulati dell'ADR 0040. Fino a una scelta del + titolare valgono queste regole: + - i connettori A e B restano generici; + - l'endpoint SdICoop resta disponibile ma non accreditato; + - la PEC si prova contro il server di posta finto dei test. + + L'issue #78 resta aperta nel backlog, senza milestone e senza l'etichetta `Status/In attesa utente`. + +## Conseguenze + +- Le issue #35 e #45 si chiudono. L'issue #78 non blocca nessuna milestone. +- Le schermate di M11-M14 non aspettano materiale dal titolare. Il rischio è che una di esse si discosti dall'idea + originale in un dettaglio che la miniatura non mostra; si corregge con un'issue quando il titolare la vede. +- Chi usa più conti presso banche diverse scrive nome e BIC una volta per banca. La compilazione automatica li + riprende poi dal conto dell'azienda. +- Prima di usare in produzione la fatturazione elettronica serve comunque una PEC o un intermediario reale. La guida + *Fatturazione elettronica* della wiki lo dice già. diff --git a/docs/mockups/README.md b/docs/mockups/README.md index 3be5bac..af80c6f 100644 --- a/docs/mockups/README.md +++ b/docs/mockups/README.md @@ -20,10 +20,10 @@ I mockup sono la **specifica visiva vincolante** dell'interfaccia (SPEC §10.1). | `thumbs/` | Miniature 401x241 di **tutte** le 88 schermate, ritagliate dalla galleria, con lo stesso nome file | | `mockup.css` | Token (`--kh-*`) e classi dei componenti usati per disegnare i mockup | -Le schermate segnate *solo miniatura* non sono ancora disponibili in alta risoluzione: si lavora con la miniatura, -`mockup.css` e le descrizioni di SPEC §10-§12 (regola 4). La richiesta dei PNG mancanti è tracciata da un'issue con -etichetta `Status/In attesa utente` nella milestone M3. Quando un PNG arriva va copiato in `png/` con lo stesso nome -e questa tabella va aggiornata. +Le schermate segnate *solo miniatura* non hanno e non avranno un PNG ad alta risoluzione (ADR 0044, issue #35): si +lavora con la miniatura, `mockup.css`, le descrizioni di SPEC §10-§12 e i mattoni della schermata più simile +(regola 4). I dettagli che la miniatura non mostra si decidono seguendo la grafica dei componenti già costruiti e si +descrivono nella pagina wiki della schermata. Alcuni mockup contengono dettagli superati dagli emendamenti di `CLAUDE.md` (ad esempio 085 mostra ancora `ghcr.io` come registro): in quei casi prevale l'emendamento (registro pacchetti di Gitea). diff --git a/docs/wiki/Dati-di-base-e-esempio.md b/docs/wiki/Dati-di-base-e-esempio.md index 444cce0..021cd8c 100644 --- a/docs/wiki/Dati-di-base-e-esempio.md +++ b/docs/wiki/Dati-di-base-e-esempio.md @@ -52,7 +52,6 @@ Il pacchetto italiano fa parte del pacchetto fiscale Italia (vedi [Fiscalità it | **Cespiti** | categorie di beni con i coefficienti di ammortamento ministeriali | | **Codici tributo F24** | IVA, ritenute, bollo, acconti | | **Code list SDI** | tipi documento (TD), modalità di pagamento (MP), regimi fiscali (RF) e altre liste della FatturaPA; regime RF01 predefinito | -| **Banche ABI/CAB** | tabella per ricavare banca e BIC dall'IBAN | | **CRM** | pipeline e fasi, modelli e-mail | | **Sistema** | ruoli predefiniti, regole di automazione predefinite, attività programmate di sistema | @@ -76,8 +75,9 @@ intervallo come `10121-10156` per le città con più CAP. Ai comuni rinominati o nati da fusioni recenti (ad esempio Sanremo) il CAP può mancare: si completa a mano nella tabella *Comuni* o con l'**Importa CSV** (colonne `Code` e `PostalCodes`, più CAP separati da virgola). La -compilazione dal CAP propone solo i comuni che hanno il CAP scritto. Le **banche ABI/CAB** non sono ancora incluse: banca e BIC dall'IBAN vengono da un conto -dell'azienda presso la stessa banca. Un comune soppresso per fusione resta nella tabella finché non lo disattivi. +compilazione dal CAP propone solo i comuni che hanno il CAP scritto. L'**elenco delle banche ABI/CAB** non è incluso: dall'IBAN +Khaemhat legge ABI e CAB, mentre nome della banca e BIC vengono da un conto dell'azienda presso la stessa banca o si +scrivono a mano la prima volta. Un comune soppresso per fusione resta nella tabella finché non lo disattivi. Le categorie dei cespiti si creano da **Cespiti → Categorie → Categorie standard** (vedi [Cespiti](Cespiti)). Le altre voci dell'elenco (piano dei conti, causali contabili, registri IVA, codici tributo, CRM) arrivano con i moduli che le diff --git a/docs/wiki/Fatturazione-elettronica.md b/docs/wiki/Fatturazione-elettronica.md index daa4380..373f4e9 100644 --- a/docs/wiki/Fatturazione-elettronica.md +++ b/docs/wiki/Fatturazione-elettronica.md @@ -236,6 +236,12 @@ modulo un campo segreto lasciato vuoto mantiene il valore memorizzato. Per ogni canale: **Prova connessione**, **Metti in pausa** / **Riprendi** e **Salva**. Gli indirizzi dei servizi devono essere `https`. +> **Quale canale usare.** Per iniziare usa la **PEC**: non richiede accreditamento né contratti. *Intermediario A* e +> *Intermediario B* sono connettori generici, provati con servizi simulati: per collegarli a un intermediario reale +> servono le sue API, quindi vanno adattati al fornitore scelto. **SdICoop** richiede l'accreditamento dell'azienda +> presso l'Agenzia delle Entrate, il certificato client e un reverse proxy con verifica reciproca dei certificati +> (mTLS): conviene solo con volumi alti. + **PEC.** Il primo invio va all'indirizzo `sdi01@pec.fatturapa.it`; con la prima risposta lo SDI comunica la casella da usare da lì in poi, che Khaemhat ricorda e mostra nel campo *Indirizzo PEC dello SDI*. La PEC non richiede accreditamento ma è il canale più lento: per volumi alti conviene una regola che sposti il traffico su un altro diff --git a/docs/wiki/Tabelle-azienda.md b/docs/wiki/Tabelle-azienda.md index 38fe4f3..b6bba01 100644 --- a/docs/wiki/Tabelle-azienda.md +++ b/docs/wiki/Tabelle-azienda.md @@ -221,7 +221,7 @@ Ogni opzione si accende o spegne con un interruttore; spenta, i campi restano da | Comune, provincia e regione dal CAP | scrivendo il CAP propone il comune (o i comuni) con provincia e regione; scrivendo il comune propone CAP e provincia | accesa | | Codice fiscale dai dati anagrafici | calcola il codice fiscale delle persone fisiche da cognome, nome, data, sesso e comune di nascita | accesa | | Verifica P.IVA UE (VIES) al salvataggio | interroga il servizio VIES e salva l'esito (*valida*, *non valida*, *servizio non disponibile*) | accesa | -| Banca e BIC dall'IBAN | legge ABI e CAB dall'IBAN; banca e BIC vengono dall'elenco ABI o, finché l'elenco non è caricato, da un conto dell'azienda presso la stessa banca | accesa | +| Banca e BIC dall'IBAN | legge ABI e CAB dall'IBAN; banca e BIC vengono da un conto dell'azienda presso la stessa banca (l'elenco ABI non è precaricato) | accesa | | Cambi BCE giornalieri | l'attività di sistema scarica i cambi nei giorni lavorativi; spenta, l'azienda usa solo cambi manuali | accesa | | Descrizione articolo nelle righe | copia la descrizione dell'articolo nella riga del documento | accesa | | Ultimo prezzo praticato al cliente | lo mostra come riferimento | accesa |