文旅数字化与文化出海背景下，公众对历史文化的消费正从“景点打卡”转向深度人文体验，但现有产品多为碎片化百科词条或静态图
文，时间脉络与地理空间割裂，用户“读传记记不住、查地图对不上”。本项目面向人文旅游、博物馆与研学教育等场景，建设“历史人
物生平时空漫游”双语内容站：以地图、时间轴、详情卡三轴联动，把人物年谱落到真实地理坐标上，用现代语汇重述古人际遇（如“
逆境中的美食哲学家”），大幅降低理解门槛，并为后续多人物、多语言、全球化的数字文化内容平台打好数据与架构基础，服务中华
优秀传统文化的数字化传播与出海。
项目包含五大功能模块：
1. 时空地图：离线矢量底图上呈现人物一生行迹路线与驻留节点，支持年份游标定位、省界叠加、细节图层按需加载；
2. 节点详情卡：展示当前驻留地点的诗文、译文与解读，与地图选中状态实时联动；
3. 心境时间轴：手写 SVG 情绪曲线，把一生际遇量化为可视化起伏（如乌台诗案骤至谷底、黄州 REBIRTH 回升）；
4. 多入口导航：首页人物长廊三级筛选、⌘K 快速直达面板、人物页切换器，另有“同时之世”“足迹”等衍生页；
5. 多端多语：Web 端中英双语、微信小程序（Taro）、鸿蒙壳（ArkWeb）三端覆盖，URL 可深链至具体人物与节点。
全局状态（当前人物+当前节点）统一驱动地图、详情卡、时间轴三处联动，形成“一生尽在一屏”的沉浸体验。
我负责整体架构设计与前后端核心实现。技术栈：前端 Next.js 15 + TypeScript + Tailwind v4 + MapLibre GL +
Vitest/Playwright；后端 Spring Boot 3.5 + Java 17 + JPA + PostgreSQL 16（人物内容以 jsonb 文档存库）；另有 Taro
小程序与鸿蒙 ArkWeb 壳。架构上“内容即数据”：content JSON 为唯一真相，后端幂等同步入库（改 JSON 重启即生效，无 SQL
迁移），API 按 locale 扁平化输出。亮点：底图完全离线化（自建矢量陆地/河湖/省界 + CJK
字体子集化，不依赖在线瓦片）；SSG 让诗文进入初始 HTML 利于搜索引擎收录。难点：切语言时地图图层引用稳定性（指纹 hook
避免反复拆建图层导致 WebGL 崩溃）；行迹动效编排（flyTo 一次到位、line-progress 驱动动画、尊重
prefers-reduced-motion）。
评论