Documentation
utilisateur Tifosi.

1. Présentation

Objectif de l’application

TIFOSI est une application web progressive (PWA) dédiée au scouting du football amateur en Île-de-France. Elle permet de consulter les matchs et clubs, créer des observations de joueurs depuis les tribunes, suivre des favoris, échanger dans une Fan Zone liée à un match, et installer l’application sur un téléphone ou un ordinateur.

Utilisateurs concernés

• Supporters, parents, famille et amis
• Joueurs et coachs
• Direction de club
• Scouts / tifosi suivant des clubs et matchs locaux

Principales fonctionnalités

• Consultation des matchs du week-end (liste et carte)
• Fiches match (score, stade, infos, feuille de match FFF, partage, favoris)
• Fiches clubs et matchs du week-end par club
• Création et consultation d’observations de joueurs
• Rubrique Scouting (vos observations + Top)
• Favoris (clubs et matchs suivis)
• Fan Zone (commentaires liés à un match)
• Profil utilisateur (Google), club suivi, thème clair/sombre
• Installation PWA et notifications push (si activées sur l’environnement)

2. Premiers pas

Accès à l’application

1. Ouvrez l’application dans un navigateur web (ordinateur ou mobile).
2. L’adresse d’accès dépend de l’environnement déployé (chemin d’application de type /app/).
3. Si vous n’êtes pas connecté, vous êtes redirigé vers l’écran de connexion.

Écran de connexion : logo TIFOSI, slogan, bloc CONNEXION REQUISE et bouton Google.

Connexion

La connexion se fait uniquement via Google.

1. Sur l’écran de connexion, lisez le message CONNEXION REQUISE.
2. Cliquez sur le bouton Google proposé (« Continuer avec Google » / équivalent selon le navigateur).
3. Choisissez votre compte Google et validez.
4. Après une connexion réussie, vous arrivez sur l’écran Matchs.

Messages possibles :

Première utilisation

Après la première connexion, il est recommandé de :

1. Ouvrir Mon profil (icône profil en haut à droite).
2. Vérifier ou renseigner votre Pseudo (obligatoire).
3. Compléter éventuellement Prénom, Nom, Email, Mobile.
4. Choisir un club à suivre.
5. Cliquer sur Enregistrer.

Installation de la PWA

Si l’installation est proposée sur votre appareil, une fenêtre peut apparaître :

Installer Tifosi sur votre mobile ?

• Sur iPhone : suivez l’indication « Sur iPhone, appuyez sur Partager puis Sur l’ecran d’accueil pour installer Tifosi. », puis Compris.
• Sur les autres appareils : Plus tard pour reporter, ou Installer pour lancer l’installation.

Une fois installée, TIFOSI s’ouvre comme une application (mode autonome), en orientation portrait préférée.

Capture non automatisable de façon fiable (invite dépend du navigateur / iOS). Sur appareil compatible, l’invite affiche Installer Tifosi sur votre mobile ? avec Plus tard / Installer (ou Compris sur iPhone).

3. Navigation générale

Menu principal (barre d’onglets)

En bas de l’écran, cinq onglets :

La barre d’onglets est visible sur ces écrans (et sur Mon profil). Elle disparaît sur les écrans de détail (match, club, Fan Zone, observation, page introuvable).

En-tête commun

Sur les écrans principaux, l’en-tête affiche généralement :

• le wordmark TIFOSI ;
• le bouton de thème (mode jour / mode nuit) ;
• l’accès Mon profil ;
• le bouton Se déconnecter (lorsque vous êtes connecté avec Google).

Écran d’accueil

L’accueil après connexion est l’écran Matchs : recherche, filtres par catégorie, navigation de week-end, puis liste des rencontres.

Accueil Matchs : recherche, filtres, week-end et cartes de rencontre.

4. Fonctionnalités

4.1 Matchs (liste)

Objectif

Consulter les matchs du week-end en Île-de-France, les filtrer et ouvrir une fiche détaillée.

Comment y accéder

1. Connectez-vous.
2. Touchez l’onglet Matchs (ou ouvrez l’application : c’est l’écran d’accueil).

Présentation de l’écran

• Barre de recherche : « Rechercher clubs ou stades... »
• Pastilles de filtre : Tous, U14, U15, U15F, U16, U17, U18, U18F, U19, U20, Seniors, R1, R2, R3, NATIONAL
• Sélecteur de week-end (libellé du type Ce week-end ou une plage de dates)
• Liste de cartes match (équipes, compétition, horaire / score, stade)

