Intake
- Asset
- ADP-PLN-FEAT-DOC-0017
- Feature
- intake
- 领域
- plane-core
- 作用域
- application-level
- 文档状态
- stub
- 产品生命周期
- planned
- 文档 Owner
- DOC
- 事实源
- canonical-docs
- 工程 Owner
- PLN
- Development Ready
- not-ready
- 更新
- 2026/10/14
FEATURE DEVELOPMENT PACKAGE
工程就绪状态
工程 Owner:PLN · 仓库:PLN
- 原子需求与验收
- 设计与工程合同
- 代码与仓库定位
- 里程碑与工作包
- 验证计划
- 无阻断决策
- Development Ready 已通过
- 验收标准已覆盖
- 正式测试已登记
- Fixture 与环境已定义
- 测试规格已物化到正式测试
- Verification Ready 已通过
- 实现修订可定位
- 发布证据已登记
- 兼容与迁移已定义
- Runbook 与回滚已定义
查看阻断项(6)
- 功能仍为 stub:不可进入开发
- Development Ready 缺少:原子需求与验收
- Development Ready 缺少:设计与工程合同
- Development Ready 缺少:代码与仓库定位
- Development Ready 缺少:里程碑与工作包
- Development Ready 缺少:验证计划
功能目标
为 Plane 的“Intake”建立可发现的 Feature 边界。首批仅完成 inventory 和页面合同骨架;页面可见不表示实现、验收或发布已经完成。
功能结论
| 主题 | 当前结论 |
|---|---|
| Producer / 用户 | Project Admin 与分诊成员。 |
| 入口 | Project Intake 入口;具体路由、按钮和权限仍待基于当前实现补证。 |
| 可见结果 | 接收、分类并转入受控的 Project 工作流。 |
| 系统保证 | 任何写操作都必须遵守 Workspace 隔离、对象权限、并发与审计约束;未补证字段不得写成稳定合同。 |
| 明确不做 | Intake 接收不等于 Automation 执行开始。 |
| 权威 owner | 产品语义由本页补全后的 canonical contract 持有;实现与环境状态分别由 Plane source、TEST/PROD evidence 持有。 |
当前落地状态、已批准合同与差距
- 当前落地状态:stub。inventory 来源于当前 Plane 用户可见导航或设置范围,但本页尚未完成 source、UI、API 和测试核验。
- 已批准合同:只批准“Intake”作为独立 Plane Feature 纳入功能库及其主层级;上表不得解释为已批准的完整行为合同。
- 差距与后续交付:需要核对用户入口、角色矩阵、稳定状态、数据/API、异常行为和现有测试,再由 Producer 审核后提升状态。
用户、权限、流程与数据
补全文档时至少覆盖:角色和租户边界、主要读写流程、稳定状态与状态转换、数据 owner、API/事件、幂等与并发。当前不推断未核验的字段、端点、默认值或可用性。
跨层依赖与停止条件
- 依赖:工作进入、工作项生命周期。
- 缺少权限、租户一致性、有效对象或 owning service evidence 时 fail closed。
- 外部集成、运行时或发布 evidence 不得由本页的 stub 状态代签。
验证与权威来源
补全前必须以 Plane 当前 source、真实 UI/路由、API schema、测试和 Producer 决策交叉验证;Docusaurus build 只证明页面可构建,不证明 Feature 已落地。
待决策问题
- v1 的最小用户闭环、明确 non-goal 和验收场景是什么?
- 哪些角色可读、可写、管理或导出,direct 与 inherited 权限如何解释?
- 哪些状态、字段、API 与事件应成为长期稳定合同?