Sommaire général

Cette page présente l'organisation complète de la documentation du Projet Horizon. Elle permet d'en comprendre la logique générale, d'identifier le rôle de chaque partie et d'accéder directement aux chapitres correspondant à un besoin précis.

La documentation suit une progression allant des fondations fonctionnelles jusqu'à la gouvernance du projet. Elle peut être lue dans cet ordre pour découvrir Horizon progressivement, ou consultée de manière thématique à l'aide des parcours proposés ci-dessous.

Portée de la documentation

La structure de référence comprend 18 parties, 68 chapitres et 24 annexes planifiées. Certains regroupements pourront évoluer pendant la rédaction, mais les grands domaines fonctionnels et techniques présentés sur cette page constituent la structure de travail actuelle.

État de rédaction

Au 12 septembre 2026, les pages préliminaires et les chapitres 1 à 25 sont disponibles. Aucun chapitre ne demeure en consolidation dans les Parties I à VII ; les chapitres 26 à 68 restent planifiés.

• Disponible : page rédigée et intégrée au parcours de référence.
• En consolidation : page rédigée, dont les règles transversales restent à harmoniser avant validation.
• Planifié : emplacement prévu dans la structure, sans contenu de référence validé à ce stade.

Prochaine étape

La prochaine partie à rédiger est la Partie VIII — Systèmes fonctionnels de La Tanière, à commencer par le chapitre 26 consacré au système de progression. Les statuts ci-dessus concernent la rédaction documentaire et ne constituent pas des statuts de développement logiciel.

Pages préliminaires

Les pages préliminaires fournissent les repères nécessaires avant d'aborder le contenu fonctionnel et technique du projet.

• Statut du document : Précise la portée, le niveau de validation et l'état général de la documentation.
• Historique des versions : Retrace les principales évolutions de la documentation et les modifications apportées à chaque version.
• Conventions utilisées dans le document : Définit les statuts, repères temporels et niveaux de contrainte employés dans l'ensemble de la documentation.
• Glossaire général : Définit les notions structurantes nécessaires à la lecture courante ; le référentiel exhaustif est prévu en Annexe A.
• Sommaire général : Présente la structure complète de la documentation et les différents parcours de lecture.

Vue d'ensemble de la documentation

Les dix-huit parties peuvent être regroupées en cinq grands ensembles de lecture. Ces ensembles facilitent l'orientation du lecteur sans modifier la structure officielle du document.

Ensemble	Parties	Finalité
Fondations fonctionnelles	I à VI	Comprendre Horizon, son Noyau, ses données, son équipage et les moyens techniques mis à la disposition de P.O.U.B.E.L.L.E.
Interfaces et systèmes de La Tanière	VII à X	Définir les interactions Twitch, Discord et Web ainsi que les systèmes communautaires de La Tanière.
Construction et exploitation technique	XI à XIV	Concevoir, tester, déployer, surveiller et maintenir la Plateforme Horizon.
Transition et évolution	XV à XVII	Migrer l'existant, organiser le développement et préparer les évolutions futures.
Gouvernance documentaire	XVIII et annexes	Conserver les décisions, administrer la documentation et rassembler les référentiels détaillés.

Parcours de lecture

La documentation n'a pas nécessairement besoin d'être parcourue intégralement dans l'ordre. Les parcours suivants permettent de cibler les chapitres les plus utiles selon l'objectif recherché.

Objectif	Parcours recommandé
Découvrir le Projet Horizon	Pages préliminaires, puis Parties I et II.
Comprendre l'équipage, les identités et les données	Parties III à V, puis Partie IX pour les permissions et la vie privée.
Comprendre la place de P.O.U.B.E.L.L.E.	Partie VI, complétée par les Parties II et VII.
Étudier les interfaces et les systèmes de La Tanière	Parties VII à X.
Préparer le développement technique	Parties XI à XVI.
Suivre les décisions et l'évolution du projet	Parties XVII et XVIII, puis annexes V, W et X.

Partie I — Vision et principes fondateurs

