Niente codice finché Alberto non risponde alle domande in fondo (tappa E0).
Che cosa chiede Alberto
Fotogrammi dai video. Un convertitore che estrae immagini dai video. Febe deve riconoscere i video che mostrano sempre la stessa foto (un «video fermo»): per quelli basta un fotogramma solo.
Un formato per tutto. Un'impostazione per avere tutti i media in un formato scelto (JPG, PNG, MP4…).
Copie in cartelle esterne. Percorsi configurabili «per ogni utente». Per ogni foto, post, video o storia Febe mostra se è già stata copiata, per intero o come fotogramma.
In breve: varie opzioni di esportazione.
Che cosa c'è già
Fotogrammi e ffmpeg
VideoFrameExtractor estrae un JPG per le miniature. Gli argomenti sono a src/Febe.Core/Library/VideoFrameExtractor.cs:82, il limite fisso di 30 s a :12.
ffmpeg si cerca nel PATH o in un percorso esplicito (VideoFrameExtractor.cs:20-24). Oggi nessuna impostazione lo espone.
Su stderr: viene svuotato e mai registrato (VideoFrameExtractor.cs:87, :111).
PerceptualHash lavora su 32×32 grigi (src/Febe.Core/Library/PerceptualHash.cs:38). HashOf è interno e accetta proprio quella griglia (:77-78).
Scrittura dei file
SafeFileWriter scrive un .part, calcola lo SHA-256 e sposta il file su un nome libero, senza mai sovrascrivere (src/Febe.Core/Library/SafeFileWriter.cs:261-297).
Sa impostare LastWriteTime (SafeFileWriter.cs:23, :157-161).
La data del file è un'impostazione, non una costante: libreria.data-file-pubblicazione (src/Febe.Core/Library/LibrarySettings.cs:9, :24).
Conversione delle foto
SkiaSharp decodifica già le immagini (ImageDecoding.cs:22-53).
Non decodifica HEIC, AVIF né raw (ContentAnalysis.cs:101).
Nomi e cartelle
NamingScheme.Validate toglie il segmento {account} iniziale (src/Febe.Core/Library/NamingScheme.cs:136-140).
FitPath accorcia i percorsi lunghi per Windows (src/Febe.Core/Library/LibraryLayout.cs:84-89, WindowsFileNames.cs:20, :93).
La cartella di un account può stare fuori dalla Libreria (SPECIFICA.md:185). Le regole sono in ResolveFolder (AccountsApi.cs:642-671).
Disco, avvisi, pulizia
Lo spazio libero minimo predefinito è 10 GB / 5 % (src/Febe.Core/Alerts/DiskSpace.cs:65).
All'avvio CleanTemporaryFilesAsync toglie i file temporanei (src/Febe.App/FebeApp.cs:784-805), in modo ricorsivo (SafeFileWriter.cs:181).
Motore
«Sessione in corso» si legge da EngineRuntime.CurrentSession != null (src/Febe.Core/Engine/EngineRuntime.cs:60), come fa Monitor (Monitor.cs:105-107).
Non si legge da IsRunning, che è vero per ore (EngineRuntime.cs:87-91).
C'è anche UserIsDriving (Monitor.cs:95).
Avvisi di cambiamento
LibraryChange(At, AccountId?, Reason) non porta id di media né di elementi (src/Febe.Web/Library/FebeLibrary.cs:89).
Chi è lento perde le notifiche più vecchie (:93-94), quindi non può alimentare una coda.
Database
Esiste solo src/Febe.Data/Migrations/0001_schema.sql, nessun 0002 su nessun ramo.
Gli stati sono TEXT con CHECK (0001_schema.sql:56, :63, :95).
La decisione 94 dice «nessuna migrazione nuova» (docs/decisioni.md:94).
La prova di scala con 200.000 elementi esiste già: tests/Febe.Tests/Data/LibraryScaleTests.cs, con IndexBoundMs = 250 (:22).
L'entrypoint cambia il proprietario solo della radice di /libreria (docker/entrypoint.sh:59-61).
Esportazione e demo
Oggi l'unica esportazione è l'elenco CSV (CsvExport.cs:20, /api/entries/export).
Copie esterne, conversioni, fotogrammi a richiesta e video fermi: non trovati.
I video della demo hanno solo la copertina (src/Febe.Web/Demo/DemoSeeder.cs:70). DemoFileResolver restituisce file solo per le foto.
Mockup
Nessun mockup per queste schermate. I mockup 00-14 sono elencati a SPECIFICA.md:775-791.
Proposta
Il principio: un'esportazione copia file che stanno già in libreria verso una cartella esterna (destinazione).
Strada facendo, un file può essere convertito o sostituito da un fotogramma.
La libreria non cambia mai.
È solo lavoro sul disco: niente Instagram, niente CDN, niente Governatore, niente action_log. Un file mancante non si riscarica.
1. Fotogrammi e video fermi
Fotogrammi a richiesta
VideoFrameExtractor diventa FrameExtractor. Il metodo attuale per le miniature resta.
I fotogrammi si possono prendere in tre modi:
un fotogramma a un istante;
uno ogni k secondi;
N in tutto.
Formati: JPG o PNG, a piena risoluzione.
Un FfmpegRunner comune gestisce:
priorità BelowNormal;
annullamento;
ambiente WithoutSecrets();
stderr mai registrato;
un limite di tempo proporzionato alla durata del video, non i 30 s fissi.
Visualizzatore: l'azione «Fotogramma» compare solo per i video e solo se c'è ffmpeg.
«Questo istante» usa il punto in cui è fermo il video, con anteprima.
Ci sono anche «Ogni k secondi» e «N fotogrammi», con il conteggio in anteprima.
Uscita: «Scarica» (un file, o uno zip per più file, con System.IO.Compression della BCL) oppure una destinazione.
Selezione multipla (Libreria e Contenuti dell'account): un pulsante «Fotogrammi…» con le stesse opzioni, eseguite come esportazione. Le foto nella selezione si saltano e la finestra lo dice.
Nomi: suffisso fisso sull'ultimo segmento, senza nuovi segnaposto:
_fotogramma per un video fermo;
_t0m12s340 per un istante;
_f001 per una serie.
Il suffisso si aggiunge prima di FitPath, altrimenti sfora i 240 caratteri.
Uno slot riservato ai fotogrammi singoli interattivi, così l'anteprima non aspetta dietro una conversione lunga. Mentre si scorre il video, le richieste si raggruppano.
Riconoscere i video fermi
Nuovo VideoStillness, solo ffmpeg e ffprobe.
Due esiti in v1: «Fermo» o «In movimento», più «Non analizzabile». Niente stato «Incerto» e niente freezedetect.
Come si decide:
Filtro veloce con ffprobe: dimensioni dei pacchetti non chiave. Se sono grandi, il video si muove e l'analisi si ferma.
Un solo processo ffmpeg per video. Prende 7 campioni con più -ss nello stesso comando, in grigi su stdout.
pHash a 32×32 con HashOf: tutte le coppie entro 2 bit.
Differenza media dei pixel a 64×64 sotto 1,5/255.
Il fotogramma da usare è il campione più nitido. Il suo istante si salva in ms.
Casi da gestire:
video sotto 1 s;
durata ignota o frequenza variabile → «Non analizzabile»;
dissolvenze dal nero (i campioni troppo scuri si scartano);
video tutto nero: non va scartato del tutto;
rotazione.
Le soglie sono una prima stima. Si tarano su video generati nelle prove. Un numero algo permette di rianalizzare senza migrazione.
Quando gira:
in sottofondo, un ffmpeg alla volta, -threads 1, priorità BelowNormal;
non durante l'ingresso in libreria;
la coda è una query: «video presenti il cui sha256 non è in video_analysis». Vale per scaricamenti, importazioni e ricostruzioni. Un LibraryChange serve al massimo da sveglia.
Cede al motore. Non avvia un nuovo lavoro mentre CurrentSession != null o UserIsDriving.
Un lavoro già partito non si può mettere in pausa in modo portabile.
Per questo l'analisi e le conversioni lunghe partono solo fuori sessione.
Senza ffmpeg non c'è analisi, e Impostazioni → Esportazione mostra «Serve ffmpeg».
Interfaccia:
nel visualizzatore, pannello File, il chip «Video fermo» («Un'immagine sola per tutto il video: basta un fotogramma») con «Salva il fotogramma»;
nel filtro «Tipo» della Libreria, la voce «Video fermi»;
nessun segno sulla tessera in v1.
Nota su «foto con musica»: probabilmente i post foto con musica arrivano come immagine più una traccia audio separata, e Febe salva già solo l'immagine. I video fermi sarebbero allora soprattutto storie e reel fatti da una foto. Non verificato su un campione ripulito. Non si progetta nessun lettore su questa ipotesi (regola 9).
2. Formato di esportazione
Ci sono valori predefiniti in Impostazioni → Esportazione. Ogni destinazione e ogni singola «Copia in…» li può cambiare.
Le conversioni nascono solo nella destinazione. Il perché: sha256, phash, chiave della miniatura, controllo dei doppioni e _febe.jsonl dipendono dai byte originali (LibraryIngest.cs:232-237).
Convertire la libreria stessa non è vietato. SPECIFICA.md:92 lo permette «per una scelta esplicita di Alberto». Però cambia identità e regole (§4.7, §8.4, §9.5): vedi domanda 2.
Origine
Scelta
Come
Perdita
qualunque
Originale (predefinito)
copia byte per byte, verificata con SHA-256
nessuna, EXIF compreso
JPG → JPG, MP4 H.264+AAC → MP4
—
copia byte per byte: mai ricodificare lo stesso formato
nessuna
PNG, WEBP, GIF (primo fotogramma), BMP
JPG (qualità 92)
SkiaSharp
con perdita; EXIF tolto; rotazione applicata; trasparenza su bianco
foto decodificabile
PNG
SkiaSharp
senza perdita; file più grande; EXIF tolto
foto decodificabile
WEBP (qualità 90)
SkiaSharp
con perdita; EXIF tolto
HEIC, AVIF, raw
qualunque
non decodificabile
si copia l'originale, con una nota nel resoconto
MOV/MKV con H.264/HEVC + AAC
MP4
rimuxaggio -c copy -movflags +faststart
nessuna
VP9, AV1, altri
MP4
ricodifica
rimandata (vedi «Fuori»)
video fermo
fotogramma JPG/PNG
§1
la risoluzione è quella del video; la finestra lo dice
Regole comuni:
La data del file segue l'impostazione libreria.data-file-pubblicazione, fotogrammi compresi.
Nei file MP4 si scrive creation_time.
Per i profili si tiene {codice}, il prefisso SHA dell'origine, anche dopo la conversione.
Su Windows serve una nuova impostazione «Percorso di ffmpeg», che usa il percorso esplicito già previsto.
Senza ffmpeg, MP4, fotogrammi e video fermi sono spenti con la nota «Serve ffmpeg».
Le foto si convertono comunque.
Da verificare prima di costruire: è probabile che i file scaricati siano quasi tutti JPEG e MP4 H.264, quindi «tutto in JPG/MP4» sarebbe per lo più una semplice copia. Va controllato con un conteggio dei formati nel database di Alberto.
3. Percorsi esterni
Modello, da confermare con la domanda 1:
una cartella di esportazione generale;
una cartella per account, facoltativa, che la sostituisce. È lo stesso schema della «Cartella» dell'account (account.js:389-413);
un interruttore «Esporta questo account».
Così ogni account ha una sola destinazione effettiva e «già copiato» è un sì o un no.
Ogni destinazione ha:
cartella;
tipi di contenuto (post foto, post video, storie, evidenza, taggati, profilo);
formati;
opzione per i video fermi;
schema dei nomi: «Come la libreria» (predefinito) oppure uno proprio, validato da Validate;
interruttore «Automatica».
Nomi nella cartella generale: Febe aggiunge sempre lei il segmento con il nome utente ripulito. Validate toglie {account}, e senza quel segmento gli account si scontrerebbero.
Cartelle rifiutate:
dentro o contenente una di queste: Dati, Libreria, una cartella di account (anche fuori dalla Libreria), /importa;
la radice di un disco o di una condivisione (proposta nuova).
Si ricontrolla quando cambia la cartella di un account. Lettere di unità e percorsi UNC possono puntare allo stesso posto: lo si scopre con un piccolo file di prova, non confrontando le stringhe.
Windows
Selettore nativo (INativeShell.PickFolderAsync).
Percorsi assoluti, UNC e di rete ammessi.
Docker
Un nuovo percorso /esporta, attivo solo se si dà --esporta / FEBE_ESPORTA in modo esplicito.
Niente VOLUME nel Dockerfile. Un volume anonimo farebbe sembrare /esporta montata e riempirebbe in silenzio il docker.img di Unraid.
Secondo controllo: /esporta deve essere un punto di montaggio, letto da /proc/self/mountinfo. È codice nuovo: oggi non esiste.
Le destinazioni sono sottocartelle di /esporta, scelte da un elenco di cartelle come per le sorgenti di importazione. .. è rifiutato.
Si cambia il proprietario solo della radice, mai in modo ricorsivo.
Da aggiornare: compose.yml, unraid/febe.xml, docs/docker.md, §11.
Mai cancellare, mai sovrascrivere
Si scrive solo con SafeFileWriter.
La radice della destinazione non si crea mai. Un disco o una condivisione assente non deve diventare una cartella locale. Le sottocartelle dello schema sì.
Togliere una destinazione cancella solo la configurazione: «I file già copiati restano dove sono».
Eliminare un elemento dalla libreria non tocca le copie: «Le copie esterne restano».
Pulizia dei .part: solo nelle cartelle registrate in lavori non finiti e solo per i .part più vecchi di qualche ora. Mai una scansione ricorsiva della destinazione all'avvio: è lenta su SMB e potrebbe togliere un .part di un'altra istanza.
Destinazione irraggiungibile
Prima di ogni gruppo di copie Febe controlla che la cartella esista, con un file di prova .febe-prova-*.part scritto e tolto.
Se non va, la destinazione si mette in pausa. Lo stato si vede in Impostazioni e in Attività.
Il giro di recupero orario riprova da solo.
Niente attese crescenti, niente notifica dopo 24 ore, mai la striscia rossa (che resta per il motore).
I controlli sul disco esterno sono asincroni, con un tempo breve, e mai sul percorso della richiesta: una condivisione staccata non deve bloccare il visualizzatore.
Spazio: per le destinazioni non valgono 10 GB / 5 %, che bloccherebbero ogni chiavetta. Basta «spazio libero ≥ prossimo file + margine».
FAT32/exFAT: limite di 4 GB per file e date a 2 s. La verifica realistica è sulla dimensione.
Manuale e automatica
Manuale («Copia in…») da:
la selezione;
il filtro corrente;
il visualizzatore;
la scheda dell'account (Contenuti, dove oggi manca un'azione su tutto il filtro).
Automatica: dopo la riga di diario di un elemento, l'elemento entra in coda. In più c'è un giro di recupero all'avvio e ogni ora.
Quando la si accende, Febe chiede: «Copia anche i 12.430 già in libreria?» oppure «Solo i nuovi».
Le copie, sia di byte sia di ffmpeg, partono fuori dalle sessioni del motore.
Esportazione e importazione o ricostruzione non girano insieme, come in SettingsApi.cs:228-231.
4. Il segno «già copiato»
Per file
Una riga export_copy per file e destinazione, con:
sha256 dell'origine;
variante (Intero, Convertito, Fotogramma);
formato e istante del fotogramma;
percorso relativo, byte e sha256 della copia;
data e stato.
La chiave si basa sullo sha256, non sull'id Instagram: gli elementi importati possono non averlo.
«Copia di nuovo» aggiorna la riga esistente, non ne aggiunge una seconda.
Adozione per percorso (evita copie «(2)» e sostituisce un diario nella destinazione)
Prima di scrivere, Febe calcola il percorso di arrivo.
Se lì c'è già un file con la stessa dimensione (e lo stesso SHA per le copie byte per byte), lo adotta come copia invece di scriverlo.
Questo copre:
il ripristino di un backup vecchio;
il database perso;
l'istanza di sviluppo e quella vera che scrivono sulla stessa cartella del NAS.
«Riconosci le copie già presenti» si avvia dalla destinazione.
Stati di un file in una destinazione
«Copiato».
«Tolto dalla destinazione»: il file non c'è più.
«Superato»: il file in libreria è cambiato. Succede dopo «Tieni il più grande» oppure dopo una ricostruzione che registra l'hash del disco (LibraryRebuilder.cs:56-57).
«Non riuscito».
«Tolto» e «Superato» non si ricopiano mai da soli: c'è «Copia di nuovo». Una nuova copia scrive un file nuovo e la vecchia resta.
Per elemento (calcolato al momento, nessuna tabella derivata)
Un file è coperto se ha una copia Intera o Convertita. Vale anche il Fotogramma, se la destinazione dice «Solo il fotogramma».
L'elemento è:
«Copiato» se tutti i file presenti sono coperti;
«Copiato in parte» se lo sono alcuni;
«Non ancora copiato» se nessuno.
Gli elementi «eliminati», con zero file presenti, non hanno stato di copia.
Non c'è una tabella entry_export: diventerebbe vecchia a ogni file aggiunto, sostituito o rihashato. Il filtro è una EXISTS su indici export_copy(destination_id, media_id) e media(entry_id), misurata in LibraryScaleTests.
«Eliminalo e lascia che torni»
DELETE FROM entry (EntryStore.cs:166) lascia le copie senza collegamento.
Quando l'elemento torna, si ricollega per sha256. Se il CDN dà byte diversi, si ricopia.
Dove si vede
Tessere: un piccolo segno in basso a sinistra (pieno, a metà), solo se esiste almeno una destinazione. Va registrato come differenza rispetto al mockup 01.
Visualizzatore, pannello File:
«Copiato in Disco USB il 3 novembre · intero»;
«· fotogramma a 0:01 · JPG»;
«Tolto dalla destinazione» con «Copia di nuovo»;
«Non ancora copiato» con «Copia».
Scheda account:
in Contenuti, «312 su 1.204 non ancora copiati», con un collegamento al filtro;
in Impostazioni, il blocco «Copie esterne».
Filtro «Copie» in Libreria e in Contenuti: Tutti / Non ancora copiati / Copiati / Tolti o superati.
5. Dati, API, schermate
Database: una sola migrazione 0002_esportazione.sql
Supera la decisione 94: serve una riga nuova in decisioni.md. Il numero va concordato con #36 S5/S6.
Stile di 0001: stati in TEXT con CHECK, sha256 con CHECK length = 64.
Tabelle:
export_destination con una colonna scope esplicita (tutti / account). NULL non significa «tutti».
Se si rimuove un account, la sua destinazione si disattiva, non si cancella a cascata.
export_copy.
export_run ed export_item, sul modello di import_run / import_file (0001_schema.sql:218-260), per interrompere e riprendere.
video_analysis, con chiave sha256. Si può ricalcolare.
Le impostazioni predefinite vanno in setting con chiavi esportazione.*, tramite ExportSettings.
Nessuna colonna nuova in account.
Lavoro in sottofondo
ExportService segue lo schema di ImportService:
un lavoro alla volta;
RecoverAsync;
avanzamento al massimo 4 volte al secondo;
resoconto CSV.
ExportHub sta in Febe.Web.
I file arrivano da LibraryFileResolver. Uno mancante diventa «File non presente in libreria».
Le scritture SQLite vanno a gruppi, sulla coda unica.
Un LibraryChange («copie») aggiorna le tessere.
IClock per i tempi.
API (nuovo ExportApi.cs, controllo dell'Origin su ogni modifica)
GET/PUT /api/settings/export.
GET/POST /api/export/destinations, PUT/DELETE /api/export/destinations/{id}. DELETE toglie solo la configurazione.
POST …/pick-folder (desktop) e GET /api/export/folders?path= (Docker).
POST …/{id}/check e POST …/{id}/recognise: riconosce le copie già presenti.
POST /api/export/preview: numero di file, già copiati, video fermi, non convertibili, dimensione stimata.
POST /api/export/run, GET /api/export/run, POST /api/export/run/stop|resume, GET /api/export/{runId}/report.csv.
GET /api/media/{id}/frame?t=&format= (non scrive nulla) e POST /api/media/{id}/frames: zip, oppure un lavoro se c'è una destinazione.
Query della Libreria: nuovi parametri copie= e fermi=. La tessera riceve copy.
Schermate (file semplici in wwwroot, testi in it.json)
Impostazioni → Esportazione (nuova rotta): cartella generale, valori predefiniti, stato di ffmpeg e il suo percorso su Windows, nota su /esporta per Docker.
Finestra della destinazione: cartella, tipi, formati, schema con anteprima (/api/settings/naming-preview), automatica.
Scheda account → Impostazioni: il blocco «Copie esterne», sotto «Cartella».
Libreria:
l'icona CSV diventa un menu: «Esporta l'elenco (CSV)» e «Copia i file in…»;
nella barra della selezione, «Copia in…» e «Fotogrammi…»;
il filtro «Copie».
Scheda account → Contenuti: le stesse azioni.
Visualizzatore: «Copia in…», «Fotogramma», le righe delle copie e il chip «Video fermo».
Finestra «Copia in…» con un riepilogo, per esempio: «312 file · 41 già copiati, saltati · 12 video fermi · 3 HEIC copiati come sono · circa 4,2 GB».
Attività: una scheda «Esportazione» con avanzamento, Interrompi/Riprendi e resoconto.
Demo: una destinazione di prova e righe video_analysis e export_copy preparate, nella scena ?scena=esportazione. I video della demo non hanno file: la demo deve mostrare «File non presente in libreria» oppure preparare piccoli video.
Tappe
Ogni tappa è un ramo, una richiesta di unione e una verifica verde. Si aggiornano docs/stato.md e docs/decisioni.md.
E0 · documenti/esportazione
Cosa: SPECIFICA (§4.6 «esportare», nuova §4.10, §8, §10.3, §11 /esporta, §12 ffmpeg su Windows, §13 «le copie escono dal controllo di Febe», §14, §15, §16, appendice D), decisioni, risposte alle domande.
Finita quando: Alberto ha risposto e la specifica è unita. Niente codice.
E1 · funzione/esportazione-schema
Cosa: migrazione 0002 (tutte le tabelle), record, archivi, ExportSettings. Nessun cambio di comportamento.
Finita quando ci sono prove per:
database v1 + 0002, con foreign_key_check pulito;
database più nuovo rifiutato.
Va unita presto, per prendere il numero 0002.
E2 · funzione/esportazione-copie
Cosa:
destinazioni (generale e per account), validazione nei due sensi, controllo di raggiungibilità, selettore Windows, /esporta in Docker con il controllo del montaggio;
«Copia in…» dei soli originali, adozione per percorso, stati Tolto e Superato;
segni sulle tessere, filtro «Copie», righe nel visualizzatore, conteggio nell'account;
scheda Attività, pulizia dei .part limitata, spazio libero per le destinazioni.
Prove:
cartelle rifiutate;
la radice non si crea;
/esporta non montata, quindi nulla scritto;
nessuna sovrascrittura;
adozione;
stati;
esportazione e importazione che si escludono;
filtro «Copie» in LibraryScaleTests entro 250 ms;
nomi nella cartella generale e FitPath.
Finita quando, in più: schermate confrontate (§10.7) e differenze in docs/schermate/differenze.md; guida docs/guida/Esportazione.md e docs/docker.md.
Da sola copre gran parte della richiesta 3.
E3 · funzione/esportazione-formati-e-fotogrammi
Cosa:
conversione delle foto con SkiaSharp e rimuxaggio dei video;
FfmpegRunner e FrameExtractor;
GET /frame, pannello del visualizzatore, «Fotogrammi…», zip, fotogrammi nelle destinazioni;
percorso di ffmpeg su Windows.
Prove:
PNG con trasparenza → JPG;
JPG → JPG è una copia (stesso SHA);
WEBP;
HEIC copiato con nota;
data del file secondo l'impostazione;
MOV → MP4;
fotogramma a t, ogni k, N, zip.
I video si generano nella prova con lavfi, mai con campioni veri. Senza ffmpeg la prova è Inconclusive in locale, ma deve girare nella CI (.gitea/scripts/ambiente-prove.sh:19).
Finita quando: schermate confrontate e guida aggiornata (docs/windows.md per ffmpeg).
E4 · funzione/video-fermi
Cosa: VideoStillness, la coda di analisi (che cede alle sessioni), video_analysis, il chip, il filtro «Video fermi», l'opzione della destinazione.
Prove con video generati:
colore fisso con audio;
dissolvenza dal nero;
testsrc2;
adesivo che si muove;
clip di 0,4 s;
tutto nero;
rotazione;
coda in pausa con una sessione finta;
un solo ffmpeg alla volta.
Finita quando: schermate confrontate e decisione sulle soglie in decisioni.md.
E5 · funzione/esportazione-automatica
Cosa: destinazioni automatiche (coda dopo la riga di diario, giro orario, domanda «Solo i nuovi»), «Riconosci le copie già presenti», guida completa.
Prove:
Tolto e Superato non si ricopiano;
destinazione irraggiungibile in pausa e poi ripresa;
nessuna copia durante una sessione.
Finita quando: guida completata e stato.md aggiornato.
Dipendenze: E1 → E2 → E3 → E4. E5 dopo E2; ha senso dopo E4.
Domande per Alberto
Che cosa vuol dire «per ogni utente»? Febe ha un solo utente, quindi probabilmente significa «per ogni account seguito».
a) Una cartella generale più una cartella facoltativa per account, con un interruttore «Esporta questo account»: una destinazione per account.
b) Più destinazioni libere (per esempio «Disco USB» e «NAS»), ognuna per tutti gli account o per uno, con «già copiato» per destinazione.
c) Solo una cartella per account, niente cartella generale.
Convertire la libreria o solo le copie?
a) Solo le copie: la libreria resta originale.
b) Anche la libreria, con un'impostazione esplicita. Cambia sha256, phash, miniature, doppioni e _febe.jsonl, e serve una modifica della specifica (§4.7, §8.4, §9.5).
a) Sì, ma solo se scelte. Predefinito «Originale», JPG a qualità 92, e la finestra dice «con perdita».
b) Solo conversioni senza perdita (PNG, rimuxaggio).
EXIF sulle foto ricodificate.
a) In v1 solo la data del file, niente EXIF.
b) Un piccolo scrittore della data di scatto per JPG, senza dipendenze nuove.
Esportazione automatica o manuale?
a) Manuale sempre disponibile. Automatica spenta per destinazione e, quando la si accende, «Solo i nuovi».
b) Automatica accesa per ogni destinazione nuova.
Video fermi: che cosa copiare in automatico?
a) «Video intero» (si tiene l'audio).
b) «Solo il fotogramma».
c) «Video e fotogramma».
L'audio dei video fermi, quando si copia solo il fotogramma.
a) Si perde, e la finestra lo dice: «Il fotogramma non ha l'audio».
b) Un file .m4a accanto al fotogramma (copia della traccia, senza ricodifica).
Quando analizzare i video fermi.
a) In sottofondo, fuori dalle sessioni del motore, solo se c'è ffmpeg.
b) Solo a richiesta, dal visualizzatore o dalla selezione.
ffmpeg su Windows (dipendenze, regola 12).
a) Nessuna dipendenza nuova: ffmpeg dal PATH o da «Percorso di ffmpeg», con avvisi «Serve ffmpeg». Zip con la BCL, conversioni con SkiaSharp.
b) ffmpeg incluso nell'installatore: circa 80-130 MB, licenza GPL con x264. Va chiesto e approvato.
Docker.
a) Percorso /esporta attivo solo con --esporta / FEBE_ESPORTA esplicito, destinazioni come sue sottocartelle, nessun VOLUME nel Dockerfile.
b) Cartelle libere montate a mano, senza un percorso fisso.
Lo stesso post in due account (il post proprio e il taggato di un altro, SPECIFICA.md:682).
a) Una copia per account: ognuno nella sua cartella.
b) Una copia sola, nel primo account; l'altro lo mostra «Copiato».
Le storie già salvate che entrano in un'evidenza.
a) Contano come storie: una destinazione con solo «evidenza» copia anche le storie che fanno parte di un'evidenza.
b) Contano solo gli elementi nati come evidenza.
Copia tolta dalla destinazione, o file della libreria cambiato.
a) «Tolto» / «Superato», mai ricopiati da soli, con «Copia di nuovo» a richiesta. Una nuova copia non tocca la vecchia.
b) Ricopiare in automatico.
Mockup (§10.7).
a) Comporre dal mockup 13 e mettere le schermate in «Schermate senza mockup» (SPECIFICA.md:797).
b) Disegnare prima 15-impostazioni-esportazione.png e 16-copia-e-fotogrammi.png.
Pianificazione.
a) Milestone «0.3.0 — Esportazione» dopo 0.2.0, tappe E0-E5. La migrazione 0002 va concordata con #36 S5/S6.
b) Dentro 0.2.0.
Fuori da questa issue
Ricodifica VP9/AV1 → MP4. Gli scaricamenti (§6.5) sono già MP4: serve solo per i file importati. Rimandata, resta il rimuxaggio.
Conversione al momento dello scaricamento. Cambierebbe §4.7, §8.4 e §9.5.
Unire immagine e traccia audio dei post con musica (§4.9).
Stato «Probabilmente fermo», il pulsante «Controlla meglio» (freezedetect) e la serie «solo fotogrammi chiave».
Segno «video fermo» sulle tessere. Bastano il chip nel visualizzatore e il filtro.
Diario _febe-copie.jsonl nelle destinazioni. È sostituito dall'adozione per percorso. In più metterebbe nomi utente e id altrui in cartelle fuori dal controllo di Febe.
Attese crescenti e notifiche dopo 24 ore per le destinazioni irraggiungibili.
Colonna «Copiato in» nel CSV.
HEIC e AVIF: in v1 si copiano come sono. Non è verificato se ffmpeg nell'immagine Docker sappia decodificarli.
Non verificato
Niente compilato, niente eseguito.
Comandi ffmpeg, soglie e tempi sono stime: non sono misurati.
Non è verificato se il ffmpeg di Debian nell'immagine includa libx264.
Non è verificato come arrivano le «foto con musica».
Non è verificato se DriveFreeSpaceProbe gestisca i percorsi UNC.
Le righe di mosaic.js, viewer.js e library.js vengono dai resoconti dei lettori e non le ho ricontrollate.
Valgono sempre le regole di §2 della specifica e quelle di CLAUDE.md, in particolare la 11 (la libreria non cancella e non sostituisce file da sola) e la 12 (dipendenze a elenco chiuso).
**Proposta da approvare** · Specifica: `docs/SPECIFICA.md` §4.6, §4.7, §4.8, §8, §10, §11, §12
Niente codice finché Alberto non risponde alle domande in fondo (tappa E0).
---
## Che cosa chiede Alberto
1. **Fotogrammi dai video.** Un convertitore che estrae immagini dai video. Febe deve riconoscere i video che mostrano sempre la stessa foto (un «video fermo»): per quelli basta un fotogramma solo.
2. **Un formato per tutto.** Un'impostazione per avere tutti i media in un formato scelto (JPG, PNG, MP4…).
3. **Copie in cartelle esterne.** Percorsi configurabili «per ogni utente». Per ogni foto, post, video o storia Febe mostra se è già stata copiata, per intero o come fotogramma.
In breve: varie opzioni di esportazione.
---
## Che cosa c'è già
**Fotogrammi e ffmpeg**
- `VideoFrameExtractor` estrae un JPG per le miniature. Gli argomenti sono a `src/Febe.Core/Library/VideoFrameExtractor.cs:82`, il limite fisso di 30 s a `:12`.
- ffmpeg si cerca nel PATH o in un percorso esplicito (`VideoFrameExtractor.cs:20-24`). Oggi nessuna impostazione lo espone.
- Su stderr: viene svuotato e mai registrato (`VideoFrameExtractor.cs:87`, `:111`).
- `PerceptualHash` lavora su 32×32 grigi (`src/Febe.Core/Library/PerceptualHash.cs:38`). `HashOf` è interno e accetta proprio quella griglia (`:77-78`).
**Scrittura dei file**
- `SafeFileWriter` scrive un `.part`, calcola lo SHA-256 e sposta il file su un nome libero, senza mai sovrascrivere (`src/Febe.Core/Library/SafeFileWriter.cs:261-297`).
- Sa impostare `LastWriteTime` (`SafeFileWriter.cs:23`, `:157-161`).
- La data del file è un'impostazione, non una costante: `libreria.data-file-pubblicazione` (`src/Febe.Core/Library/LibrarySettings.cs:9`, `:24`).
**Conversione delle foto**
- SkiaSharp decodifica già le immagini (`ImageDecoding.cs:22-53`).
- Non decodifica HEIC, AVIF né raw (`ContentAnalysis.cs:101`).
**Nomi e cartelle**
- `NamingScheme.Validate` toglie il segmento `{account}` iniziale (`src/Febe.Core/Library/NamingScheme.cs:136-140`).
- `FitPath` accorcia i percorsi lunghi per Windows (`src/Febe.Core/Library/LibraryLayout.cs:84-89`, `WindowsFileNames.cs:20`, `:93`).
- La cartella di un account può stare fuori dalla Libreria (SPECIFICA.md:185). Le regole sono in `ResolveFolder` (`AccountsApi.cs:642-671`).
**Disco, avvisi, pulizia**
- Lo spazio libero minimo predefinito è 10 GB / 5 % (`src/Febe.Core/Alerts/DiskSpace.cs:65`).
- All'avvio `CleanTemporaryFilesAsync` toglie i file temporanei (`src/Febe.App/FebeApp.cs:784-805`), in modo ricorsivo (`SafeFileWriter.cs:181`).
**Motore**
- «Sessione in corso» si legge da `EngineRuntime.CurrentSession != null` (`src/Febe.Core/Engine/EngineRuntime.cs:60`), come fa Monitor (`Monitor.cs:105-107`).
- Non si legge da `IsRunning`, che è vero per ore (`EngineRuntime.cs:87-91`).
- C'è anche `UserIsDriving` (`Monitor.cs:95`).
**Avvisi di cambiamento**
- `LibraryChange(At, AccountId?, Reason)` non porta id di media né di elementi (`src/Febe.Web/Library/FebeLibrary.cs:89`).
- Chi è lento perde le notifiche più vecchie (`:93-94`), quindi non può alimentare una coda.
**Database**
- Esiste solo `src/Febe.Data/Migrations/0001_schema.sql`, nessun 0002 su nessun ramo.
- Gli stati sono `TEXT` con `CHECK` (`0001_schema.sql:56`, `:63`, `:95`).
- La decisione 94 dice «nessuna migrazione nuova» (`docs/decisioni.md:94`).
- La prova di scala con 200.000 elementi esiste già: `tests/Febe.Tests/Data/LibraryScaleTests.cs`, con `IndexBoundMs = 250` (`:22`).
**Docker**
- `VOLUME ["/dati", "/libreria", "/importa"]` (`docker/Dockerfile:120`).
- L'entrypoint cambia il proprietario solo della radice di /libreria (`docker/entrypoint.sh:59-61`).
**Esportazione e demo**
- Oggi l'unica esportazione è l'elenco CSV (`CsvExport.cs:20`, `/api/entries/export`).
- Copie esterne, conversioni, fotogrammi a richiesta e video fermi: non trovati.
- I video della demo hanno solo la copertina (`src/Febe.Web/Demo/DemoSeeder.cs:70`). DemoFileResolver restituisce file solo per le foto.
**Mockup**
- Nessun mockup per queste schermate. I mockup 00-14 sono elencati a SPECIFICA.md:775-791.
---
## Proposta
Il principio: **un'esportazione copia file che stanno già in libreria verso una cartella esterna (destinazione)**.
- Strada facendo, un file può essere convertito o sostituito da un fotogramma.
- La libreria non cambia mai.
- È solo lavoro sul disco: niente Instagram, niente CDN, niente Governatore, niente `action_log`. Un file mancante non si riscarica.
### 1. Fotogrammi e video fermi
**Fotogrammi a richiesta**
- `VideoFrameExtractor` diventa `FrameExtractor`. Il metodo attuale per le miniature resta.
- I fotogrammi si possono prendere in tre modi:
- un fotogramma a un istante;
- uno ogni k secondi;
- N in tutto.
- Formati: JPG o PNG, a piena risoluzione.
- Un `FfmpegRunner` comune gestisce:
- priorità BelowNormal;
- annullamento;
- ambiente `WithoutSecrets()`;
- stderr mai registrato;
- un limite di tempo proporzionato alla durata del video, non i 30 s fissi.
- **Visualizzatore:** l'azione «Fotogramma» compare solo per i video e solo se c'è ffmpeg.
- «Questo istante» usa il punto in cui è fermo il video, con anteprima.
- Ci sono anche «Ogni k secondi» e «N fotogrammi», con il conteggio in anteprima.
- Uscita: «Scarica» (un file, o uno zip per più file, con System.IO.Compression della BCL) oppure una destinazione.
- **Selezione multipla** (Libreria e Contenuti dell'account): un pulsante «Fotogrammi…» con le stesse opzioni, eseguite come esportazione. Le foto nella selezione si saltano e la finestra lo dice.
- **Nomi:** suffisso fisso sull'ultimo segmento, senza nuovi segnaposto:
- `_fotogramma` per un video fermo;
- `_t0m12s340` per un istante;
- `_f001` per una serie.
- Il suffisso si aggiunge **prima** di `FitPath`, altrimenti sfora i 240 caratteri.
- **Uno slot riservato** ai fotogrammi singoli interattivi, così l'anteprima non aspetta dietro una conversione lunga. Mentre si scorre il video, le richieste si raggruppano.
**Riconoscere i video fermi**
- Nuovo `VideoStillness`, solo ffmpeg e ffprobe.
- **Due esiti in v1:** «Fermo» o «In movimento», più «Non analizzabile». Niente stato «Incerto» e niente freezedetect.
- Come si decide:
1. **Filtro veloce con ffprobe:** dimensioni dei pacchetti non chiave. Se sono grandi, il video si muove e l'analisi si ferma.
2. **Un solo processo ffmpeg per video.** Prende 7 campioni con più `-ss` nello stesso comando, in grigi su stdout.
- pHash a 32×32 con `HashOf`: tutte le coppie entro 2 bit.
- Differenza media dei pixel a 64×64 sotto 1,5/255.
3. Il fotogramma da usare è il campione più nitido. Il suo istante si salva in ms.
- Casi da gestire:
- video sotto 1 s;
- durata ignota o frequenza variabile → «Non analizzabile»;
- dissolvenze dal nero (i campioni troppo scuri si scartano);
- video tutto nero: non va scartato del tutto;
- rotazione.
- Le soglie sono una prima stima. Si tarano su video generati nelle prove. Un numero `algo` permette di rianalizzare senza migrazione.
- **Quando gira:**
- in sottofondo, un ffmpeg alla volta, `-threads 1`, priorità BelowNormal;
- non durante l'ingresso in libreria;
- la coda è una query: «video presenti il cui sha256 non è in `video_analysis`». Vale per scaricamenti, importazioni e ricostruzioni. Un `LibraryChange` serve al massimo da sveglia.
- **Cede al motore.** Non avvia un nuovo lavoro mentre `CurrentSession != null` o `UserIsDriving`.
- Un lavoro già partito non si può mettere in pausa in modo portabile.
- Per questo l'analisi e le conversioni lunghe partono solo fuori sessione.
- **Senza ffmpeg** non c'è analisi, e Impostazioni → Esportazione mostra «Serve ffmpeg».
- **Interfaccia:**
- nel visualizzatore, pannello File, il chip «Video fermo» («Un'immagine sola per tutto il video: basta un fotogramma») con «Salva il fotogramma»;
- nel filtro «Tipo» della Libreria, la voce «Video fermi»;
- nessun segno sulla tessera in v1.
Nota su «foto con musica»: probabilmente i post foto con musica arrivano come immagine più una traccia audio separata, e Febe salva già solo l'immagine. I video fermi sarebbero allora soprattutto storie e reel fatti da una foto. **Non verificato su un campione ripulito.** Non si progetta nessun lettore su questa ipotesi (regola 9).
### 2. Formato di esportazione
- Ci sono **valori predefiniti** in Impostazioni → Esportazione. Ogni destinazione e ogni singola «Copia in…» li può cambiare.
- Le conversioni nascono **solo nella destinazione**. Il perché: sha256, phash, chiave della miniatura, controllo dei doppioni e `_febe.jsonl` dipendono dai byte originali (`LibraryIngest.cs:232-237`).
- Convertire la libreria stessa **non è vietato**. SPECIFICA.md:92 lo permette «per una scelta esplicita di Alberto». Però cambia identità e regole (§4.7, §8.4, §9.5): vedi domanda 2.
| Origine | Scelta | Come | Perdita |
|---|---|---|---|
| qualunque | **Originale** (predefinito) | copia byte per byte, verificata con SHA-256 | nessuna, EXIF compreso |
| JPG → JPG, MP4 H.264+AAC → MP4 | — | copia byte per byte: mai ricodificare lo stesso formato | nessuna |
| PNG, WEBP, GIF (primo fotogramma), BMP | JPG (qualità 92) | SkiaSharp | **con perdita**; EXIF tolto; rotazione applicata; trasparenza su bianco |
| foto decodificabile | PNG | SkiaSharp | senza perdita; file più grande; EXIF tolto |
| foto decodificabile | WEBP (qualità 90) | SkiaSharp | con perdita; EXIF tolto |
| HEIC, AVIF, raw | qualunque | non decodificabile | si copia l'originale, con una nota nel resoconto |
| MOV/MKV con H.264/HEVC + AAC | MP4 | rimuxaggio `-c copy -movflags +faststart` | nessuna |
| VP9, AV1, altri | MP4 | ricodifica | **rimandata** (vedi «Fuori») |
| video fermo | fotogramma JPG/PNG | §1 | la risoluzione è quella del video; la finestra lo dice |
Regole comuni:
- La data del file segue l'impostazione `libreria.data-file-pubblicazione`, fotogrammi compresi.
- Nei file MP4 si scrive `creation_time`.
- Per i profili si tiene `{codice}`, il prefisso SHA dell'origine, anche dopo la conversione.
- Su Windows serve una nuova impostazione «Percorso di ffmpeg», che usa il percorso esplicito già previsto.
- Senza ffmpeg, MP4, fotogrammi e video fermi sono spenti con la nota «Serve ffmpeg».
- Le foto si convertono comunque.
**Da verificare prima di costruire:** è probabile che i file scaricati siano quasi tutti JPEG e MP4 H.264, quindi «tutto in JPG/MP4» sarebbe per lo più una semplice copia. Va controllato con un conteggio dei formati nel database di Alberto.
### 3. Percorsi esterni
**Modello**, da confermare con la domanda 1:
- una **cartella di esportazione generale**;
- una **cartella per account**, facoltativa, che la sostituisce. È lo stesso schema della «Cartella» dell'account (`account.js:389-413`);
- un interruttore «Esporta questo account».
Così ogni account ha **una sola destinazione effettiva** e «già copiato» è un sì o un no.
Ogni destinazione ha:
- cartella;
- tipi di contenuto (post foto, post video, storie, evidenza, taggati, profilo);
- formati;
- opzione per i video fermi;
- schema dei nomi: «Come la libreria» (predefinito) oppure uno proprio, validato da `Validate`;
- interruttore «Automatica».
**Nomi nella cartella generale:** Febe aggiunge sempre lei il segmento con il nome utente ripulito. `Validate` toglie `{account}`, e senza quel segmento gli account si scontrerebbero.
**Cartelle rifiutate:**
- dentro **o contenente** una di queste: Dati, Libreria, una cartella di account (anche fuori dalla Libreria), /importa;
- la radice di un disco o di una condivisione (proposta nuova).
Si ricontrolla quando cambia la cartella di un account. Lettere di unità e percorsi UNC possono puntare allo stesso posto: lo si scopre con un piccolo file di prova, non confrontando le stringhe.
**Windows**
- Selettore nativo (`INativeShell.PickFolderAsync`).
- Percorsi assoluti, UNC e di rete ammessi.
**Docker**
- Un nuovo percorso `/esporta`, attivo **solo** se si dà `--esporta` / `FEBE_ESPORTA` in modo esplicito.
- **Niente `VOLUME`** nel Dockerfile. Un volume anonimo farebbe sembrare /esporta montata e riempirebbe in silenzio il docker.img di Unraid.
- Secondo controllo: /esporta deve essere un punto di montaggio, letto da `/proc/self/mountinfo`. È codice nuovo: oggi non esiste.
- Le destinazioni sono sottocartelle di /esporta, scelte da un elenco di cartelle come per le sorgenti di importazione. `..` è rifiutato.
- Si cambia il proprietario solo della radice, mai in modo ricorsivo.
- Da aggiornare: compose.yml, unraid/febe.xml, docs/docker.md, §11.
**Mai cancellare, mai sovrascrivere**
- Si scrive solo con `SafeFileWriter`.
- **La radice della destinazione non si crea mai.** Un disco o una condivisione assente non deve diventare una cartella locale. Le sottocartelle dello schema sì.
- Togliere una destinazione cancella solo la configurazione: «I file già copiati restano dove sono».
- Eliminare un elemento dalla libreria non tocca le copie: «Le copie esterne restano».
- **Pulizia dei `.part`:** solo nelle cartelle registrate in lavori non finiti e solo per i `.part` più vecchi di qualche ora. Mai una scansione ricorsiva della destinazione all'avvio: è lenta su SMB e potrebbe togliere un `.part` di un'altra istanza.
**Destinazione irraggiungibile**
- Prima di ogni gruppo di copie Febe controlla che la cartella esista, con un file di prova `.febe-prova-*.part` scritto e tolto.
- Se non va, la destinazione si mette in pausa. Lo stato si vede in Impostazioni e in Attività.
- Il giro di recupero orario riprova da solo.
- Niente attese crescenti, niente notifica dopo 24 ore, **mai la striscia rossa** (che resta per il motore).
- I controlli sul disco esterno sono asincroni, con un tempo breve, e mai sul percorso della richiesta: una condivisione staccata non deve bloccare il visualizzatore.
- **Spazio:** per le destinazioni non valgono 10 GB / 5 %, che bloccherebbero ogni chiavetta. Basta «spazio libero ≥ prossimo file + margine».
- **FAT32/exFAT:** limite di 4 GB per file e date a 2 s. La verifica realistica è sulla dimensione.
**Manuale e automatica**
- **Manuale («Copia in…»)** da:
- la selezione;
- il filtro corrente;
- il visualizzatore;
- la scheda dell'account (Contenuti, dove oggi manca un'azione su tutto il filtro).
- **Automatica:** dopo la riga di diario di un elemento, l'elemento entra in coda. In più c'è un giro di recupero all'avvio e ogni ora.
- Quando la si accende, Febe chiede: «Copia anche i 12.430 già in libreria?» oppure **«Solo i nuovi»**.
- Le copie, sia di byte sia di ffmpeg, partono **fuori dalle sessioni del motore**.
- Esportazione e importazione o ricostruzione non girano insieme, come in `SettingsApi.cs:228-231`.
### 4. Il segno «già copiato»
**Per file**
- Una riga `export_copy` per file e destinazione, con:
- sha256 dell'origine;
- variante (Intero, Convertito, Fotogramma);
- formato e istante del fotogramma;
- percorso relativo, byte e sha256 della copia;
- data e stato.
- La chiave si basa sullo sha256, non sull'id Instagram: gli elementi importati possono non averlo.
- «Copia di nuovo» **aggiorna la riga esistente**, non ne aggiunge una seconda.
**Adozione per percorso** (evita copie «(2)» e sostituisce un diario nella destinazione)
- Prima di scrivere, Febe calcola il percorso di arrivo.
- Se lì c'è già un file con la stessa dimensione (e lo stesso SHA per le copie byte per byte), lo **adotta** come copia invece di scriverlo.
- Questo copre:
- il ripristino di un backup vecchio;
- il database perso;
- l'istanza di sviluppo e quella vera che scrivono sulla stessa cartella del NAS.
- «Riconosci le copie già presenti» si avvia dalla destinazione.
**Stati di un file in una destinazione**
- «Copiato».
- «Tolto dalla destinazione»: il file non c'è più.
- «Superato»: il file in libreria è cambiato. Succede dopo «Tieni il più grande» **oppure** dopo una ricostruzione che registra l'hash del disco (`LibraryRebuilder.cs:56-57`).
- «Non riuscito».
- «Tolto» e «Superato» non si ricopiano mai da soli: c'è «Copia di nuovo». Una nuova copia scrive un file nuovo e la vecchia resta.
**Per elemento** (calcolato al momento, nessuna tabella derivata)
- Un file è **coperto** se ha una copia Intera o Convertita. Vale anche il Fotogramma, se la destinazione dice «Solo il fotogramma».
- L'elemento è:
- «Copiato» se tutti i file presenti sono coperti;
- «Copiato in parte» se lo sono alcuni;
- «Non ancora copiato» se nessuno.
- Gli elementi «eliminati», con zero file presenti, non hanno stato di copia.
- Non c'è una tabella `entry_export`: diventerebbe vecchia a ogni file aggiunto, sostituito o rihashato. Il filtro è una `EXISTS` su indici `export_copy(destination_id, media_id)` e `media(entry_id)`, misurata in `LibraryScaleTests`.
**«Eliminalo e lascia che torni»**
- `DELETE FROM entry` (`EntryStore.cs:166`) lascia le copie senza collegamento.
- Quando l'elemento torna, si ricollega per sha256. Se il CDN dà byte diversi, si ricopia.
**Dove si vede**
- **Tessere:** un piccolo segno in basso a sinistra (pieno, a metà), solo se esiste almeno una destinazione. Va registrato come differenza rispetto al mockup 01.
- **Visualizzatore, pannello File:**
- «Copiato in Disco USB il 3 novembre · intero»;
- «· fotogramma a 0:01 · JPG»;
- «Tolto dalla destinazione» con «Copia di nuovo»;
- «Non ancora copiato» con «Copia».
- **Scheda account:**
- in Contenuti, «312 su 1.204 non ancora copiati», con un collegamento al filtro;
- in Impostazioni, il blocco «Copie esterne».
- **Filtro «Copie»** in Libreria e in Contenuti: Tutti / Non ancora copiati / Copiati / Tolti o superati.
### 5. Dati, API, schermate
**Database: una sola migrazione `0002_esportazione.sql`**
- Supera la decisione 94: serve una riga nuova in decisioni.md. Il numero va concordato con #36 S5/S6.
- Stile di 0001: stati in `TEXT` con `CHECK`, sha256 con `CHECK length = 64`.
- Tabelle:
- `export_destination` con una colonna **`scope`** esplicita (`tutti` / `account`). NULL non significa «tutti».
- Se si rimuove un account, la sua destinazione si **disattiva**, non si cancella a cascata.
- `export_copy`.
- `export_run` ed `export_item`, sul modello di `import_run` / `import_file` (`0001_schema.sql:218-260`), per interrompere e riprendere.
- `video_analysis`, con chiave sha256. Si può ricalcolare.
- Le impostazioni predefinite vanno in `setting` con chiavi `esportazione.*`, tramite `ExportSettings`.
- Nessuna colonna nuova in `account`.
**Lavoro in sottofondo**
- `ExportService` segue lo schema di ImportService:
- un lavoro alla volta;
- `RecoverAsync`;
- avanzamento al massimo 4 volte al secondo;
- resoconto CSV.
- `ExportHub` sta in Febe.Web.
- I file arrivano da `LibraryFileResolver`. Uno mancante diventa «File non presente in libreria».
- Le scritture SQLite vanno a gruppi, sulla coda unica.
- Un `LibraryChange` («copie») aggiorna le tessere.
- `IClock` per i tempi.
**API** (nuovo `ExportApi.cs`, controllo dell'Origin su ogni modifica)
- `GET/PUT /api/settings/export`.
- `GET/POST /api/export/destinations`, `PUT/DELETE /api/export/destinations/{id}`. DELETE toglie solo la configurazione.
- `POST …/pick-folder` (desktop) e `GET /api/export/folders?path=` (Docker).
- `POST …/{id}/check` e `POST …/{id}/recognise`: riconosce le copie già presenti.
- `POST /api/export/preview`: numero di file, già copiati, video fermi, non convertibili, dimensione stimata.
- `POST /api/export/run`, `GET /api/export/run`, `POST /api/export/run/stop|resume`, `GET /api/export/{runId}/report.csv`.
- `GET /api/media/{id}/frame?t=&format=` (non scrive nulla) e `POST /api/media/{id}/frames`: zip, oppure un lavoro se c'è una destinazione.
- Query della Libreria: nuovi parametri `copie=` e `fermi=`. La tessera riceve `copy`.
**Schermate** (file semplici in wwwroot, testi in it.json)
1. **Impostazioni → Esportazione** (nuova rotta): cartella generale, valori predefiniti, stato di ffmpeg e il suo percorso su Windows, nota su /esporta per Docker.
2. **Finestra della destinazione:** cartella, tipi, formati, schema con anteprima (`/api/settings/naming-preview`), automatica.
3. **Scheda account → Impostazioni:** il blocco «Copie esterne», sotto «Cartella».
4. **Libreria:**
- l'icona CSV diventa un menu: «Esporta l'elenco (CSV)» e «Copia i file in…»;
- nella barra della selezione, «Copia in…» e «Fotogrammi…»;
- il filtro «Copie».
5. **Scheda account → Contenuti:** le stesse azioni.
6. **Visualizzatore:** «Copia in…», «Fotogramma», le righe delle copie e il chip «Video fermo».
7. **Finestra «Copia in…»** con un riepilogo, per esempio: «312 file · 41 già copiati, saltati · 12 video fermi · 3 HEIC copiati come sono · circa 4,2 GB».
8. **Attività:** una scheda «Esportazione» con avanzamento, Interrompi/Riprendi e resoconto.
**Demo:** una destinazione di prova e righe `video_analysis` e `export_copy` preparate, nella scena `?scena=esportazione`. I video della demo non hanno file: la demo deve mostrare «File non presente in libreria» oppure preparare piccoli video.
---
## Tappe
Ogni tappa è un ramo, una richiesta di unione e una verifica verde. Si aggiornano `docs/stato.md` e `docs/decisioni.md`.
**E0 · `documenti/esportazione`**
- Cosa: SPECIFICA (§4.6 «esportare», nuova §4.10, §8, §10.3, §11 `/esporta`, §12 ffmpeg su Windows, §13 «le copie escono dal controllo di Febe», §14, §15, §16, appendice D), decisioni, risposte alle domande.
- Finita quando: Alberto ha risposto e la specifica è unita. Niente codice.
**E1 · `funzione/esportazione-schema`**
- Cosa: migrazione 0002 (tutte le tabelle), record, archivi, `ExportSettings`. Nessun cambio di comportamento.
- Finita quando ci sono prove per:
- database v1 + 0002, con `foreign_key_check` pulito;
- database più nuovo rifiutato.
- Va unita presto, per prendere il numero 0002.
**E2 · `funzione/esportazione-copie`**
- Cosa:
- destinazioni (generale e per account), validazione nei due sensi, controllo di raggiungibilità, selettore Windows, `/esporta` in Docker con il controllo del montaggio;
- «Copia in…» dei soli **originali**, adozione per percorso, stati Tolto e Superato;
- segni sulle tessere, filtro «Copie», righe nel visualizzatore, conteggio nell'account;
- scheda Attività, pulizia dei `.part` limitata, spazio libero per le destinazioni.
- Prove:
- cartelle rifiutate;
- la radice non si crea;
- /esporta non montata, quindi nulla scritto;
- nessuna sovrascrittura;
- adozione;
- stati;
- esportazione e importazione che si escludono;
- filtro «Copie» in `LibraryScaleTests` entro 250 ms;
- nomi nella cartella generale e `FitPath`.
- Finita quando, in più: schermate confrontate (§10.7) e differenze in `docs/schermate/differenze.md`; guida `docs/guida/Esportazione.md` e `docs/docker.md`.
- Da sola copre gran parte della richiesta 3.
**E3 · `funzione/esportazione-formati-e-fotogrammi`**
- Cosa:
- conversione delle foto con SkiaSharp e rimuxaggio dei video;
- `FfmpegRunner` e `FrameExtractor`;
- `GET /frame`, pannello del visualizzatore, «Fotogrammi…», zip, fotogrammi nelle destinazioni;
- percorso di ffmpeg su Windows.
- Prove:
- PNG con trasparenza → JPG;
- JPG → JPG è una copia (stesso SHA);
- WEBP;
- HEIC copiato con nota;
- data del file secondo l'impostazione;
- MOV → MP4;
- fotogramma a t, ogni k, N, zip.
- I video si generano nella prova con lavfi, mai con campioni veri. Senza ffmpeg la prova è Inconclusive in locale, ma deve girare nella CI (`.gitea/scripts/ambiente-prove.sh:19`).
- Finita quando: schermate confrontate e guida aggiornata (`docs/windows.md` per ffmpeg).
**E4 · `funzione/video-fermi`**
- Cosa: `VideoStillness`, la coda di analisi (che cede alle sessioni), `video_analysis`, il chip, il filtro «Video fermi», l'opzione della destinazione.
- Prove con video generati:
- colore fisso con audio;
- dissolvenza dal nero;
- `testsrc2`;
- adesivo che si muove;
- clip di 0,4 s;
- tutto nero;
- rotazione;
- coda in pausa con una sessione finta;
- un solo ffmpeg alla volta.
- Finita quando: schermate confrontate e decisione sulle soglie in decisioni.md.
**E5 · `funzione/esportazione-automatica`**
- Cosa: destinazioni automatiche (coda dopo la riga di diario, giro orario, domanda «Solo i nuovi»), «Riconosci le copie già presenti», guida completa.
- Prove:
- Tolto e Superato non si ricopiano;
- destinazione irraggiungibile in pausa e poi ripresa;
- nessuna copia durante una sessione.
- Finita quando: guida completata e stato.md aggiornato.
Dipendenze: E1 → E2 → E3 → E4. E5 dopo E2; ha senso dopo E4.
---
## Domande per Alberto
1. **Che cosa vuol dire «per ogni utente»?** Febe ha un solo utente, quindi probabilmente significa «per ogni account seguito».
- a) **Una cartella generale più una cartella facoltativa per account, con un interruttore «Esporta questo account»: una destinazione per account.**
- b) Più destinazioni libere (per esempio «Disco USB» e «NAS»), ognuna per tutti gli account o per uno, con «già copiato» per destinazione.
- c) Solo una cartella per account, niente cartella generale.
2. **Convertire la libreria o solo le copie?**
- a) **Solo le copie: la libreria resta originale.**
- b) Anche la libreria, con un'impostazione esplicita. Cambia sha256, phash, miniature, doppioni e `_febe.jsonl`, e serve una modifica della specifica (§4.7, §8.4, §9.5).
3. **Quali formati offrire?**
- a) **Foto: Originale / JPG / PNG / WEBP. Video: Originale / MP4 (solo rimuxaggio).**
- b) Come (a), più la ricodifica VP9/AV1 → MP4.
- c) Solo JPG e MP4.
4. **Le conversioni con perdita vanno bene?**
- a) **Sì, ma solo se scelte. Predefinito «Originale», JPG a qualità 92, e la finestra dice «con perdita».**
- b) Solo conversioni senza perdita (PNG, rimuxaggio).
5. **EXIF sulle foto ricodificate.**
- a) **In v1 solo la data del file, niente EXIF.**
- b) Un piccolo scrittore della data di scatto per JPG, senza dipendenze nuove.
6. **Esportazione automatica o manuale?**
- a) **Manuale sempre disponibile. Automatica spenta per destinazione e, quando la si accende, «Solo i nuovi».**
- b) Automatica accesa per ogni destinazione nuova.
7. **Video fermi: che cosa copiare in automatico?**
- a) **«Video intero» (si tiene l'audio).**
- b) «Solo il fotogramma».
- c) «Video e fotogramma».
8. **L'audio dei video fermi, quando si copia solo il fotogramma.**
- a) **Si perde, e la finestra lo dice: «Il fotogramma non ha l'audio».**
- b) Un file `.m4a` accanto al fotogramma (copia della traccia, senza ricodifica).
9. **Quando analizzare i video fermi.**
- a) **In sottofondo, fuori dalle sessioni del motore, solo se c'è ffmpeg.**
- b) Solo a richiesta, dal visualizzatore o dalla selezione.
10. **ffmpeg su Windows (dipendenze, regola 12).**
- a) **Nessuna dipendenza nuova: ffmpeg dal PATH o da «Percorso di ffmpeg», con avvisi «Serve ffmpeg». Zip con la BCL, conversioni con SkiaSharp.**
- b) ffmpeg incluso nell'installatore: circa 80-130 MB, licenza GPL con x264. Va chiesto e approvato.
11. **Docker.**
- a) **Percorso `/esporta` attivo solo con `--esporta` / `FEBE_ESPORTA` esplicito, destinazioni come sue sottocartelle, nessun `VOLUME` nel Dockerfile.**
- b) Cartelle libere montate a mano, senza un percorso fisso.
12. **Lo stesso post in due account** (il post proprio e il taggato di un altro, SPECIFICA.md:682).
- a) **Una copia per account: ognuno nella sua cartella.**
- b) Una copia sola, nel primo account; l'altro lo mostra «Copiato».
13. **Le storie già salvate che entrano in un'evidenza.**
- a) **Contano come storie: una destinazione con solo «evidenza» copia anche le storie che fanno parte di un'evidenza.**
- b) Contano solo gli elementi nati come evidenza.
14. **Copia tolta dalla destinazione, o file della libreria cambiato.**
- a) **«Tolto» / «Superato», mai ricopiati da soli, con «Copia di nuovo» a richiesta. Una nuova copia non tocca la vecchia.**
- b) Ricopiare in automatico.
15. **Mockup (§10.7).**
- a) **Comporre dal mockup 13 e mettere le schermate in «Schermate senza mockup» (SPECIFICA.md:797).**
- b) Disegnare prima `15-impostazioni-esportazione.png` e `16-copia-e-fotogrammi.png`.
16. **Pianificazione.**
- a) **Milestone «0.3.0 — Esportazione» dopo 0.2.0, tappe E0-E5. La migrazione 0002 va concordata con #36 S5/S6.**
- b) Dentro 0.2.0.
---
## Fuori da questa issue
- **Ricodifica VP9/AV1 → MP4.** Gli scaricamenti (§6.5) sono già MP4: serve solo per i file importati. Rimandata, resta il rimuxaggio.
- **Conversione al momento dello scaricamento.** Cambierebbe §4.7, §8.4 e §9.5.
- **Unire immagine e traccia audio** dei post con musica (§4.9).
- **Stato «Probabilmente fermo»**, il pulsante «Controlla meglio» (freezedetect) e la serie «solo fotogrammi chiave».
- **Segno «video fermo» sulle tessere.** Bastano il chip nel visualizzatore e il filtro.
- **Diario `_febe-copie.jsonl` nelle destinazioni.** È sostituito dall'adozione per percorso. In più metterebbe nomi utente e id altrui in cartelle fuori dal controllo di Febe.
- **Attese crescenti e notifiche dopo 24 ore** per le destinazioni irraggiungibili.
- **Colonna «Copiato in» nel CSV.**
- **HEIC e AVIF:** in v1 si copiano come sono. Non è verificato se ffmpeg nell'immagine Docker sappia decodificarli.
**Non verificato**
- Niente compilato, niente eseguito.
- Comandi ffmpeg, soglie e tempi sono stime: non sono misurati.
- Non è verificato se il ffmpeg di Debian nell'immagine includa libx264.
- Non è verificato come arrivano le «foto con musica».
- Non è verificato se `DriveFreeSpaceProbe` gestisca i percorsi UNC.
- Le righe di `mosaic.js`, `viewer.js` e `library.js` vengono dai resoconti dei lettori e non le ho ricontrollate.
---
Valgono sempre le regole di §2 della specifica e quelle di `CLAUDE.md`, in particolare la 11 (la libreria non cancella e non sostituisce file da sola) e la 12 (dipendenze a elenco chiuso).
Destinazioni: una cartella generale più una cartella facoltativa per account, con l'interruttore «Esporta questo account».
Conversione: sia per le copie sia per la libreria, entrambe spente di base. Per la libreria l'originale resta accanto: il convertito si aggiunge all'elemento, così vale la regola 11.
Formati: foto Originale / JPG / PNG / WEBP; video Originale / MP4, con il solo cambio di contenitore.
Perdita: ammessa solo se scelta. JPG a qualità 92, con l'avviso «con perdita».
Metadati: si copia tutto il possibile, così il convertito è la stessa foto con un'altra estensione: EXIF (orientamento compreso), profilo colore ICC, XMP, data del file; per i video -map_metadata equivalente.
Quando: la manuale c'è sempre. L'automatica è spenta per destinazione e, alla prima accensione, chiede «Solo i nuovi».
Video fermo: si copia il video intero.
Solo fotogramma: l'audio si perde e la finestra lo dice.
Analisi dei video fermi: solo a richiesta, dal visualizzatore o da una selezione.
ffmpeg: NON si usa. Vale per nessun componente esterno, né programmi né librerie: tutto il codice è scritto in casa. È una regola generale, per Febe e per gli altri progetti. Chiarimenti:
Anche le librerie: SkiaSharp si toglie e si sostituisce. Restano solo .NET/BCL, SQLite, il browser (regola 4) e MSTest per le prove.
ffmpeg/ffprobe usati oggi (miniature e metadati dei video importati, immagine Docker): si tolgono e si sostituiscono con codice nostro.
Decoder H.264 completo scritto da noi, con fotogrammi I, P e B.
Encoder nostri: JPG, PNG e WEBP senza perdita. Il WEBP con perdita resta fuori come formato di arrivo.
Docker: /esporta, attivo solo se lo dichiari.
Stesso post in due account: entrambe le scelte, configurabili (una copia per account oppure una sola).
Storia entrata in un'evidenza: conta anche come evidenza.
Copia tolta o file cambiato: «Tolto» / «Superato», mai ricopiato da solo.
Mockup: le schermate si compongono dai mockup esistenti e si registrano fra le «Schermate senza mockup».
Traguardo: nuovo «0.3.0 — Esportazione».
Tappe riviste, dopo la regola «niente componenti esterni»
E0: specifica, decisioni, §3 (dipendenze) e regola nuova in CLAUDE.md.
C1 · codec immagini in casa: decoder JPEG (base e progressivo), PNG, WEBP (con e senza perdita), GIF e BMP; encoder JPEG, PNG e WEBP senza perdita; ridimensionamento; copia dei metadati. Via SkiaSharp.
C2 · video senza ffprobe: durata, dimensioni e rotazione dal lettore MP4 nostro; cambio di contenitore MOV → MP4.
C3 · decoder H.264 nostro: miniature dei video importati. Via ffmpeg da codice, immagine Docker, CI e documenti.
E1: schema 0002.
E2: copie nelle cartelle esterne e segno «già copiato».
E3: conversione dei formati (copie e libreria) e fotogrammi.
E4: video fermi, a richiesta.
E5: esportazione automatica.
## Risposte di Alberto (18 novembre 2026, in chat)
1. **Destinazioni**: una cartella generale più una cartella facoltativa per account, con l'interruttore «Esporta questo account».
2. **Conversione**: sia per le copie sia per la libreria, **entrambe spente di base**. Per la libreria l'originale **resta accanto**: il convertito si aggiunge all'elemento, così vale la regola 11.
3. **Formati**: foto Originale / JPG / PNG / WEBP; video Originale / MP4, con il solo cambio di contenitore.
4. **Perdita**: ammessa solo se scelta. JPG a qualità 92, con l'avviso «con perdita».
5. **Metadati**: si copia **tutto il possibile**, così il convertito è la stessa foto con un'altra estensione: EXIF (orientamento compreso), profilo colore ICC, XMP, data del file; per i video `-map_metadata` equivalente.
6. **Quando**: la manuale c'è sempre. L'automatica è spenta per destinazione e, alla prima accensione, chiede «Solo i nuovi».
7. **Video fermo**: si copia il video intero.
8. **Solo fotogramma**: l'audio si perde e la finestra lo dice.
9. **Analisi dei video fermi**: **solo a richiesta**, dal visualizzatore o da una selezione.
10. **ffmpeg**: **NON si usa**. Vale per **nessun componente esterno**, né programmi né librerie: tutto il codice è scritto in casa. È una regola generale, per Febe e per gli altri progetti. Chiarimenti:
- **Anche le librerie**: SkiaSharp si toglie e si sostituisce. Restano solo .NET/BCL, SQLite, il browser (regola 4) e MSTest per le prove.
- ffmpeg/ffprobe usati oggi (miniature e metadati dei video importati, immagine Docker): **si tolgono e si sostituiscono** con codice nostro.
- **Decoder H.264 completo** scritto da noi, con fotogrammi I, P e B.
- Encoder nostri: **JPG, PNG e WEBP senza perdita**. Il WEBP con perdita resta fuori come formato di arrivo.
11. **Docker**: `/esporta`, attivo solo se lo dichiari.
12. **Stesso post in due account**: **entrambe le scelte, configurabili** (una copia per account oppure una sola).
13. **Storia entrata in un'evidenza**: conta anche come evidenza.
14. **Copia tolta o file cambiato**: «Tolto» / «Superato», mai ricopiato da solo.
15. **Mockup**: le schermate si compongono dai mockup esistenti e si registrano fra le «Schermate senza mockup».
16. **Traguardo**: nuovo «0.3.0 — Esportazione».
## Tappe riviste, dopo la regola «niente componenti esterni»
- **E0**: specifica, decisioni, §3 (dipendenze) e regola nuova in `CLAUDE.md`.
- **C1 · codec immagini in casa**: decoder JPEG (base e progressivo), PNG, WEBP (con e senza perdita), GIF e BMP; encoder JPEG, PNG e WEBP senza perdita; ridimensionamento; copia dei metadati. **Via SkiaSharp.**
- **C2 · video senza ffprobe**: durata, dimensioni e rotazione dal lettore MP4 nostro; cambio di contenitore MOV → MP4.
- **C3 · decoder H.264 nostro**: miniature dei video importati. **Via ffmpeg** da codice, immagine Docker, CI e documenti.
- **E1**: schema 0002.
- **E2**: copie nelle cartelle esterne e segno «già copiato».
- **E3**: conversione dei formati (copie e libreria) e fotogrammi.
- **E4**: video fermi, a richiesta.
- **E5**: esportazione automatica.
Alby96
changed title from Esportazione: copie in cartelle esterne, conversione dei formati, fotogrammi e video fermi to 0.3.0 · Esportazione: copie in cartelle esterne, conversione dei formati, fotogrammi e video fermi2026-11-18 10:50:51 +01:00
Alby96
added this to the 0.3.0 — Esportazione milestone 2026-11-18 10:50:51 +01:00
HEVC in casa subito, dentro la 0.3.0; VP9 e AV1 non chiesti
Video meno comuni (WMV/ASF, FLV, MPEG-PS)
Si scrivono anche quei lettori (durata, dimensioni, codec)
Componenti di terzi già in uso (Xvfb e pacchetti Debian, Archivo, Lucide, NSIS, Node)
Via anche questi: installatore senza NSIS, CI senza Node (passi in shell con git e curl), carattere di sistema (system-ui) al posto di Archivo, icone SVG disegnate da noi al posto di Lucide; Xvfb e i pacchetti Debian restano solo se Chromium ne ha bisogno
gitleaks e Trivy
Restano, solo nella CI
Altri flussi di conformità ITU-T (H.264.1 mancanti, H.265.1)
Sì, si scaricano; nel repository solo flussi e MD5 dell'uscita, con un LEGGIMI che dice la fonte
Stesso post in due account, predefinita
Una copia per account
Le tappe si allargano di conseguenza: C3 copre tutto H.264, si aggiungono C4 (HEVC), C5 (lettori ASF, FLV e MPEG-PS) e C6 (installatore senza NSIS, CI senza Node, carattere e icone nostri). La specifica si aggiorna nel ramo documenti/esportazione-e-regole.
## Altre risposte di Alberto (18 novembre 2026)
Domande nate dalla prima ondata di lavoro (E0, S4b, C1, C2–C3):
| Domanda | Risposta |
|---|---|
| H.264: interlacciato, 10 bit, 4:2:2/4:4:4, SVC, MVC | **Tutto**: il decoder copre ogni profilo |
| HEVC/H.265 (predefinito degli iPhone), VP9, AV1 | **HEVC in casa subito, dentro la 0.3.0**; VP9 e AV1 non chiesti |
| Video meno comuni (WMV/ASF, FLV, MPEG-PS) | **Si scrivono anche quei lettori** (durata, dimensioni, codec) |
| Componenti di terzi già in uso (Xvfb e pacchetti Debian, Archivo, Lucide, NSIS, Node) | **Via anche questi**: installatore senza NSIS, CI senza Node (passi in shell con git e curl), carattere di sistema (`system-ui`) al posto di Archivo, icone SVG disegnate da noi al posto di Lucide; Xvfb e i pacchetti Debian restano solo se Chromium ne ha bisogno |
| gitleaks e Trivy | **Restano**, solo nella CI |
| Altri flussi di conformità ITU-T (H.264.1 mancanti, H.265.1) | **Sì, si scaricano**; nel repository solo flussi e MD5 dell'uscita, con un LEGGIMI che dice la fonte |
| Stesso post in due account, predefinita | **Una copia per account** |
Le tappe si allargano di conseguenza: C3 copre tutto H.264, si aggiungono C4 (HEVC), C5 (lettori ASF, FLV e MPEG-PS) e C6 (installatore senza NSIS, CI senza Node, carattere e icone nostri). La specifica si aggiorna nel ramo `documenti/esportazione-e-regole`.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Proposta da approvare · Specifica:
docs/SPECIFICA.md§4.6, §4.7, §4.8, §8, §10, §11, §12Niente codice finché Alberto non risponde alle domande in fondo (tappa E0).
Che cosa chiede Alberto
In breve: varie opzioni di esportazione.
Che cosa c'è già
Fotogrammi e ffmpeg
VideoFrameExtractorestrae un JPG per le miniature. Gli argomenti sono asrc/Febe.Core/Library/VideoFrameExtractor.cs:82, il limite fisso di 30 s a:12.VideoFrameExtractor.cs:20-24). Oggi nessuna impostazione lo espone.VideoFrameExtractor.cs:87,:111).PerceptualHashlavora su 32×32 grigi (src/Febe.Core/Library/PerceptualHash.cs:38).HashOfè interno e accetta proprio quella griglia (:77-78).Scrittura dei file
SafeFileWriterscrive un.part, calcola lo SHA-256 e sposta il file su un nome libero, senza mai sovrascrivere (src/Febe.Core/Library/SafeFileWriter.cs:261-297).LastWriteTime(SafeFileWriter.cs:23,:157-161).libreria.data-file-pubblicazione(src/Febe.Core/Library/LibrarySettings.cs:9,:24).Conversione delle foto
ImageDecoding.cs:22-53).ContentAnalysis.cs:101).Nomi e cartelle
NamingScheme.Validatetoglie il segmento{account}iniziale (src/Febe.Core/Library/NamingScheme.cs:136-140).FitPathaccorcia i percorsi lunghi per Windows (src/Febe.Core/Library/LibraryLayout.cs:84-89,WindowsFileNames.cs:20,:93).ResolveFolder(AccountsApi.cs:642-671).Disco, avvisi, pulizia
src/Febe.Core/Alerts/DiskSpace.cs:65).CleanTemporaryFilesAsynctoglie i file temporanei (src/Febe.App/FebeApp.cs:784-805), in modo ricorsivo (SafeFileWriter.cs:181).Motore
EngineRuntime.CurrentSession != null(src/Febe.Core/Engine/EngineRuntime.cs:60), come fa Monitor (Monitor.cs:105-107).IsRunning, che è vero per ore (EngineRuntime.cs:87-91).UserIsDriving(Monitor.cs:95).Avvisi di cambiamento
LibraryChange(At, AccountId?, Reason)non porta id di media né di elementi (src/Febe.Web/Library/FebeLibrary.cs:89).:93-94), quindi non può alimentare una coda.Database
src/Febe.Data/Migrations/0001_schema.sql, nessun 0002 su nessun ramo.TEXTconCHECK(0001_schema.sql:56,:63,:95).docs/decisioni.md:94).tests/Febe.Tests/Data/LibraryScaleTests.cs, conIndexBoundMs = 250(:22).Docker
VOLUME ["/dati", "/libreria", "/importa"](docker/Dockerfile:120).docker/entrypoint.sh:59-61).Esportazione e demo
CsvExport.cs:20,/api/entries/export).src/Febe.Web/Demo/DemoSeeder.cs:70). DemoFileResolver restituisce file solo per le foto.Mockup
Proposta
Il principio: un'esportazione copia file che stanno già in libreria verso una cartella esterna (destinazione).
action_log. Un file mancante non si riscarica.1. Fotogrammi e video fermi
Fotogrammi a richiesta
VideoFrameExtractordiventaFrameExtractor. Il metodo attuale per le miniature resta.FfmpegRunnercomune gestisce:WithoutSecrets();_fotogrammaper un video fermo;_t0m12s340per un istante;_f001per una serie.FitPath, altrimenti sfora i 240 caratteri.Riconoscere i video fermi
VideoStillness, solo ffmpeg e ffprobe.-ssnello stesso comando, in grigi su stdout.HashOf: tutte le coppie entro 2 bit.algopermette di rianalizzare senza migrazione.-threads 1, priorità BelowNormal;video_analysis». Vale per scaricamenti, importazioni e ricostruzioni. UnLibraryChangeserve al massimo da sveglia.CurrentSession != nulloUserIsDriving.Nota su «foto con musica»: probabilmente i post foto con musica arrivano come immagine più una traccia audio separata, e Febe salva già solo l'immagine. I video fermi sarebbero allora soprattutto storie e reel fatti da una foto. Non verificato su un campione ripulito. Non si progetta nessun lettore su questa ipotesi (regola 9).
2. Formato di esportazione
_febe.jsonldipendono dai byte originali (LibraryIngest.cs:232-237).-c copy -movflags +faststartRegole comuni:
libreria.data-file-pubblicazione, fotogrammi compresi.creation_time.{codice}, il prefisso SHA dell'origine, anche dopo la conversione.Da verificare prima di costruire: è probabile che i file scaricati siano quasi tutti JPEG e MP4 H.264, quindi «tutto in JPG/MP4» sarebbe per lo più una semplice copia. Va controllato con un conteggio dei formati nel database di Alberto.
3. Percorsi esterni
Modello, da confermare con la domanda 1:
account.js:389-413);Così ogni account ha una sola destinazione effettiva e «già copiato» è un sì o un no.
Ogni destinazione ha:
Validate;Nomi nella cartella generale: Febe aggiunge sempre lei il segmento con il nome utente ripulito.
Validatetoglie{account}, e senza quel segmento gli account si scontrerebbero.Cartelle rifiutate:
Si ricontrolla quando cambia la cartella di un account. Lettere di unità e percorsi UNC possono puntare allo stesso posto: lo si scopre con un piccolo file di prova, non confrontando le stringhe.
Windows
INativeShell.PickFolderAsync).Docker
/esporta, attivo solo se si dà--esporta/FEBE_ESPORTAin modo esplicito.VOLUMEnel Dockerfile. Un volume anonimo farebbe sembrare /esporta montata e riempirebbe in silenzio il docker.img di Unraid./proc/self/mountinfo. È codice nuovo: oggi non esiste...è rifiutato.Mai cancellare, mai sovrascrivere
SafeFileWriter..part: solo nelle cartelle registrate in lavori non finiti e solo per i.partpiù vecchi di qualche ora. Mai una scansione ricorsiva della destinazione all'avvio: è lenta su SMB e potrebbe togliere un.partdi un'altra istanza.Destinazione irraggiungibile
.febe-prova-*.partscritto e tolto.Manuale e automatica
SettingsApi.cs:228-231.4. Il segno «già copiato»
Per file
export_copyper file e destinazione, con:Adozione per percorso (evita copie «(2)» e sostituisce un diario nella destinazione)
Stati di un file in una destinazione
LibraryRebuilder.cs:56-57).Per elemento (calcolato al momento, nessuna tabella derivata)
entry_export: diventerebbe vecchia a ogni file aggiunto, sostituito o rihashato. Il filtro è unaEXISTSsu indiciexport_copy(destination_id, media_id)emedia(entry_id), misurata inLibraryScaleTests.«Eliminalo e lascia che torni»
DELETE FROM entry(EntryStore.cs:166) lascia le copie senza collegamento.Dove si vede
5. Dati, API, schermate
Database: una sola migrazione
0002_esportazione.sqlTEXTconCHECK, sha256 conCHECK length = 64.export_destinationcon una colonnascopeesplicita (tutti/account). NULL non significa «tutti».export_copy.export_runedexport_item, sul modello diimport_run/import_file(0001_schema.sql:218-260), per interrompere e riprendere.video_analysis, con chiave sha256. Si può ricalcolare.settingcon chiaviesportazione.*, tramiteExportSettings.account.Lavoro in sottofondo
ExportServicesegue lo schema di ImportService:RecoverAsync;ExportHubsta in Febe.Web.LibraryFileResolver. Uno mancante diventa «File non presente in libreria».LibraryChange(«copie») aggiorna le tessere.IClockper i tempi.API (nuovo
ExportApi.cs, controllo dell'Origin su ogni modifica)GET/PUT /api/settings/export.GET/POST /api/export/destinations,PUT/DELETE /api/export/destinations/{id}. DELETE toglie solo la configurazione.POST …/pick-folder(desktop) eGET /api/export/folders?path=(Docker).POST …/{id}/checkePOST …/{id}/recognise: riconosce le copie già presenti.POST /api/export/preview: numero di file, già copiati, video fermi, non convertibili, dimensione stimata.POST /api/export/run,GET /api/export/run,POST /api/export/run/stop|resume,GET /api/export/{runId}/report.csv.GET /api/media/{id}/frame?t=&format=(non scrive nulla) ePOST /api/media/{id}/frames: zip, oppure un lavoro se c'è una destinazione.copie=efermi=. La tessera ricevecopy.Schermate (file semplici in wwwroot, testi in it.json)
/api/settings/naming-preview), automatica.Demo: una destinazione di prova e righe
video_analysiseexport_copypreparate, nella scena?scena=esportazione. I video della demo non hanno file: la demo deve mostrare «File non presente in libreria» oppure preparare piccoli video.Tappe
Ogni tappa è un ramo, una richiesta di unione e una verifica verde. Si aggiornano
docs/stato.mdedocs/decisioni.md.E0 ·
documenti/esportazione/esporta, §12 ffmpeg su Windows, §13 «le copie escono dal controllo di Febe», §14, §15, §16, appendice D), decisioni, risposte alle domande.E1 ·
funzione/esportazione-schemaExportSettings. Nessun cambio di comportamento.foreign_key_checkpulito;E2 ·
funzione/esportazione-copie/esportain Docker con il controllo del montaggio;.partlimitata, spazio libero per le destinazioni.LibraryScaleTestsentro 250 ms;FitPath.docs/schermate/differenze.md; guidadocs/guida/Esportazione.mdedocs/docker.md.E3 ·
funzione/esportazione-formati-e-fotogrammiFfmpegRunnereFrameExtractor;GET /frame, pannello del visualizzatore, «Fotogrammi…», zip, fotogrammi nelle destinazioni;.gitea/scripts/ambiente-prove.sh:19).docs/windows.mdper ffmpeg).E4 ·
funzione/video-fermiVideoStillness, la coda di analisi (che cede alle sessioni),video_analysis, il chip, il filtro «Video fermi», l'opzione della destinazione.testsrc2;E5 ·
funzione/esportazione-automaticaDipendenze: E1 → E2 → E3 → E4. E5 dopo E2; ha senso dopo E4.
Domande per Alberto
_febe.jsonl, e serve una modifica della specifica (§4.7, §8.4, §9.5)..m4aaccanto al fotogramma (copia della traccia, senza ricodifica)./esportaattivo solo con--esporta/FEBE_ESPORTAesplicito, destinazioni come sue sottocartelle, nessunVOLUMEnel Dockerfile.15-impostazioni-esportazione.pnge16-copia-e-fotogrammi.png.Fuori da questa issue
_febe-copie.jsonlnelle destinazioni. È sostituito dall'adozione per percorso. In più metterebbe nomi utente e id altrui in cartelle fuori dal controllo di Febe.Non verificato
DriveFreeSpaceProbegestisca i percorsi UNC.mosaic.js,viewer.jselibrary.jsvengono dai resoconti dei lettori e non le ho ricontrollate.Valgono sempre le regole di §2 della specifica e quelle di
CLAUDE.md, in particolare la 11 (la libreria non cancella e non sostituisce file da sola) e la 12 (dipendenze a elenco chiuso).Risposte di Alberto (18 novembre 2026, in chat)
-map_metadataequivalente./esporta, attivo solo se lo dichiari.Tappe riviste, dopo la regola «niente componenti esterni»
CLAUDE.md.Esportazione: copie in cartelle esterne, conversione dei formati, fotogrammi e video fermito 0.3.0 · Esportazione: copie in cartelle esterne, conversione dei formati, fotogrammi e video fermiAltre risposte di Alberto (18 novembre 2026)
Domande nate dalla prima ondata di lavoro (E0, S4b, C1, C2–C3):
system-ui) al posto di Archivo, icone SVG disegnate da noi al posto di Lucide; Xvfb e i pacchetti Debian restano solo se Chromium ne ha bisognoLe tappe si allargano di conseguenza: C3 copre tutto H.264, si aggiungono C4 (HEVC), C5 (lettori ASF, FLV e MPEG-PS) e C6 (installatore senza NSIS, CI senza Node, carattere e icone nostri). La specifica si aggiorna nel ramo
documenti/esportazione-e-regole.