Files
danyang-match/docs/UI_CLEANUP_REPORT_2026-09-13.md
Codex 60eeb8aef5 docs(brand): 全仓库 Codex 署名统一为 WorkBuddy + 5 个文件重命名
## 背景
用户指令:「先将 codex 的任务一并改为 workbuddy 的任务」。
Codex 已不再运行,当前由 WorkBuddy 承担开发执行,文档署名需同步。

## 判定规则(用大小写精确区分)
| 类别 | 写法 | 处置 |
|---|---|---|
| 工具署名 | 大写 Codex | → WorkBuddy |
| 分支名 | codex/ui-v11-fidelity | → workbuddy-ui-v11-fidelity(去斜杠,规避本仓库 ref 清理) |
| 已删除文件的历史路径 | 小写 2026-09-11-codex-baseline-cleanup* | 保持原样(记录真实曾存在的文件名,改了即失真) |

结果:26 个文件、126 处署名替换。残留小写 codex 仅 8 处,全部是历史路径。

## 文件重命名(git mv,保留历史)
- Codex开发执行总指令、项目规则与任务拆解.md → WorkBuddy 同名
- Codex首轮启动提示词 + Phase 01~Phase 26 Jira级任务清单 + 每阶段验收条件.md → WorkBuddy 同名
- docs/善缘丹阳 V1.1 Codex 开发执行计划修订版.md → docs/善缘丹阳 V1.1 WorkBuddy 开发执行计划修订版.md
- docs/善缘丹阳 V1.1 Codex-Jira 最终开发任务增量清单.md → docs/善缘丹阳 V1.1 WorkBuddy-Jira 最终开发任务增量清单.md
- docs/善缘丹阳 V1.1 Codex最终主启动提示词(整合版).md → docs/善缘丹阳 V1.1 WorkBuddy最终主启动提示词(整合版).md

引用已同步:AGENTS.md 6 处、AGENTS_SUMMARY.md、以及 4 份计划/规格文档。

## AGENTS.md 两处特别处理
- 「git config user.name = Codex」一句改为不点名工具的表述
- 「feature/ fix/ codex/ ui/ 前缀」示例去掉 codex/

## 有意未改动
- ui-tests/ui-document-baseline-contracts.mjs 的废弃清单仍列 codex-baseline-cleanup*
  那是「必须不存在」的断言目标,改了会让哨兵失去意义
- 仓库 git config user.name 仍是 Codex —— 未擅自改动环境身份。
  如需彻底交接:git config user.name WorkBuddy && git config user.email workbuddy@local

验证:UI 契约门禁 13/13;AGENTS.md 零 Codex 残留;5 个新文件名与全部引用一致
2026-09-16 14:37:44 +08:00

90 lines
4.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 个核心页面的参考图驱动重设计。