6.3 KiB
6.3 KiB
| 1 | ID | Title | Description | Acceptance | Test_Method | Tools | Dev_Status | Review1_Status | Regression_Status | Files | Dependencies | Notes |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 2 | A1 | R68 Portal 首页信息架构合同建档 | 创建 R68 执行合同，冻结范围：只优化 Portal 首页信息架构、对齐、内容密度、折叠层级与截图复核产物；不改后端 API、权限过滤、workflow、审批规则、状态机、Prisma 迁移和导航可见性规则。 | CSV 列完整，Dependencies 为 JSON 数组字符串；A2-A6 范围与已批准方案一致；Notes 明确无后端、无迁移、无权限与状态机变更，包含回滚路径。 | 命令：python3 - <<'PY' 校验 CSV 12 列、状态值、Dependencies JSON 数组字符串；业务：对照 AGENTS.md 确认 R68 仅覆盖前端 Portal 首页 UI 信息架构，不触碰 workflow、权限、审批规则、迁移。 | manual | DONE | DONE | DONE | issues/2026-04-26_r68-portal-information-architecture.csv | [] | 回滚路径：删除本 CSV 草稿即可回到 R67 基线；无后端 API、无 Prisma 迁移、无权限/状态机/workflow 变更。设计原则：10 人以下小团队首页优先今日待办、快捷动作、团队状态和少量动态，其余内容进入第二阅读层。 |
| 3 | A2 | Portal 首屏 8/4 信息骨架重排 | 将 Portal 首屏从多个等权卡片区改为稳定的主内容 8/4 骨架：上方保留紧凑 Hero 与 4 个核心指标，主体左侧优先展示今日待办，右侧固定快捷操作。 | 1) 首屏桌面端形成稳定左主右辅结构；2) 快捷操作不再与待办等权横铺；3) 移动端保持单列顺序：指标、待办、快捷操作；4) 不改变 query key、API 调用和跳转目标。 | 命令：cd client && npm run typecheck && npm run build；业务：员工、管理者、管理员进入 Portal，确认核心指标顺序不变，待办和快捷操作首屏可见且链接/按钮可用。 | manual | DONE | DONE | DONE | client/src/pages/PortalHomePage.tsx|client/src/components/patterns/WorkbenchHero.tsx|client/src/index.css | ["A1"] | 回滚路径：恢复 PortalHomePage、WorkbenchHero 与 CSS 到 R67；仅改前端布局和 class。验证：client typecheck/build 通过；截图 01-04 覆盖桌面与移动首屏。 |
| 4 | A3 | 团队状态与动态公告区域对齐优化 | 将团队全员状态从卡片网格改为紧凑列表，最多展示 5 人并提供查看全部；将近期动态与公告合并为右侧阅读卡，减少同质白卡堆叠。 | 1) 团队状态行高稳定、头像/姓名/状态/打卡信息对齐；2) 超过 5 人时显示查看全部；3) 动态与公告在同一右侧面板内切换或分层展示；4) 空态不占用过高页面空间。 | 命令：cd client && npm run typecheck && npm run build；业务：员工和管理视角检查团队状态、近期动态、公告内容仍可读，团队页和公告页入口仍可达。 | manual | DONE | DONE | DONE | client/src/pages/PortalHomePage.tsx|client/src/index.css | ["A2"] | 回滚路径：恢复 R67 团队状态网格、动态流面板与公告面板；不改数据结构。验证：团队列表最多 5 人、查看全部入口和动态/公告 Tab 已在截图与 e2e 中覆盖。 |
| 5 | A4 | 第二阅读层折叠与角色内容收敛 | 将我的申请/资产、继续工作、常用入口、管理补充信息、试点观测摘要收敛到第二阅读层，默认减少首页纵向长度，同时保留原有入口可访问。 | 1) 员工仍能看到我的申请与资产入口提示；2) 管理者仍能看到今日管理重点与试点观测摘要入口提示；3) 折叠区展开后原入口和指标仍可访问；4) 备用模块默认折叠逻辑不受影响。 | 命令：cd client && npm run typecheck && npm run build；业务：员工打开折叠区检查我的申请/资产、继续工作、常用入口；管理员检查管理补充信息与试点观测摘要。 | manual | DONE | DONE | DONE | client/src/pages/PortalHomePage.tsx|client/src/index.css|client/tests/e2e/login-portal-ux.spec.ts|client/tests/e2e/visual-portal.spec.ts | ["A3"] | 回滚路径：恢复 R67 角色区块直铺展示；仅改前端渲染层级，不改变权限或导航来源。验证：login-portal-ux 6/6 通过，备用模块默认折叠逻辑保持。 |
| 6 | A5 | R68 自动化与截图复核产物 | 更新受影响的前端断言，并生成 R68 Portal 复核截图索引，便于人工快速检查对齐、折叠和移动端表现。 | 1) 相关 e2e 断言与新信息架构一致；2) 员工、管理者、管理员 Portal 截图可通过 index.html 查看；3) 截图产物路径固定并记录；4) 若环境不可用，Notes 写明原因和人工替代步骤。 | 命令：git diff --check && cd client && npm run typecheck && npm run build；可选：cd client && npm run test:e2e -- tests/e2e/login-portal-ux.spec.ts tests/e2e/visual-portal.spec.ts；业务：打开截图 index.html 复核桌面与移动主要断点。 | manual | DONE | DONE | DONE | client/tests/e2e/login-portal-ux.spec.ts|client/tests/e2e/visual-portal.spec.ts|deploy/trialrun/screenshots/r68-portal-ia-review/** | ["A4"] | 回滚路径：删除 R68 截图产物并恢复测试断言；截图文件不影响运行时。验证：已生成 deploy/trialrun/screenshots/r68-portal-ia-review/index.html 和 4 张 Portal 截图；login-portal-ux 在 Vite dev server 下 6/6 通过。 |
| 7 | A6 | R68 验证、状态回填与提交收口 | 完成 Portal 信息架构优化后执行前端验证、必要 smoke 检查、截图复核产物生成和 CSV 状态回填，形成 R68 提交候选。 | 1) A2-A5 的 Test_Method 已执行并记录结果；2) git diff --check、client typecheck/build 通过；3) 截图产物已生成或记录阻塞；4) git status 只包含本轮预期变更和既有未跟踪截图。 | 命令：git diff --check && python3 CSV 校验 && cd client && npm run typecheck && npm run build；业务：员工、管理者、管理员三类入口复核 Portal 首页信息层级、对齐、折叠和移动端单列顺序。 | manual | DONE | DONE | DONE | issues/2026-04-26_r68-portal-information-architecture.csv|client/src/pages/PortalHomePage.tsx|client/src/index.css|client/tests/e2e/*.spec.ts|deploy/trialrun/screenshots/r68-portal-ia-review/** | ["A5"] | 回滚路径：若验证失败，不回填 DONE，不提交；必要时整批恢复 R68 Portal 信息架构改动。验证：git diff --check、CSV 校验、client build 已通过；最终状态核对后提交。 |