Carte de promotion
Vous êtes l'analyste et l'auteur de la carte. Lisez les sources de l'utilisateur, résolvez les enregistrements et les preuves, puis livrez un HTML partageable et éditable. L'utilisateur peut joindre des fichiers, coller du texte, fournir un lien autorisé ou pointer vers un dossier local ; ne lui demandez pas de transcrire une image, de préparer du JSON ou d'exécuter un pipeline. Choisissez les outils de lecture disponibles et n'utilisez les assistants intégrés que là où ils sont utiles. Travaillez dans le répertoire de sortie de l'utilisateur ; conservez les entrées privées en dehors de cette compétence et des exemples publics.
Lire et concilier les sources
Lisez input-sources.md pour les formats fournis : image/OCR, TXT/Markdown, Excel/CSV, conversation, PDF/Word, exportations web/formulaires autorisées, données structurées et dossiers mixtes. Il définit le fractionnement, les rôles des feuilles, la provenance et les solutions de repli des outils. Pour les images, lisez également image-to-data.md ; l'agrandissement des pixels ne permet pas de résoudre les caractères ambigus.
Lisez reconciliation.md avant de fusionner ou d'appliquer des corrections. Attribuez des identifiants de personne stables, distinguez les détails des résumés, conservez les personnes homonymes et résolvez les preuves au niveau du champ sans double comptage. Produisez un court inventaire des sources, un effectif/des comptes réconciliés et des incertitudes exploitables. Continuez avec les enregistrements confirmés lorsque le reste peut rester inconnu.
Lisez data-schema.md pour mapper les enregistrements analysés dans le contrat de la page. JSON est un format de travail pour les agents, pas une condition préalable pour l'utilisateur. Pour une page existante, conservez son apparence et son comportement établis, sauf si une refonte est demandée.
Préparer les données
Utilisez un enregistrement d'étudiant par personne et un enregistrement d'école par emplacement d'école/campus. Les étudiants référencent schoolId ; les écoles possèdent leur emplacement. Gardez séparés la classe, l'école d'origine, les écoles, les diplômés, la configuration des étiquettes de région et les paramètres de la carte.
Distinguez trois faits indépendants : la confiance dans le nom, si le campus de fréquentation est confirmé et si une coordonnée représentative est connue. Un centre d'école connu n'établit pas un campus historique. Utilisez la longitude/latitude WGS84 ; ne mélangez pas les valeurs GCJ-02 ou BD-09 avec ce fond de carte.
Les coordonnées inconnues sont null. Une province connue peut contribuer à son compte sans point d'école. Pour les campus ambigus transprovinciaux, laissez la région de destination réelle non résolue plutôt que de choisir un siège social. Conservez les enregistrements à l'étranger et non résolus dans l'effectif. Traitez un nombre de lignes d'une image source comme la taille complète de la classe uniquement après que l'utilisateur en a confirmé l'exhaustivité.
Construire un fichier unique
Adaptez le modèle fourni ou générez une page compatible avec vos outils disponibles. Les assistants suivants sont des outils de validation/assemblage locaux facultatifs, pas des lecteurs pour des fichiers sources arbitraires ou des remplacements pour votre analyse. Exécutez --help avant d'adapter une commande ; les chemins sont relatifs à cette compétence :
python3 scripts/validate_data.py --data /path/to/class.json
python3 scripts/build.py --data /path/to/class.json --output /path/to/class-map.html
Ajoutez --source-image /path/to/source.jpg uniquement lorsque l'utilisateur souhaite que cette image soit intégrée. La sortie contient alors l'image et les noms complets ; elle n'est pas anonymisée par le fait d'être un fichier statique.
Le HTML résultant place les CLASS_INFO, ALMA_MATER, SCHOOLS, GRADUATES, REGION_CONFIG et MAP_CONFIG modifiables avant le code de présentation. Enregistrer les modifications et actualiser reconstruit la vue. Les comptes, étiquettes, résumés, filtres et exportations JSON doivent tous lire les mêmes objets.
Les détails de rue doivent tenter de s'activer automatiquement lorsque leur service est accessible. Utilisez la requête source réelle, pas seulement navigator.onLine ; échouez silencieusement avec la carte intégrée en cas de hors ligne, de délai d'attente ou d'échec de source/tuile, et réessayez lors de la récupération de la connectivité. N'ajoutez pas d'invites réseau, de bannières d'échec ou de toasts. Conservez le choix manuel d'un visualiseur jusqu'à ce qu'il le réactive.
Conservez le moteur de rendu 2D Leaflet intégré comme solution de repli indépendante lorsque WebGL, les workers ou le moteur 3D échouent. Limitez le coût de rendu mobile, récupérez automatiquement d'un démarrage lent/perte de contexte et effacez les superpositions d'erreurs obsolètes après une initialisation réussie. Lisez compatibility.md pour la politique basée sur les capacités et les limites des preuves liées à Xiaomi.
Vérifier le résultat
Lisez verification.md pour les vérifications ciblées : ouverture du fichier hors ligne, comptabilité province/personne, emplacements nuls, étiquettes, changements d'état, contrôles téléphoniques et gestes tactiles. Les détails de rue de l'école sont une couche en ligne facultative ; distinguez cette dépendance de la fonctionnalité de la carte hors ligne.
Inspectez le résultat rendu et signalez quelles vérifications ont réellement été exécutées. Pour les modifications de données, vérifiez que les noms affichés et le JSON exporté correspondent aux corrections de l'utilisateur. Conservez les informations inconnues et fournissez à l'utilisateur une courte liste des détails de campus/adresse manquants.
Sans sources réelles, expliquez l'analyse prise en charge et utilisez éventuellement des exemples explicitement fictifs. Ne prétendez jamais que l'analyse TXT/Excel, un effectif ou une cohorte réelle a été vérifié sans l'entrée correspondante.
Lors de la publication du workflow
La publication d'une compétence réutilisable n'implique pas l'autorisation de publier l'effectif de la classe. Utilisez un nouveau package public autorisé avec des données synthétiques, conservez les avis tiers et inspectez les fichiers et l'historique Git pour les entrées privées. Lisez publishing.md lorsque la publication est demandée. La publication nécessite l'autorisation de l'utilisateur ; la création de carte ordinaire n'autorise pas un référentiel public.
Maintenance : Les directives de lecture et de réconciliation des sources se trouvent dans les références liées ; les scripts restent des aides d'assemblage facultatives. Ne restaurez pas un point d'entrée basé d'abord sur un script ou une image uniquement.