Actions disponibles

• Rechercher par club ou stade
• Filtrer par catégorie
• Changer de week-end
• Actualiser la liste
• Ouvrir un match (fiche détail)

Procédure pas à pas

1. Ouvrez Matchs.
2. Éventuellement saisissez un club ou un stade dans la recherche.
3. Choisissez un filtre (ex. U17).
4. Naviguez vers le week-end souhaité.
5. Touchez une carte pour ouvrir Détails du match.

Résultat attendu

La liste affiche les matchs correspondant aux critères. Les matchs sans horaire connu (sauf score final) peuvent être exclus du périmètre week-end.

Points d’attention

4.2 Carte

Objectif

Visualiser les matchs sur une carte et accéder rapidement au détail, à l’itinéraire ou à la Fan Zone.

Comment y accéder

Onglet Carte.

Présentation de l’écran

• Mêmes recherche, filtres et week-end que Matchs
• Carte centrée par défaut sur Paris
• Marqueurs pour les matchs disposant de coordonnées
• Compteur du type {n} matchs
• Bouton de localisation (centrer sur votre position, si autorisée)
• Aperçu d’un match sélectionné avec Voir détails

Écran Carte : marqueurs des matchs géolocalisés.

Actions disponibles

• Filtrer / rechercher comme sur Matchs
• Toucher un marqueur
• Voir détails
• Accéder à la Fan Zone depuis l’aperçu (selon l’aperçu affiché)
• Ouvrir la navigation vers le stade (Google Maps)
• Demander la géolocalisation

Points d’attention

• Seuls les matchs avec latitude / longitude apparaissent.
• Si la géolocalisation est refusée, aucun message d’erreur dédié n’est affiché : la carte reste utilisable sans centrage sur vous.

4.3 Fiche match

Objectif

Consulter le détail d’une rencontre, ses observations, ajouter une observation, rejoindre la Fan Zone, partager ou mettre en favori.

Comment y accéder

• Depuis Matchs, Carte, Favoris, ou la fiche d’un club.

Présentation de l’écran

Titre : Détails du match

Éléments principaux :

• Équipes (logos cliquables vers la fiche club si le club est reconnu)
• Zone centrale : Score final ou Coup d'envoi
• Lien Feuille de match (si un score est présent et qu’une clé FFF est disponible)
• Bloc STADE (adresse / infos stade, accès itinéraire selon les données)
• Bloc INFORMATIONS : Date, Journée, Surface (défaut Non spécifié), Classement avec lien Voir
• Section Observations avec compteur {n} au total
• Pied d’écran : Ajouter observation | FAN ZONE
• Actions haut de page : favori (cœur), Partager

Fiche Détails du match : équipes, coup d’envoi, STADE, INFORMATIONS, boutons Ajouter observation / FAN ZONE.

Actions disponibles

Feedback de partage

• Partagé
• Lien copié
• Partage indisponible
• Échec du partage

Points d’attention

4.4 Clubs

Objectif

Parcourir les clubs d’Île-de-France et ouvrir leur fiche.

Comment y accéder

Onglet Clubs.

Présentation de l’écran

• Recherche : « Rechercher des clubs en Ile-de-France »
• Liste de cartes club (logo, nom, ville le cas échéant)

Annuaire Clubs : recherche et liste des clubs d’Île-de-France.

Actions disponibles

• Rechercher
• Actualiser (Réessayer en cas d’erreur)
• Ouvrir une fiche club

Points d’attention

4.5 Fiche club

Objectif

Voir les informations d’un club, ses matchs du week-end et les observations liées.

Comment y accéder

• Depuis Clubs, un logo d’équipe sur une fiche match, ou les Favoris.

Présentation de l’écran

• En-tête club (logo, nom)
• Bouton Itinéraire (si adresse / coordonnées disponibles)
• Favori (cœur)
• Onglets : Match du WE | Observations (avec badges compteur)

Fiche club : infos club, favori, onglets Match du WE / Observations.

Actions disponibles

• Mettre / retirer des favoris
• Ouvrir un match du week-end
• Consulter les observations du club
• Lancer l’itinéraire

Points d’attention

4.6 Observations (création et consultation)

Objectif

Noter un joueur sur un match : identité, poste, notes par critère, commentaires (dont dictée vocale et commentaires types), puis publier.

Comment y accéder

1. Ouvrez une fiche match.
2. Touchez Ajouter observation.
3. Remplissez la Fiche observation.
4. Touchez Envoyer.

