Records · Process
开发过程记录
这份记录说明本项目是怎么从 PRD、原始数据和样式要求一步步落实到页面与文档中的。
目标
- 把 `data/` 里的源数据整理成可发布的族谱站点。
- 把功能页面和静态资料明确分开。
- 让每一个人的独立页面成为最重要的阅读入口。
- 把开发过程、数据变更和验收结果都留下记录。
关键步骤
- 先搭建 Astro 静态站点和数据适配层，再生成人物页、统计页、全书页和资料处理页。
- 把原始树结构整理成稳定的人物记录，保证数据变动时能重新生成页面。
- 为重要但缺失的字段提供中文待考填充，避免版式完整性被空值打断。
- 把首页树、人物页和全书页统一为清代线装族谱视觉，并去掉现代渐变、阴影和圆角。
- 在浏览器里核对封面、谱序、世系树和人丁详录的真实渲染效果。
数据变更规则
- 先修改 `data/`。
- 把变更写进 `docs/data-change-log.md`。
- 重新运行 `npm run check:data` 和 `npm run build`。
- 抽查首页、人物页和资料处理页。
当前结果
- 已建立私有 GitHub 仓库。
- 功能页与静态素材目录已经分离。
- 人物页采用完整的族谱详录格式。
- 缺失但重要的信息已用中文待考说明补齐。