跳转正文

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 FrameYPageContainer + YPageHeader普通管理页面的空间、标题与页面级动作
Auth TaskAuthLayout + YAuthTaskSurface登录、找回、重置、注册与首次改密
Editor TaskYEditorPanel + YTaskActions + YModal/YDrawerCreate/Edit、权限、恢复与 feature 配置任务
Data WorkbenchLegacyYDataTable + Data Workbench查询、筛选、选择、批量、分页与行任务
Data Selection TaskYDataSelectionTask + LegacyYDataTable远程分页候选的显式多选与确认
Settings CompositionPage 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。

YoyoBoot · 从真实项目走向可复用能力