feat(#182): 模型注册表后端化 TemplateRegistry 服务化 HTTP API（E1） #184

2026-08-06T07:34:29Z

bot_dev1 commented

2026-08-06 07:34:29 +00:00

概述

把已交付的 TemplateRegistry（core/model-framework/template_registry.py）通过标准库 http.server 暴露为 HTTP 服务（issue #182 / PRD 5.3 ③），服务端持久化 + FBA JWT 鉴权。

接口

GET /api/v1/registry/models 列表（可按 stage 过滤）
POST /api/v1/registry/models 注册新版本（服务端校验）
POST /api/v1/registry/models/{name}/{version}/promote dev→staging→prod
POST /api/v1/registry/models/{name}/rollback?version=&stage= 回滚指定 stage 版本

设计要点

零依赖标准库实现，对齐 core/auth/auth_api.py 风格
PersistedRegistry 写操作原子落盘到 deploy/data/registry/registry.json（重启不丢），首次启动播种 4 条演示模型
鉴权双轨：读接 FBA JWT，写要求权限码 iaop:admin/iaop:studio；未配置 FBA_TOKEN_SECRET_KEY 降级旧 core/auth 会话

验收

四接口回环联调通过（含 401/403 鉴权路径）
重启服务数据不丢（服务端文件持久化）
单测全过：新增 16 例（test_registry_api.py），model-framework 全 284 例通过
nginx 反代约定写入 deploy/fba/README.md（/api/v1/registry/ → :8090）

fixes #182

## 概述把已交付的 TemplateRegistry（core/model-framework/template_registry.py）通过标准库 http.server 暴露为 HTTP 服务（issue #182 / PRD 5.3 ③），服务端持久化 + FBA JWT 鉴权。 ## 接口 - `GET /api/v1/registry/models` 列表（可按 stage 过滤） - `POST /api/v1/registry/models` 注册新版本（服务端校验） - `POST /api/v1/registry/models/{name}/{version}/promote` dev→staging→prod - `POST /api/v1/registry/models/{name}/rollback?version=&stage=` 回滚指定 stage 版本 ## 设计要点 - 零依赖标准库实现，对齐 core/auth/auth_api.py 风格 - PersistedRegistry 写操作原子落盘到 deploy/data/registry/registry.json（重启不丢），首次启动播种 4 条演示模型 - 鉴权双轨：读接 FBA JWT，写要求权限码 iaop:admin/iaop:studio；未配置 FBA_TOKEN_SECRET_KEY 降级旧 core/auth 会话 ## 验收 - 四接口回环联调通过（含 401/403 鉴权路径） - 重启服务数据不丢（服务端文件持久化） - 单测全过：新增 16 例（test_registry_api.py），model-framework 全 284 例通过 - nginx 反代约定写入 deploy/fba/README.md（/api/v1/registry/ → :8090） fixes #182

bot_dev1 added 1 commit 2026-08-06 07:34:29 +00:00

feat(#182 ): 模型注册表后端化 TemplateRegistry 服务化 HTTP API（E1） 609fda0505

新增 core/model-framework/registry_api.py（标准库 http.server，对齐 auth_api
风格，零依赖），把已交付的 TemplateRegistry 暴露为 HTTP 服务：

- GET  /api/v1/registry/models                 列表（可按 stage 过滤）
- POST /api/v1/registry/models                 注册新版本（服务端校验）
- POST /api/v1/registry/models/{name}/{version}/promote   dev→staging→prod
- POST /api/v1/registry/models/{name}/rollback?version=&stage=  回滚指定 stage

服务端持久化：PersistedRegistry 每次写操作原子落盘到
deploy/data/registry/registry.json（可挂卷），重启不丢；首次启动自动播种
4 条演示模型（对齐 web/admin/admin.js seedModels）。

鉴权双轨：读接 FBA JWT（core/auth/fba_jwt.py），写要求权限码 iaop:admin
或 iaop:studio；未配置 FBA_TOKEN_SECRET_KEY 降级旧 core/auth 会话；
两者均无时为本地/CI 演示模式（读免鉴权、写需 token 占位）。

测试：tests/test_registry_api.py（16 例，含四接口回环联调、401/403 路径、
promote/rollback/持久化/种子）+ _fba_stub.py（FBA 桩）。全 284 例通过。

部署：deploy/fba/README.md 补 nginx 反代 /api/v1/registry/ → :8090 约定。

bot_dev1 referenced this pull request

2026-08-06 07:52:48 +00:00

[E1] 模型注册表后端化：TemplateRegistry 服务化 HTTP API（服务端持久化 + FBA JWT 鉴权） #182

bot_dev1 referenced this pull request

2026-08-06 08:03:35 +00:00

[E2] 前端接入注册表 API：模型管理/版本发布改走服务端，localStorage 降级 #183

bot_qa referenced this pull request

2026-08-06 09:22:13 +00:00

[P2·跟踪] 演示数据 → 真实数据源接入清单（依赖后端服务，待 #182/#183 落地后拆解） #190

bot_dev1 commented

2026-08-17 06:29:10 +00:00