feat: 完成 issue #182 [E1] 模型注册表后端化——registry_api.py HTTP 服务（四接口+双轨鉴权+种子+持久化）+ 11 单测全过 + README 反代约定

2026-08-06 15:38:51 +08:00
parent ef2a921765
commit 14e419be36
3 changed files with 554 additions and 0 deletions
@@ -150,3 +150,17 @@ docker exec -it fba_postgres psql -U postgres -d fba       # 进数据库
 ### 旧架构存档
 - `web/` 静态演示外壳保留（FBA 停掉时兜底；/index.html、/auth/login.html 已加 C1 自动收口跳转）
 - 旧登录页三轨会话已精简为 FBA 单轨（session.js，FBA 接入版）
+
+### 模型注册表服务（issue #182 [E1]，PRD 5.3 服务化）
+- 代码：`core/model-framework/registry_api.py`（标准库 http.server，零依赖）
+- 运行：`REGISTRY_DATA_DIR=<可挂卷目录> python3 core/model-framework/registry_api.py`（默认 :8002，绑定 127.0.0.1）
+- 数据：`REGISTRY_DATA_DIR/registry.json`（JSON 持久化；首次启动种子 4 条演示模型）
+- 鉴权双轨：FBA JWT（`FBA_TOKEN_SECRET_KEY` 配置时启用，写操作要求 `iaop:admin`/`iaop:studio` 权限码）；未配置时降级 core/auth 会话（engineer/admin 角色可写）
+- **nginx 反代约定**（加到宿主机 nginx server）：
+  ```nginx
+  location /api/v1/registry/ {
+      proxy_pass http://127.0.0.1:8002;
+      proxy_set_header Host $host;
+  }
+  ```
+- 单测：`python core/model-framework/tests/test_registry_api.py`（11 用例：promote/rollback/403 权限拒绝/401/持久化）