ruscomap/README.md

# RuscoMap
 
 _Una mappa webapp della propria città dove degli utenti in anonimo posso scattare una foto agli oggetti/mobili abbandonati per strada e segnalarli a tutti i visitatori della mappa._ 
 <br> Sulla falsa riga del "_te lo regalo se vieni a prenderlo_", questo è più il "_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<br>
[in_test] Check periodico marker (aggiunge nuovi e rimuove > 24h) <br>
[in_test] Cancellare i marker creati > di 24h (sia record db che img) <br>

## Possibili Implementazioni

Feature/fix scritte in ordine di priorità:

[X] Bottone "aggiungi marker" quando premuto diventa una "X" che se premuta annulla l'inserimento marker <br>
[ ] Quando viene aggiunto un nuovo marker l'icona in alto a dx rimane X rossa invece di tornare in modalità visualizzazione <br>
[ ] Mostrare data/ora pubblicazione del marker per far capire al visitatore quanto tempo fa è stato avvistato il rusco <br>
[X] Al momento si possono aggiungere infiniti marker (temporanei), da fixare <br>
[ ] Formattare visualizzazione form inserimento marker da mobile <br>
[ ] Al momento sul marker temporaneo si vede l'immagine rotta. fixare: sul temporaneo non bisogna mostrare nulla <br>
[ ] Creare form per ricercare tra i titoli/descrizioni dei marker esistenti (query esempio: "divano") <br>
[ ] Milgiorare css del form inserimento dati marker <br>
[ ] Inserire la posizione del marker tramite il gps dello smartphone<br>
[ ] Scatta la foto del marker da uploadare direttamente in app (su alcuni smartphone gia lo fa) <br>
[ ] Creare form e gestire login utenti <br>
[ ] Possibilità di aggiungere piu di una foto per un marker <br>

<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

## Cancella un 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';
```

## Script per aggiornare ruscomap

<code>nano /var/www/html/leaflet/ruscomap/AggiornaRuscoMap.sh</code>

```
echo -e "Stoppo ruscomap..."
systemctl stop ruscomap.service
sleep 1

cd /var/www/html/leaflet/ruscomap
echo -e "\nEseguo git pull..."
git pull
sleep 1

echo -e "Do permessi www-data..."
chown -R www-data:www-data /var/www/html/leaflet/ruscomap/public

echo -e "restarto apache e ruscmap"...
systemctl restart apache2.service
systemctl start ruscomap.service

echo -e "Aggiornamento completato!\n"
```