Cette partie présente l'origine, la finalité et les principes structurants du Projet Horizon. Elle fournit les repères nécessaires pour comprendre la démarche, les acteurs concernés et les limites générales de la plateforme avant d'aborder son fonctionnement détaillé.

• Disponible — Chapitre 1 : Présentation du Projet Horizon
  Définit l'origine du projet, son besoin initial et sa relation avec La Tanière et P.O.U.B.E.L.L.E.

• Disponible — Chapitre 2 : Vision d'ensemble
  Présente les principales composantes de la Plateforme Horizon et la manière dont elles relient P.O.U.B.E.L.L.E., l'équipage et les systèmes du vaisseau.

• Disponible — Chapitre 3 : Objectifs du projet
  Formalise les résultats fonctionnels, communautaires et techniques recherchés par le Projet Horizon.

• Disponible — Chapitre 4 : Principes fondamentaux de conception
  Établit les règles communes qui doivent guider les décisions relatives aux données, aux événements, aux permissions et aux actions.

• Disponible — Chapitre 5 : Acteurs d'Horizon
  Identifie les personnes, rôles, entités et services amenés à interagir avec la plateforme.

• Disponible — Chapitre 6 : Périmètre général
  Délimite les responsabilités d'Horizon et celles conservées par Twitch, Discord, Streamer.bot, OBS et les autres services externes.

Partie II — Architecture fonctionnelle du Noyau

Cette partie décrit le fonctionnement du Noyau Horizon, centre de coordination et de contrôle de la Plateforme. Elle explique comment les événements sont reçus, enrichis, vérifiés, traités et transformés en actions autorisées.

• Disponible — Chapitre 7 : Le Noyau Horizon
  Définit les responsabilités, les limites et les relations du Noyau avec P.O.U.B.E.L.L.E., les interfaces, les données et les services externes.

• Disponible — Chapitre 8 : Cycle de traitement d'un événement
  Décrit le parcours complet d'un événement, depuis sa réception jusqu'à l'exécution, la propagation et la journalisation de ses conséquences.

• Disponible — Chapitre 9 : État global et événements Horizon
  Définit l'état global Horizon, les différentes catégories d'événements et leurs relations.

Partie III — Identité et équipage

Cette partie définit la manière dont Horizon représente les personnes connues, leur relation actuelle avec l'équipage et les comptes externes qu'elles contrôlent. Elle encadre la création d'une identité centrale, la liaison vérifiée des comptes et la résolution contrôlée des doublons.

• Disponible — Chapitre 10 : Identité Horizon
  Définit l'identité centrale d'une personne connue d'Horizon, ses états, son statut communautaire et ses relations avec les comptes externes.

• Disponible — Chapitre 11 : Liaison des comptes
  Précise les mécanismes de liaison, de vérification, de déliaison et de remplacement des comptes Twitch et Discord. L'accès Web utilise l'un de ces comptes sans créer un troisième compte externe.

• Disponible — Chapitre 12 : Fusion d'identités
  Établit la procédure contrôlée permettant de réunir des identités vérifiées comme appartenant à une même personne, en conservant l'identité la plus ancienne et en appliquant les stratégies définies pour chaque donnée.

Partie IV — Modèle fonctionnel des données

Cette partie recense les données nécessaires au fonctionnement d'Horizon et définit les règles qui garantissent leur cohérence. Elle constitue la base fonctionnelle du futur modèle de données technique.

• Disponible — Chapitre 13 : Catalogue des données Horizon
  Définit les familles, les rattachements, les axes de production, de rôle et de cycle de vie ainsi que les métadonnées communes des données nécessaires au fonctionnement d'Horizon.

• Disponible — Chapitre 14 : Rattachement, autorité, priorité et cohérence des données
  Distingue le rattachement, la provenance et l'autorité fonctionnelle, puis sépare la sélection, le calcul, la fusion et l'arbitrage avant d'encadrer les conflits et le fonctionnement dégradé.

Partie V — Historique, statistiques et mémoire

Cette partie distingue l'état actuel de la plateforme, les événements conservés à des fins d'historique et la mémoire utilisable dans les interactions. Elle encadre également la construction prudente des statistiques et profils comportementaux.

