Mapa de graduación
Eres el analista y autor del mapa. Lee las fuentes del usuario, resuelve registros y evidencias, y entrega un HTML compartible y editable. El usuario puede adjuntar archivos, pegar texto, proporcionar un enlace permitido o señalar una carpeta local; no le exijas que transcriba una imagen, prepare JSON o ejecute un pipeline. Elige las herramientas de lectura disponibles y utiliza los ayudantes incluidos solo cuando sea útil. Trabaja en el directorio de salida del usuario; mantén las entradas privadas fuera de esta habilidad y los ejemplos públicos.
Leer y conciliar las fuentes
Lee input-sources.md para conocer los formatos admitidos: imagen/OCR, TXT/Markdown, Excel/CSV, conversación, PDF/Word, exportaciones web/formularios autorizadas, datos estructurados y carpetas mixtas. Allí se definen la división, los roles de las hojas, la procedencia y las alternativas de herramientas. Para las imágenes, lee también image-to-data.md; ampliar píxeles no resuelve caracteres ambiguos.
Lee reconciliation.md antes de fusionar o aplicar correcciones. Asigna identificadores de persona estables, distingue los resúmenes de los detalles, conserva a las personas con el mismo nombre y resuelve la evidencia a nivel de campo sin doble conteo. Entrega un breve inventario de fuentes, un censo/cuentas reconciliados y las incertidumbres procesables. Continúa con los registros confirmados cuando el resto pueda permanecer desconocido.
Lee data-schema.md para mapear los registros analizados en el contrato de la página. JSON es un formato de trabajo para el agente, no un requisito previo para el usuario. Para una página existente, conserva su apariencia y comportamiento establecidos, a menos que se te pida rediseñarla.
Preparar los datos
Usa un registro de estudiante por persona y un registro de escuela por escuela/ubicación de campus. Los estudiantes hacen referencia a schoolId; las escuelas son dueñas de su ubicación. Mantén separados la clase, la escuela de origen, las escuelas, los graduados, la configuración de etiquetas de región y la configuración del mapa.
Distingue tres hechos independientes: la confianza del nombre, si el campus al que asiste está confirmado y si se conoce una coordenada representativa. Un centro escolar conocido no establece un campus histórico. Usa longitud/latitud WGS84; no mezcles valores GCJ-02 o BD-09 con este mapa base.
Las coordenadas desconocidas son null. Una provincia conocida puede contribuir a su recuento sin un punto escolar. Para campus ambiguos entre provincias, deja sin resolver la región de destino real en lugar de elegir una sede. Mantén los registros en el extranjero y sin resolver en el censo. Trata el recuento de filas de una imagen fuente como el tamaño completo de la clase solo después de que el usuario confirme su integridad.
Construir un solo archivo
Adapta la plantilla incluida o genera una página compatible con tus herramientas disponibles. Los siguientes ayudantes son herramientas de validación/ensamblaje local opcionales, no lectores para archivos fuente arbitrarios ni sustitutos de tu análisis. Ejecuta --help antes de adaptar un comando; las rutas son relativas a esta habilidad:
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
Añade --source-image /path/to/source.jpg solo cuando el usuario quiera que esa imagen esté incrustada. La salida entonces contiene la imagen completa y los nombres; no está anonimizada por ser un archivo estático.
El HTML resultante coloca CLASS_INFO, ALMA_MATER, SCHOOLS, GRADUATES, REGION_CONFIG y MAP_CONFIG editables antes del código de presentación. Guardar las ediciones y actualizar la página reconstruye la vista. Los recuentos, etiquetas, resúmenes, filtros y exportaciones JSON deben leer todos los mismos objetos.
El detalle de la calle debe intentar activarse automáticamente cuando su servicio sea accesible. Usa la solicitud real de la fuente, no solo navigator.onLine; falla silenciosamente al mapa incrustado en caso de desconexión, tiempo de espera o fallo de fuente/mosaico, y reintenta al recuperar la conectividad. No añadas avisos de red, banners de error o notificaciones. Mantén la elección manual del visor desactivada hasta que la vuelva a activar.
Mantén el renderizador 2D Leaflet incrustado como alternativa independiente cuando WebGL, los workers o el motor 3D fallen. Limita el costo de renderizado móvil, recupérate automáticamente de un inicio lento/pérdida de contexto y limpia las superposiciones de errores obsoletas después de una inicialización exitosa. Lee compatibility.md para conocer la política basada en capacidades y los límites de la evidencia relacionada con Xiaomi.
Verificar el resultado
Lee verification.md para conocer las comprobaciones específicas: apertura de archivo sin conexión, contabilidad de provincia/persona, ubicaciones nulas, etiquetas, cambios de estado, controles de teléfono y gestos táctiles. El detalle de la calle de la escuela es una capa en línea opcional; distingue esa dependencia de la funcionalidad del mapa sin conexión.
Inspecciona el resultado renderizado e informa qué comprobaciones se ejecutaron realmente. Para ediciones de datos, verifica que los nombres mostrados y el JSON exportado coincidan con las correcciones del usuario. Conserva la información desconocida y proporciona al usuario una lista corta de los detalles faltantes del campus/dirección.
Sin fuentes reales, explica el análisis admitido y, opcionalmente, usa ejemplos explícitamente ficticios. Nunca afirmes que se verificó el análisis TXT/Excel, un censo o una cohorte real sin la entrada correspondiente.
Al publicar el flujo de trabajo
La publicación de una habilidad reutilizable no implica permiso para publicar el censo de la clase. Usa un paquete público nuevo y en lista blanca con datos sintéticos, conserva los avisos de terceros e inspecciona los archivos y el historial de Git en busca de entradas privadas. Lee publishing.md cuando se solicite la publicación. Publicar requiere la autorización del usuario; la creación de mapas ordinaria no autoriza un repositorio público.
Mantenimiento: La guía de lectura y conciliación de fuentes se encuentra en las referencias vinculadas; los scripts siguen siendo ayudas de ensamblaje opcionales. No restaures un punto de entrada basado primero en scripts o solo en imágenes.