admin/danyang-match
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
Files
4e1827295d003be4d432420ac9b346421846bd3a
danyang-match/docs/UI_CLEANUP_INVENTORY_2026-09-13.md
T
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

117 lines
8.8 KiB
Markdown
Raw 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
依据：`docs/superpowers/specs/2026-09-13-reference-driven-dual-client-ui-redesign-design.md`
## 1. 清理前基线
| 项目 | 结果 | 说明 |
|---|---|---|
| 当前分支 | `workbuddy-ui-v11-fidelity` | 普通工作区，非 linked worktree |
| 管理端源文件 | 27 | `admin-web/src` 当前文件数 |
| 小程序页面 | 63 | 以 `miniapp/app.json` 为准 |
| 小程序组件目录 | 22 | `miniapp/components` 当前目录数 |
| Markdown 文档 | 107 | `docs` 当前 Markdown 数量 |
| 页面 TS/JS 同名源 | 11 对 | 必须比较行为后移除 `.js` 双源 |
| 共享 TS/JS 同名源 | 2 对 | `env`、`utils/api` 暂时保留兼容 |
| 管理端 type-check | PASS | 直接调用现有 `vue-tsc`，退出码 0 |
| 管理端 build | PASS | Vite 转换 1727 modules；存在既有大 chunk 警告 |
| 小程序 type-check | PASS | 直接调用现有 `tsc`，退出码 0 |
| 旧 `ui-contracts` | FAIL | 要求暖白背景、220px 浅色侧栏、`index.js` 和特定 `block wx:elif`，与新基线冲突 |
系统 PowerShell 默认禁止运行本地脚本，因此盘点脚本使用单次进程参数 `-ExecutionPolicy Bypass`；未修改系统执行策略。
## 2. 文档与视觉证据
| 分类 | 文件或文件组 | 引用/冲突证据 | 处理 |
|---|---|---|---|
| DELETE | `docs/superpowers/specs/2026-09-10-ui-v11-fidelity-design.md` | 旧 UI 规格，只被旧计划和新清理记录引用 | 删除 |
| DELETE | `docs/superpowers/specs/2026-09-11-codex-baseline-cleanup-design.md` | 已被 2026-09-13 清理规格取代 | 删除 |
| DELETE | `docs/superpowers/specs/2026-09-11-dual-client-full-ui-redesign-design.md` | 要求全量 63 页，且文件存在中文编码损坏 | 删除 |
| DELETE | `docs/superpowers/plans/2026-09-10-ui-v11-fidelity.md` | 旧视觉执行入口 | 删除 |
| DELETE | `docs/superpowers/plans/2026-09-11-codex-baseline-cleanup.md` | 旧清理执行入口 | 删除 |
| DELETE | `docs/superpowers/plans/2026-09-11-admin-full-ui-redesign.md` | 要求管理端全路由重构，与当前首批范围冲突 | 删除 |
| DELETE | `docs/superpowers/plans/2026-09-11-miniapp-full-ui-redesign.md` | 要求小程序全页面重构，与 11 页范围冲突 | 删除 |
| DELETE | `docs/superpowers/plans/2026-09-11-ui-foundation-and-pilot.md` | 引用旧双端规格 | 删除 |
| DELETE | `docs/UI-V11-Visual-Acceptance-2026-09-10.md` | 宣称旧视觉通过 | 删除 |
| DELETE | `docs/善缘丹阳 V1.1 前端 UI-UX 高保真原型修订说明.md` | 含旧视觉处方；业务规则已由页面功能文档、AGENTS 和新规格覆盖 | 删除 |
| DELETE | `design-qa.md` | 宣称被用户否决的 Phase 07 页面 passed | 删除 |
| DELETE | `artifacts/phase07-*.png` 四张 | 被否决的首页/找对象截图和对比图 | 删除 |
| DELETE | `artifacts/ui-v11/*` 八个文件 | 旧暖白后台与旧首页视觉证据，仅服务于旧验收 | 删除 |
| DELETE | `artifacts/tabbar-icons-preview.png` | 旧 Tab 色彩预览；正式 PNG/SVG 源仍保留 | 删除预览图 |
| REFACTOR | `AGENTS.md` | 仍把旧高保真文档列为正式基线 | 改为新规格唯一视觉入口 |
| REFACTOR | `docs/STATUS.md` | Phase 07 被标记完成 | 区分业务证据与已否决视觉结果 |
| REFACTOR | `docs/JIRA_BACKLOG.md` | Phase 07 整体标记完成 | 重新打开 UI 子任务 |
| REFACTOR | `docs/Phase-07-V11-Recovery-Completion-Report-2026-09-13.md` | 保留业务测试价值，但视觉结论失效 | 添加醒目失效声明 |
| REFACTOR | `docs/UI_REDESIGN_PAGE_MATRIX_V1.1.md` | 旧矩阵要求 63 页全量重构 | 改为首批管理端框架/工作台和小程序 11 页 |
| REFACTOR | 两份当前执行/修复计划 | 仍引用旧 UI 阶段或完成状态 | 指向新规格与清理门禁 |
| KEEP | API、数据库、安全、运维文档 | 不决定本轮视觉方向 | 保留；不因 UI 重构删除 |
| KEEP | 历史 Phase Completion Reports | 具有业务审计价值 | 仅 Phase 07 最新报告增加视觉失效说明 |
旧高保真文档中的非视觉内容迁移核对：
- 页面结构和业务路径：由 `docs/善缘丹阳 V1.1 页面级功能清单与交互流程修订版.md` 保留；
- API、状态和权限：由数据库/API 增量设计、`AGENTS.md` 和新规格第 5、10 章保留；
- Loading、Empty、Error、无权限、未登录和可访问性：由新规格第 9、10、12 章保留；
- 响应式与目标设备：由新规格第 8、9、12 章保留；
- 当前视觉、范围与验收门禁：仅由 2026-09-13 新规格及其实施计划保留。
## 3. UI 契约代码
| 分类 | 文件 | 证据 | 处理 |
|---|---|---|---|
| REFACTOR | `ui-tests/ui-contracts.mjs` | 混合有效业务检查与旧视觉结构断言 | 保留 63 页、Tab、路由、API 和活动详情检查；删除旧暖白、浅色侧栏、`index.js` 和标签结构断言 |
| DELETE | `ui-tests/admin-redesign-contracts.mjs` | 固化旧菜单分组和旧浅色专业后台方向 | 由后续 `admin-reference-contracts.mjs` 替代 |
| DELETE | `ui-tests/miniapp-redesign-contracts.mjs` | 只覆盖被否决的首页/找对象视觉实现 | 由后续 `miniapp-reference-contracts.mjs` 替代 |
| KEEP | `ui-tests/phase07-home-contracts.mjs` | 主要验证真实首页聚合、8 入口、Capability、TS 唯一源和模块顺序 | 保留，随新设计继续运行 |
| KEEP | `ui-tests/brand-assets.mjs` | 验证现有正式本地资产存在 | 新素材完成前保留；后续重构资产列表 |
| KEEP | `ui-tests/tabbar-icons.mjs` | 验证当前 Tab 图标完整和透明 PNG | 后续设计阶段调整颜色断言 |
## 4. 小程序 TS/JS 同名源
| 分类 | 文件对 | 行为差异 | 处理 |
|---|---|---|---|
| REFACTOR | `activity-mutual-result.{ts,js}` | JS 66 行，TS 26 行 | 比较事件/API 后补齐 TS，再删 JS |
| REFACTOR | `activity-mutual-waiting.{ts,js}` | JS 66 行，TS 83 行 | 比较后删 JS |
| REFACTOR | `chat.{ts,js}` | JS 281 行，TS 283 行 | 比较后删 JS |
| REFACTOR | `counseling-intro.{ts,js}` | JS 66 行，TS 33 行 | 比较事件/API 后补齐 TS，再删 JS |
| REFACTOR | `counseling-request.{ts,js}` | JS 66 行，TS 54 行 | 比较事件/API 后补齐 TS，再删 JS |
| REFACTOR | `local-eligibility.{ts,js}` | JS 56 行，TS 43 行；JS 含当前未提交修复 | 先迁移有效修复到 TS，再删 JS |
| REFACTOR | `local-eligibility-supplement.{ts,js}` | JS 108 行，TS 77 行；JS 含当前未提交修复 | 先迁移有效修复到 TS，再删 JS |
| REFACTOR | `login.{ts,js}` | JS 79 行，TS 70 行 | 比较后删 JS |
| REFACTOR | `my-counseling.{ts,js}` | JS 66 行，TS 36 行 | 比较事件/API 后补齐 TS，再删 JS |
| REFACTOR | `premarital-intro.{ts,js}` | JS 66 行，TS 6 行 | 迁移有效页面逻辑到 TS，再删 JS |
| REFACTOR | `premarital-request.{ts,js}` | JS 66 行，TS 41 行 | 比较事件/API 后补齐 TS，再删 JS |
| KEEP | `miniapp/env.{ts,js}` | `app.js` 等纯 JS 入口仍可能消费 JS | 当前阶段保留兼容层 |
| KEEP | `miniapp/utils/api.{ts,js}` | 多个纯 JS 页面直接 `require('../../utils/api')` | 全部 JS 页面迁移前保留 |
## 5. 页面与组件范围
- 63 个 `app.json` 注册页面全部 `KEEP`，本轮不删除业务页面。
- 首批 11 个核心页面标记 `REFACTOR`：首页、找对象、消息、活动、我的、公益红娘、婚恋咨询、婚前辅导、婚恋课堂、婚恋反诈、善缘服务站。
- 22 个组件目录当前均存在活动页面引用或将在首批重构中复用；没有足够证据删除，全部暂记 `KEEP/REVIEW`。
- `admin-web/src` 27 个文件均由路由或应用入口使用，本轮不删除管理端业务页面。
## 6. 不触及范围
- 后端业务代码与测试；
- Flyway migration；
- `infrastructure/docker-compose.yml`、`infrastructure/nginx.conf`；
- `artifacts/backups` 下数据库备份；
- 两张用户指定参考图；
- 尚未进入视觉重构阶段的有效业务页面与接口。
## 7. 清理后核验
| 项目 | 清理后结果 | 结论 |
|---|---:|---|
| `app.json` 注册页面 | 63 | 页面业务范围未减少 |
| 页面逻辑源文件 | 63 | 每个页面只保留一个 `.ts` 或 `.js` 实现 |
| 页面 TS/JS 同名源 | 0 对 | 11 对页面双源已全部消除 |
| 共享 TS/JS 同名源 | 2 对 | 仅保留 `env`、`utils/api` 兼容层 |
| 管理端源文件 | 27 | 未删除仍被路由使用的管理端页面 |
| Markdown 文档 | 99 | 已包含本清单与清理报告，旧冲突规范已移除 |
11 组页面双源中，9 组 `.js` 为脚手架空壳或旧编译副本，直接保留现有 TypeScript 实现；`local-eligibility` 与 `local-eligibility-supplement` 的 `.js` 含有效 Phase 04 修复，相关真实 API、材料上传、状态刷新与审核提交逻辑已先迁移到 TypeScript 后再删除旧源。盘点开始前已在工作区删除但尚未提交的首页、找对象页旧 `.js` 也已单独提交，确保换工作区后不会恢复双源。
Reference in New Issue View Git Blame Copy Permalink