SLQNE Hockey Stats

SLQNE Hockey Stats est un add-on Home Assistant qui récupère automatiquement les statistiques et classements des équipes sur le site du Spordle – Ligue de hockey mineur de la Capitale-Nationale (SLQNE).
L’add-on lit les sections Classements et Statistiques des pages d’équipes Spordle, et publie les données dans Home Assistant via MQTT Discovery.

---

⚙️ Fonctionnement

1. Requête HTTP et parsing HTML (Requests + BeautifulSoup)
   L’add-on interroge la page Spordle d’une équipe et extrait les tableaux HTML de statistiques et de classement.

2. Conversion structurée
   Les données sont nettoyées et converties en structures JSON pour être lisibles par les cartes Lovelace personnalisées (rseq-standings-card, rseq-lastgame-card, etc.), entièrement compatibles.

3. Publication MQTT
   Grâce à MQTT Discovery, les capteurs apparaissent automatiquement dans Home Assistant, sans configuration manuelle.
   Les entités publiées comprennent notamment :

   • sensor.slqne_<equipe>_status — état du scraping (succès/erreur)
   • sensor.slqne_<equipe>_standings — classement général
   • sensor.slqne_<equipe>_players — statistiques des joueurs
   • sensor.slqne_<equipe>_goalies — statistiques des gardiens

---

🚀 Installation

1. Ajoute ce dépôt dans Home Assistant :
   Paramètres → Modules complémentaires → Boutique → menu (⋮) → Dépôts → entre l’URL du dépôt.
   Ou clique sur le bouton ci-dessous :

   

2. Installe l’add-on SLQNE Hockey Stats depuis la liste des add-ons locaux.

3. Configure les équipes et les paramètres MQTT (voir plus bas).

4. Démarre l’add-on et vérifie les logs Home Assistant — les capteurs MQTT devraient être automatiquement créés.

---

🧩 Exemple de configuration

entity_prefix: slqne
update_interval: 3600  # vérifie les données toutes les heures
mqtt_host: core-mosquitto
mqtt_port: 1883
mqtt_username: tonuser
mqtt_password: tonmotdepasse
discovery_prefix: homeassistant

teams:
  - name: "Hayden Hockey"
    team_url: "https://page.spordle.com/fr/ligue-hockey-mineur-capitale-nationale/schedule-stats-standings/bf27e08e-8d52-41be-a097-a6cf79f4466a?tab=standings&scheduleId=183363"
  - name: "Loik Hockey"
    team_url: "https://page.spordle.com/fr/ligue-hockey-mineur-capitale-nationale/schedule-stats-standings/13c38dd1-e464-4835-af5f-75be8561daf6?tab=standings&scheduleId=183367"

---

🔧 Options disponibles

Clé	Description	Valeur par défaut
teams	Liste des équipes (nom + URL Spordle)	[]
entity_prefix	Préfixe des entités MQTT publiées	"slqne"
update_interval	Intervalle de mise à jour en secondes	3600
mqtt_host	Adresse du broker MQTT	"core-mosquitto"
mqtt_port	Port du broker MQTT	1883
mqtt_username	Nom d’utilisateur MQTT	""
mqtt_password	Mot de passe MQTT	""
discovery_prefix	Préfixe MQTT Discovery	"homeassistant"

---

🧠 Capteurs publiés

Chaque équipe configurée publie plusieurs capteurs MQTT :

Entité exemple	Description
sensor.slqne_hayden_hockey_status	État de l’extraction (succès/erreur)
sensor.slqne_hayden_hockey_standings	Classement complet (avec standings[])
sensor.slqne_hayden_hockey_players	Statistiques détaillées des joueurs
sensor.slqne_hayden_hockey_goalies	Statistiques des gardiens
sensor.slqne_hayden_hockey_last_game (optionnel)	Dernier match détecté, si disponible

---

🧱 Intégration Lovelace

Compatible avec les mêmes cartes personnalisées utilisées pour RSEQ :

• rseq-standings-card.js — affichage dynamique des classements
• rseq-lastgame-card.js — affichage du dernier match avec logos
• rseq-nextgame-card.js (facultatif pour autres ligues)

💡 Tu peux réutiliser ces cartes simplement en changeant le entity: vers les entités sensor.slqne_*.

---

🧰 Architectures supportées

---

🧑‍💻 Communauté & Support

• Home Assistant Community — pour questions, partages et exemples Lovelace.
• Spordle – Ligue de hockey mineur de la Capitale-Nationale — source officielle des données.

---