Pour consulter / modifier :

• depuis la liste d’observations d’un match ;
• depuis Scouting → Mes observations ;
• depuis les observations d’un club.

Fiche observation : joueur, équipe, notes, commentaires, progression.

Présentation de l’écran

• Titre : Fiche observation (création) ou Modifier observation (édition)
• Indicateur Progression (pourcentage)
• JOUEUR : Nom, Prénom, Numéro * (obligatoire), poste (GARDIEN, DEFENSEUR, MILIEU, ATTAQUANT)
• ÉQUIPE : choix domicile / extérieur (logos et noms des équipes)
• NOTES : Technique, Physique, Vitesse, Mental, Tactique (1 à 10) ; Nb but(s) ; Nb de passe(s) décisive(s)
• COMMENTAIRES : texte libre, micro (dictée), menu des commentaires types

Actions disponibles

• Saisir / modifier les champs
• Changer d’équipe
• Ajuster les notes
• Dictée vocale (français)
• Ouvrir Commentaires types et Insérer des phrases
• Annuler (retour)
• Envoyer (création) / Enregistrer (édition)
• Partager la fiche (selon l’écran)

Procédure pas à pas — créer une observation

1. Ouvrez le match concerné.
2. Touchez Ajouter observation.
3. Choisissez l’équipe du joueur.
4. Saisissez au minimum le Numéro.
5. Choisissez le poste (un numéro classique peut proposer automatiquement un poste : 1 = gardien, 2–5 défenseur, etc.).
6. Ajustez les notes et, si besoin, buts / passes décisives.
7. Ajoutez un commentaire (clavier, dictée ou commentaires types).
8. Touchez Envoyer.
9. Vous revenez sur la fiche match ; l’observation apparaît dans la liste.

Commentaires types

1. Ouvrez le panneau Commentaires types.
2. Filtrez par catégorie (Toutes, Points forts, À travailler, Suivi, Général) ou recherchez.
3. Activez éventuellement le mode Scout (langage plus technique).
4. Touchez une phrase puis Insérer (ou Insérer (n)).
5. Sans poste choisi, un message peut indiquer : « Choisissez un poste pour des suggestions adaptées au profil. »

Dictée vocale

1. Touchez l’icône micro (Dictée vocale (français)).
2. Autorisez le microphone si demandé.
3. Parlez ; le texte s’ajoute aux commentaires.
4. Arrêtez avec Arrêter la dictée.

Messages possibles : Accès au microphone refusé., Dictée interrompue., Impossible de démarrer la dictée., Dictée vocale non disponible.

Champs et validations

Résultat attendu

Après Envoyer / Enregistrer, l’observation est enregistrée côté application et visible dans les listes concernées. En cas d’échec : message du type « Échec d'envoi vers GoPaaS… ».

Points d’attention

• Une route « observation rapide » technique existe dans l’application mais n’est pas proposée dans l’interface ; le parcours utilisateur réel est la Fiche observation détaillée.
• La proximité GPS au stade peut être vérifiée en arrière-plan (seuil d’environ 500 m) sans écran de contrôle visible pour l’utilisateur.

4.7 Scouting

Objectif

Retrouver vos observations et consulter un classement Top des observations.

Comment y accéder

Onglet Scouting.

Présentation de l’écran

• Onglets : Mes observations | Top
• Recherche (onglet Mes observations) : « Recherche libre... »
• Observations regroupées par mois (libellés en majuscules) ou SANS DATE
• Bouton d’actualisation

Rubrique Scouting : onglets Mes observations / Top.

Actions disponibles

• Basculer Mes observations / Top
• Rechercher dans vos observations
• Actualiser
• Ouvrir une observation (édition si vous en êtes l’auteur)

Points d’attention

4.8 Favoris

Objectif

Retrouver rapidement les clubs et matchs que vous suivez.

Comment y accéder

Onglet Favoris.

Présentation de l’écran

• Titre interne : Mes favoris
• Onglets : Mes clubs | Matchs suivis
• Compteur {n} au total

Rubrique Favoris : onglets Mes clubs / Matchs suivis.

Actions disponibles

• Basculer clubs / matchs
• Ouvrir une fiche club ou match
• (Le retrait du favori se fait depuis la fiche concernée via le cœur)

Procédure — ajouter un favori

1. Ouvrez une fiche match ou club.
2. Touchez le cœur (Ajouter aux favoris).
3. Retrouvez l’élément dans Favoris.

