能力总览与采用范围

本页帮助你判断该从哪里使用 Yoyo Admin，而不是列一张“所有功能均已完成”的宣传清单。后端已有实现、新前端已有接线、产品体验已验收和正式发布是不同状态。 外壳及各业务模块的详细进度由对应 OpenSpec 管理，本页不复制任务百分比。

适用对象是当前源码中的 admin-nuxtui、独立 admin-nuxtui-starter 和同仓管理后端。旧 admin-vue 的功能不能自动算作新宿主已经支持。

先按使用目标选择

目标	提供什么	范围与限制
体验前端模板	布局、导航、首页/客户/设置等示例及演示数据	无 ABP 依赖；示例操作不代表后端持久化
运行真实管理应用	新 Nuxt UI 宿主、共享会话、真实管理 API	需要后端、PostgreSQL 和已构建的 admin-core / ui-patterns；不是全部业务已迁移
直接开发普通页面	Nuxt UI 控件、已有业务服务和平台上下文	应用自己组织页面与业务意图，不强制完整 Schema
维护旧配置化管理页	已有 Schema/compiler、生成合同与 CLI 作者入口	供既有 Kit/Schema 消费者使用；旧 recipe 不自动适配新 Nuxt UI 宿主
只使用公共包	当前包的公开入口与兼容说明	查阅 External Consumption，本地制品不等于 registry 发布

前端与平台能力

以下路径相对于仓库根目录，可在源码中定位；应用使用入口见快速开始。

能力	当前可定位的实现	使用时要注意
布局、菜单、页签与偏好	`apps/yoyo-admin/admin-nuxtui/src/appLayout`、`router`、`navigation`	按当前页面和人工验收判断，不把规划选项当成已可用
账号密码认证、配置恢复与续期	新宿主 `src/shared/abp`；`packages/yoyo-admin/admin-core`	普通 Host/租户登录已有接线；额外认证与完整 Account 范围单独核对
权限与 Feature 的前端使用	新宿主 Session、navigation 与平台返回配置	前端控制入口，后端仍然授权；隐藏菜单不是安全边界
计量单位查询、名称编辑与回读	新宿主 `src/app/basic-data/measurement-units`	较小的全栈参考；其他 CRUD 动作以当前业务合同和实现为准
用户、角色与组织管理	新宿主 `src/app/identity/users`、`roles`、`organization-units`	已有真实业务源码与回归入口；当前仍需范例对齐和人工复核，不宣称全站签收或正式发布
页面定义与作者工具	`packages/yoyo-admin/admin-schema`、`tools/yoyoboot-cli`	Schema/Kit recipe 服务旧技术线；新 Nuxt UI 页面使用现有公共交互与 Feature API 接线
旧管理任务与组件	`packages/yoyo-admin/admin-kit`、旧 `admin-vue`	为实际旧消费者保留；不因为旧矩阵标为成熟就强制新页面使用

包含的后端能力

后端根目录为 apps/yoyo-admin/aspnet-core/。表中的位置用于查实现，不是对整批新 UI 或所有业务流程的完成承诺。模块的字段和操作说明从功能模块进入。

能力	后端位置（相对于后端根目录）	与新宿主的关系
用户、角色	`src/Yoyo.Admin.Application/Identity/Users`、`Identity/Roles`	新 Host 已有列表、编辑、权限等真实接线；字段、动作与采用差异以业务模块为准
组织机构	`src/Yoyo.Admin.Application/Organizations`	新 Host 已有树、成员/角色和节点任务；UI 对齐与人工验收不由后端接口存在代签
多租户与租户管理	`src/Yoyo.Admin.Application/MultiTenancy/Tenants`；实体及租户上下文在 Core	登录租户上下文与租户管理页面是不同功能；前端不得自行换租户绕过限制
Host/租户设置	`src/Yoyo.Admin.Application/Configuration/Host`、`Configuration/Tenants`	系统设置不等于浏览器内的“界面偏好”
审计与通知	`src/Yoyo.Admin.Application/Auditing`、`Notifications`	通知摘要、已读操作和通知管理页分别接入；不使用模板未读数冒充真实状态
版本与订阅	`src/Yoyo.Admin.Application/MultiTenancy/Subscription`	有服务实现不等于所有支付环境、续订路径和新 UI 均已验收
计量单位	`src/Yoyo.Admin.Application/MeasuringUnits`；`src/Yoyo.Admin.Core/BasicData/MeasuringUnits`	可沿名称编辑教程追踪已接入的读写路径
持久化与数据库迁移	`src/Yoyo.Admin.EntityFrameworkCore`、`src/Yoyo.Admin.Migrator`	实际运行使用 PostgreSQL；SQLite 集成测试不能替代 PostgreSQL 迁移验证
OpenAPI 与输入校验	Web.Host 的 OpenAPI 配置、应用 DTO 和领域输入规则	前端由唯一客户端生成边缘消费，不手工维护第二套合同

接口、应用和 UI 分别负责什么

text

后端应用服务与领域规则
        ↓ OpenAPI / 能力及动作合同
唯一生成客户端
        ↓ typed 请求与结果
宿主的平台接线、业务 service 与编辑任务
        ↓ 当前状态与可执行操作
Nuxt UI 页面

应用请求所需的令牌与租户来自会话；后端对每次操作做最终授权和范围控制。页面可以提前提示输入问题，但不能把前端校验当作服务端校验的替代。

权限、菜单配置不满足时说明缺什么、在哪里配置；不自动授予权限、不猜测相近权限，也不因为示例需要顺利运行就隐式修改业务配置。用户已经明确执行的动作，其事务与数据安全由系统保证。

如何判断一项能力可以采用

先确认需要的后端操作与生成合同，再确认新宿主是否有相应页面，最后核对该操作的实际验证范围。源码、自动测试、真实浏览器体验与发布记录各自证明不同内容。

新外壳的范围在 openspec/changes/migrate-yoyo-admin-nuxtui-shell-and-experience/；业务沿 migrate-yoyo-admin-abpzero-* 模块 change 推进。它们是仓库内维护入口，不是普通用户必须学习才能启动的前置工具。

新项目先运行前端或全栈入口。要评估开发成本，可先完成名称编辑教程，再决定哪些能力适合复用，不先按目录数量拆包。

能力总览与采用范围 ​

先按使用目标选择 ​

前端与平台能力 ​

包含的后端能力 ​

接口、应用和 UI 分别负责什么 ​