feat: add ops center and node onboarding flow
This commit is contained in:
59
docs/schemas/ops_go_live_bundle_contract.md
Normal file
59
docs/schemas/ops_go_live_bundle_contract.md
Normal file
@@ -0,0 +1,59 @@
|
||||
# ops_go_live_bundle_contract
|
||||
|
||||
## 目标
|
||||
|
||||
把发布前证据包与 `manifest.json` 复核结论压成一份统一 contract,供:
|
||||
|
||||
- Ops Center 交付面板
|
||||
- CLI `go-live-export / go-live-review`
|
||||
- 海外 Codex 驾驶员
|
||||
|
||||
共同消费。
|
||||
|
||||
它解决的问题不是“现在能不能上线”,而是:
|
||||
|
||||
> 现在有没有一份足够完整、足够可信、可交付可复盘的上线证据包
|
||||
|
||||
## 主接口
|
||||
|
||||
- `GET /api/v1/ops/go-live-bundle`
|
||||
|
||||
## 核心字段
|
||||
|
||||
- `status`
|
||||
- `missing`
|
||||
- `ready`
|
||||
- `attention`
|
||||
- `blocked`
|
||||
- `status_label`
|
||||
- `headline`
|
||||
- `bundle_available`
|
||||
- `report_dir`
|
||||
- `manifest_path`
|
||||
- `artifact_total`
|
||||
- `failure_total`
|
||||
- `critical_failures`
|
||||
- `noncritical_failures`
|
||||
- `env_audit`
|
||||
- `summary`
|
||||
- `recommended_commands`
|
||||
|
||||
## 判定原则
|
||||
|
||||
- 如果当前还没有 bundle / manifest
|
||||
- `status = missing`
|
||||
- 如果 manifest 明确标记 `review_status_hint=blocked`
|
||||
- `status = blocked`
|
||||
- 如果 manifest 已存在,但:
|
||||
- 仍有非关键失败
|
||||
- 环境审计提示 attention
|
||||
- launchpad 摘要存在漂移
|
||||
- 则 `status = attention`
|
||||
- 只有当 manifest 可读、review 为 ready、关键摘要一致
|
||||
- 才允许 `status = ready`
|
||||
|
||||
## 设计约束
|
||||
|
||||
- 页面不直接触发 shell 导出 bundle
|
||||
- 后端默认只读最新 bundle / manifest,不负责替代 CLI 执行导出
|
||||
- 当 bundle 缺失时,必须明确给出固定命令,而不是让操作者自己猜路径
|
||||
Reference in New Issue
Block a user