# Skill: eip4-page-recipe ## 触发场景 - 用户要为某实体生成默认页面(维护 / 树 / 主子表)。 - 需要派生列、父级汇总。 ## recipe 类型 - `maintenance-crud` — 普通维护 CRUD(列表 + 表单)。 - `tree-crud-v1` — 树形维护(有 parentid 的层级表)。 - `master-detail-v1` — 主子表(主表 + 子表行内编辑)。 ## 端点 编译生成默认页:`POST {{EIP4_BASE_URL}}/api/design/recipe/compile` ```json { "tableName": "EIP4_DEMO", "title": "演示页面", "recipe": "maintenance-crud", "pageSize": 20, "displayField": "NAME", "childTable": "DEMO_DETAIL", "linkColumn": "MASTERID", "childDerived": [{"column": "AMOUNT", "formula": "QTY*PRICE"}], "childRollup": [{"masterColumn": "TOTAL", "childColumn": "AMOUNT", "agg": "SUM"}] } ``` - `childTable` / `linkColumn` 仅 `master-detail-v1` 需要;`childDerived` / `childRollup` 可选。 - 生成流程:读实体属性 → 装配编译 → typed schema 严格校验(不过则 400)→ 落标准层(页面唯一真相)。 - 返回 `data.templateId`。 查可用 recipe(经 AI 链路):`GET {{EIP4_BASE_URL}}/api/ai/page-recipes`。 校验页面 schema(不写库):`POST {{EIP4_BASE_URL}}/api/page/schema/validate`。 组件能力表:`GET {{EIP4_BASE_URL}}/api/page/schema/components`。 ## 红线 - schema 只能使用注册过的组件 / 动作;typed 校验会拒未注册组件或不支持的 actionType。 - 生成 = 落标准层;设计器 overlay 在其上叠加,二者共用同一份 typed schema 校验。