53 lines
2.3 KiB
Markdown
53 lines
2.3 KiB
Markdown
# 项目交接说明
|
|
|
|
更新日期：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`。当前工作区包含上述删除和命令调整，确认无误后再提交。
|