89 lines
4.2 KiB
Markdown
89 lines
4.2 KiB
Markdown
# UI 旧代码与冲突文档清理报告
|
||
|
||
日期：2026-09-13
|
||
分支：`codex/ui-v11-fidelity`
|
||
范围：管理端与小程序端重新设计前的清理阶段
|
||
|
||
## 1. 结论
|
||
|
||
本轮清理已完成。当前唯一视觉规格为：
|
||
|
||
`docs/superpowers/specs/2026-09-13-reference-driven-dual-client-ui-redesign-design.md`
|
||
|
||
管理端首批范围固定为应用框架与工作台；小程序首批范围固定为 11 个核心页面。Phase 07 的业务测试证据继续有效，但被用户否决的视觉结论已经撤销，Phase 08 继续暂停。本报告完成后不自动进入重设计实施。
|
||
|
||
## 2. 已删除内容
|
||
|
||
### 2.1 冲突文档与旧入口（11 个）
|
||
|
||
- 3 份 2026-09-10/11 旧 UI 规格；
|
||
- 5 份要求旧暖白方案、全量管理端或全量 63 页重构的旧执行计划；
|
||
- 旧视觉验收报告；
|
||
- 旧《前端 UI-UX 高保真原型修订说明》；
|
||
- 未跟踪的 `design-qa.md`。
|
||
|
||
### 2.2 旧视觉产物（13 个）
|
||
|
||
- `artifacts/ui-v11` 下 8 个旧管理端/小程序截图与预览文件；
|
||
- 4 个被否决的 Phase 07 页面与对比截图；
|
||
- 1 个旧 Tab 色彩预览图。
|
||
|
||
数据库备份、正式品牌资产及用户提供的两张参考图均未删除。
|
||
|
||
### 2.3 旧测试（2 个）
|
||
|
||
- 删除固化旧浅色后台结构的 `admin-redesign-contracts.mjs`；
|
||
- 删除只验证被否决首页/找对象视觉的 `miniapp-redesign-contracts.mjs`。
|
||
|
||
有效业务契约继续保留；`ui-contracts.mjs` 已移除暖白背景、220px 浅色侧栏、指定标签写法和强制读取 `index.js` 等过时断言。
|
||
|
||
### 2.4 小程序页面重复源（11 个）
|
||
|
||
删除 11 个与 TypeScript 同名的页面 `.js`：活动互选结果、活动互选等待、聊天、咨询介绍、咨询申请、本地资格、本地资格补充、登录、我的咨询、婚前辅导介绍、婚前辅导申请。
|
||
|
||
清理后 63 个注册页面对应 63 个页面逻辑源，页面 TS/JS 同名源为 0。
|
||
|
||
## 3. 迁移与保留
|
||
|
||
- 将本地资格两页 `.js` 中的真实 API、状态刷新、材料上传、声明与提交审核逻辑迁入 `.ts`；
|
||
- 补回 WXML 已绑定的 `onRemoveImage`，避免清理后出现无处理函数；
|
||
- 保留 `miniapp/env.{ts,js}` 与 `miniapp/utils/api.{ts,js}` 两组共享兼容层，因为仍有纯 JavaScript 页面消费；
|
||
- 保留全部 63 个业务页面、22 个组件目录、管理端现有路由页面、后端、迁移脚本和部署配置；
|
||
- 保留 Phase 03–07 的业务完成报告，只对 Phase 07 明确标记“视觉结论失效”。
|
||
|
||
## 4. 文档治理
|
||
|
||
- `AGENTS.md` 已指向唯一视觉规格；
|
||
- `STATUS.md`、`JIRA_BACKLOG.md` 已重新打开 Phase 07 UI 子任务；
|
||
- 当前页面矩阵已收敛为管理端框架/工作台和小程序 11 个核心页面；
|
||
- 相关恢复计划已切换到新规格与新清理门禁；
|
||
- 新增文档基线契约，防止旧规范、旧截图和旧视觉测试重新进入仓库；
|
||
- 新增页面源唯一性契约，防止微信开发者工具再次加载同名旧 `.js`。
|
||
|
||
## 5. 验证结果
|
||
|
||
以下结果由清理完成后的最终门禁产生：
|
||
|
||
- 文档唯一基线契约：PASS；
|
||
- 小程序页面源唯一性契约：PASS；
|
||
- 通用 UI/业务契约：PASS；
|
||
- Phase 03、04、06、07 契约：PASS；
|
||
- 小程序登录契约：PASS；
|
||
- 品牌资产与 Tab 图标契约：PASS；
|
||
- 小程序 TypeScript 检查：PASS；
|
||
- 管理端 Vue TypeScript 检查：PASS；
|
||
- 管理端生产构建：PASS（保留既有大 chunk 警告，不属于本轮清理回归）。
|
||
|
||
## 6. 可恢复提交
|
||
|
||
- `1deda1e`：建立只读清理盘点；
|
||
- `c66e42d`：删除冲突文档、旧视觉证据与旧测试，收敛文档真源；
|
||
- `eed4400`：迁移有效逻辑并删除 11 个重复页面源；
|
||
- 本报告及最终核验记录：由后续独立提交保存。
|
||
|
||
所有删除内容均可通过上述 Git 提交的父版本恢复。未跟踪的旧截图和 `design-qa.md` 不在 Git 历史中，已按用户明确授权永久删除。
|
||
|
||
## 7. 未触及与后续门禁
|
||
|
||
工作区仍包含 Phase 03–08 的后端、部署、首页/找对象页面等既有未提交修改，本轮没有替用户覆盖、清除或混入清理提交。下一阶段只有在用户验收本报告后，才按“原位渐进替换”进入管理端框架/工作台和小程序 11 个核心页面的参考图驱动重设计。
|