fix(glossary): 修复历史 V1 漂移并建立 V2 迁移

2026-09-18 06:34:54 +08:00 · 2026-09-17 21:25:29 +08:00
parent 7f7d757f15
commit e486f1aaaa
13 changed files with 679 additions and 86 deletions
@@ -196,7 +196,7 @@ pub struct ParserRegistry {
 ### 4. 翻译系统（目标扩展，Go；当前 worker 由 Rust `bat` 承担）

 当前已实现的是 Rust `bat` 的离线 TextUnit 队列、mock/Crowdin provider worker、
-lease/retry、结果落库、项目级 Translation Memory V1 和独立 Glossary V1。TM 位于独立
+lease/retry、结果落库、项目级 Translation Memory V1 和独立 Glossary V2。TM 位于独立
 SQLite，按 raw source + 完整 context 做 trusted exact reuse，candidate 必须显式 confirm；
 Glossary 只有 approved term 进入 provider/TM 自动流程，并在结果上执行确定性 QA；模糊
 匹配和完整 Provider 体系仍属后续缺口。
@@ -296,7 +296,7 @@ HTTP Request → Middleware (Auth, CORS, Logger) → Handler → Service → Rep

 ### 7. Web 后台 (Vue 3，目标设计)

-当前只有 `bat-api` 内嵌 dashboard MVP；Rust `bat` 的 Glossary V1 已实现，登录、角色、Web 术语管理和完整协作审核仍未实现。
+当前只有 `bat-api` 内嵌 dashboard MVP；Rust `bat` 的 Glossary V2 已实现，登录、角色、Web 术语管理和完整协作审核仍未实现。

 **技术栈**：
 - Vue 3 + Composition API
@@ -36,7 +36,7 @@
   - 新的跨语言控制和查询能力优先增加 Rust RPC contract，再由
     `internal/backendrpc` 消费。

-4. **完整游戏业务 API、完整 Web 协作后台和 Provider 扩展体系仍是后续目标；Rust `bat` 已持有 Glossary V1，Web 术语协作视图仍待建设**；
+4. **完整游戏业务 API、完整 Web 协作后台和 Provider 扩展体系仍是后续目标；Rust `bat` 已持有 Glossary V2，Web 术语协作视图仍待建设**；
   Translation Memory V1 已由 Rust `bat` 持有，不能从目标架构图推断 Go 侧拥有第二份状态。

 ---
@@ -213,8 +213,9 @@ bat i18n worker run \
 `--watch`，因此可以单次、限定次数或周期执行；`--run-count > 1` 时仍必须
 显式指定 `--interval`。

-Glossary V1 是 Rust `bat` 持有的独立项目级 SQLite 资产，默认位于
-`<output>/glossary.sqlite`；也可以用 `--glossary-path`、
+Glossary V2 是 Rust `bat` 持有的独立项目级 SQLite 资产，默认位于
+`<output>/glossary.sqlite`；V2 正式吸收历史上的 `glossary_term_deletions`
+schema drift；也可以用 `--glossary-path`、
 `BAT_GLOSSARY_PATH` 或 `[translation.worker].glossary_path` 指定。worker 只把
 `approved` term 转成 provider-neutral constraints，并在 TM 复用、provider 返回
 和人工工作台/任务回写时执行相同的确定性 QA。冲突或不符合推荐/允许译法的结果会
@@ -180,8 +180,11 @@ count，任何一页不一致都会丢弃整个候选快照。
  覆盖。
 - `glossary.sqlite`：跨 release 的项目级 Glossary，不位于 `versions/<id>`，也不与
  `translation-tasks.sqlite` 或 TM 共用；记录 term、alias、推荐/允许译法、scope、
-  priority、review 状态、source provenance 和完整 source/review history；当前
-  schema version 为 V1，正式 schema evolution 不再通过 `ensure_column` 隐式修复。
+  priority、review 状态、source provenance、完整 source/review history 和 deletion
+  audit；当前 schema version 为 V2。V2 正式吸收历史上未升版本的
+  `glossary_term_deletions` drift，打开时通过 fingerprint 和 writer transaction
+  区分 V1-A/V1-B 并 fail closed；正式 schema evolution 不再通过 `ensure_column`
+  隐式修复。
  默认路径为
  `<output>/glossary.sqlite`，可由 `BAT_GLOSSARY_PATH`、`[translation.worker].glossary_path`
  或 CLI 覆盖。
@@ -74,7 +74,7 @@ Rust 窗口请基于当前真实代码生成或导出以下 JSON：
 2. `catalog.status` available=false 响应。
 3. `resource.manifest` 第一页响应，至少包含 1 到 2 个 entries。
 4. 对应 release 的 `official-sync-snapshot.json`。
-5. Rust Glossary V1 的 `translation.glossary.query` 响应，至少包含 alias、approved
+5. Rust Glossary V2 的 `translation.glossary.query` 响应，至少包含 alias、approved
   review、source provenance 和 created/approved history。

 输出应来自 Rust 代码路径，而不是手写 JSON。允许使用 fixture resource root 或临时目录，但不能依赖开发机真实资源目录。
@@ -162,11 +162,13 @@ trusted 的 raw source + 完整 context exact match，并在复用前执行已
 确定性 QA。Go `bat-api` 已提供鉴权的 summary/query 只读接口和 confirm 转发，但 Go
 不持有 TM 状态。仍缺少模糊匹配和更丰富的导入导出历史能力。

-### G-013：Glossary V1 已实现，协作视图仍缺失
+### G-013：Glossary V2 已实现，协作视图仍缺失

-Rust `bat` 已提供独立项目级 `glossary.sqlite`，当前 schema version 为 V1；打开
-遵守只读 fingerprint preflight、writer transaction、rollback 和 future/unknown
-fail-closed 契约，不再使用隐式 `ensure_column` 修复结构。term/alias/recommended/
+Rust `bat` 已提供独立项目级 `glossary.sqlite`，当前 schema version 为 V2；V2 正式
+吸收历史上未升版本的 `glossary_term_deletions` drift，并将历史 V1-A（无 deletion
+audit）和 V1-B（已有 deletion audit）分别纳入显式迁移。打开遵守只读 fingerprint
+preflight、writer transaction、rollback 和 future/unknown fail-closed 契约，不再
+使用隐式 `ensure_column` 修复结构。term/alias/recommended/
 allowed/category/priority、全局与 TextUnit scope、source history、approved review、
 冲突诊断、provider-neutral constraints 和确定性 QA 均由 Rust 持有。trusted TM 复用会
 先经过 Glossary QA；provider、TM、人工 task/workbench 结果都记录 QA，blocking