P4-4: picker 选择窗数据源 + page schema 服务化两端点

- PickerController GET /api/picker/{entityOrRef}/list?q&page&perPage:
  契约定稿——dialogid 实为 view_template_id(侦察客户库纠偏,非 SYS_REFERENCE_ID),
  按 view_template根@entityid → ref → 直连实体表名三级解析;全入参过 P1-3 白名单,
  搜索值转义防 LIKE 裸拼注入,行级权限 ctx 三级优先(与 EntityController 同口径);
  返回 amis options/CRUD 双格式。转换器 source 生成零改动(契约对接落后端解析)。
- PageSchemaController GET /api/page/schema/{templateId}:带 ETag/304,404/503;
  与 eip4-web VITE_SCHEMA_SOURCE=backend 联调渲染通过。
- SYS_PAGE_SCHEMA 平台表(bootstrap SQL + 生产 DDL 落 docs,Flyway 引入列 P5);
  SchemaImportCli 把 1489 个转换产物幂等入库(etag=sha-256)。
- 单测 +19(picker 9/schema 7/导入 3),全模块 mvn install + ArchUnit 绿。
- 新坑进迁移手册 §8.7(dialogid=view_template_id)/§8.8(GeneralPO LIKE 裸拼)/§8.9(SYS_PAGE_SCHEMA)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-06-11 17:08:59 +08:00
parent 082b439179
commit e49b39f0cf
12 changed files with 1436 additions and 0 deletions

View File

@@ -0,0 +1,35 @@
-- ============================================================================
-- 生产建表脚本:SYS_PAGE_SCHEMA(平台表)
-- ----------------------------------------------------------------------------
-- 归属:platform-metadata(页面 schema 服务化,P4-4)。
-- 契约:GET /api/page/schema/{templateId} 的下发数据源。
--
-- 【Flyway 待办(P5)】
-- 架构条款(docs/架构设计.md §「平台表管理」):SYS_* 平台表由 Flyway 管理。
-- 本工程当前未引入 Flyway。本脚本即「生产建表脚本」,P5 引入 Flyway 时
-- 原样改名为 V{n}__create_sys_page_schema.sql 纳入 src/main/resources/db/migration 即可
-- (内容无需改动,故此处保持 Flyway 友好:单条幂等 DDL,无数据)。
-- 本地 / CI 自举副本见 platform-metadata/src/main/resources/bootstrap/bootstrap-page-schema.sql。
--
-- 初始数据导入(1489 个转换产物)由 SchemaImportCli 批量入库,不在本 DDL 内。
-- ============================================================================
CREATE TABLE IF NOT EXISTS sys_page_schema (
template_id character varying(64) NOT NULL,
name character varying(255),
schema_json jsonb NOT NULL,
schema_etag character varying(64) NOT NULL,
version integer NOT NULL DEFAULT 1,
update_time bigint NOT NULL,
CONSTRAINT pk_sys_page_schema PRIMARY KEY (template_id)
);
CREATE INDEX IF NOT EXISTS idx_sys_page_schema_name ON sys_page_schema (name);
COMMENT ON TABLE sys_page_schema IS '页面 amis schema 服务化存储(platform-converter 转换产物入库)';
COMMENT ON COLUMN sys_page_schema.template_id IS 'view_template_id(转换产物文件名去 .json)';
COMMENT ON COLUMN sys_page_schema.name IS '模板名称(取自分级清单.csv)';
COMMENT ON COLUMN sys_page_schema.schema_json IS 'amis 页面 schema(顶层 type:page),已过官方 schema.json 校验闸';
COMMENT ON COLUMN sys_page_schema.schema_etag IS 'schema_json 内容指纹(sha-256 hex),HTTP ETag/304 用';
COMMENT ON COLUMN sys_page_schema.version IS '单调递增版本(同模板重导入 +1)';
COMMENT ON COLUMN sys_page_schema.update_time IS 'epoch 毫秒';

View File

