本文档由 g2rain-knowledge 的
# 架构例外
docs/architecture/deviations.md 自动同步生成。发布补充（2026-10-19）：维护者确认服务器端验证通过，详见 v1.0.0 发布记录。该验证不自动关闭下列代码与可靠性延期项；历史核对日期保留。
# 当前状态
工程已具备 g2rain-knowledge-api / g2rain-knowledge-biz / g2rain-knowledge-startup 三模块与生成 CRUD 骨架；java-domain-service 1.0.0 尚无已批准的中央 Profile 例外（跨模块同步写入、绕过 organ_id、直接对外暴露通用 CRUD 写契约、混合 embedding profile、将外部网络调用放入发布事务等仍须先登记再实施）。
下列条目为本项目已批准的领域规则/实现基线调整（相对早期设计草案），不是中央 Profile 例外。
# DEV-001：审核仅针对源文件，处理在审核之后
| 项 | 内容 |
|---|---|
| 状态 | 已批准（2026-10-07） |
| 变更 | 权威顺序由早期草案 DRAFT → PARSING → REVIEWING → INDEXING → … 调整为 DRAFT → REVIEWING → APPROVED → PROCESSING(PROCESS) → READY_TO_PUBLISH → PUBLISHED |
| 原因 | 人工审核应校验可阅读的原始文件或 FAQ 与标签；切片与向量中间产物审核人无法有效接入 |
| 后果 | 审核通过前不得 Embedding/写 Milvus；通过后由 PROCESS 完成解析/切片/索引 |
| 残留差距 | scripts/g2rain-knowledge.sql 中 revision_status COMMENT 仍列举旧状态词；运行时以 Java 枚举为准 |
# DEV-002：检索未知标签拒绝
| 项 | 内容 |
|---|---|
| 状态 | 已批准（2026-10-07） |
| 变更 | 检索请求中未知/不可用 tag_code 拒绝请求，不按「无匹配 → NO_EVIDENCE」处理 |
| 原因 | 与当前实现及 integration-contracts 一致，避免调用方拼写错误被静默当成无知识 |
| 残留 | 早期草案「未知→无匹配」已废弃 |
# DEV-003：访问模型 = Gateway 准入 + Starter 租户隔离
| 项 | 内容 |
|---|---|
| 状态 | 已批准（2026-10-07） |
| 变更 | 凡经 Gateway 可达本服务的调用方可访问本租户全部知识接口；隔离仅用 Starter @DataIsolation / organ_id |
| 不做 | 服务内五能力点门禁、第二套数据隔离、业务路径 WithoutIsolation |
| 说明 | 细粒度 IAM 若需要由 Gateway/管理端入口控制 |
# 已登记延期缺口（非 Profile 例外）
- 发布：事务内先
setSearchable再 MySQL CAS；无 offline/reconcile；无主题分布式锁。通用删除仅允许未发布且无活动版本的 release，已发布记录不得借删除绕过下线。 - 任务：
input_snapshot/lease_generation/cancel_requested列未接线；RUNNING 协作取消未实现。 - 运营：主题/草稿/FAQ 经生成
save已补受信组织、默认值与草稿白名单/updateByVersion（RQ-005）；replaceFile与 PENDING retry/cancel 已暴露专用 HTTP。任务/切片/反馈/save仅补组织与@LoginGuard，字段白名单未收紧，仍为已知残余风险。 - 原文下载：
GET /knowledge_revision/{id}/source/download已按 RQ-006 提供附件流（审核不强制已下载）。
# 本地实现选择（非例外）
- 基于 MySQL 函数索引的逻辑删除策略遵循 Profile 的 MySQL 8.0.13+ 基线。
- Milvus、Docling 和模型服务是本领域的外部基础设施；发布权威仍在 MySQL。
- 代码生成器生成基础 CRUD，领域流程在 Biz 层扩展。
- 本服务提供受控问答
POST /knowledge/answer（模板 + 可信证据 → chat completions）；不持有 Agent Runtime 会话。