Mapa de graduação
Você é o analista e autor do mapa. Leia as fontes do usuário, resolva registros e evidências e, em seguida, entregue um HTML editável e compartilhável. O usuário pode anexar arquivos, colar texto, fornecer um link permitido ou apontar para uma pasta local; não exija que ele transcreva uma imagem, prepare JSON ou execute um pipeline. Escolha as ferramentas de leitura disponíveis e use apenas ajudantes integrados quando úteis. Trabalhe no diretório de saída do usuário; mantenha entradas privadas fora desta skill e exemplos públicos.
Leia e reconcilie as fontes
Leia input-sources.md para os formatos fornecidos: imagem/OCR, TXT/Markdown, Excel/CSV, conversa, PDF/Word, exportações autorizadas da web/formulários, dados estruturados e pastas mistas. Ele define divisão, funções das planilhas, proveniência e fallbacks de ferramentas. Para imagens, leia também image-to-data.md; ampliar pixels não resolve caracteres ambíguos.
Leia reconciliation.md antes de mesclar ou aplicar correções. Atribua IDs de pessoa estáveis, distinga detalhes de resumos, preserve pessoas com o mesmo nome e resolva evidências em nível de campo sem contagem dupla. Produza um breve inventário de fontes, lista/cronograma reconciliado e incertezas acionáveis. Continue com registros confirmados quando o restante puder permanecer desconhecido.
Leia data-schema.md para mapear os registros analisados no contrato da página. JSON é um formato de trabalho do agente, não um pré-requisito para o usuário. Para uma página existente, mantenha sua aparência e comportamento estabelecidos, a menos que seja solicitado a redesenhar.
Prepare os dados
Use um registro de estudante por pessoa e um registro de escola por escola/localização do campus. Alunos referenciam schoolId; escolas possuem sua localização. Mantenha a classe, escola de origem, escolas, graduados, configuração de rótulo de região e configurações do mapa separados.
Distinga três fatos independentes: confiança no nome, se o campus frequentador está confirmado e se uma coordenada representativa é conhecida. Um centro escolar conhecido não estabelece um campus histórico. Use latitude/longitude WGS84; não misture valores GCJ-02 ou BD-09 com este mapa base.
Coordenadas desconhecidas são null. Uma província conhecida pode contribuir para sua contagem sem um ponto escolar. Para campi ambíguos entre estados, deixe o destino real da região não resolvido, em vez de escolher uma sede. Mantenha registros no exterior e não resolvidos na lista. Trate uma contagem de linhas de imagem de origem como o tamanho completo da classe somente após o usuário confirmar a completude.
Construa um único arquivo
Adapte o modelo incluído ou gere uma página compatível com suas ferramentas disponíveis. Os seguintes ajudantes são ferramentas opcionais de validação/montagem locais, não leitores para arquivos de origem arbitrários ou substitutos para sua análise. Execute --help antes de adaptar um comando; caminhos são relativos a esta skill:
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
Adicione --source-image /path/to/source.jpg somente quando o usuário desejar que essa imagem seja incorporada. A saída então contém a imagem completa e nomes; não é anonimizada por ser um arquivo estático.
O HTML resultante coloca CLASS_INFO, ALMA_MATER, SCHOOLS, GRADUATES, REGION_CONFIG e MAP_CONFIG editáveis antes do código de apresentação. Salvar edições e atualizar reconstrói a visualização. Contagens, rótulos, resumos, filtros e exportações JSON devem todos ler os mesmos objetos.
Os detalhes da rua devem tentar ativar automaticamente quando seu serviço estiver acessível. Use a solicitação de origem real, não apenas navigator.onLine; falhe silenciosamente para o mapa incorporado em caso de offline, tempo limite ou falha de origem/tile, e tente novamente quando a conectividade for restaurada. Não adicione prompts de rede, banners de falha ou notificações. Mantenha a opção manual de um visualizador desativada até que ele a reative.
Mantenha o renderizador 2D Leaflet incorporado como fallback independente quando WebGL, workers ou o mecanismo 3D falharem. Limite o custo de renderização móvel, recupere automaticamente de inicialização lenta/perda de contexto e limpe sobreposições de erro obsoletas após inicialização bem-sucedida. Leia compatibility.md para a política baseada em capacidade e os limites das evidências relacionadas à Xiaomi.
Verifique o resultado
Leia verification.md para as verificações focadas: abertura de arquivo offline, contabilidade de província/pessoa, localizações nulas, rótulos, alterações de estado, controles de telefone e gestos de toque. Detalhes da rua da escola são uma camada opcional online; distinga essa dependência da funcionalidade do mapa offline.
Inspecione o resultado renderizado e relate quais verificações realmente foram executadas. Para edições de dados, verifique se os nomes exibidos e o JSON exportado correspondem às correções do usuário. Preserve informações desconhecidas e forneça ao usuário uma pequena lista de detalhes de campus/endereço ausentes.
Sem fontes reais, explique a análise suportada e use opcionalmente exemplos explicitamente fictícios. Nunca afirme que a análise TXT/Excel, uma lista ou uma coorte real foi verificada sem a entrada correspondente.
Ao publicar o workflow
A publicação de uma skill reutilizável não implica permissão para publicar a lista de classe. Use um pacote público novo, autorizado, com dados sintéticos, preserve avisos de terceiros e inspecione arquivos e histórico do Git para entradas privadas. Leia publishing.md quando a publicação for solicitada. A publicação requer autorização do usuário; a criação de mapa comum não autoriza um repositório público.
Manutenção: A orientação de leitura e reconciliação de fontes está nas referências vinculadas; scripts continuam sendo auxiliares de montagem opcionais. Não restaure um ponto de entrada baseado em script ou apenas imagem.