• Disponible — Chapitre 15 : Historique Horizon
  Détermine les informations conservées dans le temps, leur contexte, leur niveau d'agrégation et leur durée de conservation.

• Disponible — Chapitre 16 : Mémoire de P.O.U.B.E.L.L.E.
  Définit les différentes temporalités de mémoire accessibles à P.O.U.B.E.L.L.E. ainsi que les règles de création, de révision, d'oubli et de divulgation des souvenirs.

• Disponible — Chapitre 17 : Statistiques et profil comportemental
  Encadre les mesures d'activité, de présence et de participation utilisées pour construire des tendances sans surinterpréter les comportements individuels.

Partie VI — P.O.U.B.E.L.L.E. et le LLM

Cette partie définit la manière dont P.O.U.B.E.L.L.E. utilise la Plateforme Horizon et les ressources techniques mises à sa disposition. Elle distingue clairement son identité du LLM, puis encadre la construction du contexte et l'accès aux outils.

• Disponible — Chapitre 18 : Place de P.O.U.B.E.L.L.E. dans Horizon
  Précise la relation entre l'intelligence du vaisseau et la plateforme qu'elle utilise, tout en garantissant la cohérence de son canon sur les différentes interfaces.

• Disponible — Chapitre 19 : Rôle du LLM
  Délimite les usages pertinents du modèle de langage, les traitements qui doivent rester déterministes et l'interdiction de toute exécution directe.

• Disponible — Chapitre 20 : Construction du contexte LLM
  Définit la sélection par le Noyau des informations, sources et restrictions applicables, puis la construction du contexte transmis au modèle selon la situation, l'identité du membre et les permissions.

• Disponible — Chapitre 21 : Actions et outils de P.O.U.B.E.L.L.E.
  Inventorie les catégories d'outils accessibles à P.O.U.B.E.L.L.E. et précise leurs règles d'autorisation, de confirmation et de journalisation.

Partie VII — Interfaces d'Horizon

Cette partie décrit les principaux points de contact entre la Plateforme Horizon, P.O.U.B.E.L.L.E. et l'équipage. Elle précise le rôle de chaque interface et organise la circulation cohérente des informations entre les plateformes.

• Disponible — Chapitre 22 : Extension Twitch
  Définit les interactions en direct, les événements Twitch, la connexion directe à la plateforme et la séparation de l'intégration OBS.

• Disponible — Chapitre 23 : Extension Discord
  Définit les interactions communautaires, les rôles, les messages, les notifications et leur synchronisation avec Horizon.

• Disponible — Chapitre 24 : Poste de commande Web
  Présente les espaces publics, membres, modérateurs et administratifs fournis par l'interface Web.

• Disponible — Chapitre 25 : Communications multiplateformes
  Organise l'adaptation et la diffusion d'une même information sur Twitch, Discord et le Web sans produire de notifications redondantes.

Partie VIII — Systèmes fonctionnels de La Tanière

Cette partie décrit les systèmes communautaires qui donnent à Horizon son utilité concrète dans La Tanière. Elle organise leur reprise progressive sans enfermer la plateforme dans les limites des solutions actuellement utilisées.

• Planifié — Chapitre 26 : Système de progression
  Définit la gestion commune de l'XP, des niveaux, des grades, des promotions et de leur historique.

• Planifié — Chapitre 27 : Protocole de Raid
  Prépare l'intégration du Protocole de Raid existant, de ses états, de ses scénarios et de ses manifestations audiovisuelles.

• Planifié — Chapitre 28 : Soundboard et points de chaîne
  Encadre les récompenses sonores, les variantes de P.O.U.B.E.L.L.E., les substitutions, les vétos et les remboursements.

• Planifié — Chapitre 29 : Modération
  Définit la coordination de la modération Twitch et Discord, l'historique des actions et les validations humaines nécessaires.

• Planifié — Chapitre 30 : Autres modules communautaires
  Réserve un cadre extensible aux événements, défis, missions, récompenses, succès et futurs systèmes de La Tanière.

