Commit the architecture-direction design doc (D1-D7 locked decisions) and add a companion living execution roadmap reconciling the design with the already-merged AI agent module (main 9aea6c1): phase-by-phase delivery account + ordered milestones (M0 component L1 -> render-smoke gate -> 先宽度 M1/M3a/M2/M3b -> 再深度 M4/M5/M7/M8), split autonomous-build vs env-verification.
Roadmap revised after adversarial review: restored the D2-locked P0 prerequisite (component L1), moved the render-smoke correctness gate ahead of real-DB dogfood, split net-new write-path convergence ahead of the new endpoint, marked code-complete vs integration-pending.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
77 lines
8.1 KiB
Markdown
77 lines
8.1 KiB
Markdown
# 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 / git.latent.chat,见 memory `eip3-git-remotes-latentchat`)。
|
||
- worktree `eip4-platform-ai-agent` 已与 main 同 commit,可清理。
|
||
|
||
---
|
||
|
||
*本文为活的执行计划;状态随里程碑落地回写。方向/决策权威见配套 design doc。*
|