Manuale d'uso di Pandora

Pandora è il portale di Plastic Jumper per i manuali d'uso: ogni azienda scrive i suoi, li organizza in moduli, sezioni e schede, ci mette immagini e domande frequenti, e decide chi li può leggere. Questo manuale segue la versione di Pandora che stai usando (la trovi in fondo a ogni pagina).

La prima pagina presenta Pandora: che cos'è e come funziona, tutti i manuali pubblici, dal più recente, le ultime modifiche (le pagine dei manuali pubblici cambiate da poco, con la data), le aziende che hanno scelto Pandora e il pulsante per iscriversi e cominciare il proprio manuale. Nel menu in alto, per tutti: Manuali (l'elenco completo) e FAQ – domande frequenti. Chi è entrato trova le sue pagine (La mia area, Preferiti, Collegamenti, Gruppi, Chiave API, I miei dati, Account e sicurezza…) nel menu con il suo nome, in alto a destra; il piede è uguale per tutti e ha il Manuale d'uso (questo), l'accessibilità e la privacy.

Leggere i manuali

La pagina Manuali elenca i manuali pubblici, divisi per azienda. Per leggerne uno non serve entrare. Ogni manuale ha una scheda con la copertina (il logo del manuale, o un'immagine grigia provvisoria), l'icona, il titolo, la tipologia («#manuale utente», «#guida rapida»…) e una descrizione breve. Apri porta alla sua pagina iniziale, PDF lo scarica, Invia (se sei entrato) manda a qualcuno il collegamento per posta, con un tuo messaggio (al massimo 10 invii all'ora). Accanto al nome di ogni azienda c'è il collegamento al suo profilo, con i contatti e i responsabili.

Muoversi in un manuale

Un manuale è fatto di moduli; un modulo di sezioni; una sezione di schede. - A sinistra (in fondo alla pagina, sul telefono) c'è l'indice: la pagina iniziale e tutti i moduli; del modulo in cui ti trovi vedi anche le sezioni, e della sezione le schede. La pagina corrente è in grassetto. Sugli schermi larghi l'indice resta fermo accanto alla pagina mentre scorri; se è più lungo dello schermo scorre finché se ne vede il fondo, poi si ferma lì. - In alto e in fondo a ogni pagina ci sono la pagina precedente e la successiva: si legge tutto di seguito, come un libro. - Le schermate hanno una cornice da finestra e, sotto, la didascalia in corsivo. In alto a destra della cornice: Copia l'immagine (la mette negli appunti, da incollare in un documento o in una mail; se il browser non lo permette copia il collegamento all'immagine) e Ingrandisci. - Un clic su un'immagine (o Ingrandisci) la apre grande, con le frecce per passare alle altre; da tastiera le frecce scorrono, Esc chiude. - Cerca nel manuale trova le pagine con le parole che scrivi, nel titolo o nel testo. - Domande frequenti (FAQ), se il manuale le ha, in fondo all'indice.

Preferiti e collegamenti

Copia il collegamento alla pagina mette l'indirizzo negli appunti. Se sei entrato, Tra i preferiti aggiunge la pagina ai tuoi preferiti (premuto di nuovo, la toglie): li ritrovi in La mia area → Preferiti.

Il manuale in PDF

Scarica il manuale in PDF prepara un PDF/A accessibile (titoli, indice con i numeri di pagina, segnalibri, testo alternativo delle immagini), impaginato come un libro: copertina con il logo dell'azienda e del manuale, sul retro i dati del manuale e l'indirizzo della versione online, poi introduzione e indice. Ogni modulo comincia su una pagina destra ed è numerato («Modulo 2»), le sezioni pure (2.1, 2.2…). In cima alle pagine sinistre il titolo del manuale e il logo dell'azienda, sulle destre il modulo › la sezione e il logo del manuale; in fondo Pandora, la data dell'ultimo aggiornamento e «pagina x di y» e, in piccolo, i dati di Plastic Jumper (sedi, contatti, PEC, partita IVA, REA, codice destinatario, sito). Le schermate hanno una cornice da finestra e sotto la didascalia numerata («Figura 3»).

Quando il manuale non è cambiato dall'ultima volta, il PDF pronto si scarica subito. Se no si prepara in sottofondo (i manuali lunghi richiedono qualche minuto): resti sulla pagina, sotto il pulsante compare «Preparo il PDF…» e, appena è pronto, si scarica da solo. Intanto puoi continuare a leggere. Se sei entrato con il tuo account e cambi pagina, in alto in ogni pagina c'è l'avviso «Sto preparando il PDF…», che diventa «Il PDF è pronto» con il pulsante Scarica il PDF (o «non è riuscito» con Riprova); arriva anche la notifica nella campanella. L'avviso sparisce quando scarichi il PDF (la notifica si segna da sé come letta) e comunque dopo un giorno. Se non sei entrato, resta sulla pagina finché il PDF si scarica.

Da Preferiti, Scarica i preferiti in PDF fa un PDF con tutte le pagine che hai messo tra i preferiti, raggruppate per manuale.

Entrare e il tuo account

Per leggere i manuali pubblici non serve un account. Serve per i preferiti, per i manuali riservati e per scrivere.

Iscriversi: Entra in alto, poi Registrati: indirizzo email e due volte la password (almeno 12 caratteri, non troppo comune). Arriva una mail con un collegamento: aprilo e premi Conferma.
Il profilo: al primo ingresso lo completi, come persona o come azienda. Se la tua azienda è già su Pandora non iscriverla di nuovo: chiedi a chi la amministra di aggiungerti fra le sue persone.
Entrare: email e password (l'occhio accanto al campo la mostra, per controllare di averla scritta giusta; un altro clic la nasconde), oppure una chiave d'accesso (passkey) dal telefono o dal computer.
Password dimenticata? nella pagina di accesso: arriva una mail con il collegamento per sceglierne una nuova (vale poche ore e una volta sola). Dopo il cambio della password si torna da soli alla prima pagina in 5 secondi; Resta qui per restare.
Dopo molti tentativi sbagliati l'accesso si ferma per qualche minuto: protegge da chi prova le password a caso.

Notifiche

La campanella in alto, accanto a «Esci», mostra quante notifiche hai da leggere (il numero si aggiorna da solo ogni minuto). Un clic apre l'elenco: aprendo una notifica vai alla pagina di cui parla (per esempio il PDF pronto) e diventa letta; ci sono anche «Segna come letta» e «Segna tutte come lette». Da Preferenze delle notifiche (in cima all'elenco e in «La mia area») scegli per ogni avviso dove riceverlo: sul sito (la campanella), per posta (all'indirizzo del tuo account) e, quando ci sarà, per SMS. Gli avvisi obbligatori hanno le caselle bloccate. Oggi Pandora avvisa quando il PDF che hai chiesto è pronto o non è riuscito (di base solo sul sito).

In alto a destra il pulsante con il tuo nome e il tuo ruolo apre il menu: La mia area, Le mie aziende (il profilo della tua azienda), Dashboard, Preferiti, messaggi, notifiche, collegamenti, gruppi, Chiave API, I miei dati, Account e sicurezza, Esci. Si apre con un clic o con Invio, si scorre con le frecce, Esc lo chiude.

I miei dati

Da I miei dati (nel menu con il tuo nome) puoi scaricare un file con tutto ciò che Pandora sa di te (account, profilo personale, azienda e ruolo, permessi, preferiti, accessi, notifiche) e cancellare il tuo account, con la password. Cancellando: si tolgono il profilo personale, i preferiti, il ruolo e le foto, esci dai responsabili dell'azienda e l'account diventa anonimo. I manuali dell'azienda restano all'azienda. Gli amministratori del sito non si cancellano da soli; se sei l'unico amministratore della tua azienda, prima aggiungine un altro. L'informativa è in Privacy nel piede.

La mia area

La mia area raccoglie tutto ciò che è tuo: dati personali, preferiti, foto (quadrata) e copertina (larga) del profilo (accanto a ogni campo la miniatura di quella di adesso e il pulsante Togli), indirizzi email, password, doppio fattore (un codice da un'app o una chiave d'accesso; conserva i codici di recupero), sessioni aperte (chiudi quelle che non riconosci), chiave per le API, collegamenti e gruppi. Pandora ridimensiona le foto e toglie i dati nascosti (modello del telefono, data, posizione).

Scrivere un manuale

Chi fa parte di un'azienda vede nel menu Dashboard: i manuali in uso dell'azienda, pubblici e privati. Aggiungi un manuale apre una finestra: titolo e poco altro, il resto si completa dopo. Archivio e Cestino raccolgono i manuali tolti dall'uso.

Modificare un manuale

La pagina di modifica ha quattro schede: Manuale, Moduli, Sezioni, Schede (si cambiano con un clic o con le frecce). - Manuale: titolo, icona e tipologia (si vedono nella scheda del manuale in prima pagina), logo, descrizione breve, testo d'apertura, indirizzo (slug) e due caselle: Attivo (il manuale è pubblico, nella prima pagina) e Raggiungibile con link (chi ha il collegamento lo legge anche se non è pubblico). Il logo si vede nella prima pagina, nella dashboard e nel PDF: rende meglio largo, circa 1000 × 550 pixel. - Moduli, Sezioni, Schede: titolo, indirizzo, posizione (l'ordine nell'indice), Attivo e Raggiungibile con link. Ogni modulo ha anche un'icona, scelta dalla tendina «Icona» (nella tabella, nella finestra «Aggiungi un modulo» e nella pagina del testo del modulo; accanto si vede il disegno) oppure con Scegli con i disegni, che apre una finestra con tutte le icone visibili e una ricerca per nome (frecce per muoversi, spazio per scegliere, Usa questa icona per confermare): compare nell'indice a sinistra, nel titolo della pagina del modulo e nel PDF. Ai moduli che non l'avevano Pandora ha dato un'icona suggerita dal titolo: si cambia quando si vuole. Una pagina non attiva ma raggiungibile non compare nell'indice, ma si apre dal collegamento. Una tendina mostra solo le sezioni di un modulo o le schede di una sezione. Salva moduli, sezioni e schede salva le tre tabelle insieme; Aggiungi crea una parte nuova, Testo apre la pagina per scriverla, Elimina chiede conferma (eliminando un modulo si eliminano anche le sue sezioni e schede). - Se lasci la pagina con modifiche non salvate, il browser chiede conferma.

Scrivere il testo

I testi si scrivono in Markdown, con la barra sopra il campo (grassetto, corsivo, titoletto, elenchi, citazione, collegamento); Anteprima mostra come verrà. - #### Titoletto (dentro una pagina si parte da quattro cancelletti); - - voce di elenco, 1. voce numerata, **grassetto**, _corsivo_, [testo](https://indirizzo); - due blocchi affiancati: [row], ogni blocco fra [col] e [/col], alla fine [/row] (sul telefono vanno uno sotto l'altro).

Le immagini

Inserisci un'immagine dall'album apre l'album del manuale: cerca per descrizione, scegli un'immagine e premi Inserisci nel testo (va dove si trova il cursore). Carica un'immagine: trascina il file o sceglilo, scrivi la descrizione (diventa il testo per chi non vede e la didascalia sotto la schermata) e premi Carica (JPG, PNG, WEBP). Un'immagine da sola in un paragrafo ha la cornice e la didascalia; una in mezzo al testo resta com'è. Una schermata copiata si incolla direttamente nel testo con Ctrl+V. Modifica cambia descrizione o file; Elimina dice prima in quali pagine è usata.

Domande frequenti

Dalla modifica del manuale, Domande frequenti (FAQ): aggiungi, modifica, elimina, cambia l'ordine con Su e Giù, e scegli se mostrarle ai lettori.

Archivio e cestino

Chi amministra l'azienda, o ha il permesso «eliminare» su quel manuale, lo può togliere dall'uso dalla dashboard o dalla sua pagina di modifica: - Archivia: il manuale non è più in uso ma si tiene. Esce dalla prima pagina e dalla dashboard; lo leggono (anche in PDF) solo le persone dell'azienda. Da Archivio, Riporta in uso lo rimette com'era. - Sposta nel cestino: dal Cestino si ripristina o si elimina definitivamente, con tutte le sue immagini: non si torna indietro.

Un editor senza il permesso «eliminare» modifica il manuale ma non lo archivia né lo cancella.

L'azienda

Chi amministra l'azienda (ruolo «amministratore aziendale») cura profilo e persone da La mia area → Manuali. - Profilo dell'azienda: dati, logo (si vede anche sulla copertina dei PDF) e copertina affiancati, con la miniatura e Togli, descrizione, contatti e social. - Responsabili: le persone di riferimento, nella pagina pubblica dell'azienda. Aggiungi un responsabile: se la persona è già su Pandora la scegli fra quelle dell'azienda, e nome, email e foto vengono dal suo profilo (non si riscrivono); se non è iscritta scrivi nome, cognome ed email e lascia Invitala per posta: le arriva il collegamento per iscriversi e, quando conferma l'indirizzo, il responsabile si collega al suo account. Telefono, PEC, social e una foto diversa sono del ruolo. Togli dai responsabili non tocca il suo account. - Persone dell'azienda: aggiungi una persona con il ruolo (editor) e i permessi su ogni manuale (leggere, modificare, eliminare, domande frequenti); «Seleziona tutti» e «Deseleziona tutti» aiutano con molti manuali. Nessuno può eliminare sé stesso. - Archivia l'azienda: in fondo alla pagina di modifica del profilo (solo per l'amministratore aziendale e per chi gestisce il sito). L'azienda e i suoi manuali non sono più pubblici; li leggono solo le sue persone. Riporta in uso rimette tutto com'era. - Elimina l'azienda: nello stesso posto, in «Elimina l'azienda». Per confermare scrivi il nome dell'azienda. Si eliminano per sempre l'azienda, i responsabili e tutti i manuali (anche in archivio e nel cestino) con immagini, loghi e PDF. Gli account delle persone restano: sono staccati dall'azienda e perdono il ruolo aziendale. Un editor non può archiviare né eliminare l'azienda.

Testo e colori

Pandora segue le regole di accessibilità AgID (WCAG 2.1 livello AA). Il tasto tondo «Aa» in alto: testo dall'87,5 % al 200 % e colori (automatico, chiaro, penombra, scuro); la scelta resta nel tuo browser. Da tastiera Tab passa da un elemento all'altro, il primo collegamento è Vai al contenuto, le schede si cambiano con le frecce e le finestre si chiudono con Esc.

Per chi gestisce il sito

Gli amministratori di Pandora vedono in cima a ogni pagina una barra con Gestione (nella gestione la barra dice che ci si trova lì e porta di nuovo al sito). - Cruscotto: i numeri del sito e di Pandora, gli ultimi accessi e chi amministra. - Manuali e aziende: quattro schede (Aziende, Manuali in uso, Archivio, Cestino) e una ricerca per nome. Ogni manuale si apre, si modifica, si archivia, si sposta nel cestino, si ripristina o si elimina definitivamente. Ogni azienda ha la sua pagina con i manuali e le persone: lì si archivia l'azienda (i suoi manuali e il profilo non sono più pubblici) o la si elimina (solo quando non ha più manuali né persone). - Persone, Inviti, Registro accessi, Pagine, Tendine (fra queste «Tipologie dei manuali»), Documentazione (anche l'elenco delle falle corrette), Versione, Server. - Impostazioni: la larghezza delle pagine (per Pandora, tutta la finestra), la descrizione e l'immagine per le anteprime dei collegamenti condivisi, i colori (da due o tre colori si calcolano quelli di tutti i temi, con il contrasto AA garantito, e la pagina mostra la tavolozza calcolata) e il carattere (scelto fra quelli liberi serviti dal sito). - Simboli: due schede. Simboli del sito: i disegni accanto ai pulsanti (PDF, preferiti, cerca, archivia, campanella…). Icone dei manuali: le icone che si scelgono per i moduli e i manuali (circa 125, con il nome italiano e quello di Bootstrap Icons; anche arte, natura e sport, alcune disegnate apposta per Pandora). Sono disegni pieni nello stile di Bootstrap Icons (licenza MIT, pj_base/LICENZE-ICONE.md): «Cambia» per incollare il tracciato di un altro disegno pieno (l'attributo d di un'icona di Bootstrap Icons, griglia 16 × 16), «Torna a quello di base» per annullare. - Solo il superadmin: Pannello Django, con tutte le tabelle. Da usare con prudenza.

I PDF sul server: li prepara un processo a parte, il «worker» (python manage.py coda_pdf). Per sapere come vanno: python manage.py genera_pdf --controlla (sola lettura: ultimi PDF, stato, durate, errori, ultimo segno di vita del worker). Se il worker non è acceso, il sito li prepara lo stesso, più lentamente.

Le API sono documentate su /api/v1/documentazione/.