@steedos-labs/content-compliance 0.7.21 → 0.8.1

package/README.md

@@ -0,0 +1,61 @@
+# @steedos-labs/content-compliance（内容审核系统）
+
+PepsiCo 内容审核 / 物料审批系统的核心 Steedos 包：审批引擎、物料、AI 审核、OneDrive 同步、PLS 知识库扫描、抽检、通知与定时任务。
+
+> 构建说明：修改 `src/**` 后必须 `yarn build`（`package.service.js` 加载的是编译产物 `lib/`）。
+
+---
+
+## 管理员手动接口（浏览器直接访问）
+
+以下接口用于对 **PLS 知识库（`pepsico_km_pls_file`）** 的历史数据做一次性维护。
+
+**执行前提：**
+
+- 以**空间管理员（space admin）**身份登录系统（非管理员访问会返回 `{"error":"没有权限"}`）。
+- 直接在**已登录的浏览器**中打开下面的地址即可（均为 `GET`，无需参数）。
+- 接口**可重复执行**：已处理/无需变更的记录会自动跳过，重复访问是安全的。
+- 将地址中的 `<域名>` 替换为实际环境域名，例如 UAT：`https://ccsuat.pepsico.com.cn`。
+
+### 1. 回填 PLS 记录标题（从「PLS原始文件查看」提取文件名到「标题」）
+
+把每条 `pepsico_km_pls_file` 记录的 **PLS原始文件查看**（`pls_file`）字段所对应文件的文件名，提取（去掉 `.pdf` 后缀）写入该记录的 **标题**（`name`）字段。用于补齐 `pepsico_km_pls_file_title_update` 触发器上线前、标题缺失或不一致的历史数据。
+
+```
+GET https://<域名>/api/pepsico-content/pls-file/backfill-title
+```
+
+浏览器返回示例：
+
+```json
+{ "历史记录总数": 123, "更新标题数量": 100, "跳过数量": 23 }
+```
+
+- `历史记录总数`：扫描的记录总数。
+- `更新标题数量`：本次实际写入新标题的记录数。
+- `跳过数量`：无文件、取不到文件名，或标题已一致而跳过的记录数。
+
+### 2. 重置「AI规则已提取」为 false
+
+把所有 `pepsico_km_pls_file` 记录的 **AI规则已提取**（`ai_extract`）字段全部置为 `false`（已经是 `false` 的记录会跳过，最终所有记录均为 `false`）。
+
+```
+GET https://<域名>/api/pepsico-content/pls-file/reset-ai-extract
+```
+
+浏览器返回示例：
+
+```json
+{ "记录总数": 42, "重置数量": 42 }
+```
+
+- `记录总数`：本次需要处理（原值不为 `false`）的记录数。
+- `重置数量`：实际置为 `false` 的记录数。
+
+> 实现见 `src/methods/pls.ts`（`backfillPLSFileTitles`、`resetPLSFileAIExtract`），路由注册见 `src/index.ts`。
+
+---
+
+## 其它接口与定时任务
+
+其余手动接口、定时任务、外部 AI 服务对接、PLS 规则提取等说明见仓库根目录 [README.md](../../README.md) 的「手动执行 / PLS规则提取接口」章节，以及各 `AI-*.md` 设计文档（入口 [AI-DOCUMENTATION-INDEX.md](../../AI-DOCUMENTATION-INDEX.md)）。