hyb-oa/docs/ops/non-functional-baseline.md

非功能基线（P10.5/P13）

更新时间：2026-02-12

安全基线

• 使用 server/scripts/security-baseline.sh 检查关键安全配置与核心路由语法。
• 发布前要求：
  • JWT_SECRET 非默认值。
  • ERP_SYNC_ENABLED / INVOICE_VERIFICATION_ENABLED 通过 Feature Flag 治理，默认保持关闭。
  • npm audit --omit=dev --audit-level=high 输出需评审并记录处理策略。

R66 小团队上线最低要求

• 公网试点必须使用 HTTPS，并设置 APP_ORIGIN=https://<oa-domain> 与 COOKIE_SECURE=true。
• OPENAPI_DOCS_ENABLED=false，不要在公网生产暴露接口文档。
• 管理员账号、smoke 账号和真实员工账号分离；自动化不得使用真实业务账号。
• 上线前完成 1 次 DB + 文件存储备份恢复演练，并在 deploy/trialrun/checklist.md 记录备份文件名与恢复结果。
• 普通员工默认只看到主路径模块；考勤、采购、差旅、预算、AP、ERP、AI 默认隐藏或放入管理员备用区。

性能基线（Dashboard）

• 使用 server/scripts/benchmark-dashboard.sh 对以下端点做基线采样：
  • /api/dashboard/expense-overview
  • /api/dashboard/trends
  • /api/dashboard/top-categories
  • /api/dashboard/approval-efficiency
• 默认采样次数：ITERATIONS=10。
• 建议阈值（测试环境）：
  • 平均响应（avg）< 500ms
  • 最大响应（max）< 1500ms

SLI/SLO 与错误预算（P13）

• 详细定义见：docs/ops/slo.md
• 首版目标：
  • 可用性（30天）>= 99.9%
  • 核心 Dashboard API P99 < 500ms
  • Feature Flag 更新成功率 >= 99.5%
• 告警规则文件：deploy/prometheus/alerts-slo.yml

回滚原则

• 若非功能指标异常，先执行配置回滚而非代码回滚：
  1. 将 erp_sync 和 invoice_verification 设为 force_off。
  2. 必要时将 env 硬闸 ERP_SYNC_ENABLED=false、INVOICE_VERIFICATION_ENABLED=false。
• 保留审计与历史数据，不做 destructive 数据回滚。