O atlas digital que reescreve a história de 2,400 anos da China em um só clique

---

Dados rápidos

• Repositório: DeanChensj/jiangshan-map
• Licença: GPL-3.0 (aberto para uso e modificação, com restrições de redistribuição)
• Linguagem: JavaScript
• Estrelas: 3.266 (atualizado em 2026-11-02)
• Forks: 392
• Ranking: Trendshift (daily: #9; weekly: #21)
• Data da consulta: 2026-11-02

---

Por que este projeto é relevante

A história chinesa é vastíssima e fragmentada em livros e mapas estáticos, muitas vezes confusa para estudantes e curiosos. O jiangshan-map resolve isso ao transformar um território complexo em uma interface interativa, onde o usuário pode "desfolhar" o tempo, comparar fronteiras antigas e modernas e até seguir rotas literárias de poetas como Su Shi. Criado por um desenvolvedor individual (Dean Chen), o projeto combina cartografia histórica, digital humanities e design imersivo para democratizar o acesso a dados que antes exigiam consultas em arquivos físicos ou pesquisas especializadas.

A alta demanda (3.266 estrelas em menos de 4 meses) reflete um interesse crescente por ferramentas que combinam tecnologia e história, especialmente em um contexto onde a IA e os dados abertos estão transformando a forma como estudamos o passado. O projeto não é apenas um mapa: é uma ferramenta pedagógica que permite visualizar eventos como a conquista do Ba-Shu pelo Qin (316 a.C.) ou a recuperação do Ili pela China em 1881 — algo que, sem ele, exigiria cruzamento de fontes dispersas.

---

Como funciona: do código à experiência

O jiangshan-map é construído em JavaScript e usa um banco de dados estruturado para renderizar 164 instantâneos territoriais ao longo de 2,400 anos. A interface principal é um timeline horizontal onde o usuário arrasta para navegar entre eras. Cada clique em uma cidade ou rota abre uma janela com genealogia administrativa, enquanto o modo "X-Ray Lens" projeta modernas fronteiras provinciais sobre mapas históricos.

Fluxo básico de instalação

## Requisitos prévios:
git clone https://github.com/DeanChensj/jiangshan-map.git
cd jiangshan-map
npm install # Instala dependências (Node.js necessário)
npm start # Roda o servidor local (acesso via localhost:3000)

Para uso direto no navegador, basta acessar a homepage oficial: deanchen.me/jiangshan-map/.

---

Casos de uso práticos

1. Estudantes de história

Ao clicar em Chang’an (capital imperial por mais de 1.000 anos), o projeto mostra como a cidade foi um centro político, cultural e militar em cada dinastia — desde o período das Cinco Dinastias até a República Popular. A ferramenta permite comparar a localização atual com a do século XIV, quando era o centro do império Ming.

1. Poetas e literatos

Quem busca entender onde Su Dongpo (autor da Rapsódia das Ilhas Vermelhas) compôs em exílio pode localizar Huangzhou (atual Wuhu) e ver como a região foi um ponto estratégico durante a dinastia Tang. O mapa também marca rotas de Zheng He, explorador chinês do século XV.

1. Geógrafos e militares

O modo "Ghost Boundary Diff" (diferenças de fronteiras) é útil para visualizar conquistas como a expansão do Qin em 221 a.C. ou a campanha de Li Jing contra os Tuyuhun (635 d.C.). Cada clique revela uma camada de bordas vermelhas que mostram como o território mudou.

1. Investigadores de digital humanities

Professores podem usar o projeto para criar exercícios interativos, como "Qual era o nome desta cidade na dinastia Han?" ou "Em que região estava o Passo Languan durante a dinastia Qin?". O banco de dados detalhado permite até a inclusão de dados de poesias clássicas associadas a lugares.

---

O que o diferencia de alternativas

Existem mapas históricos chineses, mas poucos combinam:

• Interatividade (como o Google Earth, mas focado em eras específicas).
• Precisão cronológica (até o ano exato de cada evento).
• Conexão cultural (ligação entre cidades e obras literárias).
• Visualização de "ghost boundaries" (mostrando como fronteiras mudaram).

Alternativas como o Atlas of China (da Universidade de Harvard) ou o Historical Map of China (do Instituto de Geografia da Academia Chinesa) são estáticos ou focados em uma era. O jiangshan-map, por outro lado, é um time-traveler para a história chinesa, com um design que lembra um pergaminho interativo.

---

Limitações e cuidados

• Licença restritiva: GPL-3.0 exige que qualquer redistribuição seja aberta sob a mesma licença. Isso pode limitar o uso comercial ou em plataformas que não compartilhem código.
• Dependências técnicas: Requer Node.js para execução local. Para uso direto, basta acessar a homepage, mas a instalação exige configuração inicial.
• Dados ausentes: Não há informações sobre a qualidade dos dados históricos incorporados (ex.: fontes primárias consultadas, possíveis erros de tradução ou interpretação).
• Atualização limitada: Último commit foi em 2026-11-02, mas a última release foi em 2026-10-27. Não há dados sobre planos futuros.
• Segurança: Como é um projeto open-source, qualquer vulnerabilidade no código JavaScript pode ser explorada. Recomenda-se evitar execução em redes públicas sem verificação prévia.
• Foco histórico: O projeto é profundo em dinastias chinesas, mas não aborda eventos de outras culturas que influenciaram a região (ex.: Mongóis, Manchus).

---

Resumo rápido

• Projeto: Atlas interativo de 2,400 anos da China, com 18 dinastias, 164 territórios e conexões entre história, poesia e geografia.
• Licença: GPL-3.0 (aberto, mas restritivo para redistribuição).
• Linguagem: JavaScript.
• Estrelas: 3.266 (ranking #9 no Trendshift diário).
• Ranking: Tendência crescente em repositórios de código aberto.
• Risco principal: Dependência de Node.js para execução local e restrições da licença.

---

Fontes

• Repositório GitHub: DeanChensj/jiangshan-map
• Release v1.1.0: 2026-10-27
• Homepage oficial: deanchen.me/jiangshan-map/
• Ranking Trendshift (daily): #9 (consulta: 2026-11-02)