pySonnerie/frontend/README_FRONTEND.md

pySonnerie Frontend (Flask)

Frontend web responsive en Flask pour piloter le backend pySonnerie deja en place.

Fonctions

• Page de connexion (URL backend + identifiants Basic Auth)
• Tableau de bord de gestion des triggers (creation/modification/suppression)
• Lancement manuel d'un trigger (/api/play/{trigger_id})
• Arret audio (/api/stop)
• Gestion du stockage audio dans backend/data/musiques (televersement, telechargement, suppression)

Installation

cd frontend
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Si présence d'un proxy, la dernière commande sera pip install -r requirements.txt --proxy http://proxy:port.

Execution

cd frontend
source .venv/bin/activate
python run.py

Application dispo sur http://127.0.0.1:5000.

Production (Debian + systemd)

Le frontend peut tourner en production avec Gunicorn et un service systemd.

cd /opt/pySonnerie/frontend
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Copier le service fourni:

sudo cp systemd/pysonnerie-frontend.service /etc/systemd/system/

Adapter au besoin les variables dans le fichier de service (FRONTEND_SECRET_KEY, FRONTEND_BIND) puis activer:

sudo systemctl daemon-reload
sudo systemctl enable --now pysonnerie-frontend.service
sudo systemctl status pysonnerie-frontend.service

Le frontend sera alors servi par Gunicorn sur l'adresse definie par FRONTEND_BIND (par defaut 0.0.0.0:5000).

Notes

• Le frontend appelle le backend en HTTPS avec certificat autosigne (verify=False).
• Les fichiers audio sont manipules localement dans backend/data/musiques.
• Formats audio acceptes: .mp3, .wav, .ogg, .flac, .aac, .m4a.