Files
eip4-platform/docs/plans/2026-06-19-EIP4开发平台-落地执行路线图.md
zhengwr dd3b048899 docs: 清除私有托管地址,改中性表述(取码地址向负责人索取)
- 新人上手 §1:托管地址/clone 命令改 <GIT_HOST>:<OWNER> 占位,SSH 端口细节改「向负责人索取」
- 路线图/用户管理Delta/总览 三处历史记录行、.gitea/ci.yml 注释:host 名改「私有 Gitea/私有远程」
- 全仓 grep 验证零残留

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 08:29:30 +08:00

9.0 KiB
Raw Blame History

🔄 里程碑状态回写(2026-06-21):正文部分表述已被本期进展推进,以此处与 总览-2026-06-21 为准。

  • ✅ M0(L1 主题 token)已上线;✅ M-Gate(渲染冒烟 4b564c6)已做;✅ M3a(单一写真相 PageSchemaWriter d3b8846)已做;✅ DesignerPage 全闭环(2278cbc 等,原 §1/§2「DesignerPage 打不开」已解除);✅ 人走五环 v1 全链交付合 main;✅ 两仓已 push origin/main(75f942b/d1fd6ed,§5「push = 用户决策」已完成);🟡 M7 recipe 扩面部分(master-detail-v1 已做,余待 v2)。
  • 🔴 仍未起步:M4(引擎 ALTER 安全通道)、M5(onEvent 声明式面板)、M8(CLI NocoBase 化 + 安全 Part2)、M1 生产单源托管(dev 反代已通,生产托管 = A10)。

EIP4 开发平台 · 落地执行路线图

日期 2026-06-19 | 活计划,配套《2026-06-19-EIP4开发平台-架构方向-design.md》(方向+锁定决策 D1-D7)。本文是该 design doc 承诺的「另立 plan 文档」。每里程碑落地后回写状态。 经对抗审查修订:补回 D2 锁定的 P0 前置(组件 L1);把正确性门禁(渲染冒烟)置于真库 dogfood 之前;net-new 旁路先收口为单一写真相再立新端点;区分「build 完成 vs env 终验」。

0. 修订要点(为什么不照搬初稿)

  • design §6 的 P0 = 组件 L1 主题 token 生产级,是 D2 锁定的「真实前置」;初稿漏了,本版补为 M0,且设计中心-facing 里程碑(M3b 新建入口 / M5 面板)必须 gated 在 M0 之后(否则重蹈 design §9「功能对观感差」覆辙)。
  • design fix#6:新 authoring 产物无对拍基准,渲染冒烟闸是绕过原数据事故控制的唯一补偿——必须先于任何真库 dogfood。
  • net-new 标准层现由 AiLocalReleaseExecutor:158 裸 JDBC 旁路直写;新端点必须先把旁路收口为单一写函数,否则两套写法并存(语义/审计/etag 漂移)。

1. AI 合并交付对账(设计五环+横向 → 已交付 → 状态 → 剩余)

图例:🟢=主体已交付且无 P0 级剩余 | 🟡=部分交付/有 P0 级剩余(见右列)| 🔴=未起步。main 现位于 9aea6c1(fast-forward 纳入 AI 合并 bd4c642 + 3 收口 bac69d8/c379f5b/9aea6c1,全 reactor 10 模块绿)。

环/横向 已交付 状态 剩余(含 P0 标注)
横向·正确性门禁 TypedPageSchemaValidator + recipe 逐字节对拍 + 官方 draft-07,已接 putOverlay(分流后只对 AI 草稿严格) 🟡 [P0] 渲染冒烟闸未做(AiSmokeRunner 仅 HTTP 探针,playwright-render 无执行代码)= design fix#6 唯一补偿控制
①元数据 MetaController.createEntity + 动态 CREATE + 缓存失效 🟡 引擎不能 ALTER;L2 建模器 UI 无;仍克隆 SYS_USERGROUP 做载体
②表结构 createTableDdl(控制器内联) 🟡 ALTER 缺口;DDL 类型映射双份真相(与引擎漂移险)
③设计 recipe/blueprint 编译器(2 recipe)生成 amis 页;DesignerPage 改存量(分流后存量页可存 overlay) 🟡 DesignerPage 打不开(serving/env);net-new 正规写端点缺(走 AI 旁路);onEvent 声明式面板未做;recipe 仅 2
④实现功能 AiFeatureDraftGenerator 用保真层 DefaultFlowHelper 生成默认 5 服务流 🟡 无人工编排 UI;只默认流;无服务流语义级 gate
⑤发布 deployment-package + CLI release ops + feature-package/revision 快照 🟡 online apply 断档(人工跑 SQL);菜单注册未串端到端;净新标准行无删除/回滚路径
横向·CLI Eip4Cli(env/ai/release ops) 🟡 feature-package 为单元的 scaffold→dev→verify→release 生命周期未成型
横向·安全 admin 门 + localhost 门 🟡 check() 身份/scope 未织入写路径(等 CLI 身份模型)
横向·UI 底座(组件 L1) — 🔴 [P0] L1 主题 token 未起步(design §6 P0 锁定前置,D2);repo 无 token 资产

2. 有序里程碑