@@ -689,6 +689,33 @@ com.dsasp.* com.eip4.*
| **对策** | P4-5 实装把 `/api/script/execute-template` 改为接受 `{templateId, seq, item}`(RequestBody),后端 `RewrittenScriptStore` 按 `(tid,seq)` 从改写产物取脚本正文执行;原「按模板名取库内 XML 脚本」端点路径区隔为 `/api/script/execute-template-by-name`(保留 P4-2 兼容)。转换器 `attachScriptOnEvent` 生成的 onEvent 即调前者,`item:${&}` 传当前全量表单数据作脚本上下文。出入点已回写报告第五章 |
| **影响范围** | `platform-metadata` ScriptExecuteController + RewrittenScriptStore;`platform-converter` TemplateToAmisConverter.attachScriptOnEvent;改写产物落盘根经 `eip4.script.rewritten-root` 配置(默认 `tools/s3_rewriter/output/rewritten`),部署须确保改写产物随应用可达 |
### 8.7 SelectDialog 的 dialogid = view_template_id(弹窗数据源解析口径坑,picker 端点契约)[NEW 2026-06-11]
| 栏目 | 内容 |
|------|------|
| **现象** | P4-4 实现 `/api/picker/{dialogid}/list` 选择窗数据源端点时,初判 `dialogid` 是 `SYS_REFERENCE_ID`(拟经 `DataDicServiceImpl.getReferenceEntityTableName` 反解实体表名)。侦察客户库实测:244 个真实 picker dialogid **全部在 `sys_reference` 反解失败(0 命中)** |
| **根因** | 旧引擎模板 XML 里 `SelectDialog`/`MultiSelectDialog` 字段的 `dialogid` 属性,取值是一个 **`view_template_id`**——即「弹窗用哪个列表模板渲染」,**不是** SYS_REFERENCE_ID。被引用模板的 XML 根元素(`<crud entityid="...">` 等)携带 `entityid`,那才是弹窗数据源实体。实测 5 个高频 dialogid 经此路径解析到 PM_PROJECT/SYS_ORG/VIEW_SYS_USER 等真实实体 |
| **对策** | picker 端点 `resolveTable` 按优先级解析:① `view_template_id` → 读其 `xml::text` 根 `@entityid` → `DataDicService.getSYSEntity(entityId).getPo().get_Value("TABLENAME")`(主路径,覆盖全部存量 source);② 退化 SYS_REFERENCE_ID 反解(兼容旧引用语义);③ 退化直接实体表名。三路任一解析出的表名都过 P1-3 白名单。**契约与转换器产物对得上靠此解析路径,转换器 source 生成(`/api/picker/{dialogid}/list`)零改动**(dialogid 即模板里原样的属性值) |
| **影响范围** | `platform-metadata` PickerController;任何按 SelectDialog 语义做数据源解析的地方;PG `xml` 列须 `xml::text` 取出再 dom4j 解析(见 §5.33);本地 M0 库 `view_template` 是裁剪 stub(无 `xml` 列),端点对 `DataAccessException` 兜底返回 null 走退化路径,不崩 |
### 8.8 引擎 GeneralPO 对 String 查询条件裸拼 `col like '%值%'`,picker 搜索须转义防注入 [NEW 2026-06-11]
| 栏目 | 内容 |
|------|------|
| **现象** | picker/entity 列表端点把前端搜索值下推为引擎查询条件(`cond.put(列名, 值)`)时,String 列的值进了一个 **字符串拼接的 LIKE** 子句 |
| **根因** | `GeneralPO.get_searchWhereWithPrefix`(GeneralPO.java:1940-1941)对 `clazz==String.class` 的条件值直接 `sb.append(columnName + " like '%" + obj.toString().trim() + "%'")`——**裸拼,无参数绑定**。列名侧已由 P1-3 白名单守(元数据即白名单),但**值侧**是注入面:值含单引号即可闭合字符串字面量注入 |
| **对策** | picker 端点对搜索值 `q` 先过 `escapeLikeValue`:单引号双写(`''`,闭合引擎拼接的字面量防注入)、LIKE 通配符 `%`/`_` 与反斜杠剔除为空格(引擎 LIKE 无 ESCAPE 子句,无法转义,降级为「不可作通配」优先保安全)。实测 `?q=' OR 1=1--` 返回 200 空结果而非 500/注入。**列名仍走白名单,值走转义,双管**。注:EntityController 的 amis filter 值侧同样经此 sink,P5 可考虑统一在引擎外包一层值转义工具(本期 picker 先落地) |
| **影响范围** | `platform-metadata` PickerController.escapeLikeValue;EntityController 的 filter 值透传(同 sink,P5 统一);任何把用户输入下推为引擎 String 查询条件的端点 |
### 8.9 SYS_PAGE_SCHEMA 平台表本期 bootstrap+生产脚本落地,Flyway 引入列 P5 [NEW 2026-06-11]
| 栏目 | 内容 |
|------|------|
| **现象** | P4-4 schema 服务化需建平台表 `SYS_PAGE_SCHEMA`(templateId/schema_json/etag/version/update_time)存 1489 个转换产物。架构条款(架构设计 §「平台表管理」):SYS_* 平台表由 Flyway 管。但本工程当前**尚未引入 Flyway** |
| **根因** | Flyway 引入是独立工程动作(依赖 + `db/migration` 目录 + baseline 策略),不应在单个功能 P4-4 内顺带引;强行引会与「业务表引擎动态建、不进 Flyway」的边界产生迁移基线划界问题,须单独决策 |
| **对策** | 本期按「bootstrap SQL(本地/CI 自举)+ 生产建表脚本落 docs」落地:①`platform-metadata/src/main/resources/bootstrap/bootstrap-page-schema.sql`(`CREATE TABLE IF NOT EXISTS`,幂等,本地/CI psql 灌);②`docs/sql/SYS_PAGE_SCHEMA.sql`(生产建表脚本,注释里写明 P5 引 Flyway 时原样改名 `V{n}__create_sys_page_schema.sql` 即可,DDL 无需改);③导入 CLI `SchemaImportCli` 启动时 `CREATE TABLE IF NOT EXISTS` 兜底。**Flyway 引入列 P5 待办** |
| **影响范围** | `platform-metadata`;P5 引 Flyway 时把 `docs/sql/*.sql` 收编为 migration;schema 接口 `GET /api/page/schema/{templateId}` 带 ETag/304(etag=schema_json 的 sha-256,入库时算),amis schema KB 级,304 省重复下发 |
---
## 九、待补章节占位