Points d’attention

Les favoris sont enregistrés sur l’appareil (ils ne sont pas synchronisés entre plusieurs téléphones).

4.9 Fan Zone

Objectif

Partager des réactions et commentaires liés à un match en direct ou autour de la rencontre.

Comment y accéder

• Depuis la fiche match : bouton FAN ZONE
• Depuis l’aperçu d’un match sur la Carte

Présentation de l’écran

• Titre : Fan Zone
• Fil de commentaires
• Zone de saisie : « Ajouter un commentaire... » (ou « Connectez-vous pour commenter » si le profil n’est pas prêt)
• Limite : 500 caractères
• Envoi avec la touche Entrée (selon le navigateur / clavier)

Fan Zone liée au match : fil de commentaires et zone de saisie.

Actions disponibles

• Lire les messages
• Saisir et envoyer un commentaire
• Revenir en arrière vers le match

Résultat attendu

Le message apparaît dans le fil (auteur par défaut possible : Supporteur si le pseudo n’est pas renseigné). Les horodatages relatifs s’affichent (À l'instant, Il y a X min/h/j).

Points d’attention

4.10 Profil

Objectif

Gérer votre identité Tifosi, le club suivi, les notifications et la déconnexion.

Comment y accéder

Icône Mon profil en haut à droite (écrans principaux).

Présentation de l’écran

• Titre : Mon profil
• Avatar / photo Google
• Bouton Se deconnecter (libellé tel qu’affiché)
• Section CLUB SUIVI
• Champs : Pseudo, Prénom, Nom, Email, Mobile
• Bouton Enregistrer
• Section NOTIFICATIONS PUSH (si disponible sur votre environnement)
• Version affichée (ex. Version v0.9.2)

Écran Mon profil : identité, club suivi et formulaire.

Actions disponibles

• Choisir / changer le club suivi (modal Choisir un club, recherche « Rechercher un club... »)
• Modifier et Enregistrer le profil
• Activer / désactiver Activer notification
• Se déconnecter
• Se reconnecter via Google si besoin (bloc CONNEXION)

Points d’attention

• Le Pseudo est obligatoire : « Le pseudo est obligatoire. »
• Après déconnexion, l’accès aux écrans protégés demande une nouvelle connexion Google.
• Certaines infos locales peuvent rester en mémoire sur l’appareil ; la session Google (identifiant) est bien coupée.

4.11 Thème clair / sombre

Objectif

Adapter l’affichage au jour ou à la nuit.

Comment y accéder

Bouton thème dans l’en-tête (et sur l’écran de connexion).

• Libellés d’accessibilité : Passer en mode jour / Passer en mode nuit
• Préférence mémorisée sur l’appareil ; par défaut : préférence système du téléphone / navigateur.

5. Parcours utilisateur principaux

5.1 Se connecter et découvrir les matchs

1. Ouvrir TIFOSI.
2. Se connecter avec Google.
3. Arriver sur Matchs.
4. Filtrer ou rechercher.
5. Ouvrir un match.

Prérequis : compte Google et connexion Google configurée sur l’environnement.

Erreur possible : messages « Connexion Google… » — réessayer ou vérifier le compte.

5.2 Créer une observation depuis le stade

1. Trouver le match (Matchs ou Carte).
2. Ouvrir Détails du match.
3. Toucher Ajouter observation.
4. Renseigner numéro (obligatoire), poste, notes, commentaires.
5. Toucher Envoyer.
6. Vérifier l’apparition dans Observations du match et dans Scouting → Mes observations.

5.3 Suivre un club et un match

1. Ouvrir une fiche club ou match.
2. Toucher le cœur.
3. Aller dans Favoris.
4. Retrouver l’élément dans Mes clubs ou Matchs suivis.

5.4 Participer à la Fan Zone

1. Ouvrir le match.
2. Toucher FAN ZONE.
3. Saisir un commentaire.
4. Envoyer.
5. Voir le message dans le fil.

5.5 Compléter son profil

1. Ouvrir Mon profil.
2. Choisir un club à suivre.
3. Renseigner le pseudo (obligatoire) et les autres champs.
4. Enregistrer.
5. Éventuellement activer les notifications.

6. Utilisation sur mobile et PWA

Installation

• Invitation automatique possible : Installer Tifosi sur votre mobile ?
• iOS : via le menu Partager du navigateur → Sur l’écran d’accueil.
• Autres navigateurs compatibles : bouton Installer de l’invite (si proposée).
• Une fois installée, l’app s’ouvre en plein écran (standalone), orientation portrait.

Utilisation mobile

• Interface pensée pour le tactile (barre d’onglets en bas, boutons larges sur fiche match).
• Géolocalisation utile sur Carte et en arrière-plan lors d’une observation.
• Dictée vocale dépend du navigateur et de l’autorisation micro.

Hors connexion

• Avec service worker activé sur l’environnement, le « squelette » de l’application (pages / fichiers statiques) peut rester accessible.
• Les données matchs / clubs / observations / Fan Zone nécessitent en pratique une connexion réseau ; elles ne sont pas conçues comme un mode hors-ligne complet métier.
• Un cache temporaire côté appareil peut accélérer les rechargements récents (durée limitée).

Synchronisation

• Profil, observations et Fan Zone sont synchronisés avec le back-office lorsque vous êtes connecté.
• Les favoris restent locaux à l’appareil.
• Le thème et certaines préférences (ex. commentaires types avancés) sont locaux.

Notifications

Si la section NOTIFICATIONS PUSH apparaît dans Mon profil :

1. Activez Activer notification.
2. Autorisez les notifications dans le navigateur.
3. En cas de refus navigateur : « Les notifications sont bloquees dans les reglages du navigateur. »
4. Désactivation possible : message « Notifications desactivées. »

Les alertes reçues portent en général le titre TIFOSI.

Mises à jour

• En navigateur ou PWA installée, une nouvelle version se charge au prochain passage en ligne / rechargement.
• Le numéro de version est visible en bas de Mon profil.

7. Rôles et droits

Il n’existe pas de rôles distincts du type « admin », « coach » ou « scout » dans l’interface.

8. Messages et erreurs courantes

9. FAQ

Faut-il un compte pour utiliser TIFOSI ?

Oui. L’accès aux écrans principaux exige une connexion Google.

Puis-je observer sans être au stade ?

Oui, vous pouvez remplir une observation à distance. Une vérification de proximité peut être enregistrée en arrière-plan si la géolocalisation est disponible, sans écran dédié.

Où retrouver mes observations ?

Dans Scouting → Mes observations, et aussi sur la fiche du match concerné.

Que signifie le badge « T » sur une note ?

Il signale une note Tifosi agrégée associée à l’observation (affichage dans les listes).

Comment mettre un match en favori ?

Ouvrez la fiche match et touchez le cœur, puis retrouvez-le dans Favoris → Matchs suivis.

Les favoris sont-ils synchronisés sur tous mes appareils ?

Non. Ils sont stockés localement sur l’appareil.

Comment installer l’application sur mon téléphone ?

Utilisez l’invite Installer Tifosi sur votre mobile ? ou, sur iPhone, Partager → Sur l’écran d’accueil.

Pourquoi la Fan Zone refuse-t-elle mon commentaire ?

Vérifiez que vous êtes bien connecté et que votre profil a bien été synchronisé (ouvrez Mon profil, reconnectez Google si besoin).

Puis-je modifier l’observation de quelqu’un d’autre ?

Non. La fiche s’affiche alors en Lecture seule.

Le filtre NATIONAL regroupe quoi ?

Il regroupe des compétitions nationales (niveaux nationaux présents dans les données), distinctes des filtres U14, U17, R1, etc.

Comment changer de thème ?

Utilisez le bouton jour / nuit dans l’en-tête.

Que faire si la page est introuvable ?

Utilisez Retour à l'accueil pour revenir aux matchs.

10. Points restant à confirmer

• URL publique exacte de production / qualification pour les utilisateurs finaux (dépend du déploiement).
• Contenu précis des notifications push reçues en conditions réelles (titre / corps peuvent varier selon les campagnes d’envoi).
• Disponibilité effective du service worker et des notifications sur chaque environnement (dépend des options d’activation côté déploiement).
• Comportement exact si l’utilisateur refuse totalement la géolocalisation pendant une observation (statut enregistré côté serveur, peu visible dans l’interface).
• Périmètre exact de l’onglet Top (toutes observations agrégées vs période limitée) : le libellé UI est Top, sans précision « week-end » à l’écran.
• La route technique d’« observation rapide » n’est pas exposée dans les menus ; son devenir produit (suppression, finalisation ou branchement) reste à confirmer fonctionnellement.

Document généré à partir de l’analyse du code source de l’application TIFOSI (PWA). En cas d’écart avec d’anciens guides ou documents marketing, le comportement réellement présent dans l’application prime.