ruscomap/README.md

# RuscoMap
 
 _Una mappa della propria città dove utenti in anonimo possono inserire dei marker con nome, descrizione e foto dell'oggetto abbandonato, segnalandolo a tutti i visitatori della mappa._ 
 <br> Sulla falsa riga del "_te lo regalo se vieni a prenderlo_", questo è più il "_segnalo che c'è sta roba lì, è tua se te la vai a prendere_"
 
### ToDo per essere funzionale alla versione 0.1

- [x] Aggiungere il marker (visivo) al clic di inserimento marker [[commit f611832592](https://git.lattuga.net/scossa/ruscomap/commit/f6118325925ba91173cf5bcc0a206b85fa3ef1a3)]
- [x] Al momento si possono aggiungere infiniti marker (temporanei), da fixare [[commit 0fba9efe99](https://git.lattuga.net/scossa/ruscomap/commit/0fba9efe99057119ef5eedec078987482a193fea)]

### ToDo per essere funzionale alla versione 0.2

- [x] ~~Cancellare i marker creati > di 24h (sia record db che img)~~ [[commit 78d4b6b216](https://git.lattuga.net/scossa/ruscomap/commit/78d4b6b2169d43550aa3af800ac2f946ebeb9743)]
- [ ] Rimuovere pezzi di codice js per cancellare marker creati > di 24h. La funzione verrà implementata con degli script bash stile plugin, dato che non tutte le mappe saranno per il rusco, nel senso che potrebbero essere maker permanenti (es fontanelle d'acqua). Il codice da pulire dovrebbe essere solo quello del [commit 78d4b6b216](https://git.lattuga.net/scossa/ruscomap/commit/78d4b6b2169d43550aa3af800ac2f946ebeb9743), ma non ne sono sicuro.
- [x] Scrivere script bash (<code>delete_rusco.sh</code>) che cancella tutti marker più vecchi di 24h (automatico) [[commit 8a5260d62f](https://git.lattuga.net/scossa/ruscomap/commit/8a5260d62f4333f4ae9c6cd1489f41481f5635f6)]
- [x] Come mettere nel cron del server lo script che cancella i marker più vecchi di 24h [[commit 5dc0c22eae](https://git.lattuga.net/scossa/ruscomap/commit/5dc0c22eae2a4222f3ce8dc35a1d89df02ac836a)]
- [x] Scrivere script bash (<code>pulisci_manualmente_vecchio_rusco.sh</code>) che cancella tutti marker più vecchi di 24h (manuale) [[commit 8a5260d62f](https://git.lattuga.net/scossa/ruscomap/commit/8a5260d62f4333f4ae9c6cd1489f41481f5635f6)]
- [x] pushare e spostare script in cartella <code>/script</code> [[commit 8a5260d62f](https://git.lattuga.net/scossa/ruscomap/commit/8a5260d62f4333f4ae9c6cd1489f41481f5635f6)]

### ToDo per essere funzionale alla versione 0.3

- [x] Implementare il bottone in alto a dx: quando premuto per passare alla modalità inserimento diventa una _X rossa_ che se premuta annulla l'inserimento marker [[commit fa82dc221e](https://git.lattuga.net/scossa/ruscomap/commit/fa82dc221e2e8d1648c78534c0320bd099f897f0)]
- [ ] A marker aggiunto con successo come icona del bottone in alto a dx rimane la X rossa (in modalità inserimento marker) invece di ritornare l'icona del marker (ovvero passare in modalità normale/visualizzazione)  
- [ ] Eliminare visualizzazione di eventuali marker temporanei aggiunti se viene cliccata la X rossa

### ToDo per essere funzionale alla versione 0.4

- [ ] Mostrare data/ora pubblicazione del marker per far capire al visitatore quanto tempo fa è stato avvistato il rusco
- [ ] Al momento sul marker temporaneo si vede l'immagine rotta. fixare: sul temporaneo non bisogna mostrare nulla 

### ToDo per essere funzionale alla versione 0.5

- [ ] Riformattare visualizzazione form inserimento marker per mobile 
- [ ] Milgiorare css del form inserimento dati marker 

### ToDo per essere funzionale alla versione 0.6

- [ ] Creare form per ricercare tra i titoli/descrizioni dei marker esistenti (query esempio: "divano") 

### ToDo per essere funzionale alla versione 0.7

- [ ] Pop-Up all'apertura di ruscomap con descrizione breve 
- [ ] Scrivere il tutorial utente di ruscomap
    - [ ] Creare pagina tutorial
    - [ ] Link alla pagina del tutorial nel PopUp iniziale

### ToDo per essere funzionale alla versione 0.8

- [ ] Creare form login per admin
- [ ] Creare bottone per form/pagina "area riservata"/"accedi"
- [ ] Creare Pannello Admin 

### ToDo per essere funzionale alla versione 0.9

- [ ] Implementare il pannelo per permettere all'admin di poter creare utenti (nomeutente/password, no mail o altro)
- [ ] Permessi Admin: Visita mappa, Aggiungi marker, Accesso a pannello admin
- [ ] Gestione autenticazione utente admin con password

---

## ToDo per essere funzionale alla versione 1.0

- [ ] Creare ruolo Admin: Visita mappa, Aggiungi marker, Accesso a pannello admin
- [ ] Creare Ruolo Utente. Permessi: Visita mappa, Aggiungi marker
- [ ] Creare (?) Ruolo Ospite. Permessi: Visita mappa
- [ ] Gestione autenticazione utenti con password
- [ ] Implemtare nel pannello lo switch per on/off inserimento solo utenti e admin o anche ospiti.

oppure

- [ ] Implemtare review per moderazione rusco inserito
- [ ] Implemtare nel pannello lo switch per on/off moderazione

---

### ToDo per essere funzionale alla versione 1.1

- [ ] Feature da pannello admin: poter cancellare un utente 

### ToDo per essere funzionale alla versione 1.2

- [ ] Feature da pannello admin: poter disabilitare un utente 

### ToDo per essere funzionale alla versione 1.3

- [ ] Cancella Marker
    - [ ] Quando autenticati come admin mostrare un pulsante affianco/sopra/dentro al form dei dati del marker che ha la funzione di cancellare il marker corrispondente
    - [ ] Popup che chiede la conferma della cancellazione del marker

### ToDo per essere funzionale alla versione 1.4

- [ ] Implemtare review per moderazione rusco inserito
- [ ] Implemtare nel pannello lo switch per on/off moderazione

### ToDo per essere funzionale alla versione 1.5

- [ ] Creare Ruolo Moderatore. Permessi : Visita mappa, Aggiungi marker

### ToDo per essere funzionale alla versione 1.6

- [ ] Feature da pannello admin: poter cambiare ruolo o un utente 

### ToDo per essere funzionale alla versione 1.7

- [ ] Feature da pannello admin: poter settare permessi personalizzati ai vari Ruoli (magari si vuole dare l'inserimento anche agli ospiti e/o la cancellazione dei marker agli user) 

### ToDo per essere funzionale alla versione 1.8

- [ ] Creare form registrazione con mail
- [ ] Richiedere conferma mail via link spedito a l'indirizzo

### ToDo per essere funzionale alla versione 2.0

- [ ] Implementare ActivityPub

### Possibili altre implementazioni

- [ ] Scatta la foto del marker da uploadare direttamente in app (su alcuni smartphone gia lo fa)
- [ ] Inserire la posizione del marker tramite il gps dello smartphone
- [ ] Possibilità di aggiungere piu di una foto per un marker 
- [ ] Script di installazione ruscomap
- [x] Standardizzare gli script con controllo "myusername"
    - [ ] Standardizzare con le varialibili del <code>default.json</code> gli script
    - [ ] File config per popolare default.json e gli script
- [ ] Creare logo RuscoMap

<br>

---
<br><br>

# ISTRUZIONI INSTALLAZIONE

## Installazione dipendenze

#### Installa mariadb
<code>sudo apt update && sudo apt install mariadb</code>

#### Installa node e nvm
Curl da sito ufficiale [qui](https://github.com/nvm-sh/nvm?tab=readme-ov-file#install--update-script) <br>
_trobleshooting: cerca nvm in .bashrc_

## Installazione ruscomap

#### Clona il git
```
# crea la cartella
mkdir /var/www/html/leaflet/; cd /var/www/html/leaflet/;

# clona il repo
git clone https://git.lattuga.net/scossa/ruscomap.git
```

#### Personalizza il file di configurazione db
<code>nano /var/www/html/leaflet/ruscomap/config/default.json</code>

#### Inizializza db
```
# usa la versione node spcificata nel file .nvmrc
cd /var/www/html/leaflet/ruscomap/; nvm use 

# sempre da cartella git
cd /var/www/html/leaflet/ruscomap/; 

# inzializza Db
mysql < intDb.sql
```
#### Apri porta sul firewall
<code>sudo iptables -A INPUT -p tcp --dport 3000 -j ACCEPT</code>

#### Crea il servzio
<code>nano /etc/systemd/system/ruscomap.service</code>

```
[Unit]
Description=Ruscomap Service
After=network.target

[Service]
User=<utente_del_config/default.json>
WorkingDirectory=/var/www/html/leaflet/ruscomap/
ExecStart=/bin/bash -c "node index.js"
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
```
##### avvialo e abilitalo a startarsi in automatico
```
sudo systemctl start ruscomap.service
sudo systemctl enable ruscomap.service
```

#### Crea il file conf di apache

<code>nano /etc/apache2/site-enabled/ruscomap.conf</code>

```
#PORT 80 RUSCOMAP
<VirtualHost ruscomap.myserver.it:80>

DocumentRoot /var/www/html/leaflet/ruscomap/public
ServerName ruscomap.myserver.it

ProxyPass / http://localhost:3000/
ProxyPassReverse /  http://localhost:3000/

RewriteEngine on
RewriteCond %{HTTP:Upgrade} =websocket
RewriteRule /(.*) ws://localhost:3000/$1 [P,L]

ErrorLog ${APACHE_LOG_DIR}/ruscomap.log
CustomLog ${APACHE_LOG_DIR}/ruscomap-access.log combined

</VirtualHost>
```
##### restarta apache
```
sudo systemctl restart apache2.service
```

<br>

# ISTRUZIONI ADMIN

## Script per cancellare tutti i record della table "markers" più vecchi di 24h (automatico)

Si trova in [<code>/var/www/html/leaflet/ruscomap/script/pulisci_vecchio_rusco.sh</code>](script/pulisci_vecchio_rusco.sh)

### Imposta lo script su cron per essere eseguito ogni 24h

#### Per eseguire tutti i giorni a mezzanotte un script che elimina tutti i marker più vecchi di 24h:

```
# Entra in modalità edit su cron:
crontab -e

# Edita il file aggiungendo la riga:
0 0 * * * /var/www/html/leaflet/ruscomap/script/pulisci_vecchio_rusco.sh

# Assicurati che lo script abbia i permessi di esecuzione:
ls -l /var/www/html/leaflet/ruscomap/script/pulisci_vecchio_rusco.sh

# Se mancano, impostali:
chmod +x /var/www/html/leaflet/ruscomap/script/pulisci_vecchio_rusco.sh
```

## Script per cancellare tutti i record della table "markers" più vecchi di 24h (manuale)

Si trova in [<code>/var/www/html/leaflet/ruscomap/script/pulisci_manualmente_vecchio_rusco.sh</code>](script/pulisci_manualmente_vecchio_rusco.sh)

## Script per aggiornare ruscomap

Si trova in [<code>/var/www/html/leaflet/ruscomap/script/AggiornaRuscoMap.sh</code>](script/AggiornaRuscoMap.sh)

## Script per cancellare tutti i record della table "markers"

Si trova in [<code>/var/www/html/leaflet/ruscomap/script/delete_rusco.sh</code>](script/delete_rusco.sh)

## Cancella un singolo record del db

```
mariadb -u <utente_del_config/default.json> -p

show databases;
use ruscomap;
show tables;
select * from markers;
DELETE FROM markers WHERE filename = '0a9f02167f85c845db2d4b81bbeef9d5';
```