# 架构、取舍与验证

MoonBranch 的输入由配方和已经授权使用的 PostgreSQL 样本组成；输出是可在应用迁移后的空库恢复的测试制品。库负责规则和 SQL，命令行胶水负责运行 `psql` 和处理文件。没有额外的 Mooncakes 第三方依赖。

## 图的两种访问状态

每个表按主键元组做哈希索引；每条向下边另建反向索引。访问有两种状态：**进入结果**与**允许向下扩展**。所有入选行补齐祖先；祖先仅因外键进入结果时没有向下扩展资格。如果后来又走显式向下边到达同一行，就补做一次向下扩展。这保证遍历与输入行顺序无关，同时不会因为共享客户或公共字典表意外纳入更多业务记录。复合键序列化为 JSON 元组，避免分隔符拼接歧义。

采集阶段在同一个 `REPEATABLE READ READ ONLY` 事务里锁定表、校验 `pg_catalog`，以遮盖表达式读取并返回列白名单。恢复阶段按外键依赖排插入顺序，锁定目标表，在同一个事务内检查空表、写入以及强制校验延迟外键。范围上限不足会拒绝产出；迁移导致约束冲突则整个事务回滚。

## 外部基线

| 项目 | 能力与关系 |
| --- | --- |
| [Greenmask](https://github.com/GreenmaskIO/greenmask) · Apache-2.0 | 成熟数据库脱敏与测试数据管理实现，适合更完整的管理场景。 |
| [TonicAI Condenser](https://github.com/TonicAI/condenser) · MIT | 数据库子集工具，证明按业务范围裁剪是一个已有的使用场景。 |
| [Neon Branching](https://neon.com/docs/introduction/branching) | 托管 PostgreSQL 实例的分支能力，适用于需要完整分支和生命周期管理的团队。 |

这些是产品与架构的对照，没有移植其代码。MoonBranch 聚焦 MoonBit 可离线复用的规则库和独立测试制品。选题时检索 Mooncakes 与 GitHub，采用 `PostgreSQL`、`fixture`、`mask`、`subset`、`branch` 等关键词；没有把“没有找到同定位的 Mooncakes 包”当作全球首次实现。

## 验证链

MoonBit 单测覆盖复合键、关联边界、循环、排序、缺失父行、行预算和字段遮盖。`scripts/integration.mjs` 用真实 PostgreSQL 创建独立数据库，验证恢复、约束失败回滚和 catalog 漂移。夹具为项目自制合成数据。GitHub Actions 在 push 和 PR 上重复运行构建、静态检查和测试；验收应以实际运行记录为准。

运行 `node scripts/benchmark.mjs` 可用合成数据检查引擎在 1,001、10,001、50,001 行输入下的耗时与结果范围。报告五次独立进程的中位数，包含 Node 启动、JSON 解析、图计算和结果编码。它不测 PostgreSQL，也不用于跨机器的性能承诺。
