Import de composition par OCR¶

Cette page décrit le workflow d'import de composition par OCR disponible dans MY-LIVE-SPORT pour le football, le futsal, le hockey et les autres sports d'équipe compatibles.

Terminologie¶

Pour garder un vocabulaire cohérent dans l'interface et sur le site :

• feuille de match : le document source, en photo ou en scan ;
• OCR : la lecture automatique du document ;
• import de composition : l'action finale qui applique la composition au match après contrôle.

Objectif¶

L'import de composition par OCR permet de :

• partir d'une photo ou d'un scan de feuille de match ;
• détecter les titulaires et remplaçants plus vite qu'une saisie manuelle complète ;
• contrôler les lignes avant insertion ;
• appliquer directement la composition au match après validation.

Activation et quota¶

L'import de composition par OCR n'est pas uniquement un bouton d'interface.

Il dépend de plusieurs conditions :

• la fonctionnalité doit être activée pour l'espace concerné ;
• la compétition doit autoriser l'import de composition par OCR ;
• un quota disponible doit exister ;
• l'utilisateur doit avoir accès au match concerné.

Règle de consommation¶

Le quota est consommé uniquement à la validation finale de l'import de composition.

Concrètement :

• prévisualiser ;
• relancer une analyse ;
• ajuster les zones ;
• corriger des lignes ;

ne consomme pas d'unité, tant que l'utilisateur n'applique pas réellement l'import.

Chargement de l'image¶

Depuis l'écran du match :

1. ouvrir le panneau d'import de composition par OCR ;
2. choisir une image depuis l'ordinateur ;
3. sur mobile, utiliser directement l'appareil photo si le navigateur le permet ;
4. attendre l'affichage de l'image dans le panneau d'import.

Définition des zones OCR¶

Le cadrage est pensé pour aller vite :

• aucune zone n'est pré-définie au départ ;
• l'utilisateur clique les 4 coins d'une zone ;
• après les 4 premiers points, l'interface passe automatiquement à la zone suivante ;
• une zone d'export réelle peut être affichée en overlay pour voir exactement ce qui sera envoyé au moteur OCR.

Guides de lignes¶

Une fois la zone définie, des lignes horizontales servent de repère.

Elles ont deux objectifs :

• aider l'utilisateur à bien visualiser où se termine chaque ligne du tableau ;
• découper l'analyse OCR par ligne pour réduire les décalages entre joueurs.

Le nombre de lignes est adapté au sport :

• football : 11 titulaires ;
• futsal : 5 titulaires ;
• autres sports : adaptation selon la structure de la composition.

Pour la zone des remplaçants, les guides permettent aussi d'affiner l'espacement si la feuille est irrégulière.

Moteur OCR¶

MY-LIVE-SPORT utilise désormais un moteur OCR dédié orienté lecture de documents, avec une logique de découpe plus robuste que l'ancien flux basé sur un modèle conversationnel généraliste.

En pratique, cela améliore :

• la lecture des listes de joueurs ;
• la stabilité sur des feuilles variées ;
• la consommation serveur ;
• la reproductibilité du résultat.

Validation avant application¶

Après analyse, l'écran de revue affiche :

• les lignes reconnues ;
• les lignes à vérifier ;
• les joueurs associés automatiquement ;
• les lignes non résolues.

Actions possibles¶

Pour chaque ligne non résolue, l'utilisateur peut :

• choisir un joueur existant dans la base ;
• appliquer cette sélection à la composition ;
• ajouter un nouveau joueur si la base n'est pas encore à jour.

Quand un nouveau joueur est créé depuis ce flux :

• il est ajouté à la base du club ;
• il devient disponible dans la liste de sélection ;
• il peut ensuite être appliqué à la composition sans quitter le panneau.

Sécurité des fichiers¶

Les fichiers liés à l'import ne sont plus servis comme des fichiers publics simples.

Points importants :

• l'utilisateur doit être authentifié ;
• l'accès dépend du service et du championnat ;
• les fichiers restent lisibles dans le cadre autorisé du championnat ;
• l'écriture et la validation restent protégées par les endpoints métier.

Conseils de prise de vue¶

Pour de meilleurs résultats :

• cadrer la feuille le plus à plat possible ;
• éviter les ombres et reflets ;
• laisser tout le tableau visible ;
• vérifier que les lignes du tableau sont lisibles ;
• corriger si nécessaire les guides avant de lancer l'analyse.

Limites connues¶

L'OCR reste sensible si :

• l'image est trop floue ;
• l'écriture manuscrite est très irrégulière ;
• les colonnes ne sont pas respectées ;
• plusieurs lignes se touchent visuellement.

Dans ces cas, la revue manuelle garde la main : l'utilisateur peut ajuster les zones, relancer l'analyse ou compléter la composition ligne par ligne.

Aller plus loin¶

Pour les cas concrets rencontrés en production, consultez aussi la FAQ dédiée à l'import de composition par OCR.