docs: record owner decisions on mockups, bank list and SDI channels (#35 #45 #78)
CI / Build and test (SQLite) (pull_request) Successful in 5m27s
CI / PostgreSQL 16 integration (pull_request) Skipped
CI / PostgreSQL 17 integration (pull_request) Skipped
CI / YAML check (pull_request) Successful in 6s
CI / Docker image (pull_request) Successful in 1m59s
CI / Build and test (SQLite) (pull_request) Successful in 5m27s
CI / PostgreSQL 16 integration (pull_request) Skipped
CI / PostgreSQL 17 integration (pull_request) Skipped
CI / YAML check (pull_request) Successful in 6s
CI / Docker image (pull_request) Successful in 1m59s
The owner confirmed that no further high-resolution mockups exist, gave up the preloaded ABI/CAB bank list and set aside real SDI intermediaries, SdICoop accreditation and a test PEC mailbox. ADR 0044 records this so the next milestones stop waiting on that material: thumbnail-only screens are designed from the thumbnail and the existing UI, bank name and BIC come from a company account or are typed once, and #78 moves to the backlog. CLAUDE.md E4, the mockup index, related ADRs, status, changelog and the user guide are updated accordingly. Closes #35 Closes #45 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
a8f00cbae0
commit
83ef60fce2
12 files changed
+88
-17
No files matched your search
@@ -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
|
||||
|
||||
@@ -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
@@ -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à.
|
||||
@@ -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).
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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 |
|
||||
|
||||
Reference in new issue
Block a user