The milestone's Definition of Done asks for real screenshots, complete wiki pages and a changelog for everything delivered. Fifteen screenshots taken on a fresh instance now sit next to the mockups in the wiki; Interfaccia, Dashboard, Preferenze, Design UI and Allegati are marked complete, with the date-field shortcuts and the profile tabs that are not built yet described as they really are. ADR 0024 records the Kh component library, record pages and the shared list query, which shipped without one, and the changelog gains its entries and a 0.3.0 section. The visual check against the mockups found three layout bugs, fixed here: the document total label took the timeline's .tl style and was cut, the radar's .kh-choices class stacked the profile's theme cards in a column (renamed .kh-radio-set), and on phones the top bar wrapped; it now keeps icons only and the status bar shows only the live values. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
9.8 KiB
Allegati e file
Stato: completa per M3 (invio e-mail e scanner con M5) · Ultima revisione: 2026-11-11 · Versione software: 0.3.0 (milestone M3) Modulo di licenza: CORE · Permessi principali:
attachments.read,attachments.write,attachments.delete· Specifica: SPEC §9.4
Ogni documento e ogni anagrafica può avere allegati: file caricati dall'utente (l'ordine del cliente in PDF, una foto, un foglio di calcolo) e file generati da Khaemhat (PDF di stampa, XML FatturaPA, esportazioni, pacchetti ZIP). Gli allegati sono archiviati sul volume dei dati dell'istanza, con versione e impronta digitale.
Dove si trova
Da qualunque documento: icona Allegati nella toolbar (con il numero degli allegati) oppure scheda Allegati (n). Si apre il pannello laterale Allegati e file generati.
In questa versione i documenti veri arrivano con le vendite (M5): pannello, anteprime e anteprima di stampa si provano sul documento di prova degli sviluppatori (dal catalogo dei componenti
/sviluppo/componenti, solo in ambiente di sviluppo), che ha tre file generabili (PDF, righe in CSV, righe in Excel). Mancano ancora Invia per e-mail e Da scanner / foto.
Mockup 024 — pannello laterale sopra la fattura: elenco degli allegati con azioni, Carica file, Da scanner / foto, Scarica tutto (ZIP) e sezione Genera file (anteprima ridotta).
Khaemhat 0.3.0 — la scheda Allegati del documento di prova: tre file generati con le loro versioni, Carica file, Scarica tutto (ZIP) e Genera file.
Regole di base
- Un allegato appartiene a un solo documento (o a una sola anagrafica). Non esistono allegati "sciolti": se lo stesso file serve a due documenti va caricato in entrambi.
- I file generati dal gestionale sono versionati (
v1,v2…); i file caricati sono conservati così come sono, con l'impronta SHA-256 che ne garantisce l'integrità. - Alcuni allegati sono bloccati: ad esempio l'XML già inviato allo SDI non si può cancellare né sostituire.
- Cancellare un documento (quando è ammesso) sposta i suoi allegati nel cestino dell'azienda per 30 giorni.
Tipi di allegato
| Tipo | Esempio | Si può cancellare? |
|---|---|---|
| Caricato | ordine del cliente in PDF, foto del cantiere, preventivo del fornitore | sì, con il permesso attachments.delete |
| Generato | PDF della fattura, righe esportate in XLSX, copia di cortesia ZIP, etichette colli | sì, con il permesso; in alternativa si rigenera una nuova versione |
| Fattura elettronica | XML FatturaPA emesso o ricevuto, file P7M | no, se inviato o ricevuto dallo SDI (bloccato) |
| Notifica | ricevute dello SDI (consegna, scarto…) | bloccata (regola da confermare in sviluppo) |
Per ogni allegato il pannello mostra: icona del formato (PDF, XML, XLSX, immagine, ZIP, CSV…), nome, chi l'ha caricato o generato e quando, dimensione, versione, eventuale modello usato.
Azioni sugli allegati
| Icona | Azione |
|---|---|
| occhio | Anteprima in app |
| freccia in giù | Scarica |
| busta | Invia per e-mail (con le vendite) |
| frecce circolari | Rigenera (nella sezione Genera file): crea una nuova versione del file generato |
| lucchetto | Blocca: da quel momento il file non si può più eliminare; accanto al nome indica un file bloccato |
| cestino | Sposta nel cestino (solo file non bloccati e con permesso), dopo una conferma |
La casella Versioni precedenti mostra anche le versioni superate dei file generati (v1 quando c'è già v2).
In fondo all'elenco:
- Carica file — scegli uno o più file dal computer;
- Da scanner / foto — acquisisci un documento da fotocamera o scanner del dispositivo;
- Scarica tutto (ZIP) — un unico archivio con tutti gli allegati del documento.
Generare file da un documento
La sezione Genera file del pannello elenca le uscite disponibili per il documento; ognuna ha il pulsante Genera e produce un allegato versionato, scaricabile o inviabile.
| Uscita | Formato | Note |
|---|---|---|
| Stampa PDF | modello di stampa, numero di copie, lingua | |
| XML FatturaPA | XML (FPR12 / FPA12) | eventualmente con il PDF di cortesia incorporato; richiede il modulo EINV |
| Righe in XLSX / CSV | XLSX o CSV | colonne visibili della griglia righe |
| Copia di cortesia PDF + XML | ZIP | pacchetto da inviare al cliente |
| Etichette colli | per formato etichetta e numero di colli | |
| Estratti conto, rapportini | dai moduli che li prevedono |
Rigenera non sovrascrive mai: crea la versione successiva (v2, v3…) e lascia consultabili le precedenti.
Anche i report producono file (XLSX, CSV, PDF) scaricabili e, se pianificati, inviati per e-mail come allegati. Le stampe massive (ad esempio tutte le fatture del mese) producono un unico ZIP scaricato direttamente, senza file temporanei.
Anteprima
Il pannello apre in app l'anteprima di:
| Formato | Come si vede |
|---|---|
| visualizzatore PDF del browser, dentro la finestra di anteprima | |
| Immagini (JPEG, PNG, GIF, WebP) | adattate alla finestra |
| XML, testo | testo così com'è |
| CSV, XLSX | griglia (il primo foglio per gli XLSX) |
Khaemhat 0.3.0 — l'anteprima di un file Excel generato: il primo foglio come griglia.
Dei file lunghi l'anteprima mostra l'inizio (200 righe, 200.000 caratteri) e lo dice. Gli altri formati si scaricano; PDF e immagini si aprono anche in una nuova finestra del browser.
Anteprima di stampa
Mockup 025 — anteprima di stampa di una fattura in formato A4 (anteprima ridotta).
Ctrl+P o l'icona Stampa del documento aprono in una scheda l'anteprima di stampa: il documento come foglio
A4, con ingrandimento al 75, 100 o 125%. In alto:
- Stampa — la stampa del browser, che stampa solo il foglio (non menu e barre);
- Apri PDF e Scarica PDF — il PDF prodotto da Khaemhat, senza salvarlo fra gli allegati;
- Salva come allegato — salva il PDF fra gli allegati del documento come nuova versione.
Modello di stampa, copie e lingua arrivano con i documenti di vendita (Vendite).
Khaemhat 0.3.0 — l'anteprima di stampa del documento di prova, con Stampa, Apri PDF, Scarica PDF, Salva come allegato e l'ingrandimento.
Cestino
Quando un allegato viene spostato nel cestino, o quando viene cancellato il suo documento, il file non sparisce
subito: resta nel cestino dell'azienda per 30 giorni e poi viene eliminato definitivamente da un'attività
programmata. In fondo al pannello degli allegati, la sezione Nel cestino elenca i file del documento
che sono nel cestino, con la data in cui saranno eliminati e il pulsante Ripristina (serve
attachments.delete).
Limiti e archiviazione
- Dimensione massima di un file caricato: 25 MB per impostazione predefinita, modificabile dagli amministratori in Amministrazione → Impostazioni (vedi Impostazioni).
- Il caricamento avviene in streaming, senza tenere l'intero file in memoria.
- Ogni azienda ha una quota di spazio con statistiche d'uso.
- Khaemhat non include un antivirus: è previsto un punto di aggancio per collegarne uno in futuro. Carica solo file di provenienza nota.
- I file stanno nel volume dei dati dell'istanza, in una cartella per azienda e per anno; i backup dell'azienda includono anche gli allegati (vedi Backup e ripristino).
Come si usa
Allegare l'ordine del cliente a una fattura
- Apri la fattura e premi l'icona Allegati (o la scheda Allegati).
- Carica file e scegli il PDF dell'ordine.
- Il file compare nell'elenco con il tuo nome e la data.
Inviare al cliente la copia di cortesia
- Nel pannello allegati, sezione Genera file, premi Genera su Copia di cortesia PDF + XML.
- Nell'elenco compare lo ZIP: premi l'icona busta per inviarlo con il modello e-mail dell'azienda.
Permessi e licenza
Gli allegati sono nel modulo CORE. Vedere e scaricare richiede attachments.read; caricare, generare e bloccare
richiede attachments.write; spostare nel cestino e ripristinare richiede attachments.delete. Un utente aziendale
vede solo gli allegati della propria azienda. I file si scaricano solo dopo l'accesso: un indirizzo copiato non
funziona per chi non è collegato. Gli allegati sono raggiungibili anche
dalle API (download e caricamento su un documento, modulo API; vedi API e MCP).
Domande frequenti
- Non riesco a cancellare l'XML della fattura. È bloccato perché già inviato allo SDI: è parte della documentazione fiscale.
- Ho rigenerato il PDF ma il cliente ha ricevuto quello vecchio. Ogni versione resta nell'elenco: controlla quale versione è stata inviata.
- Il caricamento fallisce con un file grande. Supera il limite configurato (25 MB predefiniti).
Pagine correlate
Vendite · Acquisti · Fatturazione elettronica · Report · Backup e ripristino · Impostazioni · Interfaccia e scorciatoie