认识 Yoyo Admin

Yoyo Admin 是基于 YoyoBoot 的全栈管理应用开发方案：包含 Vue / Nuxt UI 前端、ASP.NET Core 后端、认证与租户等平台接线，以及真实管理功能的实现。它不是只有界面的模板，也不要求开发者从 Button 开始维护自己的通用组件库。

你可以先运行独立前端模板了解页面组合，再运行真实应用体验登录和数据保存。新功能使用 Nuxt UI、公共管理交互和业务服务；Kit/Schema 的作者流程保留给旧 admin-vue 消费者，不作为新项目的默认步骤。

它与你的项目有什么关系

你需要什么	Yoyo Admin 提供的起点	仍由你的项目决定
一套前端管理界面	独立 Starter、Nuxt UI 布局和示例	自己的导航、业务信息和后端接线
一个含真实后端的后台应用	管理 API、生成客户端、共享会话和新前端宿主	环境、业务规则、账号配置和实际交付范围
少写重复管理交互	List、任务面、Tree、反馈与无 UI 平台合同	业务字段、API、权限和写入；旧配置化能力按技术线单独选择
团队和 Agent 协作开发	明确的合同来源、生成入口、验证脚本和代码参考	业务需求、代码审查与最终产品验收

本方案适合需要管理账号、角色、租户及自己业务数据的团队。它不承诺零配置生产部署、所有管理模块都已迁入新界面，或无需领域设计即可自动生成完整业务。

三份内容，不是三套重复系统

前端 Starter

templates/admin-nuxtui-starter/ 是可独立运行的前端起点，基于官方 Dashboard Vue 模板整理。布局、控件组合与演示数据帮助开发者理解应用结构；示例操作不代表真实登录、授权或数据库写入。

Starter 没有 ABP 和共享平台运行时依赖。创建项目后独立演进，不在运行时导入模板目录，也不要求与上游同步全部示例页面。来源和本地采用说明在模板的 UPSTREAM.md。

真实管理应用

apps/yoyo-admin/admin-nuxtui/ 使用 Vue + Vite + Nuxt UI，连接 apps/yoyo-admin/aspnet-core/ 的真实后端。Nuxt UI 是组件基础；使用它不意味着本应用采用 Nuxt 全栈框架。

应用的 shared/abp 接入生成 API 与平台会话，bootstrap 组合 Vue、路由和导航；共享 @yoyoboot/yoyo-admin-core 提供认证、配置、权限与本地化等无 UI 合同。页面按业务放在 app，appLayout 承接外壳，ui-patterns 提供管理交互。

按需复用的开发能力

packages/yoyo-admin/admin-schema/ 和 tools/yoyoboot-cli/ 保留配置化管理页的作者能力；旧 Admin Kit 仍服务已有消费者。新 Nuxt UI 页面不必经过全部旧包装，也不应为了迁移把整套 Kit 改名复制。

公共包是否提取，由真实复用决定。单页特有逻辑先留在 feature 中；已经正确的认证、校验与业务规则优先复用。

后端不是一个需要另找的示例服务

当前管理后端基于 .NET 10、ASP.NET Core 和仓库的经典 ABP 兼容体系，实际运行与迁移使用 PostgreSQL。它提供业务应用服务及权限、租户、校验和持久化接线，不只是把前端请求转发出去。

例如，计量单位页面保存名称时，服务端会检查 Edit 权限、重新读取记录、拒绝通过该输入修改编码或启用状态，并将合法名称写入数据库。前端再请求当前记录和列表，确认实际结果。完整步骤见计量单位名称编辑。

后端功能存在，不等于新宿主已经提供所有相应页面。能力总览区分平台、后端模块、新 UI 和参考实现，避免把接口数量当成最终产品能力。

与 YoyoBoot 的关系

YoyoBoot 是框架、模块、工具和模板的平台；Yoyo Admin 是其中的管理应用产品与全栈组合。 YoyoBoot 还服务其他应用，不能把管理端的菜单、页面或特定业务放进最底层框架。

框架说明见框架入口；本产品的使用入口见Yoyo Admin 总览。使用指南从采用者视角说明用法，不另行定义框架架构。

工程传承与品牌 / Engineering roots and brand

YoyoBoot 的前身是 52ABP，这一传承关系由项目发起人确认。梁桐铭的著作《深入浅出 ASP.NET Core》与 52ABP 创始人身份有公开出版介绍；这些经历提供技术与教学背景，不代表出版机构为 YoyoBoot 背书，也不推定旧版本全部兼容。

品牌与历程提供产品关系、历史与出处；架构总览解释母品牌、管理产品、前后端和开发工具的关系。

开始之前应当知道

• 新前端正在逐项承接旧 admin-vue 的有效能力；旧应用是参考和迁移来源，不是另一条新 UI 开发主线。
• 新宿主采用当前 Starter 的 Nuxt UI 视觉，额外控件按实际缺口评估，不承诺同时支持多套基础 UI。
• 当前源码通过 file: 使用 admin-core / ui-patterns，安装前先构建公共包；独立采用须提供匹配制品，不能把本地版本当成 registry 已发布版本。
• 人工设计确认、自动测试通过、真实业务验收与发布互不替代。使用范围看当前实现和对应说明，不以模板演示推断全部业务完成。

下一步

从快速开始选择前端模板或前后端应用；已有环境后，跟随全栈教程找到一次真实保存的每一层代码。需要理解页面开发取舍时，再读核心理念与优势。