feat: Instance 聚合最小生命周期与 checkpoint #13

Merged

panxiao81 merged 1 commits from feature/instance-lifecycle-checkpoints into main 2026-09-16 17:40:20 +00:00

Conversation 0 Commits 1 Files Changed 2

+235

panxiao81 commented 2026-09-16 17:36:33 +00:00

Owner

Copy Link

Copy Source

范围

落实 docs/domain-instance.md 中 Instance 的重建与意图状态转换合同。

• 从有效 ObservationTarget 和持久化快照重建 Instance；缺失或未知阶段保守回到 Pending。
• BeginValidation 只记录验证意图，不推进 observedRevision。
• BeginDeletion 要求存在删除请求；删除请求阻止开始验证。
• Snapshot 返回独立值，禁止通过快照修改聚合内部状态。
• 测试覆盖阶段恢复、非法零值、重复动作、删除前置条件及状态隔离。

仅两个新文件，235 行。无外部 IO，不改变现有运行路径。不实现能力观察、Ready 判定、供应授权、资源删除或 finalizer 操作；持久化 Ready 快照不代表已建立有效的能力证据。

验证

• 领域包 lint（含自动修正后复查）：0 issues。
• git diff --check：通过。
• 未改 API markers 或生成文件；本次未运行全仓 lint。
• 单元测试已编写，未在本地执行；完整测试交给 self-hosted CI。

Refs #1

## 范围 落实 docs/domain-instance.md 中 Instance 的重建与意图状态转换合同。 - 从有效 ObservationTarget 和持久化快照重建 Instance；缺失或未知阶段保守回到 Pending。 - BeginValidation 只记录验证意图，不推进 observedRevision。 - BeginDeletion 要求存在删除请求；删除请求阻止开始验证。 - Snapshot 返回独立值，禁止通过快照修改聚合内部状态。 - 测试覆盖阶段恢复、非法零值、重复动作、删除前置条件及状态隔离。 仅两个新文件，235 行。无外部 IO，不改变现有运行路径。不实现能力观察、Ready 判定、供应授权、资源删除或 finalizer 操作；持久化 Ready 快照不代表已建立有效的能力证据。 ## 验证 - 领域包 lint（含自动修正后复查）：0 issues。 - git diff --check：通过。 - 未改 API markers 或生成文件；本次未运行全仓 lint。 - 单元测试已编写，未在本地执行；完整测试交给 self-hosted CI。 Refs #1

panxiao81 added 1 commit 2026-09-16 17:36:34 +00:00

feat: add Instance lifecycle checkpoints 0c66760628

panxiao81 merged commit a84c37d842 into main 2026-09-16 17:40:20 +00:00

panxiao81 deleted branch feature/instance-lifecycle-checkpoints 2026-09-16 17:40:20 +00:00

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

No items

No labels

Milestone

No items

No Milestone

Projects

Clear projects

No projects

Assignees

Clear assignees

panxiao81 (Xiao Pan)

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: panxiao81/postgresql-tenant-operator#13