# PROMPT OPENCODE — FILYX KICK ROULETTE ## Roue de la chance interactive avec tickets, points, suspense et animation OBS ### Version exclusive AHMED LNDY + version Filyx personnalisable ## 1. OBJECTIF DU PROJET Je veux créer une nouvelle fonctionnalité sur ma plateforme : https://filyx.fr/ Nom du module : **Filyx Kick Roulette** Il s'agit d'une roue de la chance interactive pour les streamers Kick, intégrée au système de points et de tickets déjà présent dans le bot Filyx. Le module doit permettre d'organiser des événements en direct où un viewer sélectionné gagne le droit de faire tourner une roue pour tenter de remporter un lot. Je veux deux versions : **VERSION 1 — AHMED LNDY** Une roulette personnalisée exclusivement pour le streamer Ahmed LNDY, avec le visuel GTA VI / Vice City que je fournis en référence. **VERSION 2 — FILYX** Un modèle générique noir et orange Filyx, utilisable et personnalisable par les autres streamers. Le système doit être entièrement intégré à Filyx, fonctionner depuis le navigateur et s'afficher dans OBS via une URL. **Important : il faut développer une véritable roue animée et fonctionnelle, pas simplement afficher une image qui tourne.** --- ## 2. ANALYSER L'EXISTANT AVANT DE CODER Avant toute modification : - Inspecter le dépôt Filyx. - Identifier l'authentification et les rôles. - Identifier les connexions Kick. - Identifier le bot Filyx. - Identifier le système de points des viewers. - Identifier le système d'achat de tickets. - Identifier le mécanisme existant de sélection aléatoire. - Identifier les widgets et leurs URL OBS. - Identifier le système d'overlays Filyx. - Identifier le moteur audio et les WebSockets existants. - Identifier les abonnements Free / Pro. - Identifier les permissions founder. **Le bot sélectionne déjà les candidats : ne pas reconstruire ni remplacer ce système.** La roulette doit utiliser le résultat de sélection du bot existant. Ne pas créer une seconde économie de points, un second portefeuille ou un second système de tickets. Ne rien casser dans les fonctions existantes. --- ## 3. FONCTIONNEMENT GÉNÉRAL Le fonctionnement attendu est : ```text Viewer regarde le live Kick | v Il gagne des points Filyx | v Chat / activité / abonnements, selon les règles existantes | v Il achète un ticket avec ses points | v Le bot Filyx sélectionne un participant | v Le candidat apparaît sur l'overlay | v Le streamer présente le candidat | v Musique et montée du suspense | v Le streamer clique sur LANCER | v La roue tourne réellement | v GTA VI / RESPIN / WASTED | v Animation de résultat | v Enregistrement de la tentative ``` **Aucune rotation automatique après la sélection du candidat.** Le streamer doit garder entièrement le contrôle du rythme de son émission. --- # PARTIE A — VERSION EXCLUSIVE AHMED LNDY ## 4. IDENTITÉ VISUELLE D'AHMED Créer une apparence dédiée au streamer : **AHMED LNDY** Utiliser l'image que je fournis comme référence visuelle. Je veux retrouver son ambiance générale : - décor tropical inspiré de Vice City ; - coucher de soleil rose et violet ; - palmiers ; - ville illuminée en arrière-plan ; - reflets de néons sur l'eau ; - éclairages rose, cyan et orange ; - roue métallique spectaculaire ; - effet casino / événement spécial ; - logo AHMED LNDY au centre. Le rendu doit être haut de gamme et adapté à une diffusion en direct. ### Roue personnalisée Afficher exactement **10 secteurs** : - 1 case GTA VI ; - 2 cases RESPIN ; - 7 cases WASTED. La case GTA VI doit être très petite visuellement. Les cases WASTED doivent utiliser de grandes lettres rouges, disposées de manière lisible en suivant l'orientation des secteurs, dans une esthétique inspirée des écrans de défaite des jeux GTA. Les cases RESPIN doivent être immédiatement reconnaissables avec une couleur cyan ou bleue. La case gagnante doit avoir une couleur premium : - or ; - orange lumineux ; - éclat spécial ; - symbole de jackpot. Ne pas utiliser d'asset officiel sous licence sans autorisation. Si les logos officiels ne peuvent pas être réutilisés, réaliser des éléments graphiques originaux dans la même ambiance générale. ### Centre de la roue Afficher : **AHMED LNDY** Le logo central reste fixe pendant la rotation si ce comportement rend l'animation plus professionnelle. Ajouter un pointeur lumineux en haut de la roue. La case gagnante doit pouvoir être identifiée sans ambiguïté lorsque la roue s'arrête. --- ## 5. NE PAS UTILISER L'IMAGE COMME ROUE FIGÉE L'image fournie est une référence artistique. Je veux que la roue soit reconstruite en éléments réellement animables. Utiliser une solution performante adaptée : - SVG ; - Canvas ; - CSS ; - ou une technologie déjà utilisée par Filyx. Chaque case doit être un secteur indépendant. Le moteur doit pouvoir : - changer ses couleurs ; - changer son texte ; - modifier sa taille ; - faire tourner toute la roue ; - arrêter précisément le pointeur sur un secteur ; - afficher des effets visuels ; - déclencher les sons ; - afficher le résultat. L'image de référence peut servir de décor, d'inspiration ou de texture, mais elle ne doit pas empêcher la modification individuelle des cases. La roue ne doit pas contenir une fausse animation indépendante du résultat du serveur. --- ## 6. CONFIGURATION DES PROBABILITÉS D'AHMED Configuration obligatoire : **GTA VI : 2 % de chances par lancement.** Pour obtenir réellement cette probabilité avec dix secteurs, utiliser une roue pondérée. Proposition initiale : | Type | Nombre de cases | Probabilité totale | |---|---:|---:| | GTA VI | 1 | 2 % | | RESPIN | 2 | 10 % | | WASTED | 7 | 88 % | Répartition par secteur : - GTA VI : 2 % ; - chaque RESPIN : 5 % ; - chaque WASTED : environ 12,5714286 %. Ces valeurs définissent la géométrie et les probabilités par défaut. Le fondateur peut régler les probabilités RESPIN et WASTED, tout en conservant les 2 % GTA VI pour l'événement Ahmed. La somme doit toujours être égale à 100 %. Le secteur GTA VI représente donc 2 % de la circonférence, soit 7,2 degrés. Les labels des secteurs très étroits doivent rester lisibles grâce à un marqueur, une légende ou un indicateur de résultat approprié. ### Contraintes - Calculer le résultat côté serveur. - Utiliser un générateur aléatoire cryptographiquement sûr. - Ne jamais faire dépendre le résultat du nombre de pixels, du navigateur, du FPS ou du pointeur. - Bloquer le résultat avant de lancer l'animation. - Transmettre au client le secteur cible et les paramètres nécessaires à la rotation. - Ne jamais recalculer le résultat si la page OBS se reconnecte. - Journaliser le résultat réel. **Les 2 % doivent être une probabilité effective par lancement, pas simplement une valeur affichée dans le panel.** --- ## 7. AFFICHAGE DES PROBABILITÉS Pour l'événement d'Ahmed : Ne pas afficher les pourcentages sur l'overlay OBS. Ne pas afficher : - 2 % ; - 10 % ; - 88 % ; - les poids des secteurs. L'overlay doit uniquement présenter les résultats possibles et les animations. En revanche, le fondateur et l'organisateur doivent disposer des probabilités exactes dans l'administration, et le règlement destiné aux participants doit communiquer clairement les règles et les chances applicables. Ne jamais afficher une roue laissant croire que les dix cases ont des chances égales si les probabilités sont pondérées. La taille réelle des secteurs doit refléter les probabilités configurées. --- # PARTIE B — TIRAGE ET CONTRÔLE DU STREAMER ## 8. CONNEXION AU BOT FILYX Le système de tickets existe déjà dans le bot. Le module Roulette doit pouvoir récupérer : - l'identifiant du tirage ; - l'identifiant Kick du candidat sélectionné ; - son pseudo ; - son avatar si disponible ; - le nombre de tickets du candidat si pertinent ; - l'horodatage ; - l'identifiant du streamer ; - l'identifiant de la campagne. Les tickets déjà utilisés pour la sélection doivent suivre les règles de consommation existantes. Ne jamais sélectionner deux fois le candidat à cause d'une reconnexion ou d'un doublon d'événement. Ne pas utiliser uniquement le pseudo comme identifiant. L'intégration doit se faire à travers les services ou événements internes du bot Filyx. Ne pas inventer un endpoint Kick qui désignerait les candidats. --- ## 9. PANNEAU DE CONTRÔLE D'AHMED Créer une page : `/panel/widgets/kick-roulette` Ou réutiliser le chemin équivalent dans l'architecture Filyx. L'interface doit afficher : ### Campagne - Nom : GTA VI — Ahmed LNDY - État : active / suspendue / terminée - Soirée actuelle - Nombre de soirées restantes - Nombre de tentatives réalisées - Dernier résultat - Lot encore disponible ou remporté ### Participant sélectionné Afficher en grand : - avatar ; - pseudo ; - identifiant ; - statut du participant ; - numéro de soirée ; - état de la tentative. ### Boutons **PRÉSENTER LE CANDIDAT** Affiche le pseudo sur l'overlay. **LANCER LA MUSIQUE** Démarre le fond sonore de suspense. **MONTER LE SUSPENSE** Déclenche des animations lumineuses et sonores préparatoires. **LANCER LA ROUE** Déclenche la véritable rotation. **AFFICHER LE RÉSULTAT** Permet de rejouer uniquement la présentation visuelle du résultat existant, sans nouveau tirage. **FERMER L'OVERLAY** Masque la roulette. **ARRÊT D'URGENCE** Arrête les effets et la musique, sans modifier rétroactivement un résultat déjà obtenu. Les commandes doivent être accessibles uniquement aux comptes et rôles autorisés. --- ## 10. AUCUN LANCEMENT AUTOMATIQUE C'est une règle absolue. Quand le bot sélectionne le participant : **La roue ne doit pas tourner immédiatement.** Afficher simplement un écran : « CANDIDAT SÉLECTIONNÉ » Avec le pseudo du viewer. Ahmed doit pouvoir : 1. Annoncer son nom. 2. Discuter avec lui. 3. Faire patienter le public. 4. Mettre une musique de suspense. 5. Présenter le lot. 6. Lancer la roue quand il le décide. Le bouton **LANCER LA ROUE** doit être une action distincte, manuelle et sécurisée. Pas de timer automatique obligatoire. Pas de lancement après 5 secondes. Pas de lancement déclenché par l'apparition du candidat. --- # PARTIE C — ANIMATION DE LA ROUE ## 11. ROTATION CINÉMATOGRAPHIQUE Je veux une rotation spectaculaire pour OBS. Séquence : ### Phase 1 — Préparation - La roue s'illumine. - Les néons s'activent. - Le pointeur scintille. - La musique augmente. - Le pseudo du candidat apparaît. ### Phase 2 — Lancement Au clic du streamer : - la roue commence à tourner ; - elle accélère ; - atteint une vitesse élevée ; - effectue plusieurs tours ; - commence progressivement à ralentir. ### Phase 3 — Suspense Pendant le ralentissement : - le pointeur produit un son de cliquetis ; - les dernières cases passent lentement ; - les lumières évoluent ; - la musique accentue la tension. ### Phase 4 — Arrêt La roue s'immobilise exactement sur le secteur déjà déterminé par le serveur. Le pointeur doit clairement désigner la case. ### Durée Réglage initial proposé : - durée normale : 12 secondes ; - durée suspense : 18 secondes ; - durée courte : 6 secondes. Le streamer peut choisir le profil avant le lancement. Ne pas faire dépendre les probabilités de la durée de rotation. --- ## 12. RÉSULTAT GTA VI Si la roue tombe sur GTA VI : Afficher : **GTA VI** **GAGNÉ !** Animations : - explosion de confettis ; - flashs lumineux ; - éclairage doré ; - feu d'artifice visuel ; - effet jackpot ; - pseudo du gagnant en grand ; - musique de victoire. Exemple : « AHMED LNDY — GTA VI REMPORTÉ PAR VIEWER123 ! » La victoire doit être enregistrée côté serveur immédiatement et de façon transactionnelle. L'overlay ne doit pas permettre de créer une deuxième victoire en rejouant l'animation. Mettre fin à la campagne automatiquement. --- ## 13. RÉSULTAT WASTED Si le résultat est WASTED : Afficher plein écran : **WASTED** Style : - grandes lettres rouges ; - ambiance GTA ; - effet sombre ; - ralentissement visuel ; - son de défaite personnalisé. Afficher éventuellement : « Pas de chance, Viewer123 ! » Durée configurable. Après l'animation : - fermer ou masquer le résultat ; - marquer la tentative comme perdue ; - permettre au streamer de continuer son émission. Ne pas attribuer de lot. --- ## 14. RÉSULTAT RESPIN Si la roue s'arrête sur RESPIN : Afficher : **RESPIN !** **NOUVELLE CHANCE !** Animations : - éclairage cyan ; - effet électrique ; - son de bonus ; - animation spéciale. ### Fonctionnement Le même candidat obtient une relance gratuite. Il ne doit pas : - racheter de ticket ; - dépenser de nouveaux points ; - être sélectionné une seconde fois par le bot. Afficher le bouton : **RELANCER LA ROUE** Ce bouton est uniquement activé après le résultat RESPIN. Le streamer décide manuellement quand lancer la nouvelle rotation. ### Limites Prévoir un nombre maximal de RESPIN par participation. Valeur initiale proposée : 2 relances maximum par soirée. Cette limite doit être configurable par l'organisateur avant le début de la campagne. Une fois la limite atteinte, appliquer une règle explicite et connue à l'avance, sans changer arbitrairement le résultat. Par exemple, une relance supplémentaire peut être refusée et le résultat de fin de participation appliqué selon le règlement publié. La mécanique doit être validée avant lancement, et non modifiée au cours d'une tentative. **Attention : chaque RESPIN entraîne un nouveau lancement avec ses propres probabilités. Cela augmente les chances cumulées de gagner au cours de la soirée.** Afficher des calculs exacts dans l'administration en tenant compte : - des probabilités par lancement ; - des RESPIN ; - de leur limite ; - des dix soirées ; - des règles d'arrêt. Ne pas réutiliser automatiquement la valeur de 18,3 % lorsqu'il existe des relances. --- # PARTIE D — ORGANISATION SUR DIX SOIRÉES ## 15. CAMPAGNE AHMED — GTA VI Créer une campagne spécifique : **Ahmed LNDY — Kick Roulette GTA VI** Règles : - maximum dix soirées ; - un participant principal sélectionné par soirée ; - une participation principale par soirée ; - RESPIN possibles selon les règles ; - arrêt immédiat si GTA VI est remporté ; - fermeture de la campagne après la dixième soirée si personne ne gagne. La campagne doit être pilotée depuis le panel. Afficher : `SOIRÉE 1 / 10` `SOIRÉE 2 / 10` Et ainsi de suite. ### Actions organisateur - Ouvrir la soirée. - Vérifier la sélection du bot. - Présenter le candidat. - Lancer la roue. - Gérer les éventuels RESPIN. - Clôturer la soirée. - Ouvrir la soirée suivante lorsque c'est autorisé. - Suspendre la campagne. - Terminer la campagne. Le compteur de soirées ne doit pas augmenter à chaque RESPIN. Le système doit distinguer : - soirée ; - participation principale ; - lancement de roue ; - relance. --- ## 16. ARRÊT AUTOMATIQUE SI GTA VI EST GAGNÉ Si GTA VI est remporté : 1. Enregistrer le gagnant. 2. Enregistrer le résultat. 3. Marquer le lot comme attribué. 4. Bloquer tous les futurs lancements réels de cette campagne. 5. Désactiver les achats de tickets destinés à cette campagne. 6. Arrêter les futurs tirages. 7. Afficher le statut « TERMINÉ — LOT REMPORTÉ ». 8. Conserver l'historique. 9. Prévoir le traitement des tickets non utilisés selon les règles publiées. Ne pas bloquer les autres fonctionnalités du bot Filyx. La fermeture concerne uniquement cette campagne. --- # PARTIE E — INTÉGRATION OBS ET AUDIO ## 17. URL OBS Créer une URL d'overlay spécifique. Exemple : `https://filyx.fr/overlay/kick-roulette/:id?token=TOKEN` Elle doit permettre d'afficher : - l'écran de présentation ; - la roue ; - les animations ; - les résultats ; - les sons compatibles. Résolution : - 1920 × 1080 par défaut ; - fond transparent en option ; - mode plein écran ; - mode roue seule. Le streamer doit pouvoir choisir : - arrière-plan complet ; - arrière-plan transparent ; - uniquement la roue ; - uniquement l'écran de résultat. L'URL est en lecture seule et ne permet pas de commander les tirages. --- ## 18. SYSTÈME AUDIO Réutiliser **Filyx Audio Engine** si ce système existe déjà. Prévoir : - musique d'introduction ; - musique de suspense ; - cliquetis de roue ; - sons des secteurs ; - son RESPIN ; - son WASTED ; - son jackpot GTA VI ; - sons d'ambiance. Chaque piste peut être : - activée ; - désactivée ; - remplacée ; - réglée en volume ; - mise en fondu ; - assignée à un bus audio. ### Mixeur Groupes proposés : - Ambiance - Suspense - Roue - Résultat - Effets spéciaux Prévoir : - volume principal ; - volume par groupe ; - mute ; - test ; - fondu d'entrée ; - fondu de sortie ; - arrêt global. ### OBS Mode simple : - une URL avec visuel et audio. Mode avancé : - URL visuelle ; - source audio séparée facultative. Ne pas jouer les sons en double. Ne pas nécessiter un logiciel supplémentaire sur le PC. Respecter les restrictions de lecture automatique. La bibliothèque audio doit contenir uniquement des sons originaux, libres ou autorisés à être utilisés. --- ## 19. SYNCHRONISATION ET FIABILITÉ Le serveur est la source de vérité. La roulette doit fonctionner correctement si : - OBS se reconnecte ; - le streamer actualise le panel ; - une connexion WebSocket tombe ; - deux fenêtres OBS utilisent le même overlay ; - un événement est envoyé plusieurs fois ; - le navigateur rencontre une erreur ; - le VPS redémarre. Utiliser un identifiant unique par lancement. Créer une machine à états : ```text CAMPAIGN_READY NIGHT_OPEN PARTICIPANT_SELECTED PRESENTATION READY_TO_SPIN SPIN_COMMITTED SPINNING RESULT_GTA_VI RESULT_WASTED RESULT_RESPIN AWAITING_RESPIN NIGHT_COMPLETED CAMPAIGN_WON CAMPAIGN_COMPLETED CAMPAIGN_SUSPENDED ``` Ne jamais redéterminer un résultat déjà engagé. En cas de coupure pendant la rotation, restaurer l'état du lancement existant, sans attribuer de nouvelle chance. Les opérations critiques doivent être transactionnelles et idempotentes. --- # PARTIE F — MODÈLE STANDARD FILYX ## 20. VERSION GÉNÉRIQUE POUR TOUS LES STREAMERS Créer un second thème : **Filyx Roulette — Default** Il doit être différent de celui d'Ahmed. Style : - noir ; - orange ; - éclairages futuristes ; - métal sombre ; - néons orange ; - effets lumineux ; - logo Filyx au centre. Ne pas afficher : - AHMED LNDY ; - GTA VI ; - WASTED ; - décor Vice City ; dans la version standard, sauf si l'utilisateur choisit volontairement de personnaliser son propre thème dans ce style et possède les droits sur ses médias. Le modèle générique doit proposer des libellés neutres : - GAGNÉ ; - PERDU ; - RELANCE ; - BONUS ; - CADEAU. Le modèle Ahmed doit rester propre au compte autorisé. --- ## 21. PERSONNALISATION PAR LES STREAMERS Chaque streamer doit pouvoir modifier sa propre roue. Options : ### Apparence - image de fond ; - couleur de fond ; - logo central ; - image personnelle ; - GIF animé ; - couleurs des néons ; - couleur des secteurs ; - police ; - taille des textes ; - pointeur ; - texture ; - animation ; - résolution. ### Cases Permettre : - ajout ; - suppression ; - renommage ; - réorganisation ; - définition des couleurs ; - icônes ; - images ; - sons ; - probabilité ; - type de résultat. Types : - gagné ; - perdu ; - relance ; - bonus ; - résultat personnalisé. Le nombre de cases doit être configurable pour les autres streamers. Les probabilités doivent totaliser 100 %. ### Lots Permettre de configurer : - nom du lot ; - description ; - image ; - quantité disponible ; - statut ; - conditions de remise ; - nombre maximal de gagnants. ### Contrôle - lancer manuellement ; - suspendre ; - régler les durées ; - configurer les sons ; - activer ou désactiver les relances ; - fixer les limites. Les réglages doivent être accessibles depuis le panel Filyx. --- ## 22. THÈME AHMED NON MODIFIABLE PAR LES AUTRES Associer le thème Ahmed à l'identifiant interne du compte streamer concerné, pas uniquement à son pseudo. Le fondateur doit pouvoir : - attribuer le thème à Ahmed ; - le modifier ; - le retirer ; - le dupliquer pour ses propres tests. Les autres utilisateurs doivent avoir accès au thème standard Filyx et à leurs propres créations. Ne pas donner accès aux médias privés d'Ahmed. Ne pas autoriser les streamers à modifier ses campagnes. --- ## 23. INTÉGRATION À FILYX OVERLAY STUDIO Ajouter Kick Roulette au registre de widgets compatibles. Nom : **Kick Roulette** Catégorie : **Jeux / Interactions** Le widget doit pouvoir être placé dans une composition Filyx Overlay Studio. Fonctions : - redimensionner ; - repositionner ; - gérer le calque ; - passer en plein écran ; - masquer ; - afficher ; - affecter un profil audio. Si Overlay Studio n'est pas encore opérationnel, prévoir une URL OBS autonome. Ne pas rendre Kick Roulette dépendant d'un éditeur d'overlays incomplet. --- # PARTIE G — ADMINISTRATION ## 24. CONFIGURATION FONDATEUR Créer une administration : `/admin/widgets/kick-roulette` Fonctions : - voir les campagnes ; - gérer les thèmes ; - définir les limitations ; - configurer Free/Pro ; - autoriser des campagnes ; - gérer les incidents ; - voir les statistiques ; - consulter les historiques ; - valider les nouveautés. ### Campagne Ahmed Créer la configuration par défaut : - streamer : Ahmed LNDY ; - thème : Ahmed GTA VI ; - lot : GTA VI ; - maximum : 10 soirées ; - candidat principal : 1 par soirée ; - GTA VI : 2 % par lancement ; - RESPIN : 2 cases ; - WASTED : 7 cases ; - lancement : manuel ; - arrêt : automatique au jackpot. Le fondateur doit pouvoir consulter les probabilités, mais les résultats déjà tirés ne doivent jamais pouvoir être modifiés. Les changements de configuration doivent être historisés et ne prendre effet que selon des règles préétablies et communiquées aux participants. --- ## 25. AUDIT ET TRANSPARENCE C'est indispensable pour un jeu avec un lot réel. Créer un journal : - identifiant campagne ; - identifiant soirée ; - participant ; - tickets pris en compte ; - date du tirage initial ; - date du lancement ; - probabilités configurées ; - version des règles ; - secteur sélectionné ; - résultat ; - nombre de RESPIN ; - statut du lot ; - clôture. Le serveur doit enregistrer le résultat avant l'animation et le rendre vérifiable après l'événement. Prévoir éventuellement un mécanisme de preuve cryptographique du résultat, sans exposer les secrets qui permettraient de prédire les futurs tirages. **Aucun administrateur ne doit pouvoir choisir secrètement le résultat d'un lancement réel.** Prévoir un mode simulation séparé pour tester : - GTA VI ; - RESPIN ; - WASTED. Les simulations doivent être clairement identifiées et ne jamais attribuer de lots. --- ## 26. SÉCURITÉ Obligatoire : - authentification Filyx ; - permissions serveur ; - isolation streamerId ; - vérification des campagnes ; - tokens OBS protégés ; - limitation des requêtes ; - protection contre les doubles clics ; - protection contre les doubles résultats ; - protection contre les relances non autorisées ; - génération aléatoire sécurisée ; - historiques non modifiables ; - contrôle de cohérence des probabilités ; - gestion des reconnexions. Un viewer ne doit pas pouvoir lancer la roulette en appelant une API. Seul le streamer et les modérateurs expressément autorisés peuvent commander la présentation et le lancement. --- ## 27. CONDITIONS DE PARTICIPATION ET LOTS RÉELS Comme la roulette permet de gagner un vrai jeu, prévoir un système de règlement de campagne avant activation. Le règlement doit pouvoir préciser : - organisateur ; - dates ; - conditions d'éligibilité ; - fonctionnement des points et tickets ; - modalités de sélection ; - probabilités ; - RESPIN ; - limite de soirées ; - conditions d'attribution ; - modalités de remise du lot ; - cas d'annulation ; - traitement des tickets non utilisés. Prévoir un accès public au règlement, distinct de l'overlay qui ne doit pas afficher les pourcentages pendant l'animation. Vérifier les règles applicables aux loteries promotionnelles et les conditions de la plateforme. En particulier, vérifier que l'attribution de points supplémentaires pour des abonnements ou abonnements offerts ne transforme pas l'accès au jeu en mécanisme payant problématique. Prévoir une solution de participation gratuite réellement accessible et équitable lorsqu'elle est nécessaire. Ne pas activer une campagne réelle sans règlement validé. Les points ne doivent pas être convertibles en argent ou en mises financières. Ne pas annoncer automatiquement une clé ou un exemplaire GTA VI disponible sans avoir défini les conditions réelles de livraison du prix. --- # PARTIE H — ARCHITECTURE TECHNIQUE ## 28. SERVICES À CRÉER OU RÉUTILISER Architecture indicative : ```text /src/kick-roulette/ services/ RouletteCampaignService RouletteNightService RouletteParticipantService RouletteBotIntegration RouletteSpinService RouletteProbabilityEngine RouletteResultService RouletteRespinService RoulettePrizeService RouletteThemeService RouletteAuditService RoulettePermissions frontend/ RouletteDashboard RouletteControlPanel ParticipantPresentation RouletteConfiguration RouletteThemeEditor RouletteHistory RouletteStatistics overlay/ RouletteOverlay RouletteWheel RoulettePointer RouletteAnimationEngine RouletteSoundEngine WinnerScreen WastedScreen RespinScreen ``` Adapter à la stack réelle du dépôt. Ne pas imposer un nouveau framework. --- ## 29. BASE DE DONNÉES Créer ou adapter : ### roulette_campaigns - id - streamerId - name - prizeId - themeId - status - maxNights - completedNights - maxRespins - configVersion - createdAt - updatedAt ### roulette_nights - id - campaignId - nightNumber - selectedParticipantId - status - openedAt - completedAt ### roulette_spins - id - campaignId - nightId - participantId - parentSpinId - spinNumber - probabilityConfigSnapshot - selectedSegmentId - resultType - committedAt - animationStartedAt - completedAt - status ### roulette_segments - id - campaignId - label - resultType - probabilityWeight - color - icon - audioAssetId - orderIndex ### roulette_prizes - id - campaignId - name - description - quantity - awardedTo - awardedAt - deliveryStatus ### roulette_themes - id - ownerId - name - visibility - backgroundAssetId - logoAssetId - settingsJson ### roulette_audit_logs - id - campaignId - actorId - action - detailsJson - createdAt Utiliser les références existantes aux comptes, au bot et aux tickets. Ne pas recréer les comptes viewers. --- ## 30. API Routes indicatives : ```text GET /api/roulette/campaigns POST /api/roulette/campaigns GET /api/roulette/campaigns/:id PUT /api/roulette/campaigns/:id POST /api/roulette/campaigns/:id/open-night POST /api/roulette/campaigns/:id/close-night GET /api/roulette/campaigns/:id/participant POST /api/roulette/campaigns/:id/present POST /api/roulette/campaigns/:id/suspense POST /api/roulette/campaigns/:id/spin POST /api/roulette/campaigns/:id/respin POST /api/roulette/campaigns/:id/suspend POST /api/roulette/campaigns/:id/resume POST /api/roulette/campaigns/:id/close GET /api/roulette/campaigns/:id/history GET /api/roulette/campaigns/:id/statistics GET /api/roulette/themes POST /api/roulette/themes PUT /api/roulette/themes/:id POST /api/roulette/simulate ``` Le endpoint `spin` doit être idempotent pour un même ordre de lancement et empêcher tout résultat concurrent. L'API de simulation doit être totalement isolée des résultats réels. --- # PARTIE I — TESTS OBLIGATOIRES ## 31. TESTS FONCTIONNELS Tester : 1. Connexion avec le bot Filyx existant. 2. Réception d'un candidat sélectionné. 3. Affichage du bon pseudo. 4. Aucun lancement automatique. 5. Présentation manuelle. 6. Musique de suspense. 7. Lancement manuel. 8. Rotation fluide. 9. Arrêt sur le bon secteur. 10. Résultat WASTED. 11. Résultat RESPIN. 12. Relance du même participant. 13. Aucun débit de points pour RESPIN. 14. Limite des relances. 15. Résultat GTA VI. 16. Attribution unique du lot. 17. Arrêt automatique de la campagne. 18. Dix soirées maximum. 19. Soirées et lancements comptés séparément. 20. Reconnexion OBS. 21. Reconnexion du panel. 22. Double clic. 23. Deux opérateurs simultanés. 24. Redémarrage VPS. 25. Simulation sans gain réel. ## 32. TESTS DES PROBABILITÉS Effectuer des tests statistiques sur un grand nombre de simulations indépendantes. Vérifier : - probabilité GTA VI proche de 2 % par lancement ; - probabilité RESPIN conforme au réglage ; - probabilité WASTED conforme au réglage ; - somme des probabilités égale à 100 % ; - distribution des résultats indépendante du navigateur ; - absence de recalcul après reconnexion ; - fréquence cumulée correctement calculée avec les RESPIN ; - impact des limites de relance sur les probabilités. Calculer les probabilités théoriques exactes ou par une méthode numérique validée lorsque les règles de relance rendent la formule complexe. **Les statistiques de dix lancements simples ne doivent pas être présentées comme celles de dix soirées avec relances.** ## 33. TESTS VISUELS Vérifier : - dix cases correctement générées ; - case GTA VI très petite ; - deux cases RESPIN ; - sept cases WASTED ; - lisibilité des textes ; - pointeur exact ; - roue non déformée ; - animations fluides ; - transparence OBS ; - thème Ahmed ; - thème Filyx ; - images personnelles ; - audio ; - absence de son en double. --- # PARTIE J — DÉPLOIEMENT ET VALIDATION ## 34. FOUNDER REVIEW Ne pas publier directement la nouvelle fonctionnalité pour tous les utilisateurs. Respecter le système existant : `draft → submitted_for_review → founder_review → approved → published` Le fondateur doit pouvoir : - tester la roue d'Ahmed ; - simuler les trois résultats ; - vérifier les probabilités ; - tester OBS ; - vérifier la connexion au bot ; - contrôler les logs ; - activer la campagne Ahmed ; - approuver le modèle standard Filyx ; - ouvrir ensuite la fonctionnalité aux autres streamers. Prévoir des feature flags. La version personnalisée Ahmed doit être accessible seulement au compte autorisé et aux administrateurs concernés. --- ## 35. RÉSULTAT FINAL ATTENDU Je veux que le streamer Ahmed LNDY puisse : 1. Ouvrir Filyx. 2. Accéder à sa Kick Roulette personnalisée. 3. Lancer sa soirée. 4. Utiliser le participant sélectionné par le bot. 5. Afficher son pseudo sur OBS. 6. Présenter le candidat. 7. Lancer une musique de suspense. 8. Faire son show. 9. Cliquer manuellement sur LANCER LA ROUE. 10. Voir la roue tourner avec des animations spectaculaires. 11. Obtenir un résultat serveur fiable. 12. Afficher GTA VI, RESPIN ou WASTED. 13. Relancer manuellement si RESPIN est obtenu. 14. Passer à la soirée suivante si aucun gagnant. 15. Terminer automatiquement la campagne si GTA VI est remporté. ## CONTRAINTES FINALES **Pour Ahmed :** - visuel personnel inspiré de l'image fournie ; - logo AHMED LNDY ; - ambiance tropicale rose/violette/cyan ; - 1 case GTA VI ; - 2 cases RESPIN ; - 7 cases WASTED ; - chance GTA VI de 2 % par lancement ; - lancement manuel ; - maximum dix soirées ; - une sélection principale par soirée ; - arrêt si GTA VI est gagné. **Pour les autres streamers :** - thème Filyx noir/orange par défaut ; - roue personnalisable ; - logos, fonds et images personnels ; - textes et couleurs modifiables ; - lots configurables ; - probabilités configurables ; - animations et sons configurables ; - intégration aux widgets et overlays Filyx. **Je veux une vraie roue de la chance interactive, pilotable par le streamer, avec animations OBS, audio, sécurité serveur, résultats fiables et intégration complète au bot Filyx existant.** Le module doit fonctionner sans logiciel supplémentaire sur le PC, être optimisé pour mon VPS OVH et ne pas casser les fonctionnalités déjà présentes. **NE PAS LIVRER UNE SIMPLE MAQUETTE. DÉVELOPPER UN WIDGET FILYX KICK ROULETTE RÉELLEMENT FONCTIONNEL.**