Guida all'uso

1. Agenzia: primo accesso e preparazione

1. Apri https://www.cityshirt.eu/volantinaggio-sas/login ed entra con email e password dell'agenzia (le ricevi dal super-admin).
2. Impostazioni (menu a sinistra): controlla nome agenzia, logo e dati che compariranno nei report PDF.
3. Operatori → Nuovo: crea un utente per ogni volantinatore (nome, email, password). Sono le credenziali che l'operatore userà nell'app sul telefono. Un operatore si può disattivare con il pulsante Attiva/Disattiva senza cancellarlo.
4. Clienti → Nuovo: inserisci il cliente (ragione sociale, email). Se vuoi che il cliente veda il lavoro dal suo portale, compila anche Accesso portale (email + password): sono le credenziali che darai al cliente.

Ruoli: l'admin agenzia fa tutto; il supervisore gestisce campagne e report ma non impostazioni e utenti.

2. Creare e avviare una campagna

1. Campagne → Nuova campagna: nome (es. "Volantino Primavera"), cliente, date di inizio e fine, numero di volantini da distribuire.
2. Zone: disegna sulla mappa l'area da coprire (clicca i vertici del poligono, chiudi sul primo punto). Puoi creare più zone per la stessa campagna.
3. Assegna operatori: scegli chi lavora su quali zone. L'operatore vedrà la campagna nell'app solo dopo l'assegnazione.
4. Avvia (pulsante nella pagina della campagna): da questo momento gli operatori possono iniziare le sessioni. Finché è in bozza non compare nell'app.
5. A lavoro finito: Chiudi la campagna. Da chiusa non accetta più sessioni e si può generare il report definitivo.

3. Operatore: l'app sul telefono

Installazione (Android, una volta sola): apri sul telefono https://www.cityshirt.eu/volantinaggio-sas/storage/app/index.html, scarica l'APK e installalo (se chiede "consenti da questa origine", accetta). Al primo avvio concedi i permessi di posizione ("sempre" o "mentre usi l'app") e fotocamera.

1. Accedi con email e password create dall'agenzia.
2. Nella lista Campagne tocca quella di oggi: vedi la zona sulla mappa e i volantini previsti.
3. Tocca Avvia quando sei nella zona e inizi a distribuire. L'app registra il percorso GPS in automatico: tieni il telefono con te, non serve fare altro.
4. Ogni tanto scatta una Foto (cassetta, portone, volantino consegnato): l'app le manda al server con data, ora e posizione. Sono le prove per il cliente.
5. Pausa se ti fermi (pranzo, spostamento in auto) e Riprendi quando ricominci: così il percorso resta pulito.
6. A fine giro tocca Termina. La sessione si chiude e l'agenzia la vede subito.

Senza rete l'app continua a registrare e invia tutto appena torna la connessione. Se esci dalla zona assegnata, se il GPS risulta falsato o se la velocità è da veicolo, il sistema lo segnala all'agenzia: lavora normalmente e la certificazione è automatica.

4. Agenzia: seguire il lavoro in tempo reale

• Dashboard: campagne attive, operatori in servizio adesso, volantini distribuiti oggi, avvisi.
• Campagna → Tracciamento (pulsante Track): mappa con il percorso di ogni operatore, le foto sul punto in cui sono state scattate e la percentuale di zona coperta.
• Gli avvisi anti-frode (fuori zona, posizione simulata, velocità anomala) compaiono in rosso nella sessione: verifica con l'operatore prima di chiudere il report.
• La campanella in alto raccoglie le notifiche (sessione avviata, contestazione aperta, report inviato).

5. Report e portale del cliente

1. Report → Genera: scegli la campagna; il sistema produce un PDF con mappa dei percorsi, foto, ore lavorate, volantini distribuiti e stato della copertura.
2. Scarica per controllarlo, poi Invia al cliente: il cliente lo trova nel portale e (se la posta è configurata) riceve una email.
3. Il cliente entra su https://www.cityshirt.eu/volantinaggio-sas/portal con le credenziali che gli hai creato: vede l'avanzamento in tempo reale, scarica i report e può aprire una contestazione su una campagna.

6. Contestazioni

Se il cliente segnala un problema ("in via X non è arrivato niente"), apre una contestazione dal portale. L'agenzia la trova in Contestazioni: rispondi con le prove (foto e percorso GPS di quella zona sono già lì), e quando è risolta premi Chiudi. Tutto lo scambio resta registrato e visibile a entrambi.

7. Super-admin (gestore della piattaforma)

• Agenzie: crea una nuova agenzia con il suo utente admin, attivala/disattivala, oppure Impersona per entrare nel suo pannello e aiutarla (in alto compare la barra gialla; "Torna al tuo account" per uscire).
• Piani: limiti per agenzia (operatori, campagne, foto).
• Audit log: chi ha fatto cosa e quando.
• Le attività automatiche (chiusura sessioni dimenticate, pulizia, report programmati) partono da sole ogni pochi minuti finché il sito riceve visite: non serve configurare nulla.

8. Problemi comuni

L'operatore non vede la campagna nell'app

La campagna deve essere avviata (non in bozza) e l'operatore assegnato a una zona. Poi nell'app tira giù per aggiornare.

Il percorso sulla mappa ha buchi

Il telefono ha messo l'app in risparmio energetico. Impostazioni Android → App → VolantinoTrack → Batteria → "Senza limitazioni"; posizione su "Sempre".

Le foto non compaiono subito

Vengono inviate quando c'è rete; con connessione debole possono arrivare qualche minuto dopo. Se la sessione è terminata arrivano comunque.

Il cliente non riesce a entrare nel portale

Agenzia → Clienti → apri il cliente → sezione Accesso portale: imposta o reimposta la password.

Password dimenticata (agenzia/operatore)

La reimposta l'admin dell'agenzia da Operatori (o il super-admin da Agenzie per gli admin).

Non arrivano le email

Le notifiche in app (campanella) funzionano sempre; le email partono solo se la posta è configurata sul server. Le azioni non si bloccano mai per questo.