文件
hyb-oa/.trellis/tasks/archive/2026-07/07-16-system-multidimensional-audit/research/audit-scope-baseline.md
T

53 行
2.9 KiB
Markdown

# 多维系统审查范围基线
## Repository Snapshot
- 审查 task 创建日期:2026-07-16。
- 创建 task 前工作树:clean。
- 当前技术栈:React/TypeScript/Vite/Tailwind;Fastify/Prisma/PostgreSQL。
- 前端资产:75 个 page 文件、60 个 component 文件、76 个 `<Route>` 声明。
- 后端资产:68 个 route 文件、63 个 service 文件、117 个 Prisma model。
- 验证资产:63 个 Playwright spec、153 个后端测试文件、50 个 QA 脚本;`client/src` 下没有独立 unit spec。
这些数字只用于确定审查规模,不等同于功能完成率或测试覆盖率。
## Current Truth Boundary
- 最后有证据的公网部署来源为 `df26922`。
- 当前本地 `main` 包含后续可信度修复和治理收口,尚无对应公网部署证据。
- 旧 7 天试运行只完成 Day 1–Day 4,原目标未完成;不得用于证明当前系统已经连续稳定运行。
- 本轮只读审查默认只对当前本地基线作结论。
## Existing Findings To Reconcile
- 付款页对仅有复核权限的角色仍显示新建批次。
- 合同只读角色仍看到新增、编辑、续约和归档入口。
- 票据上传按钮未使用已有上传权限判断。
- 两个资产 E2E 仍按旧“资产分类”直接按钮交互。
- 标题动作容器只有布局,没有动作数量合同;项目/资产视觉覆盖不足。
以上问题来自 `05-31-unified-page-header-actions`,新审查应复核、补证和归因,不重复登记。
## UI/UX Rubric Input
`ui-ux-pro-max` 对本任务有价值的通用检查项:
- 键盘可达、焦点可见、标题层级和颜色不能作为唯一提示。
- 表格在移动端应使用可控横向滚动或卡片化,不能撑破 viewport。
- 表单需要 loading/success/error 反馈,并在 blur 或合理时机提供校验。
- 固定导航不能遮挡内容;交互状态不应引发布局位移。
- 代表视口至少覆盖 375、768、1024、1440,并检查移动横向滚动。
- React 搜索/筛选需要测量后再决定 debounce 或 `useDeferredValue`,不凭感觉优化。
该 skill 生成的“红/金 + 活泼块状”样式与当前成熟、低认知负担的企业 OA 目标冲突,因此不作为品牌、配色或换肤建议。现有产品事实与组件设计规则优先。
## Initial Risk Hypotheses
- 前端动作显隐与后端权限校验可能存在系统性合同缺口,而不只是三个页面的局部问题。
- 大量 E2E、零前端 unit spec 可能导致纯逻辑、组件合同和测试维护成本不平衡。
- 历史页面/视觉 spec 数量多,可能存在旧交互断言、重复覆盖和环境性脆弱。
- 117 个数据模型与多个集成/试运行脚本增加跨层状态、迁移和外部依赖口径漂移风险。
- 本地与公网来源分离后,任何“正式可用”结论都必须重新标注适用环境。
这些是假设,不是 finding;只有后续证据支持时才进入正式台账。