Partie IX — Authentification, permissions, sécurité et vie privée

Cette partie définit les garanties nécessaires pour protéger les comptes, les données et les actions sensibles. Elle distingue l'accès à une information, son utilisation, sa modification et sa divulgation.

• Planifié — Chapitre 31 : Authentification et autorisation
  Encadre la connexion des utilisateurs, les sessions, les comptes liés et la révocation des accès.

• Planifié — Chapitre 32 : Modèle de permissions
  Définit les droits accordés aux membres, modérateurs, administrateurs, au Capitaine et à P.O.U.B.E.L.L.E. selon les services concernés.

• Planifié — Chapitre 33 : Classification des données
  Classe les informations selon leur sensibilité afin de déterminer leurs conditions d'accès, d'utilisation et de divulgation.

• Planifié — Chapitre 34 : Actions critiques
  Identifie les opérations à risque et définit leurs mécanismes de confirmation, d'annulation et d'audit.

• Planifié — Chapitre 35 : Vie privée et conservation
  Établit les principes de minimisation, de conservation, d'accès, de correction, d'export et de suppression des données personnelles.

Partie X — Conception du Poste de commande

Cette partie traite le Poste de commande comme un produit à part entière, et non comme une simple façade Web. Elle définit son organisation et les expériences propres aux membres, aux modérateurs, aux administrateurs et au Capitaine.

• Planifié — Chapitre 36 : Architecture de l'information
  Organise la navigation et l'accès aux fonctions selon les différents profils d'utilisateur.

• Planifié — Chapitre 37 : Expérience membre
  Définit le tableau de bord personnel, la fiche d'équipage, la progression, l'historique et les paramètres accessibles à un membre.

• Planifié — Chapitre 38 : Outils de modération
  Présente les vues, recherches et actions nécessaires à la modération coordonnée de Twitch et Discord.

• Planifié — Chapitre 39 : Administration
  Regroupe les fonctions de gestion de la plateforme, de ses modules, de ses membres, de ses paramètres et de sa santé générale.

• Planifié — Chapitre 40 : Poste du Capitaine
  Définit le centre de contrôle global réservé au Capitaine, incluant la configuration, les diagnostics et les actions exceptionnelles.

Partie XI — Architecture technique

Cette partie traduit les besoins fonctionnels définis précédemment en architecture logicielle. Elle fixe les composants, technologies, communications et conventions nécessaires à la construction durable de la plateforme.

• Planifié — Chapitre 41 : Architecture cible
  Présente les composants techniques d'Horizon et les communications prévues entre les services locaux et distants.

• Planifié — Chapitre 42 : Choix technologiques
  Évalue et justifie les technologies retenues pour le Web, les bots, les données, les intégrations, le déploiement et le LLM.

• Planifié — Chapitre 43 : Architecture des données
  Transforme le modèle fonctionnel en schémas conceptuels et logiques, avec leurs entités, relations, contraintes et migrations.

• Planifié — Chapitre 44 : API et communications internes
  Définit les contrats, événements, webhooks et mécanismes temps réel utilisés par les composants de la plateforme.

• Planifié — Chapitre 45 : Intégrations externes
  Encadre les connexions à Twitch, Discord, OBS, Streamer.bot, Voicemod, aux services TTS et au fournisseur ou modèle LLM.

• Planifié — Chapitre 46 : Organisation du code
  Établit la structure des dépôts, modules, dépendances, configurations, versions et conventions de développement.

Partie XII — Robustesse et exploitation

Cette partie prépare Horizon à fonctionner dans des conditions réelles, y compris lorsque certains services deviennent indisponibles. Elle organise la détection des problèmes, les modes dégradés, la restauration et le suivi de la capacité.

• Planifié — Chapitre 47 : Gestion des erreurs
  Définit les réactions de la plateforme face aux indisponibilités, événements invalides et exécutions partielles.

• Planifié — Chapitre 48 : Journalisation et observabilité
  Organise les logs, audits, métriques, alertes et outils de diagnostic nécessaires au suivi d'Horizon.

