Copertura contenuti

Questa pagina e la mappa di copertura del manuale. Quando viene aggiunta una nuova area o cambia un comportamento, deve comparire qui e nel manifest di copertura, cosi il test di drift blocca UI non documentata. Il manuale deve spiegare cosa fa la route e i flussi importanti dovrebbero essere illustrati con screenshot sensibili al tema, mostrando una sola variante alla volta.

Aree pubbliche e account

Percorso	Pubblico	Cosa copre
/	Visitatori pubblici	Landing page con proposta di valore, panoramica feature, workflow, testimonianze, integrazioni, CTA pricing e footer.
/about	Visitatori pubblici	Storia del prodotto, valori operativi, contesto del team e ritorno verso signup o app autenticata.
/pricing	Visitatori pubblici, owner	Confronto piani, toggle mensile/annuale, limiti, FAQ e punti di ingresso al checkout (documentato in riferimento piani).
/login	Tutti gli utenti	Accesso email/password, redirect preservato, link password dimenticata e ingresso in /app.
/register	Nuovi utenti	Registrazione pubblica quando abilitata, nome/email/password, regole password e redirect post-registrazione.
/forgot-password	Tutti gli utenti	Richiesta reset password con invio di link monouso all'email account.
/reset-password	Tutti gli utenti	Reset tramite token, gestione token assente/non valido e invio nuova password.
/accept-invitation/$invitationId	Utenti e clienti invitati	Accettazione inviti organizzazione o galleria, creazione account invitato, verifica email, setup accessi e redirect finale.
/guest-review/$token	Ospiti invitati	Apertura della revisione ospite tramite link condiviso, con eventuale passaggio di verifica prima dell'accesso.
/guest-review/challenge	Ospiti invitati	Schermata di verifica quando serve confermare l'email prima di entrare nella galleria.
/guest-review/error	Ospiti invitati	Schermata che spiega se il link e revocato, scaduto o non valido.
/guest-review/unsubscribed	Ospiti invitati	Conferma di rimozione o stato non valido delle notifiche guest.

Aree autenticate

Percorso	Pubblico	Cosa copre
/app	Utenti autenticati	Shell con sidebar, header, ruolo organizzazione, brand, controlli lingua/tema, help globale e guardia sessione.
/app/	Utenti autenticati	Dashboard per ruolo con lavori attivi, metriche operative, scadenze, attivita recente e link rapidi.
/app/notifications	Utenti autenticati	Inbox review con risposte, cambi stato, feedback cliente, non letti, conteggi, link galleria e segna come letto.
/app/settings/notifications	Utenti autenticati	Preferenze personali in-app/email per eventi di advanced review.

Aree gallerie cliente

Percorso	Pubblico	Cosa copre
/app/galleries	Clienti e team	Shell annidata per lista gallerie condivise e dettaglio galleria.
/app/galleries/	Clienti e team	Lista gallerie condivise, preferenza griglia/tabella, miniature, stati, date shooting, cliente e apertura galleria.
/app/galleries/$galleryId/	Clienti e reviewer	Workspace proofing con browsing immagini, lightbox, selezioni, commenti, stati advanced review, commenti pinnati, filtro volti e shortcut.

Aree admin gallerie

Percorso	Pubblico	Cosa copre
/app/admin	Owner e admin	Guardia permessi delle route admin; gli utenti non owner tornano a /app.
/app/admin/galleries/	Owner, admin	Lista operativa gallerie con ricerca, filtri stato, quick filter, vista griglia/tabella, alert limiti, azioni bulk e controlli piano.
/app/admin/galleries/new	Owner, admin	Creazione galleria: cliente, titolo, slug, descrizione, stato, proofing, limiti selezione, date, sezioni e review.
/app/admin/galleries/$galleryId/	Owner, admin	Workspace admin con griglia immagini, selezioni/review, azioni batch, condivisione, vendor, slideshow e controlli advanced review.
/app/admin/galleries/$galleryId/edit	Owner, admin	Editor impostazioni galleria per metadata, cliente, regole proofing, review avanzata, miniatura e sezioni.
/app/admin/galleries/$galleryId/upload	Owner, admin	Upload anteprime con stato uploader, feedback di processamento e contesto galleria.
/app/admin/galleries/$galleryId/delivery	Owner, admin	Consegna finale: upload o generazione asset, pubblicazione download, disponibilita programmata e rimozione asset vecchi.
/app/admin/tasks	Owner, admin	Centro job background per preview, face detection, clustering e vendor share, con tab attivi/completati, filtri, refresh, retry, pausa/ripresa e cancel.
/app/admin/gear-analytics/	Owner, admin	Workspace Gear Analytics con KPI e grafici su camera, lenti e focali, con azioni di backfill EXIF per gallerie storiche.

