切换主题
Application UI
适用范围:Legacy Admin Kit / Schema 与旧
admin-vue。新admin-nuxtui的开发入口见管理端 Nuxt UI 指南。
Application UI 说明一个完整管理任务如何由公共组件和既有 runtime 组成。它回答“这个任务应该用哪种 composition、状态归谁、feature 需要提供什么”,不重复单个组件的 props 表。
仓库外消费者从 External Consumption 安装同步版本的 Core / Schema / Kit;本目录只解释任务级 composition。
Core Compositions
| 任务 | Public surface | 适用场景 |
|---|---|---|
| Page Frame | YPageContainer + YPageHeader | 普通管理页面的空间、标题与页面级动作 |
| Auth Task | AuthLayout + YAuthTaskSurface | 登录、找回、重置、注册与首次改密 |
| Editor Task | YEditorPanel + YTaskActions + YModal/YDrawer | Create/Edit、权限、恢复与 feature 配置任务 |
| Data Workbench | LegacyYDataTable + Data Workbench | 查询、筛选、选择、批量、分页与行任务 |
| Data Selection Task | YDataSelectionTask + LegacyYDataTable | 远程分页候选的显式多选与确认 |
| Settings Composition | Page Frame + YTabs + YFormSection/YFormGrid/YSettingRow | 个人与系统设置的分类、说明和响应式字段布局 |
成熟度与暂缓边界见 Application UI 成熟度矩阵。
文档内交互示例覆盖 Editor Task、Data Selection、Settings、SchemaForm 与 Data Workbench;示例复用正式组件并展示同源代码,不复制宿主业务页、DTO 或状态机。文档演示只说明组合用法,真实操作的权限、提交与回读仍由消费者证明,验证维度见组件成熟度矩阵。
正式业务页面如何复用这些 composition、哪些独特布局应保留,以及当前页面分类与碰撞边界,见 Real-page Adoption。
完成任务构图选择后,继续阅读 Schema / Data Workbench Authoring,从后端事实、Page Schema 与 CLI 建立正式业务页面。
Owner 原则
text
feature / runtime authoritative state
↓ explicit input / event / slot
shared Application Composition
↓
public Y* components- Composition 拥有重复的页面和任务 anatomy、响应式关系与公共状态呈现。
- Data Workbench、Form、Permission、route、challenge、datasource、mutation、dirty/busy、session 继续由现有 owner 持有。
- Feature 提供业务 input、权限与动作实现,不复制 header、task footer、discard、loading/error/empty 等公共结构。
- 文档中的 consumer path 是架构证据;路径或 public surface 改变时,intent test 会要求同步复核。
明确不做
- 不把 Application UI 做成 universal page DSL。
- 不在文档站复制 production runtime、Schema、Data Workbench 或 demo-only component。
- 不为凑齐目录制造 feature consumer。
- Dashboard 与 Shell 尚未进入本轮 Productized core,按成熟度矩阵继续使用现有 owner。