Files
eip4-platform/docs/P1/P4收口简报.md
zhengwr 1b69f8b481
Some checks failed
ci / build-test-parity (push) Has been cancelled
docs: 统一项目文档进 eip4-platform/docs + 新增进度路线总览
- 从工作区根 docs/(非 git,未版本化)合并全部文档进版本控制,消除文档两头分裂
- 新增 README(状态总览+模块完成度+全文档索引)、项目进度与路线-总览-2026-06-17(A兼容/B新功能+关键路径+待拍板决策)
- 被取代的冲突状态/审计快照归入 归档/;对最易误导的两份("16视图已交付"实现交付报告、06-13架构快照)加"已归档"横幅
- 现行权威:engineclass移植backlog(46视图) + 用户管理Delta移植(方法论/交接) + 组件设计体系 + 通用模板收口 + 客户沟通
- 诚实口径:纵向模块仅用户管理 parity,横向引擎地基较全,余 153 定制视图(47 framework+106 业务)多为通用页已产·delta 未移植

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-17 14:53:29 +08:00

53 lines
3.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# P4 收口简报(前端与迁移工具链 + 只读切流端到端链路)
> 2026-06-11 | 接《P4中期简报》| 三主线 + 四衔接缺口全部交付,只读切流端到端链路闭合
> 仍暂缓(人工/客户依赖):153 重写、JOR C 类、editor 二开、27 孤儿模板定性
## 一、衔接四缺口(本轮)
| # | 项 | 结果 | 证据 |
|---|----|------|------|
| P4-4 | /api/picker + schema 接口 | picker 数据源端点(过白名单+行级权限,注入负例 400/转义)+ `GET /api/page/schema/{id}`(1,489 产物入 SYS_PAGE_SCHEMA,ETag/304);前端切 `VITE_SCHEMA_SOURCE=backend` 渲染实证 | `platform-metadata/P4衔接-picker与schema接口报告.md` |
| P4-5 | 脚本挂回 onEvent 重放 | 转换器注入 onEvent→`/api/script/execute-template`(按 templateId/seq 读改写产物,**无脚本注入面**)→前端 runActions 重放 29 UI 动词;2 真实模板端到端(字段隐藏/服务端数据闭环) | `tools/s3_rewriter/P4脚本挂回实测报告.md` |
| P4-6 | 待办→业务页映射 | tablename→entityid→templateid(EDITFORM 表单优先);真实待办带 pageUrl 与客户库直查一致;Caffeine 缓存 | `platform-flow-gateway/P3网关实测报告.md` P4-6 节 |
## 二、只读切流端到端链路(闭合)
```
登录(JWT)→ 待办列表(/api/todo 带 pageUrl)→ 点击进业务页
→ schema 接口取转换产物(/api/page/schema/{id})→ amis 渲染
→ 列表取数(/api/entity/{t}/list,行级权限)→ 选择窗联动(/api/picker)
→ 交互触发脚本(onEvent→execute-template→指令重放)
```
各环节均有本地实证(playwright);这是检查点②"首批只读功能点切流"的完整技术底座。
## 三、本轮两个关键发现(进性能/安全清单)
1. **新注入点(安全)**:`GeneralPO.java:1940` 对字符串过滤值**裸拼**进 `col like '%值%'`,无参数绑定——架构第四节"值位置经 StringUtil 转义已挡最低级注入"的判断**在 LIKE 搜索路径上不成立**。picker/list 入口已在现代层转义兜底,但根治须纳入 P2 渐进参数化清单的 LIKE 路径项(原清单未单列)。
2. **dialogid 契约修正(架构认知)**:SelectDialog 的 dialogid = view_template_id(弹窗列表模板),非 SYS_REFERENCE_ID;数据源实体在该模板 XML 根 `@entityid`。后端解析消化,937 模板产物零改动。
## 四、检查点② 就绪度评估
| 维度 | 状态 |
|------|------|
| 页面转换 | 闸一 98.2%(1,489 产物已服务化) |
| 只读取数 + 行级权限 | P1/P2 已验,picker 补齐选择窗 |
| 脚本交互 | facade-only 296 条可直接挂回;115 人工作业单并行 |
| 前端宿主 | 端到端通,Nginx 可托管 |
| **结论** | **只读类功能点切流的技术链路就绪**;切流执行需走决策会七条红线 + 客户签字矩阵(非技术动作) |
## 五、剩余工作(全是人工/客户依赖,技术线已尽)
| 项 | 卡点 |
|----|------|
| 153 视图重写(13 个) | Q1:106 addon 源码归属(阻塞)+ Q2:S1 止损决策 |
| JOR C 类(45 模板) | 客户文件系统侧清点 |
| 27 孤儿模板 / 58 零引用视图 | 客户/老员工定性 |
| 11 引擎缺陷(P1) | 旧系统同病验证 |
| editor 二开 | 排期项,P4/P5 后段 |
| 检查点①② | 决策会评审 + 商务开放项 1/3 |
## 六、累计口径
模块 10、单测 ~300 全绿、迁移手册至 §8.9、eip4-platform 42 提交 + eip4-web 仓库、阶段简报六份(M0/P1/P2/P3/P4中期/P4收口)。SYS_PAGE_SCHEMA 是首张"现代层平台表"(Flyway 管理列 P5)。