Owner: @marco.devito ## Attivazione mappa pubblica delle segnalazioni sul territorio ### Sul sito Il sito deve essere configurato per connettersi a un'area personale (vedi Gestione informazioni generali) e deve avere il widget Segnalazioni sul territorio attivato #### 1) installare il modulo `OpenCity Inefficiency dataset` Sulla macchina cron dell'architettura sass eseguire il comando ``` cd /usr/share/nginx/saasopenpa-distribution/html php vendor/bin/ocinstall -s${IDENTIFICATORE_ISTANZA}_backend opencity::inefficiency-dataset ``` Esempio per Bugliano ``` php vendor/bin/ocinstall -sopencitybugliano_backend opencity::inefficiency-dataset ``` #### 2) predisporre nel sito un editor Documenti abilitato Dall'interfaccia di gestioni redazione (esempio per Bugliano: https://www.comune.bugliano.pi.it/bootstrapitalia/permissions) creare un utente e garantirgli il ruolo `Editors Amministrazione` Modificarne poi la password usando il modulo "Hai dimenticato la password?" (esempio per Bugliano: https://www.comune.bugliano.pi.it/userpaex/forgotpassword): la password servirà a creare l'header di autenticazione nel webhook {width="557" height="529"} ### Su area personale #### 1) Attivare feature flag `feature_inefficiencies_backoffice` #### 2) Impostare il modulo backoffice Per impostare il modulo backoffice eseguire una query in db ``` update servizio set backoffice_form_id = '66e95788e830010045715850' where id = '${SERVICE_ID}' ``` Esempio in Bugliano ``` update servizio set backoffice_form_id = '66e95788e830010045715850' where id = 'b15004e2-2ce0-472a-99a0-f32264e540e6' ``` #### 3) Impostare il webhook Accedere come admin, navigare nelle impostazioni dei webhook (esempio in Bugliano https://servizi.comune.bugliano.pi.it/lang/it/admin/webhook/) e impostare il webhook come segue: | Etichetta | Valore | |-----------|--------| | Nome | Webook mappa segnalazioni | | Endpoint | [https://${URL_SITO}/api/inefficiency/v1/collect](https://$%7BURL_SITO%7D/api/inefficiency/v1/collect) | | Method | POST | | Attivatore | Modulo operatore aggiornato | | Seleziona i servizi abilitati per il webhook | Segnala disservizio | | Headers (json) | `{"Authorization": "Basic ${BASIC_AUTH_TOKEN}"}` | | Versione | 2.0 | | Attivo | (checked) | (Per generare il token è possibile usare [questo sito di utilità](https://www.blitter.se/utils/basic-authentication-header-generator/)) ### Per eseguire un test 1. creare una segnalazione disservizio dal sito (cliccando sul footer) 2. accedere in area personale come operatore abilitato alla gestione del servizio Segnala disserivizio 3. aprire la segnalazione inserita al punto 1 4. deve comparire un pulsante in alto a destra per rendere pubblica la segnalazione: cliccare su Pubblica 5. dopo il passaggio del webhook neella mappa resente sul sito alla pagina `/Amministrazione/Documenti-e-dati/Dataset/Elenco-segnalazioni` deve comparire la segnalazione ### Per verificare l'inserimento di una segnalazione 1. In https://www.comune.bugliano.pi.it/api/inefficiency/v1/ è possibile inserire come payload il contenuto api di una segnalazione everificarne l'inserimento