docs: add inbox markdown test plans
This commit is contained in:
@@ -0,0 +1,64 @@
|
||||
# Inbox `init` Test Plan
|
||||
|
||||
## Scope
|
||||
|
||||
This document covers the externally visible behavior of `inbox init`.
|
||||
|
||||
Shared conventions live in [../_shared/README.md](../_shared/README.md).
|
||||
|
||||
## case: init-creates-schema-on-empty-db
|
||||
|
||||
### 用例意义
|
||||
|
||||
验证在空数据库路径上执行 `init` 会创建可用的 inbox schema,并返回稳定的初始化响应。
|
||||
|
||||
### 前置条件
|
||||
|
||||
- 选择一个尚不存在的数据库路径 `TMPDIR/coord.db`
|
||||
|
||||
### 输入
|
||||
|
||||
```bash
|
||||
inbox --db TMPDIR/coord.db --json init
|
||||
```
|
||||
|
||||
### 预期输出
|
||||
|
||||
- 命令退出码为 `0`
|
||||
- 返回 `ok=true`
|
||||
- `command` 为 `init`
|
||||
- `data.db_path` 等于传入路径
|
||||
- `data.status` 为 `initialized`
|
||||
|
||||
### 断言结论
|
||||
|
||||
- `init` 在空路径上可以直接完成 schema 初始化
|
||||
- 初始化结果足以让后续 `send`、`fetch` 等命令继续使用同一数据库
|
||||
|
||||
## case: init-is-idempotent-on-existing-db
|
||||
|
||||
### 用例意义
|
||||
|
||||
验证 `init` 可以对已初始化过的数据库重复执行,而不会报错或破坏已有 schema。
|
||||
|
||||
### 前置条件
|
||||
|
||||
- `TMPDIR/coord.db` 已经执行过一次 `inbox --db TMPDIR/coord.db --json init`
|
||||
|
||||
### 输入
|
||||
|
||||
```bash
|
||||
inbox --db TMPDIR/coord.db --json init
|
||||
inbox --db TMPDIR/coord.db --json init
|
||||
```
|
||||
|
||||
### 预期输出
|
||||
|
||||
- 两次命令都退出码为 `0`
|
||||
- 两次响应都返回 `data.status == "initialized"`
|
||||
- 两次响应都返回相同的 `data.db_path`
|
||||
|
||||
### 断言结论
|
||||
|
||||
- `init` 是幂等操作
|
||||
- 对已存在 schema 的重复初始化不应引入额外迁移失败或状态漂移
|
||||
Reference in New Issue
Block a user