API 契约（唯一）
- 运行时契约：
GET /api/v1/meta/openapi.yaml（与代码同嵌入） - 目录清单：
GET /api/v1/meta/apis - 源文件：
platform/internal/handler/openapi.yaml+platform/internal/apidef/catalog.go
动词
| 方法 | 用途 |
|---|---|
| GET | 读取 |
| POST | 创建，或无幂等动作（login / import / publish / generate） |
| PUT | 更新 |
| DELETE | 删除 |
禁止再用 PATCH 作为更新主路径；禁止为行业场景新增平行 CRUD。
动态业务数据
仅：
GET|POST /api/v1/apps/{slug}/{resource}
GET|PUT|DELETE /api/v1/apps/{slug}/{resource}/{id}
POST /api/v1/apps/{slug}/{resource}/import
GET /api/v1/apps/{slug}/{resource}/export
GET /api/v1/apps/{slug}/{resource}/aggregate
字段由蓝图定义，平台不做行业写死接口。
AI（不重复实现）
经网关 /ai 前缀：
POST /ai/api/v1/apps/generate
GET /ai/api/v1/llm/providers