104 lines
7.8 KiB
Markdown
104 lines
7.8 KiB
Markdown
# 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/src` 27 个文件均由路由或应用入口使用，本轮不删除管理端业务页面。
|
||
|
||
## 6. 不触及范围
|
||
|
||
- 后端业务代码与测试；
|
||
- Flyway migration；
|
||
- `infrastructure/docker-compose.yml`、`infrastructure/nginx.conf`；
|
||
- `artifacts/backups` 下数据库备份；
|
||
- 两张用户指定参考图；
|
||
- 尚未进入视觉重构阶段的有效业务页面与接口。
|