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 毫秒';