修改问题

2026-09-17 16:35:57 +08:00
parent bbc024f7f2
commit f53a2dbc87
17 changed files with 54 additions and 2246 deletions
@@ -0,0 +1,52 @@
+# 项目交接说明
+
+更新日期：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`。当前工作区包含上述删除和命令调整，确认无误后再提交。