# 项目交接说明

更新日期：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/` 保存这些资源的校验清单。

## 常用检查

在根目录运行：

```bash
npm.cmd run check
```

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

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

2026-09-17 的执行结果：

```text
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`。当前工作区包含上述删除和命令调整，确认无误后再提交。