系统边界
AutoDev Platform 是一组由明确 owner 管理、通过稳定合同协作的能力,不是一个可以替代所有事实源的中央数据库。
| 领域 | 权威事实源 | 本知识库保存什么 |
|---|---|---|
| 长期产品合同 | canonical Feature 文档 | 目标、边界、状态机、接口语义与验收标准 |
| 代码与正式测试 | owning Git 仓库及固定 revision | 资产位置、稳定标识与关系,不复制实现正文 |
| Project Workspace | project.yaml、repo registry 与 Project policy | 身份、路由、owner 和授权边界 |
| AutoDev 开发工作 | Linear 原生 Issues | 当前需求、反馈、依赖和人工验收;开发对象主要是 Plane |
| Plane 工作管理 | Plane 原生对象 | 工作意图、依赖、责任人和业务状态 |
| Issue 委托与执行 | Plane Issue 委托;官方 Symphony 执行状态 | 开关与唯一 Issue 进度、执行边界,不复制 Run 台账 |
| Plane 构建与部署 | GitLab、Harbor、Git desired state、Argo CD 及运行环境 | 长期流程和证据入口,不保存瞬时状态 |
| 其它组件交付 | 对应 owning release surface(可能包含 TeamCity) | 各组件独立合同,不推断为 Plane 发布路径 |
不跨越的边界
- 文档状态不等于实现状态、Plane 工作项状态或环境状态。
- Git revision、Plane UUID、OpenAPI operationId 和测试名称保留各自原生身份;Asset ID 只提供跨系统语义身份。
- 文档构建不读取各仓最新分支,而是读取经审核的固定来源快照。
- 本站不保存凭据、私有地址明细、一次性命令或运行时秘密。
- Symphony 当前执行状态只能从执行服务查询,不能从本文档、Git、Issue 业务状态、评论、标签或目录推断。