# Documenti Archivio DAFARE

## Obiettivo operativo

Costruire un flusso unico che parta dal file digitale, generi il codice mnemonico/QR, stampi l'etichetta corretta e accompagni il documento dentro la catena fisica fino alla collocazione finale.

## Slice da fare subito

1. Rifinire il builder etichette su `etichette-generiche`.
2. Tenere le impostazioni accanto alla riga o al campo che controllano.
3. Rendere piu esplicita la modifica e la ristampa delle etichette gia create.
4. Portare la gestione di supporto e ubicazione nella tab `movimentazione-codici`.
5. Preparare il flusso `file base -> primo supporto -> contenitori successivi`.

## Convenzioni archivio da fissare

### Codice categoria archivio

- `CONTR-ANNO-###`: contratti di servizio
- `ASSIC-ANNO-###`: polizze assicurative
- `CERT-ANNO-###`: certificati e autorizzazioni
- `PREV-ANNO-###`: preventivi e offerte
- `FATT-ANNO-###`: fatture e documenti fiscali
- `VERB-ANNO-###`: verbali assemblee
- `DOC-ANNO-###`: altri documenti

### Regole comuni

- Il prefisso categoria va salvato anche nella voce archivio su database.
- Il valore deve essere in formato Linux-safe: maiuscolo, senza spazi, uniforme.
- Il codice mnemonico deve diventare sia nome logico del file digitale sia fallback umano dell'etichetta stampata.
- Il QR o TAG deve contenere l'identificatore unico universale del nodo archivistico, leggibile da smartphone o lettore fisico.
- Il passaggio consegne tra amministratori deve riusare lo stesso codice mnemonico/QR senza ricodifiche locali.

### Data nei file

- Inserire la data nel nome file con formato `YYMMGG`.
- Prevedere una futura impostazione generale dell'amministratore per cambiare il formato globale della data.

## Flussi da realizzare

### 1. Gestione file base

Una Blade dedicata deve permettere di registrare il singolo file o una raccolta di fogli con:

- titolo
- descrizione
- note
- tag
- categoria come tag strutturato
- numero totale dei fogli o dell'incartamento
- selezione del layout etichetta da usare
- stampa etichetta con QR e fallback testuale nel titolo e sotto il QR

### 2. Primo contenitore fisico

Dal file base bisogna poter scegliere il primo supporto:

- busta ad anelli
- faldone a tre lembi
- raccoglitore
- altro supporto scelto a catalogo

Il record deve restare collegato al documento digitale per consentire nuove stampe dell'etichetta in qualsiasi momento.

### 3. Contenitori successivi e movimentazione

Serve una gestione separata dove il materiale gia preparato venga caricato nei contenitori successivi:

- cartellina
- busta
- faldone
- scatola
- scaffale
- posto finale

La tab `movimentazione-codici` deve diventare il centro operativo per:

- cambiare il contenitore padre
- aggiornare supporto operativo
- aggiornare magazzino, scaffale, ripiano e dettaglio ubicazione
- leggere codici da scanner, smartphone, QR o plugin locale

## Etichette 11354 e binding DB

- Per il formato `11354` prevedere un campo di collegamento ai dati DB da riversare automaticamente in stampa.
- Ogni riga deve poter leggere un campo DB oppure testo libero.
- Le impostazioni della singola riga devono stare vicino alla riga stessa.
- La ristampa deve essere disponibile anche se fallisce la lettura automatica del QR.

## Catalogo supporti e Amazon

- Ogni supporto fisico scelto dall'utente deve poter avere il pulsante Amazon.
- Il link Amazon deve arrivare dal catalogo prodotti gestito dal super admin.
- L'archivio fisico non deve duplicare il catalogo: deve consumare il dato gia scelto.

## Plugin locale / bridge dispositivi

Serve un plugin HTTP locale o agent Windows per passare dati hardware fuori dal browser:

- TWAIN/WIA scanner
- lettori barcode e QR
- NFC
- seriali
- eventuali periferiche di stampa/lettura

La webapp deve restare il pannello operativo, mentre il bridge locale si occupa della parte hardware.

## Backlog successivo

1. Foto ubicazione finale come nel ticket.
2. Vista modifica/ristampa dalle ultime etichette.
3. Blade separata per file singolo e per raccolta fogli.
4. Conteggio pagine persistente su database.
5. Impostazioni globali amministratore per formato data e convenzioni etichetta.
6. Integrazione completa col bridge locale di comunicazione.