docs: specify postgres and secret distribution

This commit is contained in:
Codex
2026-05-29 09:19:06 +08:00
parent feebafd769
commit 55bafd1c71
7 changed files with 209 additions and 4 deletions
+4 -1
View File
@@ -190,8 +190,9 @@ Event 是 append-only,并按 seq 分页:
## 数据模型方向
第一版实现可以使用紧凑 schema,但不应把所有事实都隐藏在一个 JSON blob 中。稳定方向是:
`v0.1` 使用 Postgres 作为唯一 durable storefile、sqlite、JSONL 或 Pod 本地目录只能用于临时测试或日志,不作为运行面事实来源。第一版实现可以使用紧凑 schema,但不应把所有事实都隐藏在一个 JSON blob 中。稳定方向是:
- `agentrun_schema_migrations`migration id、checksum 和 applied timestamp
- `agentrun_runs`run identity、tenant/project/workspace/backend policy、status 和 timestamps
- `agentrun_commands`command type、idempotency key、payload hash、state 和 ack timestamps
- `agentrun_events`:按 run 和 seq 索引的 append-only event records
@@ -199,6 +200,8 @@ Event 是 append-only,并按 seq 分页:
- `agentrun_backends`backend profile、capabilities、capacity 和 health
- `agentrun_leases`:当前 ownership 和 expiry。
Postgres DSN、provider API Key 和未来 tenant credential 的分发边界见 [spec-v01-secret-distribution.md](spec-v01-secret-distribution.md)source、GitOps、event、trace、日志和 CLI 输出都不得保存 Secret 明文。
## 部署方向
AgentRun 从 `v0.1` 开始按版本 lane 滚动,废弃 `dev/prod` 管理口径。`v0.1` 的固定 source workspace 是 `G14:/root/agentrun-v01`,固定 source branch 是 `v0.1`,固定运行目标是 G14 原生 k3s namespace `agentrun-v01`。后续 `v0.2``v0.3` 必须拥有自己的 branch、workspace、namespace、GitOps branch、runtime path 和发布验收。