文件
hyb-oa/docs/ops/non-functional-baseline.md
T

43 行
2.0 KiB
Markdown
原始文件 Blame 文件历史

此文件含有模棱两可的 Unicode 字符
此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。
# 非功能基线(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 数据回滚。