This is an automated email from the ASF dual-hosted git repository.
zyxxoo pushed a commit to branch refactor/rust-rewrite-design
in repository https://gitbox.apache.org/repos/asf/hugegraph.git
The following commit(s) were added to refs/heads/refactor/rust-rewrite-design
by this push:
new e5e4db0c0 docs: define Rust rewrite formal go no-go gate
e5e4db0c0 is described below
commit e5e4db0c05d98ac2f21767271e55d56da6fb3d01
Author: vaughn <[email protected]>
AuthorDate: Thu Sep 10 01:44:24 2026 +0800
docs: define Rust rewrite formal go no-go gate
---
docs/rust-rewrite-design.md | 2 ++
docs/rust-rewrite-go-no-go-checklist.md | 51 +++++++++++++++++++++++++++++++++
2 files changed, 53 insertions(+)
diff --git a/docs/rust-rewrite-design.md b/docs/rust-rewrite-design.md
index 83f7ebf17..c257e431d 100644
--- a/docs/rust-rewrite-design.md
+++ b/docs/rust-rewrite-design.md
@@ -8,6 +8,8 @@ HugeGraph 当前由 Java 服务、核心图引擎、RocksDB/HStore 后端以及
测试资产盘点和迁移门禁见 [Rust
重构验收矩阵](rust-rewrite-acceptance-matrix.md)；该矩阵是本设计的执行入口，不满足其中的进入/退出条件就不能扩大替换范围。
+正式开工的充要条件和当前 Go/No-Go 状态见 [Rust 重构正式开工清单](rust-rewrite-go-no-go-checklist.md)。
+
目标是降低运行时资源开销，改善并发和故障恢复能力，统一分布式组件的实现语言，并保留
Gremlin、REST、Schema、索引和现有部署方式的兼容性。目标不是一次性重写，也不是重新设计图数据库语义。
## 2. 设计原则
diff --git a/docs/rust-rewrite-go-no-go-checklist.md
b/docs/rust-rewrite-go-no-go-checklist.md
new file mode 100644
index 000000000..a8876e5dd
--- /dev/null
+++ b/docs/rust-rewrite-go-no-go-checklist.md
@@ -0,0 +1,51 @@
+# Rust 重构正式开工 Go/No-Go 清单
+
+本文是从设计阶段进入正式实现阶段的唯一门禁。POC 可以在门禁前进行，但不得接管生产路径或改变持久化格式。
+
+## 1. 必要条件
+
+以下任一项未满足，正式重构不得开始：
+
+- [ ] 重构目标、非目标和成功指标已获项目维护者确认；
+- [ ] 本次实现边界、依赖边界和不迁移范围明确；
+- [ ] 外部协议、数据语义、事务、索引、Raft、快照和恢复不变量已编号；
+- [ ] 现有测试入口、Maven profile、CI job 和 filter 已完成资产盘点；
+- [ ] 当前边界的测试已映射到契约、Oracle 和执行入口；
+- [ ] Java 基线、输入数据、配置和结果可重复；
+- [ ] Rust toolchain、MSRV、依赖许可证、`unsafe`/FFI 政策和 CI 门禁已确定；
+- [ ] 数据格式、升级、降级、灰度和回滚方案已评审；
+- [ ] 性能、资源、稳定性和恢复阈值已预先定义；
+- [ ] 社区 review 的反馈已分类并有处理结论。
+
+## 2. 充分条件
+
+只有以下证据全部具备，才能把边界状态标记为 **GO**：
+
+- [ ] 设计文档、测试审计、验收矩阵和工程规范通过 review；
+- [ ] 该边界至少完成一次 POC，证明架构假设可行；
+- [ ] 关键契约有独立 Oracle，而不是只复制 Java 输出；
+- [ ] 负向变异测试能捕获预先注入的错误；
+- [ ] 集成测试、差分回放、故障注入和恢复测试均有确定性结果；
+- [ ] POC 未发现无法解释的协议、数据或一致性差异；
+- [ ] 已有双读/灰度实现和一键回滚开关；
+- [ ] 性能与资源结果达到预先批准的阈值；
+- [ ] 至少两名 reviewer 完成签核，其中一人不参与主要实现；
+- [ ] Go/No-Go 记录包含提交版本、配置、数据集、seed、日志、报告链接和未解决风险。
+
+## 3. 当前状态
+
+截至本文件生成时，设计文档、测试资产文件级/入口级盘点、方法级追踪底稿、验收矩阵、Rust 工程规范和 Partition POC
计划已具备。方法级语义归类、独立 Oracle 实现、负向测试执行、POC 结果和社区签核尚未完成，因此当前结论为 **NO-GO（允许继续做非生产
POC）**。
+
+## 4. 正式开工顺序
+
+```text
+社区 review 文档
+→ 修订并签核 Go/No-Go 清单
+→ 完成一个边界 POC
+→ 执行契约/集成/故障/负向验证
+→ 记录报告并确认 GO
+→ 进入该边界的正式 Rust 实现
+→ 每个小步重复同一门禁
+```
+
+“正式开工”只表示一个已批准边界可以实现，不表示整个 HugeGraph 可以跳过后续边界门禁。
