# Deploy in produzione

Promemoria su dove gira il bot e come si aggiorna. Niente password qui: stanno nel `.env` del server.

## Server

| Cosa | Valore |
|---|---|
| Host | `194.163.181.219` (hostname `vmi2876515`) |
| Accesso | `ssh root@194.163.181.219` (chiave SSH già configurata su questo Mac) |
| Cartella progetto | `/var/www/html/userbot` |
| Compose | `/var/www/html/userbot/docker-compose.yml` (quello base, il server è x86) |

Container:

| Container | Ruolo |
|---|---|
| `userbot_telegram_bot` | il bot (`npm run bot`), quello da riavviare dopo un deploy |
| `userbot_nodejs` | container di servizio per script manuali (`create-session`, `login`) |
| `userbot_mysql` | MySQL 8, dati nel volume `mysql_data` |
| `userbot_phpmyadmin` | phpMyAdmin |

Il codice è montato nel container (`.:/app`): per aggiornarlo basta copiare i file e
riavviare. **Non serve** una nuova build, a meno che non cambi `package.json`.

Se cambi il `.env`, `restart` **non basta** (le variabili si leggono solo alla creazione
del container): serve `docker compose up -d --no-deps --force-recreate bot nodejs`.

## Come si fa il deploy

Il deploy si fa **copiando i file via scp**, non con git:

- il repository GitHub `Stefy88-bot/madelineuserbot` non è più accessibile (dal 2026-11-08
  risponde "Repository not found" sia da HTTPS sia da SSH);
- sul server git è fermo a `61ad7a2` e tutte le modifiche successive sono non committate;
- `deploy.sh` fa `git pull origin main`, ma `main` è indietro rispetto a `master`.
  **Non usare `deploy.sh`.**

Procedura:

```bash
# 1. backup dei file sul server
TS=$(date +%Y%m%d-%H%M%S)
ssh root@194.163.181.219 "cd /var/www/html/userbot && for f in database.js telegram-bot.js; do cp -p \$f \$f.bak.<motivo>-$TS; done"

# 2. backup delle tabelle toccate (fuori da /var/www/html: contiene le session string)
ssh root@194.163.181.219 "mkdir -p /root/backups && docker exec userbot_mysql sh -c 'mysqldump -uroot -p\"\$MYSQL_ROOT_PASSWORD\" \"\$MYSQL_DATABASE\" sessions app_settings 2>/dev/null' > /root/backups/userbot-<motivo>-$TS.sql"

# 3. copia dei file
scp database.js telegram-bot.js root@194.163.181.219:/var/www/html/userbot/

# 4. controllo sintassi dentro il container
ssh root@194.163.181.219 "docker exec userbot_telegram_bot sh -c 'node --check database.js && node --check telegram-bot.js'"

# 5. riavvio solo del bot (prima controlla nei log che non ci sia un /add_members in corso)
ssh root@194.163.181.219 "docker logs --since 30m userbot_telegram_bot 2>&1 | tail"
ssh root@194.163.181.219 "cd /var/www/html/userbot && docker compose restart bot"

# 6. log di avvio
ssh root@194.163.181.219 "docker logs --since 1m userbot_telegram_bot"
```

All'avvio è normale vedere `npm error signal SIGTERM`: è il vecchio processo fermato dal
riavvio. La riga "Bot Telegram avviato" non compare mai (Telegraf non la stampa mentre il
bot è in polling): se dopo `✅ Hash per i nuovi login: ...` non ci sono errori, il bot è su.

## Rollback

```bash
ssh root@194.163.181.219 "cd /var/www/html/userbot && cp -p telegram-bot.js.bak.<motivo>-<TS> telegram-bot.js && cp -p database.js.bak.<motivo>-<TS> database.js && docker compose restart bot"
```

## Database

```bash
ssh root@194.163.181.219 "docker exec -it userbot_mysql sh -c 'mysql -uroot -p\"\$MYSQL_ROOT_PASSWORD\" \"\$MYSQL_DATABASE\"'"
```

Backup fatti prima dei deploy: `/root/backups/` sul server.

## Storico deploy

| Data | Cosa | Backup |
|---|---|---|
| 2026-11-08 | Multi hash API (commit `e08460f`): tabella `telegram_api_credentials`, ogni sessione usa il proprio hash. Migrati 2 hash: #1 `30540920` (predefinito, 54 sessioni), #2 `39855742` (62 sessioni, prima ignorate dal bot) | file `*.bak.multihash-20261108-110019`, DB `/root/backups/userbot-predeploy-multihash-20261108-110019.sql` |
| 2026-11-08 | Reset su richiesta: svuotate `sessions`, `telegram_api_credentials`, `telegram_api_settings` e le chiavi `flood_cooldown_*` / `last_add_session_id` di `app_settings` (si riparte con hash e numeri nuovi). `group_members` non toccata. Tolte anche `TELEGRAM_API_ID`/`TELEGRAM_API_HASH` dal `.env` del server (backup `.env.bak.no-api-20261108-110500`): gli hash si gestiscono solo dal bot |
| 2026-11-08 | Proxy: `/create` prova fino a 5 porte sticky DataImpulse (20s l'una) e salva quella che risponde in `sessions.proxy_port`; tutte le operazioni successive usano quella. Motivo: alcune porte non rispondono (es. 18751) e prima il login falliva sempre per quel numero | file `*.bak.proxyport-20261108-113816` |

## Note sul proxy (DataImpulse)

- Il `.env` del server ha fine riga Windows (`\r\n`). Docker li toglie, ma se testi a mano
  leggendo il `.env` (es. con `curl --proxy-user`) togli il `\r`, altrimenti DataImpulse
  risponde `407 NO_USER` e sembra che le credenziali siano sbagliate.
- Test rapido del proxy dal server: `curl --socks5-hostname gw.dataimpulse.com:10000 --proxy-user "LOGIN:PASSWORD" https://api.ipify.org`
  (deve stampare un IP). DB completo `/root/backups/userbot-full-before-reset-20261108-110337.sql` |
