Funzionalità atti
Un atto avrà la struttura delle informazioni prevista per le diverse tipologie prevista in: https://github.com/openpolis/open_municipio/wiki/Atti-del-Comune
Un atto viene pubblicato sulla piattaforma per via automatica (API) o tramite interfaccia di back-end dai moderatori del sito. Alla pubblicazione dell'atto il sistema:
- Aggiunge nel back-end l'atto come da classificare.
- Produce notizia riguardante la tipologia dell'atto (vedi seguito del documento)
- Qualora fosse utente del sistema, invia email al primo firmatario dell'atto con l'invito a descrive l'atto stesso e le motivazioni della sua presentazione.
- Qualora il politico ancora non fosse utente del sistema, la notifica oltre alla notizia della pubblicazione dell'atto, conterrà l'invito alla registrazione.
Direttamente dall'interfaccia di front-end i moderatori avranno la possibilità di classificare l'atto secondo le specifiche del capitolo precedente. Il moderatore può inoltre inserire un titolo aggiuntivo (titolo giornalistico) all'atto. Per questo è necessario aggiungere un campo titolo_aggiuntivo (varchar, default null) alla tabella atto.
Ogni atto può essere votato dagli utenti registrati (un utente, un voto). Ogni utente registrato può esprimere un voto contrario o un voto favorevole. Agli utenti non loggati che tentano di esprimere un voto, gli viene fornita la finestra di login/registrazione. Dopo aver espresso il proprio voto, viene mostrata all'utente:
- la possibilità di commento (“sono favorevole perchè ...”, “Sono contrario perche ...”). Per le funzionalità di commento si vedano i paragrafi successivi.
- mostra all'utente la possibilità di condividere il voto su FB, Tw e G+
- mostra all'utente la possibilità di pubblicare il widget dell'atto (vedi dopo)
- se l'utente ancora non monitora (vedi par. successivi) l'atto, gli viene mostrata la funzionalità di monitoraggio.
Gli utenti registrati hanno la possibilità di commentare tutti gli atti (contenuti OC). I commenti sono divisi in tre categorie:
- commenti favorevoli all'atto
- commenti contrari all'atto
- commenti senza posizione
Alla pubblicazione di un commento l'utente deve esprimere la propria posizione. (default: senza posizione).
- I commenti hanno la possibilità di contenere link anche a siti esterni (vedere la possibilità di pubblicare parte del contenuto del link “alla FB” o almeno il title).
- Un utente può modificare un suo commento entro 10 minuti dalla pubblicazione.
- Un commento può ricevere mi piace da altri utenti
- Un commento può essere condiviso da altri sui social network
Agli utenti che ricevono i mi piace sui commenti viene inviata una notifica (vedi in seguito Funzionalità utente).
Un atto può essere descritto dal politico primo firmatario dell'atto stesso qualora il politico sia utente del sistema. La descrizione può essere successivamente modificata dallo stesso politico. Nella descrizione è possibile inserire dei link anche a siti esterni.
Come già detto al politico primo firmatario viene notificata per email la pubblicazione dell'atto con l'invito a descriverlo e votarlo. Gli altri utenti possono dare il mi piace e condividere la descrizione sui social network.
Questa funzionalità non è più prevista.
Il sistema invierà delle email ai membri di giunta e consiglio comunale al raggiungimento di determinate attività degli utenti sull'atto, a prescindere se i politici siano utenti o meno della piattaforma. In quest'ultimo caso, politici non utenti, la email sarà accompagnata con l'invito a registrarsi alla piattaforma. L'evento che produrrà l'invio automatico delle email sarà il raggiungimento di un certo numero di utenti che hanno votato l'atto. Le soglie numeriche per l'invio delle email saranno determinate dalla tipologia dell'atto e dal numero di popolazione residente nel comune.
La email sull'atto conterrà:
- numero di utenti favorevoli e contrari
- numero di commenti
- numero di utenti che monitorano l'atto
Ai politici utenti della piattaforma l'invito a commentare l'atto, a quelli ancora non registrati l'invito alla registrazione.
Di seguito una tabella riassuntiva delle news sull'atto e loro proprietà:
| Evento | Tipo di evento | Puntuali/Gruppo | Priorità |
|---|---|---|---|
| presentazione dell'atto | Is | P | I |
| apposizione di firme di primi e cofirmatari | Is | P | III |
| passaggi di iter dell'atto | Is | P | II |
| votazioni sull'atto (vedi in seguito al capitolo dedicato alla votazioni) | Is | P | II |
| Gruppo di interventi in una seduta sull'atto | Is | G | II |
| interventi in aula e commissione di singoli politici sull'atto | Is | P | III |
| ordini del giorno in cui è presente l'atto | Is | P | II |
| la descrizione dell'atto da parte del primo firmatario | Ut | P | I |
| le votazioni degli utenti | Ut | G | II |
| i commenti degli utenti | Ut | G | II |
| i link ad articoli stampa | Ut | G | III |
| notifiche inviate ai politici eletti | Ut | P | I |
Un utente registrato può avviare il monitoraggio di un atto. Monitorare un atto significa ricevere tutte le news di un atto in due modalità: tramite invio di email giornaliera tra le notizie dei miei monitoraggi tramite interfaccia ad accesso protetto nella pagina personale Per maggiori dettagli si veda il capitolo funzionalità utente.
Ogni atto possiede delle funzionalità per la pubblicazione e condivisione delle informazioni:
- feed RSS delle news dell'atto
- widget - Nblock configurabile per colori, dimensioni (si veda successivi documenti per dettaglio). Il contenuto del widget è:
- Voto utente (“Sono favorevole!”, “Sono contrario!”)
- Titolo atto e ultimo status di iter
- Numero voti favorevoli e contrari
- Numero commenti favorevoli e contrari
- Ultimo commento (fav o contr) a seconda del voto dell'utente
Dove è necessario visualizzare il titolo di un atto, in liste, widget, pagina dell'atto, news …, i criteri di visualizzazione rispondono ai seguenti casi:
| Caso | Titolo da visualizzare |
|---|---|
| Campo titolo_aggiuntivo=NULL | Campo Codice/Numero+Titolo atto |
| Campo titolo_aggiuntivo!=NULL | Il valore del campo titolo_aggiuntivo |
I moderatori del sistema possono indicare tre livelli di importanza di un atto:
- 2: key (molto importante)
- 1: high (importante)
- 0: normal
L'indicazione dell'importanza di un atto deve avvenire nel frontend.
Gli ordini del giorno come tipologie di atti hanno dei requisiti particolari.