feat(aihr): close functional checklist gaps

2026-08-02 12:15:45 +08:00
parent 699cc08050
commit 6ad8a017a4
80 changed files with 4930 additions and 430 deletions
@@ -151,7 +151,22 @@ order by id desc;

 队列状态固定为 `0=待处理、1=处理中、2=完成、3=失败`。成功条件是最新队列条目为 2、附件为 2、片段数大于 0，并按当前向量配置确认相应片段已向量化；零片段必须保持失败态，不能显示为完成。普通失败条目只有在 72 小时暂存保留期内才可调用 `POST /api/knowledge/doc/upload-items/{id}/retry`；暂存已清理时应重新上传。历史附件重试不依赖旧暂存文件，而是从 OSS 原件重新入队。

-### 5.3 细粒度 SOP 迁入 `yc_property_sop`
+### 5.3 RC-007 容量与存储门禁
+
+当前资料加工 worker 固定为单实例并发 2，单文件上限 500MiB，ZIP 解压总量上限 2GiB，失败暂存保留 72 小时。默认暂存目录为 `./.data/staging`，生产必须通过 `AIHR_UPLOAD_STAGING` 或 `aihr.upload.staging` 指向独立、可监控的持久磁盘，不得依赖系统临时目录。`aihrUploadCapacity` 健康组件默认要求可用空间不少于 10GiB；可用 `AIHR_UPLOAD_MINIMUM_FREE_BYTES` 调整，但只能在完成容量测算后修改。
+
+发布前先只读检查：
+
+```bash
+curl -fsS https://<backend-host>/actuator/health/aihrUploadCapacity
+curl -fsS https://<backend-host>/actuator/metrics/http.server.requests
+```
+
+健康详情必须满足 `status=UP`、`stagingWritable=true`、`capacityReady=true`，并核对 `workerConcurrency=2`、`maxFileBytes=524288000`、`maxArchiveUnpackedBytes=2147483648`。生产配置已为 `http.server.requests` 开启 P50/P95/P99 分位统计；错误率按同一指标的 `status/outcome` 标签计算。出现低磁盘健康失败时先扩容或迁移暂存盘，不得通过降低门禁值冒充恢复。
+
+录音中的约 600 名生活管家只是用户规模，不是 600 并发。压测前由业务、实施和运维另行签认峰值在线人数、并发到达率、业务流量占比、文件大小分布、弱网条件、P95 目标、错误率目标和持续时长；未签认前只可验证健康门禁和现有并发上限，不得宣称容量验收通过。压测必须使用隔离环境和脱敏/合成数据，不对生产执行写压测。
+
+### 5.4 细粒度 SOP 迁入 `yc_property_sop`

 现有“投诉处理 SOP、催缴沟通 SOP、报修跟进 SOP”等 `legacy_*` 空间不直接改名。按以下顺序执行：