# AITO.PF — Guides utilisateurs par profil *Version pilote (Sprint P7) · Dernière mise à jour : 2026-09-19* Ce document décrit **en français simple** ce que chaque profil peut faire sur la plateforme AITO.PF. À partager avec chaque utilisateur au moment de son onboarding. Chaque profil a sa propre page. Tu peux les extraire une par une et les envoyer aux personnes concernées. --- ## 🧭 Sommaire - [1. Visiteur (non connecté)](#1-visiteur-non-connecté) - [2. Athlète](#2-athlète) - [3. Coach / Encadrant](#3-coach--encadrant) - [4. Club](#4-club) - [5. Fédération](#5-fédération) - [6. COPF (Comité Olympique de Polynésie Française)](#6-copf-comité-olympique-de-polynésie-française) - [7. Admin AITO](#7-admin-aito) --- ## 1. Visiteur (non connecté) Bienvenue sur AITO.PF, la plateforme dédiée au sport polynésien. **Ce que tu peux faire librement :** - Consulter l'accueil, les actualités, les annuaires (Athlètes, Coachs, Clubs, Fédérations). - Découvrir les fiches publiques (photos, palmarès, disciplines, clubs). - Regarder les livrets et mémoires sportives publiés. - Précommander des T-shirts sur les campagnes AITO × Athlète ouvertes. - Partager n'importe quelle fiche sur Facebook, Instagram, WhatsApp (les visuels s'affichent automatiquement). **Pour aller plus loin :** - Crée un compte gratuit → accès à ton espace personnel, ta fiche athlète, tes livrets, tes notifications. - Tu ne verras jamais de données privées ni de coordonnées personnelles tant que tu n'as pas les droits. --- ## 2. Athlète Ton objectif : **valoriser ton parcours sportif** et être visible pour tes clubs, fédérations et sélectionneurs. ### Ce que tu peux faire - **Créer et gérer ta fiche athlète** : photo, disciplines, biographie, réseaux sociaux (Instagram, TikTok). - **Déclarer tes résultats** : compétitions, médailles, records. Ils apparaissent immédiatement en statut « Déclaratif » puis peuvent être validés par ton club/fédération. - **Rejoindre un club** : envoie une demande d'affiliation depuis la fiche club. Le club accepte ou refuse. - **Rejoindre une fédération** : depuis ta fiche → « Demande d'affiliation ». La fédération valide. - **Utiliser l'IA pour enrichir ta fiche** : bouton *« Recherche IA (sans URL) »* dans ton wizard — la plateforme te propose des articles publics à propos de toi que tu peux adopter. - **Demander un livret personnalisé** : « Ma Mémoire Sportive » — un livret PDF premium résumant ton parcours (l'équipe AITO l'édite). - **Ajouter des embeds sociaux** (Instagram, TikTok) qui apparaissent sur ta fiche. - **Précommander tes propres T-shirts** de campagne AITO × Athlète. ### Ce que tu ne peux pas faire - Modifier la fiche d'un autre athlète. - Créer/supprimer des athletes autres que toi. - Valider institutionnellement tes propres résultats (l'entité qui te soutient le fait). - Créer une fédération ou un club. ### Bonnes pratiques - Ajoute une photo de qualité, cadrage vertical portrait recommandé. - Renseigne ton sexe pour un fallback correct si pas de photo (silhouette masculine/féminine). - Publie tes résultats au fur et à mesure : plus la base est riche, plus tu es visible. - Utilise « Recherche IA sans URL » régulièrement pour capter les articles de presse te concernant. --- ## 3. Coach / Encadrant Ton objectif : **valoriser ton expertise** et suivre les athletes que tu encadres. ### Ce que tu peux faire - **Créer ta fiche coach** : photo, spécialités, clubs où tu interviens, années d'expérience. - **Te rattacher à un club** : demande d'affiliation depuis la fiche club. - **Être associé à des athletes** : quand un athlete te déclare comme coach, tu apparais sur sa fiche (après ta validation). - **Consulter les fiches** de tes athletes. - **Demander un livret** valorisant ton parcours d'entraîneur. ### Ce que tu ne peux pas faire - Modifier la fiche d'un athlete que tu entraînes. - Valider les résultats sportifs à la place de la fédération. ### Bonnes pratiques - Renseigne tes diplômes fédéraux (BF1, BF2, BPPES, BPJEPS) — ils apparaissent en badge sur ta fiche. - Ajoute une photo pro (cadrage buste, fond neutre). --- ## 4. Club Ton objectif : **animer la vie de ton club** et suivre les licenciés. ### Ce que tu peux faire - **Gérer la fiche club** : logo, description, adresse, contacts, réseaux, galerie photo. - **Accepter/refuser les affiliations athletes et coachs** entrantes depuis « Mes validations ». - **Voir la liste** des athletes et coachs rattachés. - **Consulter les résultats** de tes athletes (agrégés par le club). - **Demander un livret Club** pour valoriser ton histoire et tes champions. - **Se rattacher à une fédération** : envoie une demande à la fédération de ta discipline. - **Précommander les T-shirts** de campagnes. ### Ce que tu ne peux pas faire - Créer un athlete/coach dans la base AITO (chaque personne créé son compte). - Modifier les fiches personnelles des athletes/coachs affiliés (ils gardent la main sur leurs données). - Modifier les données d'une fédération. ### Bonnes pratiques - Complète l'adresse et les horaires d'entraînement — les visiteurs t'appelleront. - Valide rapidement les demandes d'affiliation entrantes (48 h max recommandé). - Ajoute une galerie photo dynamique pour attirer de nouveaux licenciés. --- ## 5. Fédération Ton objectif : **piloter ta discipline** en Polynésie, valoriser tes clubs, tes athletes et tes résultats. ### Ton espace : le Cockpit Fédération Accessible depuis **Mon Espace → Cockpit Fédération** ou directement `/mes-federations/{ton-slug}`. Le cockpit affiche : - **Tableau de bord** : KPI en temps réel (Clubs / Athletes / Coachs / Résultats de l'année / Or / Argent / Bronze / Athletes SELECTED JP 2027). - **Onglet Athletes** : tous les athletes de ton périmètre. Filtre entre affiliés directement et via un club. Recherche par nom. - **Onglet Clubs** : tes clubs affiliés (fédération directe + EntityLink accepté). - **Onglet Coachs** : coachs rattachés à tes clubs. - **Onglet Résultats & Palmarès** : filtre par année, médaille (Or/Argent/Bronze). Tri chronologique. - **Onglet Actualités** : articles publiés (Curator) taguant ta fédération, un de tes clubs ou de tes athletes. - **Onglet Livrets & Mémoires** : demande un livret sur ta fédération, un club, un athlete de ton périmètre. ### Ce que tu peux faire ✅ - **Consulter** clubs affiliés, athletes du périmètre (direct + via club), coachs, résultats, articles. - **Filtrer** par période, année, athlete, club, discipline, médaille. - **Voir ton palmarès agrégé** (Or / Argent / Bronze) — calculé automatiquement. - **Accepter/refuser/révoquer** les affiliations qui te concernent. - **Modifier ta fiche fédération** (nom, logo, description, contacts, site web, réseaux, galerie). - **Demander un livret** ou une mémoire sportive **sur ton périmètre uniquement** : - Mémoire de ta fédération (avec période). - Mémoire d'un club affilié. - Mémoire d'un athlete du périmètre. - Bilan annuel de ta fédération. - **Importer des documents** (PDF, Excel, coupures de presse, archives) → ils alimentent uniquement le **corpus documentaire** du livret, jamais la base canonique AITO. - **Utiliser la recherche IA** pour trouver des sources externes complémentaires. - **Exporter** tes données autorisées (à venir dans P8). ### Ce que tu ne peux pas faire ❌ - **Créer** dans la base AITO : athletes, coachs, clubs, autres fédérations (**réservé Admin/COPF**). - **Importer en masse** athletes/clubs/coachs dans la base canonique. - **Modifier les données personnelles** d'un athlete affilié (il garde la main sur sa fiche). - **Créer une sélection JP 2027 officielle** (rôle COPF). - **Valider institutionnellement** un résultat à la place du COPF. - **Se déclarer « COPF »** ou modifier `is_copf` — ce flag est réservé Admin AITO. - **Injecter automatiquement des données** depuis un import : si un élément importé pourrait enrichir la base, une suggestion est envoyée à l'admin AITO pour validation manuelle. - **Accéder au cockpit d'une autre fédération** — chaque manager voit uniquement son propre périmètre. ### Import documentaire (règle importante) Depuis la fenêtre d'un projet de livret, tu peux importer : - PDF, documents, archives ; - résultats historiques (Excel, CSV) ; - tableaux, articles, coupures de presse ; - photos, coupures diverses. Ces fichiers sont marqués **« Source fournie par la Fédération »** et alimentent uniquement le corpus du livret concerné. Ils ne créent jamais d'athlete/club/résultat canonique. Si un élément semble intéressant pour la base globale, un admin AITO reçoit une suggestion à valider. ### Bonnes pratiques - Vérifie régulièrement tes demandes d'affiliation entrantes. - Renseigne la description institutionnelle de ta fédération : elle est reprise dans les livrets. - Complète le président, site web, contact, réseaux — ces informations enrichissent ta fiche publique. - Réponds aux notifications d'admin AITO concernant les suggestions issues de tes imports documentaires. ### Sécurité Ton compte manager est unique. Si tu veux confier la gestion à un autre membre de ton bureau : - **Option A** : contacte l'admin AITO qui peut transférer les droits (voir `FEDERATION_PILOT_TRANSFER.md`). - **Option B** (à venir P8) : invite un gestionnaire suppléant depuis ton cockpit. --- ## 6. COPF (Comité Olympique de Polynésie Française) Ton objectif : **piloter la sélection polynésienne** et valider institutionnellement. ### Ce que tu peux faire ✅ - **Tout ce que fait un manager Fédération** — sur toutes les fédérations. - **Comparer les fédérations** (reporting global à venir P8). - **Créer une sélection JP 2027** (SELECTED / RESERVE / OUT) sur les athletes des fédérations. - **Valider institutionnellement** des résultats importants. - **Produire des bilans consolidés** du sport polynésien (livrets multi-fédérations). - **Importer officiellement** des données canoniques via les endpoints Admin (Excel, imports multi-entités). - **Créer des mémoires transverses** : - Mémoire annuelle du sport polynésien. - Mémoire par discipline olympique. - Bilan Jeux du Pacifique 2027 (à venir août 2027). - **Gérer les revendications de fiche** (approuver/refuser les demandes « Je gère cette page »). ### Ce que tu ne peux pas faire ❌ - Aucune limite dans le périmètre sportif polynésien, sauf accès purement techniques (config plateforme = Admin AITO). ### Bonnes pratiques - Réponds aux demandes de validation dans les 5 jours ouvrés. - Utilise les livrets pour communiquer les bilans institutionnels aux tutelles. --- ## 7. Admin AITO Ton objectif : **maintenir la plateforme et sa qualité**. ### Accès complet - Tout ce que fait un COPF. - Configuration plateforme (SEO, hero rotation, campagnes T-shirts, curator, sonar JP2027). - Import massif d'entités canoniques (Excel athletes, multi-entités). - Gestion des utilisateurs et rôles. - Modération : signalements, litiges, validation des revendications. - Livrets premium : gestion des sections, workflow images (validation + attribution + stockage), aperçu PDF. - Sonar JP2027 : activation/désactivation du scan hebdo, run manuel, historique. - Attribution automatique (deviner crédit/licence depuis les pages sources). - Curator : scan DDG manuel + publication + épinglage. ### Règles éthiques - Ne jamais publier une image sans licence claire (obligatoire : crédit + license). - Toujours attribuer les sources externes (© photographe / éditeur). - Ne pas modifier les fiches personnelles sans consentement. - Respecter la doctrine anti-hallucination pour les livrets IA (documenter les sources). ### Bonnes pratiques - Vérifie le rapport Sonar JP2027 chaque semaine. - Traite les demandes de « Je gère cette page » sous 48 h. - Fais tourner le testing_agent avant chaque déploiement majeur. --- ## Comment obtenir plus de droits ? Contacte l'admin AITO en précisant : 1. Ton profil actuel (athlete, coach, club, fédération). 2. Ton besoin exact (ex : « je veux importer 200 athletes d'un club » = pas possible pour toi mais admin peut le faire). 3. Pièce justifiant ton rôle (mandat fédéral, décision du bureau, etc.). L'équipe AITO ne crée jamais de raccourci silencieux : chaque exception est documentée dans l'audit trail. --- *AITO.PF · Plateforme du sport polynésien · Contact : équipe AITO*