前置地基(design 锁定 P0,先于一切设计中心-facing 工作)

  • M0 组件设计体系 L1 主题 token 生产级[自主 build / 需 env 终验观感]:落 组件设计体系-design L1 主题层。D2 锁定前置 + 设计中心/设计器观感底座。M3b/M5 必须在 M0 后。
  • M-Gate 正确性门禁第二闸(渲染冒烟)[harness 自主 / 需 headless 终验]:Playwright/headless 对 previewUrl 真渲染断言(可视 + 无控制台报错),替 AiSmokeRunner HTTP 探针。design fix#6 唯一补偿控制——必须先于任何真库 dogfood(M2)。

先宽度(让 2 recipe + 设计器对存量 真端到端可用)

  • M1 Serving 解锁(A10)[配置部分自主 / 终验需 env]:(a) 修 stale vite 代理死端口 8084 + safeLocalBase 默认(可自主改配置);(b) 前端(含设计器)被真正托管 → DesignerPage 能打开(终验需 env)。先消 design §7 已定位的环境性根因。
  • M3a net-new 写路径收口(单一写真相)[自主 + TDD]:把 AiLocalReleaseExecutor:158 裸 INSERT sys_page_schema 改为调用唯一共享写函数(复用 typed 校验/审计/etag);PageSchemaController 加标准层写端点复用同一函数。验收 = sys_page_schema 写入只剩一个函数,无旁路裸 INSERT。收口先于新建入口。
  • M2 真库 dogfood(沙箱 schema)[需 env + admin creds]:AI 产 EIP4AI_净新 CRUD → 过三闸(含 M-Gate 渲染冒烟)→ 写一次性/沙箱 schema(非共享生产 PG) → 浏览器打开可用;附净新行清理/回滚脚本。前置 = M-Gate + M3a。
  • M3b 设计中心「新建功能」入口[前端,gated by M0 + M3a]:DesignCenterPage 加新建入口,走 M3a 共享写函数;设计角色细分(复用 RBAC)。
  • → 宽度闭环「建实体→生成默认页→设计器微调→发布」可演示(前置 M0/M-Gate/M1/M3a 全绿)。

再深度

  • M4 引擎 ALTER 安全通道 + DDL 单源[自主 build / 需 env 终验]:保真层白名单化 alterTableSql(只加列/扩长/改可空,改删走升级窗口)+ MetaController alter 端点 + 独立安全门;顺带把 createTableDdl 的第二份 DDL 类型映射收敛回引擎单源(消漂移)。
  • M5 onEvent 声明式面板(逻辑 b 主干第一块·design P3 硬骨头)[前端,gated by M0]:32 facade 动词配置面板。风险储备:design 标的最高不确定环(S3 自动化率 <80% 触发工期重估);20% 复杂逻辑保留「人工作业单」兜底(design fix#3),不进面板。
  • M7 recipe 扩面[自主 + TDD]:主子表/EditGrid/审批/组合 tabs recipe + 字段控件补 select/picker/input-tree/引用列(每种自带逐字节对拍基准)。
  • M8 CLI NocoBase 化 + 安全 Part2[design + code 自主]:feature-package 为单元 scaffold→dev→verify→release 生命周期(D6);「认证用户→AI employee→scope」映射 + check() 织入写路径。

3. 自主 vs 需环境(build 完成 ≠ 集成已证)

里程碑 可自主 build + unit-test 需 env/creds 终验
M0 L1 token 定义 token 层 生产级观感(浏览器)
M-Gate 渲染冒烟 Playwright harness 代码 真渲染断言(headless)
M1 serving 改 vite/8084 配置 托管 + 打开终验
M3a 收口 共享写函数 + 端点 + TDD —(纯写路径,集成在 M2 证)
M2 dogfood — 端到端(沙箱 PG + admin)
M3b 新建入口 端点接线 浏览器新建终验
M4 ALTER alterSql + 端点 + TDD 真 PG 在线加列证
M5 面板 面板代码 浏览器联动证
M7 recipe 编译器 + 对拍 TDD 渲染证
M8 CLI/Part2 命令 + 身份映射 + TDD 端到端证

纪律:M3a/M4/M7 的「完成」= code-complete, integration-pending;集成声明等 env 终验,不在绿单测上宣称端到端 done。

4. 下一步(已定,honest)

M3a — net-new 写路径收口为单一写真相(自主 + TDD,不依赖 env,不碰 L1-gated UI,收口 critic 点名的三真相旁路纪律)。其「完成」严格限 code-complete;端到端宽度价值待 M0/M-Gate/M1/M2 解锁后证。 M0(L1)与 M1(serving 配置)可并行起(L1 是 D2 锁定前置);M2/M3b/M5 的浏览器/真库终验等用户给登录方式。

5. Housekeeping

  • 本文 + design doc(补 D6/D7)commit 进 main。
  • main 现领先 origin/main 20 提交(AI 合并 + 3 收口),push = 用户决策(两仓需先 add remote 到私有托管,见 memory eip3-git-remotes-latentchat)。
  • worktree eip4-platform-ai-agent 已与 main 同 commit,可清理。

本文为活的执行计划;状态随里程碑落地回写。方向/决策权威见配套 design doc。