8.7 KiB
8.7 KiB
UI 清理候选与引用证据清单
日期：2026-09-13
依据：docs/superpowers/specs/2026-09-13-reference-driven-dual-client-ui-redesign-design.md
1. 清理前基线
| 项目 | 结果 | 说明 |
|---|---|---|
| 当前分支 | codex/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/src27 个文件均由路由或应用入口使用，本轮不删除管理端业务页面。
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 后再删除旧源。