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,29 @@
-- ============================================================================
-- eip4-platform 平台表 SYS_PAGE_SCHEMA —— bootstrap-page-schema.sql
-- ----------------------------------------------------------------------------
-- 用途:页面 schema 服务化(P4-4)。把 platform-converter 的转换产物
-- (转换产物/schema/{view_template_id}.json,1489 个) 作为初始数据源导入,
-- 由 GET /api/page/schema/{templateId} 在线下发(amis SDK 直接渲染)。
--
-- 架构条款(docs/架构设计.md §「平台表管理」):SYS_* 平台表由 Flyway 管,业务表由引擎动态建。
-- 本工程当前尚未引入 Flyway —— 本次按「bootstrap SQL(本地/CI 自举) + 生产建表脚本
-- (docs/sql/SYS_PAGE_SCHEMA.sql) 落 docs」落地,Flyway 引入列 P5 待办
-- (见 platform-metadata/P4衔接-picker与schema接口报告.md「Flyway 待办」)。
--
-- 纪律:可重复执行(CREATE TABLE IF NOT EXISTS / DROP INDEX IF EXISTS);
-- 表名/列名一律小写(PG 不区分大小写,引擎与现代层 SQL 大小写混用,小写建库两侧皆命中)。
-- schema 列用 jsonb(amis 页面 schema 不小,jsonb 便于校验/索引,且导入侧用 ::jsonb 强校验 JSON 合法)。
-- ============================================================================
CREATE TABLE IF NOT EXISTS sys_page_schema (
template_id character varying(64) NOT NULL, -- view_template_id(转换产物文件名去 .json)
name character varying(255), -- 模板名称(取自分级清单.csv,便于运维检索)
schema_json jsonb NOT NULL, -- amis 页面 schema(顶层 type:page)
schema_etag character varying(64) NOT NULL, -- schema_json 的内容指纹(sha-256 hex),用于 HTTP ETag/304
version integer NOT NULL DEFAULT 1, -- 单调递增版本(同模板重导入 +1)
update_time bigint NOT NULL, -- epoch 毫秒(与引擎 DATE 列同口径)
CONSTRAINT pk_sys_page_schema PRIMARY KEY (template_id)
);
-- 按名称检索(运维/联调按模板名找 templateId)
CREATE INDEX IF NOT EXISTS idx_sys_page_schema_name ON sys_page_schema (name);