后端合同与生成客户端

业务 API、DTO、授权和校验由后端拥有。新 admin-nuxtui Feature 通过产品级 apps/yoyo-admin/api-client 消费生成 operation、类型和校验，不复制 DTO 或接口 URL。

修改接口时的顺序

1. 修改后端 API、DTO、校验、权限或租户规则，并验证生产者。
2. 从当前后端刷新正式 OpenAPI，使用产品既有生成入口；准确命令见 apps/yoyo-admin/api-client/README.md 与 api-client-tools。
3. 核对生成差异，再在 Feature service 中映射查询和输入。当前 Host 通过 @api 指向唯一生成边缘，不引用旧前端的 service 或 store。
4. 验证受影响的类型、请求序列化、授权、保存和回读。接口存在不表示页面已经接入，也不表示真实运行验收通过。

ASP.NET Core / Yoyo.Abp
        ↓
正式 OpenAPI
        ↓
Orval / 产品生成入口
        ↓
apps/yoyo-admin/api-client
        ↓
Host shared/abp + Feature service
        ↓
业务任务与页面

哪些文件可以手改

可以修改后端合同、生成配置与 transformer、typed transport、Feature 业务映射。生成的 operation、DTO、Zod 和参考输出由工具重建，不在其中维护长期手工补丁。

generated edge 提供调用与输入合同，不拥有查询草稿、选择、租户会话、任务草稿或保存后的业务回读。这些分别由 admin-core 的平台合同、公共交互和 Feature 承担。

结果与错误

Host 的 ABP 适配负责认证上下文、租户 Header、envelope 和错误分类；Feature 使用既有 @api/runtime 与 shared/abp 入口，不逐接口猜 result / success / error / __abp。

401、403、404、409、字段错误和未知服务端错误分别处理。字段错误保留草稿，写入成功但回读失败只重试读取，不再次提交已经成功的写入。身份变化后，旧请求不能把结果回灌到新任务。

继续阅读

• 权限与运行上下文
• 快速开始
• Nuxt UI 起点与真实宿主
• 计量单位名称编辑

本页维护开发步骤；接口与生成边缘的详细约束由对应架构合同维护。