Merge decisioni del titolare su mockup, banche e canali SDI (#130)
Wiki / Publish the wiki (push) Successful in 11s

This commit was merged in pull request #130.
This commit is contained in:
Alby96 committed 2026-11-16 17:27:17 +01:00
commit f7b5cfb1bd
12 files changed
+88 -17

No files matched your search

+6
View File
@@ -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
+3 -2
View File
@@ -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
+5 -6
View File
@@ -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`).
@@ -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.
@@ -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`.
@@ -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
@@ -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
@@ -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à.
+4 -4
View File
@@ -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).
+3 -3
View File
@@ -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
+6
View File
@@ -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
+1 -1
View File
@@ -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 |