jiapuapp/docs/项目交接说明.md

项目交接说明

更新日期：2026-09-17

当前状态

这是一个 uni-app / Vue 3 家谱应用，现有 62 个页面。登录、家谱、成员树、家族内容、人物档案、消息和个人中心均已接入页面路由。

这次清理移除了此前留下的联调、审计、回归和页面对比记录，也删除了资源清单的两份单元测试。项目保留了运行时检查，当前工作区校验通过。

从哪里开始看

• pages.json：页面注册和页面级配置。
• utils/navigation/routes.js：业务跳转使用的路由定义。新增或删改页面时，这里要和 pages.json 一起改。
• services/api/：接口调用和接口数据整理。一般一个业务模块对应一组 *-service.js、*-contract.js 文件。
• services/api/request-client.js：请求入口，处理登录失效、响应格式和上传请求。
• utils/runtime-config.js：线上接口地址、客户端标识和租户标识。当前写的是正式环境配置。
• static/assets/：页面实际使用的图片资源；design-pipeline/manifests/ 保存这些资源的校验清单。

常用检查

在根目录运行：

npm.cmd run check

PowerShell 的执行策略可能会拦截 npm，所以这里固定使用 npm.cmd。该命令目前会检查：

• 页面文件与路由注册是否匹配；
• 几处关键页面和导航恢复逻辑是否被误改；
• 静态资源文件是否和资源清单一致。

2026-09-17 的执行结果：

PROJECT CHECK PASS pages=62 routes=62 sources=182
AUDIT REGRESSION CHECK PASS icons=17
NAVIGATION RECOVERY CHECK PASS
RUNTIME ASSET CHECK PASS manifests=4 assets=102

页面交互、上传或端能力相关的修改，仍需要在 HBuilderX 和目标端实际走一遍；这里的检查不能代替真机验证。

这次留下的改动

• 原 docs/ 中的 12 份过程记录已删除。
• design-pipeline/tests/ 下的两份测试已删除，design-pipeline 的 check 现在只做资源清单校验。
• 根目录已移除 check:parity，因为它依赖已删掉的页面对比记录。
• genealogy-app-openapi.yaml 仍保留。它记录接口描述，改服务层前先核对它和现有 services/api/ 实现是否一致。

提交前先看一次 git status。当前工作区包含上述删除和命令调整，确认无误后再提交。