• Planifié — Chapitre 49 : Sauvegarde et restauration
  Définit la protection de la base, de la configuration et de la mémoire ainsi que les procédures de reprise après perte.

• Planifié — Chapitre 50 : Performance et capacité
  Établit les objectifs de charge, de latence, de coût et d'évolutivité pour les différentes composantes de la plateforme.

Partie XIII — Qualité et tests

Cette partie définit les méthodes permettant de vérifier qu'Horizon répond aux besoins fonctionnels et techniques. Elle organise les niveaux de test, les environnements et les critères nécessaires avant toute mise en production.

• Planifié — Chapitre 51 : Stratégie de tests
  Définit les tests unitaires, d'intégration, de sécurité, de charge, de non-régression et les validations manuelles.

• Planifié — Chapitre 52 : Environnements
  Sépare les contextes de développement, de test et de production ainsi que leurs données, secrets et services simulés.

• Planifié — Chapitre 53 : Validation des fonctionnalités
  Établit les critères d'acceptation, la définition de « terminé » et les responsabilités de validation.

Partie XIV — Déploiement et maintenance

Cette partie organise la mise à disposition durable d'Horizon et son évolution après déploiement. Elle couvre l'hébergement, les procédures de publication, les retours arrière et le maintien de la compatibilité.

• Planifié — Chapitre 54 : Hébergement
  Répartit les composants locaux et distants selon leurs besoins de disponibilité, de données et d'accès aux systèmes du stream.

• Planifié — Chapitre 55 : Déploiement
  Définit la construction, la configuration, la gestion des secrets, les migrations, les vérifications et le retour arrière.

• Planifié — Chapitre 56 : Maintenance
  Encadre les mises à jour, les dépendances, la dette technique, la compatibilité et la fin de vie des fonctionnalités.

Partie XV — Migration des systèmes existants

Cette partie prend en compte les systèmes déjà utilisés dans La Tanière. Elle prépare leur coexistence temporaire avec Horizon, la reprise des données et une bascule progressive pouvant être annulée en cas de problème.

• Planifié — Chapitre 57 : Inventaire de l'existant
  Recense les solutions, données et intégrations actuellement utilisées autour de Streamer.bot, OBS, Twitch, Discord et P.O.U.B.E.L.L.E.

• Planifié — Chapitre 58 : Stratégie de migration
  Définit l'ordre de migration, les mécanismes transitoires, les vérifications et le retrait progressif des anciens composants.

Partie XVI — Plan de développement

Cette partie transforme la vision d'Horizon en démarche de travail réaliste, compatible avec le temps disponible et l'apprentissage nécessaire. Elle définit les phases, les résultats attendus et les critères permettant de passer d'une étape à la suivante.

• Planifié — Chapitre 59 : Méthode générale
  Établit une approche incrémentale fondée sur des versions courtes, testables et compatibles avec le temps réellement disponible.

• Planifié — Chapitre 60 : Phase 1 - Référence fonctionnelle
  Formalise les objectifs, résultats et critères de clôture de la phase de cadrage documentaire.

• Planifié — Chapitre 61 : Phase 2 - Apprentissage technique ciblé
  Organise l'apprentissage progressif des technologies nécessaires à travers des exercices indépendants et validables.

• Planifié — Chapitre 62 : Phase 3 - Prototype transversal
  Définit une première preuve de fonctionnement commune à Twitch, Discord, au Web, à la base de données et à l'orchestrateur.

• Planifié — Chapitre 63 : Phase 4 - Développement réel
  Découpe la construction de la plateforme en versions fonctionnelles successives allant des fondations à la stabilisation de la V1.

• Planifié — Chapitre 64 : Planning et estimations
  Regroupe les hypothèses, charges, jalons, dépendances et marges d'incertitude nécessaires au suivi du calendrier.

Partie XVII — Évolutions futures

Cette partie conserve les fonctionnalités volontairement exclues des premières versions sans les confondre avec des décisions abandonnées. Elle prépare l'extension progressive d'Horizon en fonction des usages réellement observés.

• Planifié — Chapitre 65 : Fonctionnalités volontairement reportées
  Recense les capacités envisagées pour les versions ultérieures et les idées dont la pertinence dépend encore de l'usage réel.

