切换主题
Schema / Data Workbench Authoring
适用范围：Legacy Admin Kit / Schema 与旧
admin-vue。新admin-nuxtui的开发入口见管理端 Nuxt UI 指南。
本指南把后端事实、Page Schema、Data Workbench、Application UI 与 CLI 串成一条可执行的管理页作者路径。它是导航 owner，不复制各层完整 contract；语义仍由对应 package、generated catalog 和 feature owner 持有。
开始前建议依次阅读 组件 与 Application UI，再从本页选择 authoring lane。
仓库外项目还应先完成 External Consumption 的 runtime 安装，并遵守同步版本合同；本指南不复制 package/release 状态。
路径选择
| Lane | 何时选择 | 作者入口 | Runtime |
|---|---|---|---|
| Standard CRUD | generated resource 已证明 standard-crud compatible，页面是常规目录型 CRUD | CLI 生成结构，再补 schema.ts 产品语义 | Standard Management Runtime → LegacyYDataTable |
| Advanced CRUD | 需要 typed editor、row overlay、remote option、业务 command | 手写 canonical crud-ex Page Schema、registry 与 typed binding | Data Workbench → LegacyYDataTable |
| Custom Data Workbench / Query | 仍属于查询/表格/动作/详情组合，但不满足 standard-crud recipe | 直接使用公开 Schema/Data Workbench contract | Data Workbench → LegacyYDataTable |
不存在第四套 feature-local page runtime。CLI 没有 recipe 时，也不能退回裸 endpoint、手写分页状态或新的 JSON/DSL。
Authoring surface inventory
| Surface | 唯一 owner | 作者使用方式 | 不拥有 |
|---|---|---|---|
| Page Schema / compiler / normalized IR | @yoyoboot/yoyo-admin-schema | defineYoyoQueryPage、compileYoyoPageSchema | DTO、URL、授权结果、运行时 state |
| Resource / permission / action / validation catalog | 对应后端 exporter 与 generated edge | 用 CLI inspect 或 package public catalog 读取 | 页面展示与业务命名选择 |
| Feature binding / adapter | Admin Vue feature | 将 generated DTO/wire 映射到 datasource、typed extension | 通用 Data Workbench 状态机 |
| Data Workbench | Admin Kit LegacyYDataTable 与 Data Workbench runtime | 消费 compiled IR、datasource 和显式 capabilities | 第二份 Page Schema |
| Application UI | Page Frame / Editor Task / Data Workbench owner | 选择任务构图 | query、mutation、permission state |
| CLI | @yoyoboot/cli | 发现 capability、检查事实、生成稳定标准结构 | identity/headline、查询语义、renderer、复杂业务 extension |
| Verification | 各 package/host owner scripts | 运行最小受影响验证 | 平行 authoring CI |
Reference 不是 owner
- Measuring Unit 展示 Standard CRUD 从 skeleton 到 product-content-ready 的差异。
- Identity Users / Roles 展示
crud-ex、typed extension 与业务 binding。 - Product Catalog 展示有 provenance 的 fixture Data Workbench；Tenant Management 展示正式 production binding。
这些页面用于定位可运行模式，路径变化会触发 drift review，但不会变成新的公共 Schema 或 runtime owner。
AI 与 CLI 边界
人类、AI 和 CLI 使用同一套官方文档、machine-readable capabilities、generated catalogs 与 public package contract。当前不提供 AI-specific prompt bundle、context package、专用 Schema 或 autonomous page generator；AI 不能通过提示约定发明 permission、endpoint、renderer 或 workflow。