生成Open api文档，前后端基于open api文档协同

[important-new]

[important-new]

实现核对(基于当前 main 代码库)

状态:⚠️ 部分实现

• ✅ 已存在独立维护的 OpenAPI 规范:client/Admin/docs/openapi.yaml(及 openapi-complete.yaml),为 OpenAPI 3.0.x 格式,含路径、schema、security scheme
• ❌ 但前端并未"基于 OpenAPI 文档协同":client/*/package.json 中无 openapi-generator / ng-openapi-gen 等代码生成工具,前端 service 仍为手写,未由规范自动生成客户端

待办:引入代码生成(如 ng-openapi-gen),让前端 API 客户端/类型由 OpenAPI 规范自动生成,并纳入 CI 校验前后端一致性。

—— 自动核对,仅供追踪。