openbot/DEPLOY_NOTES.md

Notes de deploiement - OpenSquared PWA

Date: 2026-04-26

Depot

https://gitea.open-squared.tech/admin/openbot.git
branche main

Commits importants:

fb8cc4d Initial PWA assistant proof of concept
94148e8 Rename installed PWA to OpenSquared
1f815fa Version PWA icon asset to refresh Android cache
1b9933d Fix voice button audio unlock hang

Derniers changements locaux a deployer:

- Service systemd `opensquared-assistant` pour tourner hors session Putty.
- Raccourci optionnel `/usr/local/bin/openbot`.
- Mode mains libres: `Demarrer` ecoute en continu, envoi apres 2 secondes de silence.
- TTS par defaut via voix navigateur `fr-FR` pour eviter l'accent anglais Groq.
- Voix navigateur adoucie avec preference pour voix feminine francaise.
- Ajout de contacts email par conversation.
- Carnet de contacts prod dans `/root/openbot/data/contacts.json`.
- Cache PWA: opensquared-assistant-v6.

VPS

Serveur: 46.202.173.47
Dossier app: /root/openbot
Domaine: bot.open-squared.tech
URL: https://bot.open-squared.tech

L'app Flask a ete testee sur:

http://46.202.173.47:8080/health
https://bot.open-squared.tech/health

Python

Sur le VPS, python3 -m venv .venv a d'abord echoue car python3.12-venv manquait.

Correctif:

apt update
apt install -y python3.12-venv
cd /root/openbot
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Service systemd

Installer ou mettre a jour le service:

cd /root/openbot
cp deploy/opensquared-assistant.service /etc/systemd/system/opensquared-assistant.service
systemctl daemon-reload
systemctl enable --now opensquared-assistant

Commandes quotidiennes:

systemctl start opensquared-assistant
systemctl stop opensquared-assistant
systemctl restart opensquared-assistant
systemctl status opensquared-assistant
journalctl -u opensquared-assistant -f

Raccourci optionnel:

install -m 755 /root/openbot/deploy/openbot /usr/local/bin/openbot
openbot start
openbot stop
openbot restart
openbot logs

HTTPS et Nginx Docker

Le VPS utilise deja un docker-compose.yml avec un conteneur nginx.

Montage nginx:

/root/tradon/nginx/conf -> /etc/nginx/conf.d
/etc/letsencrypt -> /etc/letsencrypt:ro
/root/tradon/nginx/certbot -> /var/www/certbot

Le bloc HTTP doit servir les challenges avant la redirection:

location /.well-known/acme-challenge/ {
    root /var/www/certbot;
}

location / {
    return 301 https://$host$request_uri;
}

Certificat cree avec:

certbot certonly --webroot \
  -w /root/tradon/nginx/certbot \
  -d bot.open-squared.tech

Le bloc HTTPS bot.open-squared.tech doit utiliser:

ssl_certificate /etc/letsencrypt/live/bot.open-squared.tech/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/bot.open-squared.tech/privkey.pem;

Proxy depuis nginx Docker vers Flask sur l'hote:

proxy_pass http://172.17.0.1:8080;

Verifier:

docker exec nginx nginx -t
docker exec nginx nginx -s reload
curl -I https://bot.open-squared.tech/health

PWA Android

Nom installe:

OpenSquared

Icone:

static/icons/icon-v2.svg

Pour forcer Android/Chrome a prendre la nouvelle icone:

1. git pull sur le VPS.
2. Ouvrir https://bot.open-squared.tech/icons/icon-v2.svg.
3. Desinstaller l'ancienne PWA.
4. Reinstaller depuis Chrome.

Cache et bouton micro

Le bouton Demarrer etait non reactif sur navigateur parce que unlockAudio() pouvait rester bloque sur audio.play() avec un audio vide.

Correctif applique:

• unlockAudio() utilise maintenant AudioContext.
• index.html charge /app.js?v=5.
• Service worker: opensquared-assistant-v5.
• Le bouton Demarrer lance le mode mains libres.
• Le message vocal est envoye automatiquement apres 2 secondes de silence.
• La voix par defaut est celle du navigateur en fr-FR, via TTS_PROVIDER=browser.
• La version v6 privilegie une voix feminine francaise si disponible sur l'appareil.
• Les contacts peuvent etre ajoutes en disant par exemple: Ajoute Sophie avec l'adresse sophie@example.com.
• Le service systemd definit CONTACTS_FILE=/root/openbot/data/contacts.json.

Si le bouton ne reagit pas apres un deploiement:

PC: Ctrl+F5
Android: fermer l'app, rouvrir Chrome, ou desinstaller/reinstaller la PWA

Si ca persiste, ouvrir F12 -> Console et lire l'erreur JS.