Help / FAQ — SituaRadar

Introduzione & Come iniziare

Qui trovi risposte pratiche e spiegazioni oneste su SituaRadar: cosa è, cosa non è, come usarlo e come contribuire.

Che cos'è SituaRadar?

SituaRadar è una mappa partecipativa: una piattaforma che segnala eventi, incontri, iniziative culturali e momenti politici che sfuggono ai canali istituzionali e ai feed algoritmici. È pensata per essere autonoma, non profili gli utenti e renda visibili i moti dal basso della città.
Devo registrarmi per usare la mappa?

No. Per consultare la mappa non serve registrazione — la fruizione è anonima e libera. La registrazione è richiesta solo per alcune azioni (es. pubblicare eventi, modificare aree se la policy lo richiede, salvare eventi lato server).
Qual è la filosofia di SituaRadar rispetto alla privacy?

Minimizzazione dei dati: raccogliamo il minimo indispensabile. Non facciamo profiling, né tracciamento pubblicitario. Le policy sono pubbliche nella Privacy Policy; in generale: niente tracciamento esterno, niente profilazione, salvataggi locali per i "saved".

Quali tipi di punti vedo sulla mappa?

Punti che rappresentano eventi (concerti, reading, assemblee, mostre ecc.), e — in futuro — aree/poligoni. Alcuni punti sono pubblici; altri sono segnati come segreti (richiedono codice).
Cosa significa "hype"?

L'hype è un conteggio locale che misura l'interesse: ogni click/salvataggio su un evento incrementa il valore visuale. Non dipende da algoritmi esterni: è una misura collaborativa del coinvolgimento.
Come sono visualizzati gli eventi segreti?

Gli eventi con `codice_hash` (o contrassegnati come segreti) non sono visibili normalmente: possono comparire solo dopo aver inserito il codice corretto nella UI dedicata. La logica lato client chiede il codice, calcola lo sha256 e lo invia per verificare corrispondenza (la verifica è fatta server-side per sicurezza).

Qual è la differenza tra Organizer e Explorer?
Due ruoli minimali pensati per chiarezza operativa:
- Organizer: può creare eventi, modificarli e (se policy lo prevede) gestire contenuti del proprio spazio. Di solito chi mette eventi pubblici/privati.
- Explorer: utente che naviga, salva eventi, interagisce con hype, partecipa ma non necessariamente pubblica. Ha accesso limitato alle operazioni protette.
Come viene assegnato il ruolo?

Al momento il ruolo può essere fornito come `user_metadata.role` al momento della registrazione o impostato successivamente tramite il profilo. Il server (RPC `ensure_profile_current`) allinea il profilo alla `user_metadata` quando l'utente accede. Gli amministratori possono anche assegnare ruoli dal DB.

Dove compilo il form per pubblicare un evento?

C'è una pagina `form.html` accessibile dal pulsante “+ Aggiungi” nella barra. Organizer: aprite la pagina, compilate titolo, descrizione, data/ora, categoria, e (opzionale) codice per evento segreto. Il form invia al DB `eventi` (colonna `codice_hash` per i segreti).
Posso inserire eventi segreti?

Sì. Se vuoi che l'evento sia nascosto fino alla condivisione del codice, inserisci un codice nel form: il client calcola lo sha256 e il DB conserva solo l'hash (`codice_hash`). Solo chi inserisce lo stesso codice vedrà l'evento. Non condividere codici pubblicamente se desideri riservatezza: passali a voce o DM.
Cosa devo sapere sull'affidabilità dei dati?

SituaRadar non verifica a priori i contenuti: la responsabilità dei dati (orario, luogo, descrizione) resta di chi pubblica. Abbiamo strumenti di segnalazione e moderation (vedi sezione Moderation) per rimuovere contenuti illegali o pericolosi.

Come è implementato il meccanismo dei codici?

Tecnica sintetica: il client raccoglie il codice — es. `neon47` — calcola `sha256(code)` e lo invia (o lo confronta) con i record che contengono `codice_hash`. Il DB non conserva il codice in chiaro: solo hash. Questo è il pattern più sicuro per eventi di tipo "invite-only".
Se perdo il codice, posso recuperare l'evento?

No. Se il codice non è memorizzato da te, il DB non può rivelarlo (viene memorizzato solo l'hash). Contatta l'organizzazione che ha fornito l'evento per ottenerlo: per ragioni di sicurezza e privacy il progetto non mette a disposizione una "backdoor".

Come salvo un evento?

La fiamma / icona "salva" mantiene gli eventi nello storage locale del tuo browser (localStorage) per rispetto della privacy. È una salvezza lato client: se vuoi copie server-side usa la funzione "Saved events" del profilo (richiede login e policy server-side).
Perché vedo numeri 0/0 nel counter?

Il counter dell'interfaccia è legato alla lista di eventi attualmente “visibili” (filtro + tempo + ricerca). Se appare 0/0 significa che il badge è presente ma la fonte dati per il conteggio non è stata aggiornata. In pratica: la funzione che pubblica gli eventi renderizzati (hook `window.publishVisible`) deve essere chiamata dopo il rendering dei marker. Se c'è un bug, controlla che `window.srNotifyRendered` (o la funzione che ascolta) sia disponibile e riceva l'array di eventi.
L'hype è manipolabile?

Il contatore di hype è locale e serve come metrica sociale. Per evitare abusi, la versione server-side può memorizzare un unico "like/hype" per utente per evento (`event_hype`), e RLS/validazioni prevengono insert massivi. Se vuoi una metrica condivisa, la logica server deve contare una singola voce per utente (vedi tabella `event_hype` nello schema DB consigliato).

Come segnalo un evento pericoloso o illegale?
Usa l'indirizzo situaradar@proton.me con oggetto "Segnalazione evento" e allega:
- Screenshot / link
- Motivazione chiara
- Eventuali prove (foto, orari)
Il team valuterà la rimozione urgente se l'evento viola norme di sicurezza pubblica o leggi. In casi estremi si collabora con le autorità competenti (solo quando obbligatorio).
Chi decide la rimozione?

La rimozione è gestita dal team/volontari di SituaRadar in base alle policy pubbliche: violazioni legali, minacce, rischio per la sicurezza. Per dubbi e appelli usa lo stesso indirizzo email: la discussione è trasparente e documentata.

Come contatto il team?

Email: situaradar@proton.me. Puoi anche proporre collaborazioni, segnalare bug o inviare materiale da pubblicare (immagini, locandine, testi).
Voglio contribuire: codice, grafica o moderazione. Come faccio?

Scrivi all'email con oggetto "Contributo" specificando il tipo (dev/frontend/backend/moderazione). Per sviluppatori: apri una PR su repo (se disponibile) o invia patch via email. Documenta le modifiche e usa branch separati per evitare conflitti.