# PROMPT OPENCODE — FILYX COUNTDOWN ## Widget compte à rebours personnalisable pour OBS ### Giveaways • Événements • Tournois • GTA VI • Images personnelles Je veux ajouter un nouveau petit widget à mon site : https://filyx.fr/ Nom : **Filyx Countdown** L'objectif est de permettre aux streamers de créer facilement un compte à rebours pour annoncer : - leur prochain giveaway ; - un tirage au sort ; - une roulette ; - un tournoi ; - le début d'un événement ; - le lancement d'un jeu ; - une pause ; - un rendez-vous spécial ; - ou tout autre événement personnalisé. Le widget doit être compact, esthétique et entièrement personnalisable. Il doit fonctionner dans OBS grâce à une URL de source navigateur. ## 1. Intégration Filyx Avant de coder, inspecter les systèmes existants : - authentification ; - widgets ; - overlays ; - événements temps réel ; - stockage des médias ; - rôles ; - abonnements Free/Pro ; - validation founder. Réutiliser au maximum les services et composants déjà présents. Ajouter le widget dans le catalogue des widgets Filyx. Page proposée : `/panel/widgets/countdown` Ne pas casser les autres fonctionnalités. ## 2. Interface du widget Créer une interface simple avec : **Nom du compte à rebours** Exemple : Prochain Giveaway. **Texte affiché** Exemples : - PROCHAIN GIVEAWAY - TIRAGE DANS - GTA VI — PROCHAINE CHANCE - DÉBUT DU TOURNOI - DÉBUT DU LIVE - ÉVÉNEMENT SPÉCIAL Le streamer peut écrire n'importe quel texte personnalisé. **Mode de programmation** Deux possibilités : 1. Choisir une date et une heure précises. 2. Choisir une durée : heures, minutes et secondes. Exemple : `00:14:32` Ou, pour un événement plus éloigné : `02J 05H 30M 10S` Ajouter des boutons : - Démarrer - Mettre en pause - Reprendre - Réinitialiser - Modifier - Tester - Copier URL OBS La pause et la reprise doivent être synchronisées côté serveur. ## 3. Thème 1 — Filyx par défaut Créer un thème standard utilisable par tous les streamers. Apparence : - noir ; - orange Filyx ; - design futuriste ; - bordure lumineuse ; - texte blanc ; - chiffres orange ; - animations légères ; - coins arrondis. Exemple visuel : ```text ╭─────────────────────────────╮ │ 🎁 PROCHAIN GIVEAWAY │ │ │ │ 00 : 14 : 32 │ ╰─────────────────────────────╯ ``` Le fond doit pouvoir être totalement transparent. Le widget ne doit pas obligatoirement occuper tout l'écran OBS. Prévoir différentes dispositions : - horizontale ; - compacte ; - verticale ; - minimaliste. ## 4. Thème 2 — GTA VI Créer un second thème : **GTA VI Countdown** S'inspirer de l'ambiance visuelle GTA VI / Vice City utilisée pour la roulette Ahmed LNDY. Ambiance : - coucher de soleil ; - rose ; - violet ; - cyan ; - néons ; - palmiers ; - effet rétro Miami ; - éclairage lumineux. Exemple : ```text ╭─────────────────────────────╮ │ 🌴 GTA VI GIVEAWAY │ │ │ │ 00 : 14 : 32 │ │ │ │ NEXT CHANCE │ ╰─────────────────────────────╯ ``` Ajouter une légère animation des néons et du compteur. Prévoir un fond transparent ou décoratif. Le thème doit rester personnalisable. Ne pas utiliser de logos ou éléments officiels protégés sans les droits nécessaires ; créer une esthétique originale inspirée de l'ambiance tropicale néon. Ce thème ne doit pas être réservé à Ahmed : tous les streamers autorisés doivent pouvoir le sélectionner. ## 5. Images personnelles **Fonction obligatoire.** Le streamer doit pouvoir importer sa propre image pour personnaliser son compteur. Formats : - PNG ; - JPG ; - JPEG ; - WEBP ; - GIF animé. L'utilisateur doit pouvoir : - importer une image ; - sélectionner une image déjà présente dans sa bibliothèque Filyx ; - utiliser l'image comme fond ; - ajouter une image au-dessus ou à côté du compteur ; - placer un logo personnel ; - redimensionner ; - repositionner ; - ajuster l'opacité ; - recadrer ; - remplacer ; - supprimer. Conserver la transparence des PNG, WebP et GIF. Ne pas transformer les GIF animés en images fixes. Prévoir deux modes d'affichage du fond : - Contenir - Couvrir Le streamer doit pouvoir créer son compteur uniquement avec son image personnelle, sans être obligé d'utiliser un thème Filyx ou GTA VI. ## 6. Personnalisation complète Ajouter les réglages : - couleur des chiffres ; - couleur du texte ; - police ; - taille des chiffres ; - taille du titre ; - bordure ; - épaisseur de bordure ; - couleur de fond ; - transparence ; - ombre ; - glow ; - animation ; - position du titre ; - position du compteur ; - format du temps ; - espacement ; - arrondi des coins. Prévoir un sélecteur de couleurs. Permettre de masquer : - le titre ; - les secondes ; - les jours ; - les décorations. Prévoir plusieurs styles de chiffres : - classique ; - digital ; - futuriste. ## 7. Comportement du compte à rebours Le compteur doit être fiable. Utiliser un temps de référence serveur pour éviter les décalages entre le panel et OBS. Le compte à rebours doit continuer même si le streamer ferme Filyx. L'URL OBS doit retrouver le bon temps restant après rechargement. Pour une date fixe, stocker la date cible et la gérer correctement avec les fuseaux horaires. Pour une durée, enregistrer l'heure de démarrage et le temps restant en cas de pause. Ne pas dépendre uniquement d'un timer JavaScript local. Le compteur ne doit jamais afficher de durée négative. ## 8. Quand le compteur atteint zéro Ajouter un réglage : **Action à la fin du compte à rebours** Choix : - afficher « C'EST PARTI ! » ; - afficher « GIVEAWAY TIME ! » ; - afficher « LE TIRAGE COMMENCE ! » ; - afficher un texte personnalisé ; - faire clignoter le compteur ; - jouer un son ; - masquer automatiquement le widget ; - conserver 00:00 à l'écran. Le texte et l'action doivent être configurables. La fin du compte à rebours ne doit pas déclencher automatiquement un véritable tirage, un giveaway ou une roulette. Prévoir plus tard une intégration explicite et autorisée avec les modules Filyx. ## 9. Effets audio Si Filyx Audio Engine existe, le réutiliser. Ajouter : - son de fin ; - son personnel ; - volume ; - muet ; - test audio. Ne pas faire jouer le son en double. Prévoir un aperçu muet par défaut. Le son doit être facultatif. ## 10. Affichage OBS Générer une URL : `https://filyx.fr/overlay/countdown/:id?token=TOKEN` Cette URL doit : - afficher uniquement le widget ; - utiliser un fond transparent par défaut ; - s'adapter à la taille de la source navigateur ; - conserver ses proportions ; - afficher le temps en direct ; - ne pas donner accès aux commandes administratives. Le streamer peut créer plusieurs compteurs avec des URL indépendantes. Exemples : - Giveaway de 21 h ; - prochain tournoi ; - prochaine roulette ; - événement spécial. Ajouter un bouton **Copier URL OBS**. Afficher des instructions simples pour OBS. ## 11. Aperçu en direct Créer un aperçu directement dans le panel. Chaque modification visuelle doit apparaître immédiatement. Le streamer doit pouvoir : - essayer le thème Filyx ; - essayer le thème GTA VI ; - importer une image ; - modifier les couleurs ; - tester la fin du timer ; - prévisualiser le rendu transparent. Ne pas déclencher de véritables événements métier pendant les tests. ## 12. Intégration Overlay Studio Si Filyx Overlay Studio existe déjà, enregistrer Countdown comme widget compatible. Il doit pouvoir être : - ajouté au canvas ; - déplacé ; - redimensionné ; - placé dans un calque ; - intégré à une scène ; - rendu transparent ; - configuré depuis les propriétés. S'il n'est pas encore disponible, le compteur doit fonctionner de façon autonome avec sa propre URL OBS. ## 13. Sécurité Chaque compte à rebours doit appartenir à un streamer précis. Vérifier : - authentification ; - permissions ; - streamerId ; - droits d'édition ; - tokens OBS ; - limites de stockage ; - contrôle des fichiers importés ; - quotas Free/Pro. Ne jamais exposer de token OAuth Kick ou Twitch dans l'overlay. Les modifications du compteur doivent passer par les contrôles serveur. ## 14. Administration et abonnements Intégrer le widget aux offres Free/Pro existantes. Prévoir dans l'administration founder : - activation du widget ; - limite de compteurs par formule ; - limite de stockage des médias ; - thèmes disponibles ; - fonctions premium éventuelles ; - statistiques d'utilisation. Proposition initiale : - Gratuit : compteur, thème Filyx, texte personnalisé, image personnelle, URL OBS. - Pro : plusieurs compteurs, thème GTA VI, animations avancées et options supplémentaires. Ces règles doivent rester configurables par le fondateur. Ne pas publier la nouveauté automatiquement. Respecter le workflow de validation founder existant avant sa publication générale. ## 15. Tests obligatoires Tester : - création du compteur ; - lancement ; - pause ; - reprise ; - réinitialisation ; - date programmée ; - durée personnalisée ; - changement de fuseau horaire ; - rechargement d'OBS ; - fermeture du panel ; - reconnexion ; - fin du compteur ; - image transparente ; - GIF animé ; - thème Filyx ; - thème GTA VI ; - plusieurs compteurs ; - personnalisation ; - audio ; - isolation entre streamers ; - accès non autorisé ; - limites Free/Pro. ## 16. Résultat attendu Je veux un petit widget : **Filyx Countdown** Simple à configurer, avec : 1. Un titre personnalisable. 2. Un choix de date ou de durée. 3. Un bouton Démarrer. 4. Des commandes Pause / Reprendre / Réinitialiser. 5. Un thème Filyx par défaut. 6. Un thème GTA VI. 7. La possibilité d'importer ses propres images et GIF. 8. Des couleurs, textes et animations personnalisables. 9. Une URL OBS transparente. 10. Un fonctionnement fiable même lorsque le navigateur Filyx est fermé. 11. Une intégration facultative avec Filyx Overlay Studio. **Je veux un vrai widget fonctionnel et léger, pas une simple maquette.** Le streamer doit pouvoir créer un joli compte à rebours en quelques clics pour annoncer son prochain giveaway ou n'importe quel autre événement. Le tout doit respecter le design Filyx, fonctionner sur mon VPS OVH et ne pas perturber les fonctionnalités existantes.