Persone, vendor e slideshow

Route	Pubblico	Cosa copre
/app/admin/users/	Owner, admin	Gestione utenti con ricerca, filtri stato, inviti, ruoli, annullamento inviti, modifica e cancellazione.
/app/admin/users/new	Owner, admin	Creazione diretta utente per setup interni.
/app/admin/users/$userId/edit	Owner, admin	Modifica profilo e ruolo utente esistente.
/app/admin/clients/	Owner, admin	Directory clienti con ricerca, contatti, note, data iscrizione e modifica.
/app/admin/clients/new	Owner, admin	Redirect di compatibilita verso onboarding cliente tramite invito utente.
/app/admin/clients/$clientId/edit	Owner, admin	Editor profilo cliente per contatti, note e metadata directory.
/app/admin/vendors/	Owner, admin	Directory vendor con ricerca, filtri tipo/stato/sort, creazione vendor, referral URL, flag attivo e leaderboard.
/app/admin/vendors/$vendorId	Owner, admin	Profilo vendor e audit con link share, referral, watermark, scadenza, rinnovo, revoca e accesso per galleria.
/app/admin/vendors/leaderboard	Owner, admin	Classifica vendor 30 giorni con score, aperture, viste immagini, referral qualificati e ultima attivita.
/vendor-share/$publicToken	Vendor esterni	Share pubblico vendor con token, scadenza, immagini watermarked, tracking attivita, CTA referral e caricamento infinito.
/r/$referralToken	Referral esterni	Redirect referral che registra traffico qualificato e inoltra alla destinazione configurata.
/app/admin/slideshow/	Owner, admin	Lista slideshow con galleria, stato live/out-of-sync/unavailable, conteggio immagini, update e azioni.
/app/admin/slideshow/$slideshowId	Owner, admin	Gestione slideshow con preview, link pubblico, refresh/update/delete, durata, loop e controlli legati al piano.
/slideshow/$publicToken	Clienti, ospiti, pubblico	Viewer slideshow pubblico con tema scuro, auto-advance, controlli prev/next, progress, counter, end card, logo e stato unavailable.

Impostazioni e billing

Route	Pubblico	Cosa copre
/app/admin/settings/brand	Owner, admin	Brand studio: nome, slug, colore primario, sito web e logo caricato.
/app/admin/settings/notifications	Owner, admin	Preferenze notifiche organizzazione per eventi review e canali.
/app/admin/settings/reminder	Owner, admin	Reminder automatici per gallerie non aperte, proofing incompleto e deadline, con preview email e timing.
/app/admin/settings/integrations	Owner, admin	Gestione integrazioni e API key per sistemi esterni e automazioni.
/app/admin/billing	Owner	Billing con ritorni checkout/portal, card piani, mensile/annuale, usage, storage, rinnovo e azioni Polar.

Aree interne e sviluppo

Percorso	Pubblico	Cosa copre
/api/auth/$	Endpoint interno	Catch-all Better Auth per login, logout, sessioni, reset password e operazioni server auth.
/api/img/$	Endpoint interno	Proxy immagini autenticato o firmato con cache per preview, immagini galleria e share.
/api/session/logout	Endpoint interno	POST che chiude la sessione corrente.
/api/guest-review/enter	Endpoint interno	Apertura del link guest review e avvio del flusso di accesso o verifica.
/api/guest-review/confirm	Endpoint interno	Conferma della verifica guest quando il link richiede controllo email.
/api/guest-review/unsubscribe	Endpoint interno	Rimozione dalle notifiche guest tramite token dedicato.
/api/webhooks/polar	Endpoint billing	Webhook Polar per sincronizzare subscription, checkout e billing.
/api/debug/db	Endpoint sviluppo	Diagnostica connettivita database per sviluppo o troubleshooting controllato.
/dev/face-poc	Solo sviluppo	Benchmark face detection per confrontare worker face-api e Human.