technical

开发计划

把当前工作锁定在五模块路线图之下,并同步模块五框架层验收、Day 10 收口结果,以及下一轮真实实现优先级。

Audience

开发

Updated

2026-03-28

Source

docs/development-plan.zh-CN.md

当前状态

  • 模块一已验收完成,staging 与真实浏览器人工确认都已闭环
  • 模块二 Day 1 到 Day 7 已完成:endpoint inventory、共享 client、target detail、参数校验、store adapter 合同与 API shape lock 都已收口
  • workflow store 现在默认要求 cloudflare-d1,只有显式打开 fallback env 时才允许回退到 local-dev-file-store
  • profiles store 现在默认要求 cloudflare-d1,只有显式打开 TOOLPLANE_ENABLE_PROFILE_LOCAL_FALLBACK 时才允许回退到 local-dev-file-store
  • targets store 现在默认要求 cloudflare-d1,只有显式打开 TOOLPLANE_ENABLE_TARGET_LOCAL_FALLBACK 时才允许回退到 local-dev-file-store
  • 模块三 Day 1 已把 workflow / registry / ledger / reserved supply 四类 D1 对象边界固化到 src/lib/server/d1-boundary-map.ts
  • 模块三 Day 1 已重新通过 npm run lint:windows 与 npm run build:windows 本机验证
  • 模块二 Day 7 已通过 local D1 与 staging 两条合同锁形验证路径
  • 模块三 Day 6 已把 preview / accept / complete / run detail 的 creditBoundary 合同补齐,并把 testing-consumes-credits 规则提升成稳定 API 字段。
  • 模块三 Day 7 已在 fresh local port 3200 与 staging 上通过 D1 query proof,workflow / profiles / targets / runs / usage 的查询路径、wallet balance 与 run detail 边界都已对齐真实 D1。
  • 模块三 Day 8 已补齐 data-foundation 文档与模块三数据库验收记录,Docs Center、Help Center 与工作台状态已在此基础上继续推进到模块四 Day 5 并完成收口。
  • 旧 D1 seed 如果缺少 workflow_nodes.ui_json.creditCost,当前会按 node kind 回退到模板默认值,避免 Autofill 成本被误读成 0。
  • 模块四 Day 1 已固定 dev / build / preview / deploy 命令约定,并把 WSL2 固定为默认发布主路径。
  • 模块四 Day 2 已把 staging 绑定、环境变量分层与 local / staging 差异固定到 docs/staging-bindings.zh-CN.md。
  • 模块四 Day 3 已把默认 staging smoke 路径固定为 npm run verify:smoke,并把接口检查清单收口到 docs/staging-smoke-checklist.zh-CN.md。
  • 模块四 Day 4 已把默认 staging 发布顺序固定为 npm run release:staging,并把 bootstrap / redeploy / rollback 规则收口到 docs/staging-release-sequence.zh-CN.md。
  • 模块四 Day 5 已把完整 staging 发布演练固定为 npm run release:staging:drill,并把部署操作 runbook 收口到 docs/staging-operations.zh-CN.md。
  • 模块五 Day 10 已完成:扩展框架验收文档已入库,最新一轮 staging drill 也已对齐到最终文档状态,下一轮真正实现优先级锁定为组织、成员、权限优先。
  • Day 11 第 9 刀已把 `POST /api/team` 与 `POST /api/team/activate` 也接到真实 actor / RBAC enforcement,并已补齐 staging proof;team 写路径的 actor requirement 现已进入 staging contract lock,remote D1 也已确认 `membership.invited` / `membership.activated` 会写入真实 `actor_user_id`。

当前进度

当前主线已经完成模块五 Day 1 到 Day 10 的框架验收:组织、商业、供给、市场、结算与二级入口都已进入共享 foundation、工作台与文档真相源。

这意味着扩展框架层已经满足切换条件;后续可以直接从真实组织、成员、权限实现切入,而不需要返工 route、service、shared client、商业边界或模块信息架构。

当前最大的剩余风险已经收敛到 account / project / membership 如果继续停留在只读框架,invite、owner / operator / member 说明与后续 Auth / RBAC enforcement 仍可能再次漂移,因此它被锁定为第一优先级。

已完成范围

  • 前端工作台壳子
  • Workflow Alpha 与真实 API
  • workflow / profiles / targets / runs 的统一 control-plane envelope
  • workflow-client / registry-client / run-client 共享前端合同边界
  • Workflow 列表、新建、切换与 per-workflow 草稿隔离
  • Docs / Help 入口同步
  • Profiles / Targets live API 读写
  • Target detail active schema / field templates / review fields
  • workflow-service / registry-service 与 store adapter contract
  • Review gate / Result gate 预演结构与 accepted-run 最小闭环
  • Runs / Usage / Team control-plane API 骨架

下一批排队任务

  • 下一轮真正实现优先级 1:继续推进执行器、审核与剩余 runtime 缺口
  • 下一轮真正实现优先级 2:补齐更细的执行器 / 审核闭环 proof