🎟️ Bienvenue dans LotoPotos

LotoPotos, c’est un jeu de grilles en groupe: on pronostique, on suit le live, puis on clôture pour figer les points, les bonus et les gains.

📲 Installer la PWA (mode “app”)

La PWA rend l’accès plus rapide, plein écran, et augmente les chances d’avoir des notifications fiables. C’est le mode recommandé si tu joues souvent.

• Android / Chrome: menu ⋮ → “Installer l’application”.
• iPhone / Safari: bouton partager → “Sur l’écran d’accueil”.
• PC: icône “installer” dans la barre d’adresse (si proposée).

🔐 Compte, session et profil public

Pour jouer, il faut être connecté. Le site utilise une session (cookie): sur mobile, évite la navigation privée si tu veux rester connecté entre deux visites.

• Inscription: pseudo + mot de passe. Choisis un pseudo stable: il apparaît partout.
• Connexion: accès aux groupes/compétitions et à la saisie des grilles.
• Profil public: depuis certaines pages (performances), ton pseudo peut ouvrir ton profil public.

🧑‍🚀 Profil: avatar, mot de passe, notifications

Ton profil est ta carte d’identité dans le jeu. Un avatar clair améliore la lisibilité du live et des classements.

• Avatar: plus simple à repérer pendant le live.
• Mot de passe: change-le si besoin (sécurité).
• Notifications: active les types utiles (TOP VALIDE, live, alertes, clôture…).

👥 Groupes de jeu

Un groupe, c’est ta salle privée. Tu peux en créer un (tu deviens admin) ou en rejoindre un via invitation.

• Créer: tu gères les membres, demandes et accès.
• Rejoindre: tu demandes une invitation, l’admin valide.
• Dashboard groupe: la tour de contrôle (compétitions, accès rapides).

🏁 Compétitions

Une compétition vit dans un groupe. Elle définit les joueurs, les bonus, et la logique des comptes (coûts des grilles, prises en charge, répartition des gains).

• Créer la compétition (admin): nom + paramètres.
• Joueurs: import automatique depuis le groupe à la création, puis gestion au cas par cas.
• Bonus: paliers w/x/y/z configurés au niveau compétition.

🧩 Grille: cycle de vie

Une grille suit des états. L’interface se verrouille/déverrouille selon l’état pour éviter les incohérences.

1. Création: le valideur/admin crée la grille (matchs + options).
2. Saisie: chacun saisit ses pronostics.
3. TOP VALIDE (facultatif): verrouille “dans les temps” (manuel ou auto).
4. Live: les matchs démarrent, le classement bouge.
5. Terminée: tous les matchs finis.
6. Clôture: calcul bonus/gains, archivage, notifications.

⏱️ TOP VALIDE: verrouiller “dans les temps”

TOP VALIDE sert à figer les pronostics “dans les temps”. Dans la logique historique du jeu, le valideur le fait souvent après avoir joué la grille en vrai à la FDJ (si votre groupe joue réellement).

• Après TOP VALIDE, la grille passe en pronostics clos.
• Les champs se figent pour garantir l’équité.

✍️ Phase de pronostics

Tant que la grille est ouverte, tu peux modifier tes choix. Le système attend une saisie complète pour te considérer comme “a joué”.

• Renseigne tous les matchs pour éviter le statut “n’a pas joué”.
• Tu peux revenir tant que la grille est en saisie (et autorisée).
• Le système fonctionne par “ticket”: joueur + grille = participation.

🕒 Mode retardataire

Certaines compétitions autorisent une participation “en retard” pendant une fenêtre limitée (souvent entre TOP VALIDE et le début réel des matchs).

• Le coût d’un ticket “retard” peut être différent (règles de compétition).
• Le système peut afficher la situation (retard / officialisation).
• Une fois le live démarré, le mode retardataire n’est plus possible.

🤝 Substitution / prise en charge

Si un joueur ne peut pas jouer, un autre peut prendre en charge (jouer/financer) son ticket. L’important: que ce soit clair et traçable pour la compta.

• Typiquement: ticket retardataire + payeur différent.
• Utile pour dépanner, selon les règles de votre groupe.
• Les comptes en fin de compétition s’appuient sur ces infos.

🚫 “N’a pas joué”: règle automatique

Si les pronostics sont incomplets, le joueur est marqué n’a pas joué. Une pénalité est appliquée pour éviter qu’un ticket vide devienne “avantageux” par accident.

• Score base = (pire score des joueurs ayant joué) − 1
• Plancher: minimum 0
• Badge “n’a pas joué” affichable sur la grille/classement

⭐ Points, bonus, gains

Principe général: Total = Base + Bonus. Les bonus se configurent au niveau compétition. Les gains en € peuvent être affichés, mais ils ne changent pas les points.

• Base: score “matchs” selon tes règles internes.
• Bonus: paliers w/x/y/z (ex: bonus si score ≥ x).
• Gains €: affichage informatif, n’influence pas le score en points.

🔴 Le live: suivre les matchs

Pendant le live, la page est un tableau de bord: matchs en cours/terminés, points et classement live. Les champs de saisie se figent.

• Matchs: à venir → en cours → terminé.
• Classement live: évolue au fil des résultats.
• Notifications/alertes possibles selon événements.

✅ Clôture: figer bonus et gains

Quand tout est terminé, la grille attend la clôture. C’est le moment où l’on calcule bonus/gains, puis on archive la grille.

💶 Comptes de compétition

Les comptes synthétisent les tickets: qui a joué, qui est retardataire, qui a été pris en charge, et proposent une répartition des coûts/gains sur la compétition.

• But: une sortie claire “prête à payer/équilibrer”.
• Si une grille n’apparaît pas: vérifier les résultats puis backfill.

🧠 FAQ express

• Pas de notifications: PWA + autorisation navigateur + réglages notifs.
• Redirigé vers login: pas connecté (ou cookie bloqué).
• Je ne vois pas la grille: vérifier groupe/compétition + état + droits.
• Pourquoi clôturer ?: pour figer points/bonus/gains et archiver proprement.