# 非功能基线（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 数据回滚。