# UI 旧代码与冲突文档清理报告

日期：2026-09-13
分支：`workbuddy-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 小程序页面重复源（13 个）

删除 11 个盘点时仍与 TypeScript 同名的页面 `.js`：活动互选结果、活动互选等待、聊天、咨询介绍、咨询申请、本地资格、本地资格补充、登录、我的咨询、婚前辅导介绍、婚前辅导申请；并将盘点前已在工作区删除、但尚未提交的首页和找对象页旧 `.js` 一并固化到 Git。

清理后 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 个重复页面源；
- `61ca737`：保存清理报告及最终核验记录；
- `097c4c4`：固化首页与找对象页遗留的旧 `.js` 删除。

所有删除内容均可通过上述 Git 提交的父版本恢复。未跟踪的旧截图和 `design-qa.md` 不在 Git 历史中，已按用户明确授权永久删除。

## 7. 未触及与后续门禁

工作区仍包含 Phase 03–08 的后端、部署、首页/找对象页面等既有未提交修改，本轮没有替用户覆盖、清除或混入清理提交。下一阶段只有在用户验收本报告后，才按“原位渐进替换”进入管理端框架/工作台和小程序 11 个核心页面的参考图驱动重设计。