oaops1-seven-day-trial-prep 归档7天试运行准备任务

2026-05-26 17:14:36 +08:00
@@ -0,0 +1,4 @@
+{"file": ".trellis/spec/hyb-oa/deployment-trialrun.md", "reason": "检查准备工作没有越过公网部署、配置和真实数据边界。"}
+{"file": ".trellis/spec/hyb-oa/docs-and-evidence.md", "reason": "检查报告和 PRD 是否只保存相对引用、状态和脱敏证据。"}
+{"file": ".trellis/spec/hyb-oa/security-privacy.md", "reason": "检查任务文件和 research 目录未写入敏感信息。"}
+{"file": ".trellis/tasks/05-26-oaops1-seven-day-trial-prep/research/prep-readiness.md", "reason": "核对准备预检、人工确认项和证据引用是否完整。"}
@@ -0,0 +1,4 @@
+{"file": ".trellis/spec/hyb-oa/deployment-trialrun.md", "reason": "公网 OA、部署、试运行和真实数据操作边界。"}
+{"file": ".trellis/spec/hyb-oa/docs-and-evidence.md", "reason": "QA summary、证据引用、脱敏和报告聚合契约。"}
+{"file": ".trellis/spec/hyb-oa/security-privacy.md", "reason": "Trellis 任务和报告不得保存的敏感信息边界。"}
+{"file": ".trellis/tasks/05-26-oaops1-seven-day-trial-prep/research/prep-readiness.md", "reason": "本任务启动准备预检结论和人工待确认项。"}
@@ -0,0 +1,26 @@
+# Implementation Notes
+
+## Plan
+
+1. 建立 Trellis task，作为 OAOPS1 7 天真实试运行准备阶段的执行合同。
+2. 读取现有试运行事实源、OALAUNCH1 closeout 证据、OAOPS1 巡检改进证据和 Trellis spec。
+3. 执行只读准备预检：
+   - `bash -n scripts/qa/run-oa-real-use-daily.sh`
+   - `bash -n scripts/qa/run-oa-final-launch-readiness.sh`
+   - live smoke / OCR / 公网 `/ready` / 企业微信配置检查
+   - 公网权限矩阵只读检查
+4. 将准备结论写入 `prd.md` 和 `research/prep-readiness.md`。
+5. 通过 Trellis task validate、治理检查和 diff 检查。
+
+## Current Result
+
+- live smoke 和真实 OCR 条件已具备。
+- 公网 `/ready` 和企业微信配置只读检查通过。
+- 权限矩阵只读预检通过，报告在 `research/prep-permission-matrix/summary.json`。
+- 仍需用户人工确认 7 天窗口起始日期、每日负责人、真实业务样本安排、备份恢复演练证据和 Day 7 Go/No-Go 方式。
+- 用户已确认前端存在啰嗦、复杂和视觉不足等问题；本任务记录为后续独立前端体验成熟化 task，不混入 7 天试运行启动。
+
+## Boundaries
+
+本任务不部署、不改公网配置、不写真实业务数据、不写企业微信、不执行真实付款、不恢复或重置生产数据库。
+本任务不重构前端 UI；试运行期间只收集真实卡点，阻断问题另建最小修复 task，非阻断体验问题进入后续体验治理池。
@@ -0,0 +1,134 @@
+# OAOPS1 7 天真实试运行准备
+
+## Goal
+
+为 OAOPS1 7 天小团队真实使用稳定化做好启动准备：确认公网只读基线、live smoke/OCR 条件、权限矩阵、人工业务闭环证据模板、每日巡检节奏和最终 OALAUNCH1 Go/No-Go 输入，确保后续启动窗口时不会把自动化通过误解为最终正式启用完成。
+
+本任务只做准备和只读验证；不部署、不改生产配置、不写公网业务数据、不写企业微信、不执行付款、不做生产数据库恢复。
+
+## Scope
+
+- 创建 OAOPS1 7 天真实试运行的 Trellis 执行合同。
+- 汇总当前 OALAUNCH1/OAOPS1 已知缺口、启动条件和人工证据要求。
+- 执行启动前只读预检，包括脚本语法、live smoke/OCR 条件、公网健康、企业微信配置和权限矩阵。
+- 记录每日巡检、Day 7 汇总和 Go/No-Go 所需输入。
+- 不进入真实 7 天计数，不执行业务写入或生产变更。
+
+## What I Already Know
+
+- 当前没有活动任务，本任务从 Trellis planning 阶段创建。
+- OALAUNCH1 最新结论仍是 `PAUSED_MANUAL_CONFIRMATION`，不是 `PASS_OA_LAUNCH_READY`。
+- 仍阻断最终启用的关键门禁包括：
+  - OAOPS1 真实业务闭环：报销/PDF OCR/审批/付款/AP、采购/费用/项目或合同、合同台账/归档/权限。
+  - 连续 7 天稳定化起始日期和每日巡检证据。
+  - 备份恢复演练或影子库恢复证据。
+  - 数据治理培训和运营支持证据。
+  - Day 7 人工 Go/No-Go 结论。
+- 巡检脚本已完成改进：父级 summary 能传播子报告 finding，报告引用使用相对路径，隐私扫描不会打印原始敏感命中。
+- 本机已有 live smoke env 文件；2026-05-26 只读公网复核显示 live smoke、真实 OCR 样票、公网 `/ready` 和企业微信配置均满足启动前自动化条件，报告见 `research/prep-live-smoke-env-current.json`。
+- 本轮只读权限矩阵复核已通过：7 个角色、43 个正例、42 个负例、0 个问题，报告见 `research/prep-permission-matrix-current/summary.json`。
+
+## Assumptions
+
+- 7 天窗口按自然日连续计算，必须由用户确认 `OALAUNCH_STABILIZATION_START_DATE=YYYY-MM-DD` 后才能进入正式计数。
+- 真实业务写入只由人工在公网 OA 内完成；Codex 自动化只做只读巡检和证据汇总。
+- 真实发票 PDF、合同/回单/归档资料只在 OA 或线下安全位置处理；Trellis task、docs、聊天和自动化报告只记录脱敏摘要、状态、数量和相对证据引用。
+- 若某天出现 blocker，默认当天另建最小修复 Trellis task；不在 7 天窗口任务里扩大范围或临时绕过生产规则。
+- 前端体验问题已确认需要治理，但不混入 OAOPS1 7 天试运行启动条件；试运行期间只记录真实用户卡点，试运行后另建前端体验成熟化 task 分批处理。
+
+## Requirements
+
+- 固定 7 天窗口启动前输入：
+  - 起始日期。
+  - 当日负责人、问题登记负责人、暂停决策人。
+  - 首批真实业务参与角色：员工、审批人、财务/出纳、管理员。
+  - 每日巡检执行人和报告存放口径。
+- 准备并确认人工业务闭环证据要求：
+  - 至少 1 条真实报销 PDF OCR -> 审批 -> 付款批次 -> 银行回单 -> 已付款 -> AP 导出。
+  - 至少 1 条采购/费用审批，并关联项目或合同。
+  - 至少 1 条合同台账，记录归档位置摘要、权限边界和必要附件审计。
+  - 资产台账 ASSET1D 后续抽查责任人或保管人。
+- 每日巡检必须覆盖：
+  - 公网 `/ready`。
+  - live smoke 和真实 OCR 条件。
+  - `payment_batch_v1=force_on`、`erp_sync=force_off`、冻结项未误开启。
+  - 只读业务探针、移动入口、企业微信入口/渲染、隐私扫描。
+  - 子报告 finding、SKIP、PARTIAL、PAUSED 均进入父级 summary。
+- 最终 OALAUNCH1 输入必须能被 `scripts/qa/run-oa-final-launch-readiness.sh` 聚合：
+  - `OALAUNCH_STABILIZATION_START_DATE`。
+  - `OALAUNCH_BACKUP_EVIDENCE`。
+  - `OALAUNCH_PERMISSION_EVIDENCE`。
+  - `OALAUNCH_BUSINESS_EVIDENCE`。
+  - `OALAUNCH_POLICY_EVIDENCE` 如需覆盖默认 OPOLICY1 证据。
+  - `OALAUNCH_MANUAL_ACCEPT` 只能在 Day 7 人工决策后设置。
+- 前端体验治理按后续独立 task 处理，初步分四类：
+  - 减噪音：删除或弱化啰嗦说明，保留状态、下一步动作和异常原因。
+  - 减步骤：前置常用动作，折叠低频配置，用默认值和自动带出减少跳转。
+  - 重排信息架构：按员工、审批人、财务、管理员角色重排入口和首屏任务。
+  - 视觉统一：统一间距、字号、按钮层级、卡片密度、表格和移动布局。
+
+## Acceptance Criteria
+
+- [x] 当前任务记录 7 天真实试运行的启动条件、边界和证据要求。
+- [x] 当前任务记录本轮只读准备预检结果和证据引用。
+- [x] 明确哪些事项启动前已具备，哪些仍需用户人工确认或执行。
+- [x] 明确每日巡检命令、最终汇总命令和预期状态解释。
+- [x] 明确不得自动执行的操作：部署、生产配置变更、真实业务写入、企业微信写入、真实付款、生产数据库恢复。
+- [x] Trellis 任务校验和治理检查通过。
+
+## Definition Of Done
+
+- PRD 与准备清单完整。
+- 只读预检结果保存在当前任务 research 下，且不含密码、token、Secret、完整账号、完整本地路径、合同正文、银行资料、原始票据或 raw payload。
+- 用户拿到清楚的下一步人工输入清单：起始日期、负责人、每日问题登记方式、备份恢复证据计划、业务闭环样本安排。
+- 不把本任务误归档为 7 天试运行完成；本任务只是启动准备。
+
+## Out Of Scope
+
+- 不启动真实 7 天计数，除非用户明确确认起始日期。
+- 不创建、提交、审批或付款真实单据。
+- 不部署、不同步远端文件、不改公网 `.env`。
+- 不写企业微信消息、通讯录、审批或回调数据。
+- 不做生产数据库恢复、重置或迁移。
+- 不启用图片 OCR、复杂 BPM、预算、ERP 写入、银行流水导入、真实支付接口、企业微信 HR 深镜像、应急接管、恢复回写或 RuleOps。
+- 不在本准备任务中重构或美化前端页面；前端体验改进另建任务，避免干扰 7 天试运行启动判断。
+
+## Test Plan
+
+- `bash -n scripts/qa/run-oa-real-use-daily.sh`
+- `bash -n scripts/qa/run-oa-final-launch-readiness.sh`
+- 只读公网条件预检：`LIVE_SMOKE_BASE_URL=https://oa.hyinda.com node scripts/qa/check-live-smoke-env.mjs --json`
+- 只读权限矩阵预检：`LIVE_SMOKE_BASE_URL=https://oa.hyinda.com OA_PERMISSION_MATRIX_REPORT_DIR=<task-research-dir> node scripts/qa/check-oa-permission-matrix.mjs`
+- `python3 ./.trellis/scripts/task.py validate 05-26-oaops1-seven-day-trial-prep`
+- `node scripts/qa/check-trellis-governance.mjs`
+- `git diff --check`
+
+正式启动后每日命令另按用户确认执行：
+
+```bash
+bash scripts/qa/run-oa-real-use-daily.sh
+```
+
+Day 7 汇总命令另按证据路径补齐后执行：
+
+```bash
+OALAUNCH_STABILIZATION_START_DATE=<YYYY-MM-DD> \
+OALAUNCH_BACKUP_EVIDENCE=<redacted-evidence-ref> \
+OALAUNCH_PERMISSION_EVIDENCE=<redacted-evidence-ref> \
+OALAUNCH_BUSINESS_EVIDENCE=<redacted-evidence-ref> \
+bash scripts/qa/run-oa-final-launch-readiness.sh
+```
+
+## Technical Notes
+
+- 试运行事实源：`docs/试运行与自动化验证手册.md`、`docs/管理员手册.md`。
+- live smoke 条件：`docs/trialrun/公网LiveSmoke准备清单.md`。
+- 发布/试运行边界：`docs/trialrun/发布试运行准备清单.md`。
+- 真机和企业微信人工验收：`docs/trialrun/真机公网测试清单.md`。
+- Trellis spec：`.trellis/spec/hyb-oa/deployment-trialrun.md`、`.trellis/spec/hyb-oa/docs-and-evidence.md`、`.trellis/spec/hyb-oa/security-privacy.md`。
+- 上游证据：
+  - OALAUNCH1 closeout：`.trellis/tasks/archive/2026-05/05-26-oalaunch1-final-readiness-closeout/research/initial-readiness/summary.json`。
+  - OAOPS1 巡检改进后验证：`.trellis/tasks/archive/2026-05/05-26-oaops1-patrol-feature-review/research/oaops1-after-patrol-fix-final/summary.json`。
+  - 本任务 live smoke/OCR/公网/企微复核：`research/prep-live-smoke-env-current.json`。
+  - 本任务权限矩阵复核：`research/prep-permission-matrix-current/summary.json`。
+- 前端体验后续任务建议：试运行后创建 `oa-frontend-experience-maturity`，先覆盖首页、报销、审批、移动入口和财务/AP 高频页；低频后台页和合同/项目/资产页面放第二批。
@@ -0,0 +1,42 @@
+{
+  "checkedAt": "2026-05-26T09:11:48.874Z",
+  "baseUrl": "https://oa.hyinda.com",
+  "liveSmokeReady": true,
+  "liveSmoke": {
+    "LIVE_SMOKE_ADMIN_IDENTIFIER": true,
+    "LIVE_SMOKE_ADMIN_PASSWORD": true,
+    "LIVE_SMOKE_EMPLOYEE_IDENTIFIER": true,
+    "LIVE_SMOKE_EMPLOYEE_PASSWORD": true
+  },
+  "liveSmokeOptional": {
+    "LIVE_EXPECT_WECOM_STATUS": true,
+    "LIVE_SMOKE_MANAGER_IDENTIFIER": true,
+    "LIVE_SMOKE_MANAGER_PASSWORD": true,
+    "LIVE_SMOKE_FINANCE_IDENTIFIER": true,
+    "LIVE_SMOKE_FINANCE_PASSWORD": true
+  },
+  "liveOcrReady": true,
+  "liveOcr": {
+    "userReady": true,
+    "invoiceSampleReady": true,
+    "invoiceFileProvided": true,
+    "invoiceFileReady": true,
+    "invoiceBatchDirProvided": false,
+    "invoiceBatchDirReady": false,
+    "allowDuplicate": true
+  },
+  "missing": [],
+  "publicReady": {
+    "ok": true,
+    "status": 200
+  },
+  "wecomConfig": {
+    "ok": true,
+    "status": 200,
+    "statusText": "ready",
+    "entryEnabled": true,
+    "oauthEnabled": true,
+    "defaultReturnTo": "/mobile",
+    "loginUrl": "/api/auth/wecom/login?returnTo=%2Fmobile"
+  }
+}
@@ -0,0 +1,28 @@
+# OA 权限矩阵脱敏自动验证报告
+
+生成时间：2026-05-26T09:12:30.877Z
+结论：PASS_PERMISSION_MATRIX_READY
+
+## 统计
+
+- 角色数：7
+- 正向探针：43
+- 负向探针：42
+- 问题数：0
+
+## 角色结果
+
+| 角色 | 登录 | 角色匹配 | 探针通过/总数 |
+| --- | --- | --- | ---: |
+| employee | PASS | PASS | 17/17 |
+| manager | PASS | PASS | 13/13 |
+| finance | PASS | PASS | 14/14 |
+| finance_mgr | PASS | PASS | 10/10 |
+| hr | PASS | PASS | 11/11 |
+| ceo | PASS | PASS | 9/9 |
+| admin | PASS | PASS | 11/11 |
+
+## 说明
+
+- 本报告只输出角色、HTTP 状态、脱敏账号和摘要计数，不输出密码、token、Secret、完整账号、合同正文、票据内容或原始 payload。
+- 409 表示功能门禁关闭且未泄露数据；对财务/AP/付款等冻结或受控功能可作为可解释拒绝。
@@ -0,0 +1,28 @@
+# OA 权限矩阵脱敏自动验证报告
+
+生成时间：2026-05-26T06:27:32.887Z
+结论：PASS_PERMISSION_MATRIX_READY
+
+## 统计
+
+- 角色数：7
+- 正向探针：43
+- 负向探针：42
+- 问题数：0
+
+## 角色结果
+
+| 角色 | 登录 | 角色匹配 | 探针通过/总数 |
+| --- | --- | --- | ---: |
+| employee | PASS | PASS | 17/17 |
+| manager | PASS | PASS | 13/13 |
+| finance | PASS | PASS | 14/14 |
+| finance_mgr | PASS | PASS | 10/10 |
+| hr | PASS | PASS | 11/11 |
+| ceo | PASS | PASS | 9/9 |
+| admin | PASS | PASS | 11/11 |
+
+## 说明
+
+- 本报告只输出角色、HTTP 状态、脱敏账号和摘要计数，不输出密码、token、Secret、完整账号、合同正文、票据内容或原始 payload。
+- 409 表示功能门禁关闭且未泄露数据；对财务/AP/付款等冻结或受控功能可作为可解释拒绝。
@@ -0,0 +1,55 @@
+# OAOPS1 7 天真实试运行准备预检
+
+## 只读预检结论
+
+- `bash -n scripts/qa/run-oa-real-use-daily.sh`：通过。
+- `bash -n scripts/qa/run-oa-final-launch-readiness.sh`：通过。
+- live smoke env 文件：存在，且仅在本机仓库外加载。
+- live smoke / OCR 条件：2026-05-26 复核通过，缺项为空。
+- 公网 `/ready`：2026-05-26 复核为 200。
+- 企业微信配置：2026-05-26 复核为 ready，入口启用，OAuth 启用，默认回到移动端。
+- 权限矩阵：2026-05-26 复核为 `PASS_PERMISSION_MATRIX_READY`，7 个角色、43 个正例、42 个负例、0 个问题。
+
+## 已具备
+
+- 自动化只读巡检脚本语法通过。
+- 最终启用汇总脚本语法通过。
+- live smoke 管理员和员工账号条件具备。
+- 真实 OCR 测试用户和 PDF 样票条件具备。
+- 经理、财务等可选 live smoke 账号条件具备。
+- 公网入口和企业微信配置可达。
+- 权限矩阵只读负例/正例通过。
+
+## 仍需人工确认
+
+- 7 天窗口起始日期。
+- 每日业务负责人、问题登记负责人和暂停决策人。
+- 员工、审批人、财务/出纳、管理员的真实业务执行安排。
+- 备份恢复演练方式和脱敏证据位置。
+- 数据治理/资料上传边界培训完成证据。
+- Day 7 Go/No-Go 只能在窗口结束后人工确认。
+
+## 前端体验治理建议
+
+- 不建议把前端整体体验改造放进 7 天试运行准备任务。
+- 7 天窗口前只修阻断真实使用的问题；啰嗦、复杂、不美观等非阻断问题先登记。
+- 后续独立 task 建议分四类处理：
+  - 减噪音：删长说明，弱化辅助文案，保留状态、动作和异常原因。
+  - 减步骤：常用动作前置，低频配置折叠，减少多页跳转。
+  - 重排信息架构：按员工、审批人、财务、管理员重排入口。
+  - 视觉统一：统一间距、字号、按钮、卡片、表格和移动布局。
+- 建议优先批次：Portal/首页、报销、审批、移动入口、财务/AP；合同、项目、资产和后台配置放第二批。
+- 试运行前可做范围已补充调研：见 `research/pretrial-frontend-scope.md`。PC 页面风格不统一应纳入启动前清障，但只做“PC 样板收敛 + 文案减噪 + 默认视图降噪 + 视觉证据补齐”，不要做全局改版。参考体系见 `research/pretrial-reference-systems.md`：品牌看 Hyinda，主体验看飞书工作台/审批，PC 样板看 Ant Design，业务覆盖只参考钉钉、泛微、合思/每刻。
+
+## 证据引用
+
+- live smoke/OCR/公网/企微复核：`research/prep-live-smoke-env-current.json`。
+- 权限矩阵历史报告：`research/prep-permission-matrix/summary.json`。
+- 权限矩阵当前复核：`research/prep-permission-matrix-current/summary.json`。
+- 本准备 PRD：`prd.md`。
+- 试运行前前端可改范围调研：`research/pretrial-frontend-scope.md`。
+- 试运行前 PC 参考体系调研：`research/pretrial-reference-systems.md`。
+
+## 边界
+
+本预检未执行部署、生产配置修改、真实业务写入、企业微信写入、真实付款或生产数据库恢复。
@@ -0,0 +1,156 @@
+# 试运行前前端可改范围调研
+
+## 调研来源
+
+- `docs/产品设计规则.md`
+- `.trellis/spec/hyb-oa/frontend-react-vite-design.md`
+- `docs/trialrun/人工试运行报告.md` 中 OAFRONT6、OAKISS1、PCDESIGN1 结论
+- `research/pretrial-reference-systems.md`
+- 当前前端抽样文件：
+  - `client/src/pages/PortalHomePage.tsx`
+  - `client/src/pages/ReimbursementsPage.tsx`
+  - `client/src/pages/WorkflowTasksPage.tsx`
+  - `client/src/pages/ApOperationsPage.tsx`
+  - `client/src/components/navigation/NavLinks.tsx`
+  - `client/src/features/navigation/schema.ts`
+- `node scripts/qa/check-ui-design-rules.mjs --json`
+
+## 当前判断
+
+前端基础质量已经能进入真实使用稳定化：设计规则扫描 130 个文件，0 findings；PC 只读视觉矩阵和移动矩阵已有历史通过证据。当前问题主要不是页面不可用，而是信息密度、默认暴露范围、解释文案、测试数据噪声、角色默认视图和 PC 页面风格不统一仍会增加试运行认知成本。
+
+需要特别区分：自动化视觉矩阵通过只说明“没有明显打不开、遮挡、403、UUID 主展示等硬伤”，不等于 PC 端页面已经形成统一体验。当前抽样可以看到页面同时存在 `ListWorkspace/WorkspaceHeader`、`PageScaffold + WorkbenchHero`、`SectionPanel`、直接 `card-std` 和页面内自定义表格/分区等多套写法；这会让不同 PC 页面在标题层级、卡片密度、表格工具条、按钮层级和说明文案上观感不一致。
+
+试运行前可以做小范围清障，但不建议做全局改版。所有改动必须满足：
+
+- 不改审批、OCR、付款、AP、权限、状态机或后端数据语义。
+- 不新增公网业务写入。
+- 不改变企业微信主办/链接回 OA 的边界。
+- 不把试运行起点推迟成无限 UI 打磨。
+- 每项改动能用现有 typecheck/build/视觉矩阵验证。
+
+## 试运行前可以做
+
+### A. 补视觉与动态详情证据
+
+这是最低风险，建议优先做。
+
+- 补 5 类动态详情页截图证据：报销详情、审批详情、项目详情、人员详情、打印/留痕页。
+- 启动当天复跑 UI 设计规则、PC 只读视觉矩阵和移动入口矩阵。
+- 目的：证明“能用、无遮挡、不误导、不泄露内部编号”，不追求视觉重构。
+
+### B. 文案减噪
+
+适合试运行前做，但要控制在页面字幕、说明、空状态和提示层。
+
+- 压缩 Portal、报销、审批、财务/AP 的副标题和说明。
+- 删除设计意图式、流程解释式、重复式文案。
+- 保留三类信息：当前状态、下一步动作、异常原因。
+- 不改确认弹窗中的风险说明；高风险动作仍要说明后果。
+
+### C. PC 页面风格统一收口
+
+这是用户明确指出的试运行前问题，建议作为清障型 UI 小修里的独立优先项处理。
+
+参考体系按 `research/pretrial-reference-systems.md` 执行：品牌看 Hyinda 官网，主体验看飞书工作台/飞书审批，PC 样板看 Ant Design 中后台模式，业务覆盖只参考钉钉、泛微、合思/每刻，不照抄任何竞品视觉或专有交互。
+
+范围限定在高频 PC 页面和容易误导真实用户的页面：
+
+- Portal/首页、报销列表和详情、审批列表和详情。
+- 财务/AP、付款批次、合同台账、项目、资产台账。
+- HR/考勤、预算、差旅、ERP、功能开关等冻结/后置或 C 类管理页只做边界表达和样式收敛。
+
+可做改动：
+
+- 统一 PC 页头：列表页优先 `WorkspaceHeader`，首页保留工作台样式但减少营销化大块说明，详情页用事实源摘要。
+- 统一卡片密度：高频工作页统一 `p-4 md:p-5` 为主，避免同一层级混用过大留白、过重卡片和过多说明。
+- 统一表格/筛选：列表页按“页头 -> 关键筛选 -> 表格/卡片 -> 分页/批量动作”排列，高级筛选折叠。
+- 统一按钮层级：主动作使用品牌蓝，次动作弱化，危险动作只在允许状态出现并保持二次确认。
+- 统一文案层级：标题说业务对象，副标题只保留状态/下一步/异常原因，删除解释设计意图的长段落。
+- 统一空/错/加载状态：按现有 `card-std` 和共享组件表达，不在不同页面临时自造提示样式。
+
+不做改动：
+
+- 不改 API、权限、审批、OCR、付款、AP 状态机。
+- 不重排全部信息架构，不新建大型设计系统。
+- 不为低频管理页做深度视觉重构，只做“安全摘要 + 高级配置”的默认收敛。
+
+验收建议：
+
+- 补 PC 1280/1440 截图对比，至少覆盖首页、报销、审批、AP/付款、合同/项目/资产。
+- 复跑 `node scripts/qa/check-ui-design-rules.mjs --strict`。
+- 若改前端代码，执行 `cd client && npm run typecheck && npm run build`。
+- 若涉及实际页面截图，复跑 `bash scripts/qa/run-oafront3-pc-readonly-visual.sh`。
+
+### D. 导航与冻结边界清晰化
+
+适合试运行前做，能降低误点风险。
+
+- 保持主导航收敛，备用模块继续默认收起。
+- 对预算、差旅、ERP、切换控制台等后置/冻结模块强化“未启用/仅管理/仅历史/只读”标识。
+- HR/考勤页面需要继续表达“企业微信主办，OA 留存/审计”，避免员工误以为 OA 是日常新建入口。
+
+### E. 默认视图降噪
+
+只改默认筛选、折叠和排序，不改数据。
+
+- AP 默认优先待付款、异常、待补资料，不把全量历史测试记录压到首屏。
+- 合同/项目默认隐藏或弱化 `TEST/SMOKE` 数据，保留正式合同、到期、负责人、归档位置。
+- 资产台账默认展示资产列表和详情；分类维护、ERP 同步状态和高级字段放折叠区。
+- 功能开关、通知渠道等 C 类管理页默认展示安全摘要，高级配置折叠。
+
+### F. 移动轻任务微调
+
+只处理明显卡点，不重做移动体系。
+
+- 报销移动卡片保留单号、状态、金额、报销人、下一步动作。
+- 审批移动页优先“待我审批/我发起的进度”，避免混成无分组流水。
+- 深层详情继续用统一返回、状态和吸底动作，不加新导航。
+
+## 试运行前不建议做
+
+- Portal 首屏大重排或角色工作台重构。
+- 全站视觉统一大改版；试运行前只做 PC 样板收敛和高频页面观感对齐。
+- 审批中心流程重构、批量审批策略变化、快捷审批语义调整。
+- 报销/OCR/发票上传主链路调整。
+- 付款批次、AP、财务复核状态机调整。
+- 合同、项目、资产的数据模型或权限模型调整。
+- 预算、ERP、差旅、HR 深镜像、应急接管、恢复回写、RuleOps 等后置能力开发。
+
+## 建议拆分
+
+### 试运行前小任务：`oa-frontend-pretrial-cleanup`
+
+目标：1 到 2 天内完成低风险清障，不能拖延 7 天真实试运行。
+
+范围：
+
+1. UI 证据补齐：动态详情页截图、PC 只读视觉矩阵、移动入口矩阵。
+2. PC 风格统一收口：页头、卡片密度、表格/筛选、按钮层级、空/错/加载状态。
+3. 高频页文案减噪：Portal、报销、审批、财务/AP。
+4. 冻结/后置模块边界提示：预算、差旅、ERP、HR/考勤、切换控制台。
+5. 默认视图降噪：AP、合同/项目、资产台账。
+
+验收：
+
+- `node scripts/qa/check-ui-design-rules.mjs --strict`
+- `cd client && npm run typecheck && npm run build`
+- `bash scripts/qa/run-oafront3-pc-readonly-visual.sh`
+- `QA_ISSUE_ID=oa-frontend-pretrial VISUAL_MATRIX_SCOPE=mobile bash scripts/qa/run-visual-matrix.sh live`
+- 若改移动页，补代表性移动/企业微信截图。
+
+### 试运行后任务：`oa-frontend-experience-maturity`
+
+目标：基于 7 天真实反馈做更完整的体验成熟化。
+
+范围：
+
+- Portal 角色工作台重排。
+- 报销/OCR 提交流程进一步减步。
+- 财务/AP 专用工作台。
+- 合同/项目/资产管理页信息架构。
+- C 类后台配置页安全摘要与高级模式。
+
+## 推荐结论
+
+试运行前可以做，而且 PC 页面风格不统一建议纳入启动前清障。但边界必须窄：只做“PC 样板收敛 + 文案减噪 + 默认视图降噪 + 视觉证据补齐”。如果要做，建议独立建一个小 task，严格限定 1 到 2 天，不把它并入 OAOPS1 7 天试运行准备，也不让它阻断真实业务闭环。
@@ -0,0 +1,99 @@
+# 试运行前 PC 前端参考体系调研
+
+## 调研目的
+
+回答“是否需要为 PC 页面统一增加目标网站或类似系统参考”。结论是：需要，但不应指定单一竞品照抄。hyb-oa 的 PC 页面应使用分层参考体系，避免一会儿像飞书、一会儿像泛微、一会儿像通用后台模板。
+
+## 调研来源
+
+- 现有事实源：`docs/产品设计规则.md` 已固定 Hyinda 官网品牌气质，并把飞书工作台/飞书审批作为唯一主 UI/布局参考。
+- 飞书审批官方帮助：
+  - `https://www.feishu.cn/hc/zh-CN/articles/360033971554-飞书审批管理员手册`
+  - `https://www.feishu.cn/hc/zh-CN/articles/633391673719-飞书审批-小组件使用手册`
+- 钉钉审批官方页面和管理员手册：
+  - `https://page.dingtalk.com/wow/dingtalk/act/approval-web`
+  - `https://static.dingtalk.com/media/lBDOASk63s4-WqFDznPJIHA.pdf`
+- Ant Design 设计规范：
+  - `https://ant.design/docs/spec/navigation/`
+  - `https://3x.ant.design/docs/spec/data-display-cn`
+  - `https://ant.design/docs/spec/research-form/`
+  - `https://5x.ant.design/docs/spec/data-list/`
+  - `https://4x-ant-design.antgroup.com/docs/spec/detail-page`
+- 泛微 e-office 官方产品资料：
+  - `https://www.eofficeoa.com/productupdate`
+  - `https://e-office.cn/oa/product/purchase`
+- 费控/报销产品资料：
+  - 合思：`https://www.hosecloud.com/`
+  - 每刻：`https://www.maycur.com/`
+
+## 候选参考判断
+
+| 参考对象 | 适合借鉴 | 不适合借鉴 | 结论 |
+| --- | --- | --- | --- |
+| Hyinda 官网 | 品牌蓝、浅色背景、清晰边界、稳重科技气质 | 官网英雄页、营销叙事、大图大标题 | 品牌气质基线，不做交互参考 |
+| 飞书工作台/飞书审批 | 工作台任务聚合、待办/已发起/抄送分组、审批入口、消息直达详情、管理后台的搜索/导出/交接 | IM、云文档、多维表格、开放平台生态、飞书专有文案和细节 | 主参考，决定 PC 工作台和审批体验方向 |
+| Ant Design | PC 中后台导航、表格、筛选、表单、详情页、空状态、按钮层级等可复用模式 | 直接引入 Ant 组件库、照搬视觉皮肤、把页面变成重型后台 | 实施参考，决定页面样板和控件语义 |
+| 钉钉审批 | 审批模板覆盖、假勤/财务/物品领用等轻流程场景、移动审批轻任务 | 钉钉生态、强移动优先、营销页样式 | 功能覆盖参考，不做 PC 视觉参考 |
+| 泛微 e-office | OA 台账、合同/采购/付款/权限/日志等业务完整性 | 重型 OA 复杂度、自定义配置过多、页面密度过高 | 后台台账和字段完整性参考，不做主视觉参考 |
+| 合思/每刻 | 报销、发票、OCR、财务复核、付款/AP、电子档案的专业路径 | 预算/差旅/银企深集成、大型费控平台复杂度 | 财务流程参考，不做全局 UI 参考 |
+
+## 推荐参考体系
+
+### 1. 主目标：飞书工作台/飞书审批
+
+用于统一“用户每天怎么进来处理事”：
+
+- 首页只突出待处理、我发起的进度、常用入口和异常提醒。
+- 审批列表分清“待我审批 / 已处理 / 我发起的 / 抄送或通知”。
+- 消息或通知点击后直达业务详情或审批详情。
+- 管理后台可以有搜索、导出、交接和权限管理，但普通员工不看这些复杂配置。
+
+### 2. 实施样板：Ant Design PC 中后台模式
+
+用于统一“页面怎么长、控件怎么排”：
+
+- PC 列表页：页头 -> 关键筛选 -> 表格/列表 -> 分页/批量动作。
+- PC 详情页：摘要 -> 关键字段 -> 附件/发票/审批流/日志 -> 主操作。
+- 表格适合结构化数据和横纵向比较；列表适合概要扫读；卡片只用于轻量分组，不堆叠成营销布局。
+- 表单同类内容使用同类控件，提示和标题简短；复杂表单分组，不在单区块内塞过多字段。
+- C 类配置页默认“安全摘要 + 高级配置”，降低误操作。
+
+### 3. 业务覆盖参考：钉钉、泛微、合思/每刻
+
+用于确认“有没有漏场景”，不指导视觉：
+
+- 钉钉：审批模板、假勤、财务、物品领用等高频场景覆盖。
+- 泛微：合同、采购、付款、台账、权限和日志留痕。
+- 合思/每刻：报销、发票、OCR、财务复核、付款/AP、档案归集。
+
+## PC 清障落地映射
+
+| hyb-oa 页面 | 主参考 | 本轮试运行前只做 |
+| --- | --- | --- |
+| Portal/首页 | 飞书工作台 + Hyinda 品牌 | 减少说明，突出待办、进度、异常、常用入口 |
+| 报销列表 | Ant 列表/表格 + 合思/每刻流程 | 统一筛选、状态、金额、申请人、下一步动作 |
+| 报销详情 | Ant 详情页 + 飞书审批单据 | 摘要、明细、发票、附件、审批流、付款状态分区一致 |
+| 审批列表/详情 | 飞书审批 + Ant 详情页 | 分清待办/已处理/我发起，详情突出对象、状态、历史和动作 |
+| AP/付款 | Ant 表格 + 合思/每刻财务路径 | 默认待付款/异常，历史和导出次级化 |
+| 合同/项目 | 泛微台账 + Ant 列表/详情 | 默认正式数据、负责人、到期、归档位置，弱化 TEST/SMOKE |
+| 资产台账 | Ant 列表/详情 | 日常资产列表和详情优先，分类/ERP/高级字段折叠 |
+| C 类配置页 | Ant 配置页 | 安全摘要优先，高级配置折叠，危险动作二次确认 |
+
+## 应避免
+
+- 不把飞书、钉钉、泛微、合思或每刻的文案、视觉细节、专有交互复制进 hyb-oa。
+- 不把 OA 做成飞书生态入口；企业微信仍只是入口和消息触达，业务主办仍在 OA。
+- 不用泛微/e-office 的复杂度来扩张 V1。
+- 不因参考合思/每刻而启用预算硬控、差旅、银企直连或大费控平台能力。
+- 不在试运行前引入新的 UI 组件库。
+
+## 推荐结论
+
+应在 `oa-frontend-pretrial-cleanup` 中明确“目标参考体系”：
+
+1. 品牌看 Hyinda 官网。
+2. 主体验看飞书工作台/飞书审批。
+3. PC 样板看 Ant Design 中后台模式。
+4. 业务覆盖看钉钉、泛微、合思/每刻。
+
+这比指定单一目标网站更稳妥。单一竞品容易导致照抄、范围膨胀或风格冲突；分层参考能约束每个页面只借鉴它该借鉴的部分。
@@ -0,0 +1,34 @@
+{
+  "id": "oaops1-seven-day-trial-prep",
+  "name": "oaops1-seven-day-trial-prep",
+  "title": "OAOPS1 7天真实试运行准备",
+  "description": "准备 OAOPS1 7 天小团队真实使用稳定化启动条件、只读预检和人工证据清单。",
+  "status": "completed",
+  "dev_type": null,
+  "scope": "trialrun-prep",
+  "package": null,
+  "priority": "P2",
+  "creator": "shunli",
+  "assignee": "shunli",
+  "createdAt": "2026-05-26",
+  "completedAt": "2026-05-26",
+  "branch": null,
+  "base_branch": "main",
+  "worktree_path": null,
+  "commit": null,
+  "pr_url": null,
+  "subtasks": [],
+  "children": [
+    "05-26-oa-frontend-pretrial-cleanup"
+  ],
+  "parent": null,
+  "relatedFiles": [
+    "scripts/qa/run-oa-real-use-daily.sh",
+    "scripts/qa/run-oa-final-launch-readiness.sh",
+    "scripts/qa/check-oa-permission-matrix.mjs",
+    "docs/试运行与自动化验证手册.md",
+    "docs/管理员手册.md"
+  ],
+  "notes": "",
+  "meta": {}
+}