• Planifié — Chapitre 66 : Évolutivité d'Horizon
  Définit les principes permettant d'ajouter de nouvelles plateformes, mémoires, interfaces, fonctions et formes d'autonomie.

Partie XVIII — Gouvernance du projet et du document

Cette partie garantit que les décisions et la documentation restent compréhensibles dans la durée. Elle organise la traçabilité des choix, la gestion des versions et la cohérence entre les différents chapitres.

• Planifié — Chapitre 67 : Gestion des décisions
  Définit le suivi des décisions validées, temporaires, ouvertes ou abandonnées ainsi que les conditions de leur réexamen.

• Planifié — Chapitre 68 : Gestion du document de référence
  Organise le versionnement, le journal des changements, les mises à jour croisées et l'archivage de la documentation.

Annexes planifiées

Les annexes rassemblent les catalogues, matrices, schémas et listes de contrôle nécessaires à la conception ou à l'exploitation d'Horizon. Elles complètent les chapitres sans alourdir le parcours de lecture principal.

Annexe	Référentiel
A	Glossaire global — Référentiel complet — Définitions exhaustives du vocabulaire fonctionnel et technique d'Horizon.
B	Acronymes — Signification des acronymes employés dans le projet et ses systèmes associés.
C	Schémas d'architecture — Représentations fonctionnelles et techniques des composantes de la plateforme.
D	Diagrammes de circulation des événements — Parcours détaillés des événements entre les interfaces, le Noyau et les services.
E	Modèle complet d'identité Horizon — Structure détaillée des identités, comptes liés, états et relations.
F	Catalogue des données — Annexe planifiée ; futur référentiel exhaustif des données gérées par Horizon.
G	Catalogue des événements — Liste normalisée des événements, de leurs propriétés et de leurs origines.
H	Matrice des permissions — Droits de lecture, d'écriture, d'action et de divulgation par rôle.
I	Matrice des actions critiques — Niveau de risque, confirmations et traces exigées pour chaque opération sensible.
J	Matrice des données et niveaux de sensibilité — Classification des données et règles de protection associées.
K	Catalogue des outils de P.O.U.B.E.L.L.E. — Actions accessibles, conditions d'utilisation et limites applicables.
L	Catalogue des intégrations externes — Services connectés, dépendances et modes de défaillance prévus.
M	Catalogue des commandes Twitch — Commandes, paramètres, permissions et réponses attendues sur Twitch.
N	Catalogue des commandes Discord — Commandes, paramètres, permissions et réponses attendues sur Discord.
O	Arborescence du Poste de commande — Organisation détaillée des espaces, pages et fonctions de l'interface Web.
P	Schéma de base de données — Entités, relations, contraintes et index du modèle technique.
Q	Contrats API — Structures des requêtes, réponses et échanges entre composants.
R	Conventions d'événements — Règles de nommage, de structure, de versionnement et de traitement des événements.
S	Stratégie de sauvegarde — Périmètre, fréquence, conservation, vérification et restauration des sauvegardes.
T	Plan de tests — Cas de test, niveaux de validation et couverture attendue.
U	Checklist de mise en production — Vérifications requises avant et après chaque déploiement.
V	Roadmap détaillée — Jalons, dépendances, charges et résultats attendus par version.
W	Registre des décisions — Historique des choix structurants et de leurs justifications.
X	Backlog des fonctionnalités futures — Capacités reportées, idées ouvertes et conditions éventuelles de réévaluation.

Utilisation de ce sommaire

Ce sommaire décrit l'organisation de référence de la documentation. Une entrée peut donc apparaître avant que le chapitre correspondant soit entièrement rédigé : sa présence indique qu'un domaine doit être traité, et non que toutes les décisions associées sont déjà validées ou développées.

La structure sera mise à jour lorsque des chapitres seront ajoutés, fusionnés ou déplacés. Les modifications importantes devront également être consignées dans l'historique des versions et, lorsqu'elles résultent d'un choix structurant, dans le registre des décisions.