JumpStart Reporting

Webapp Streamlit multi-clients pour generer des rapports PPTX a partir des exports Vista Social + templates PowerPoint (compatibles Keynote).

Prerequis

• Python 3.11+ (recommande: 3.12)
• pip

Installation locale

pip install -r requirements.txt

Lancer l'app

export TEAM_PASSWORD=\"mon_mot_de_passe_equipe\"
streamlit run app.py

Utilisation

1. Choisir un client.
2. Uploader les CSV Vista Social du mois (par reseau).
3. (Optionnel) Uploader les CSV du mois precedent pour les deltas.
4. Uploader le CSV top posts si demande par le client.
5. Generer le PPTX.

Ajouter un client

1. Ajouter le template PPTX dans templates/.
2. Creer un fichier engine/clients/<client_id>.json avec:
   • slug, label, template
   • networks et top_posts
   • next_steps_count
3. Verifier les tags {{...}} dans le template:
   • global.*, <reseau>.*, top_<reseau>.*
4. Ajouter les formes nommees pour les images:
   • TOP_POST_INSTAGRAM_1, TOP_POST_FACEBOOK_1, etc.

Docker (optionnel)

docker build -t jumpstart-reporting .
docker run -p 8501:8501 -e TEAM_PASSWORD=\"mon_mot_de_passe_equipe\" jumpstart-reporting

Checklist rapide

• Les CSV Vista Social contiennent les colonnes attendues (followers, impressions, interactions, posts, reach).
• Les tags dans le PPTX correspondent aux tags generes par l'app.
• Les images top posts sont nommees TOP_POST_<RESEAU>_1.

jumpstart-reporting

jumpstart-reporting