dm-telegram-bot/README.md

# BOT Telegram per i gruppi dei corsi del dipartimento di matematica

Descrizione TODO

## Development

Installare tutti i pacchetti necessari con:

```bash
pip install -r requirements.txt
```

Il token va messo dentro un file `.env` nella root del progetto. Per crearne uno di esempio:

```bash
echo "BOT_TOKEN=123456789:ABCdefGhIjKlMnOpQrStUvWxYz" > .env
```


## Funzionalità del bot di ingresso

* [x] Manda un messaggio di benvenuto
* [ ] Spunta un bottone per autenticarsi con Google con account di ateneo
* [ ] Viene generato un link unico per del tipo `bot.phc.dm.unipi.it/login?sid=1234567890ABCDEF`
* [ ] Una volta che clicca questo link, viene salvato nel database: user_id telegram, sid
* [ ] Se il login va a buon fine (ovvero se è di matematica), manda un messaggio dove è possibile visualizzare (con caselle carine organizzati per anno / area matematica) i link di accesso per i gruppi

> **NOTA:** Questo implica che vi sarà un link pubblico, quindi la gente potrebbe accedere ai gruppi senza essere autenticata se qualcuno dovesse passargli quel link. Per evitare spam ed esterni indesiderati, il bot inserito nel gruppo, ogni volta che un utente accede, controlla se il suo ID è presente nel database. Se si, non ci sono problemi, altrimenti viene silenziato, e viene mandato un messaggio (pubblico) sul gruppo dicendo qualcosa del tipo "Ciao @utente, per accedere ai gruppi devi prima autenticarti con il bot di ingresso. Per farlo, clicca qui" e spunta sotto un bottone (lo stesso che abbiamo usato nel bot di ingresso)


## Side notes

* [ ] Scegliere se per ogni gruppo creare un topic "domande esame" o se utilizzare gli `#hashtags`
* [ ] Scegliere se i canali tipo "Rappresentati" e "PHC" debbano essere effettivamente canali o un gruppo normale