# OpenAPI 契约

- `platform-api-v1.yaml`：浏览器访问的公共业务接口。
- `demo-core-extension-v1.yaml`：第 15 小步冻结的 Demo 目标扩展接口；
  与 `platform-api-v1.yaml` 合并后构成完整公共 API v1。
- `storage-api-internal-v1.yaml`：Storage Service 内部接口。
- `runtime-api-internal-v1.yaml`：Runtime Manager 内部接口。

现有服务契约由对应 FastAPI 应用生成；目标扩展契约先冻结、后实现，不能
标记为已上线。所有文件均纳入结构校验。公共接口统一使用 `/api/v1`，
内部服务接口统一使用 `/internal/v1`。