4.4 KiB
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 小程序页面重复源（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 个核心页面的参考图驱动重设计。