🎭 HCAutomate Pi

Manuel utilisateur — Génération et publication automatique de l'agenda Human Comédie

1 Présentation générale

HCAutomate Pi est une application web qui génère et publie automatiquement l'agenda de l'association Human Comédie sur WordPress. Elle tourne en permanence sur le Raspberry Pi 5 et est accessible depuis n'importe quel navigateur sur le réseau local.

Fonction	Description
Chargement événements	Récupère spectacles et stages depuis l'API HelloAsso
Génération affiche	Deux thèmes : Programme (liste) et Cartes
Descriptions HTML	Scraping automatique depuis chaque page HelloAsso via Chromium
Publication WordPress	Mise à jour du bloc HTML dans la page "Agenda"
Publication automatique	Cron quotidien à 07h00

2 Accès à l'application

Depuis n'importe quel navigateur sur le réseau local :

http://192.168.1.60:3141    ← adresse IP du Pi
http://FSA-PI5.local:3141  ← nom réseau

Barre de titre

Élément	Rôle
Pastille HelloAsso	Verte = connecté · Rouge = erreur credentials
Pastille WordPress	Verte = connecté · Rouge = erreur
🕐 Dernière publication	Date et heure de la dernière publication réussie
déployé le …	Date du dernier redémarrage du serveur
⚡ Publier maintenant	Lance le pipeline complet immédiatement

3 Onglet Agenda

Paramètres

Champ	Description
Semaines à venir	Fenêtre temporelle : 2 / 4 / 6 / 8 / 12 semaines (défaut : 4)
Thème	`Programme (liste)` ou `Cartes`
Texte pied de page	Mention affichée en bas de l'affiche (ex : "Réservations conseillées")

Ces préférences sont sauvegardées automatiquement et utilisées par la publication cron quotidienne.

Chargement

Cliquez sur ⬇️ Charger — l'application interroge HelloAsso et affiche les événements groupés par mois dans la période sélectionnée.

Sélection

Cochez/décochez individuellement chaque événement. Utilisez Tout cocher ou Tout décocher pour sélectionner en masse.

Aperçu

Cliquez sur 🔄 Aperçu pour générer le rendu visuel à droite.

Thème Cartes : chaque carte affiche la miniature, le titre, le lieu, la date et un bouton "+ Voir plus" qui déplie la description HTML complète récupérée depuis HelloAsso par scraping Chromium.

Actions

Bouton	Action
🔄 Aperçu	Génère le rendu visuel avec les événements sélectionnés
💾 Exporter	Télécharge le fichier HTML sur votre ordinateur
🌐 WordPress	Publie immédiatement les événements sélectionnés sur la page Agenda

4 Onglet Configuration

HelloAsso API

Champ	Description
Client ID	ID de l'application OAuth HelloAsso
Client Secret	Clé secrète (confidentielle)
Slug organisation	Identifiant de l'association dans l'URL (ex : `human-comedie`)

Cliquez 💾 Sauvegarder & Tester — la pastille HelloAsso doit passer au vert.

WordPress

Champ	Description
URL du site	Adresse racine (ex : `https://humancomedie.fr`)
Identifiant	Nom d'utilisateur WordPress
Mot de passe d'application	Généré dans WordPress → Utilisateurs → Profil → Mots de passe d'application

⚠️ Le mot de passe d'application est différent de votre mot de passe de connexion WordPress.
La page cible doit exister avec le slug agenda et contenir un bloc . L'application ne crée jamais de page.

5 Publication manuelle

⚡ Publier maintenant

Pipeline complet exécuté dans l'ordre :

Authentification HelloAsso
Récupération des événements (N semaines configurées)
Scraping des descriptions HTML depuis chaque page HelloAsso (Chromium)
Génération de l'affiche avec le thème sauvegardé
Publication dans le bloc HTML de la page WordPress "Agenda"
Enregistrement de l'horodatage

🌐 WordPress (depuis l'aperçu)

Publie les événements actuellement sélectionnés — sans re-chargement depuis HelloAsso ni scraping.

Ligne de commande

cd ~/prj-hcautomate && node publish.js

6 Publication automatique

Une tâche cron s'exécute chaque matin à 07h00 et lance le pipeline complet avec la configuration sauvegardée.

Vérifier / modifier

# Voir la tâche planifiée
crontab -l

# Modifier l'heure
crontab -e

Logs

cat ~/prj-hcautomate/publish.log

⚠️ Le Raspberry Pi doit être allumé pour que le cron s'exécute.

7 Journal des activités

Le journal en bas de l'onglet Agenda affiche en temps réel :

Icône	Signification
✅	Opération réussie (vert)
❌	Erreur (rouge)
📍 fichier:ligne	Localisation précise de l'erreur dans le code
HH:MM:SS	Horodatage de chaque étape

8 Dépannage

❌ Les événements ne se chargent pas

Vérifier Client ID / Secret / Slug dans Configuration et cliquer sur Sauvegarder & Tester. La pastille HelloAsso doit passer au vert.

❌ "Page Agenda introuvable sur WordPress"

Créer manuellement la page WordPress avec le slug agenda et y ajouter un bloc HTML personnalisé via l'éditeur Gutenberg.

❌ "Aucun bloc HTML personnalisé trouvé"

La page Agenda existe mais ne contient pas de bloc . Ajouter ce bloc dans l'éditeur WordPress.

❌ Erreur 401 / 403 WordPress

Régénérer le mot de passe d'application dans WordPress (Utilisateurs → Profil → Mots de passe d'application) et le mettre à jour dans la Configuration.

⚠️ Description manquante dans les cartes (fallback texte)

Normal si Cloudflare bloque temporairement le scraping. L'événement est publié avec la description textuelle. Relancer manuellement si nécessaire.

❌ Interface inaccessible (cannot connect)

Le serveur n'est pas démarré. Sur le Pi : bash ~/prj-hcautomate/restart.sh

❌ La publication cron ne s'exécute pas à 07h00

Vérifier crontab -l, consulter ~/prj-hcautomate/publish.log et s'assurer que le Pi est allumé.