feat(vnext2): close portal key management ui on real host

2026-06-06 10:12:13 +08:00
parent 5b59ad7490
commit 47a67eb663
4 changed files with 212 additions and 77 deletions
--- a/docs/2026-06-05-VNEXT_COMPLETION_CHECKLIST.md
+++ b/docs/2026-06-05-VNEXT_COMPLETION_CHECKLIST.md
@@ -15,21 +15,21 @@
 说明：

 - vNext.1 已完成代码/文档/发布闭环。
- vNext.2 当前只完成了 V2-4：key self-service API + 用户首次调用 200 真实线上闭环。
- vNext.2 的 V2-5（portal key 管理 UI）尚未开始验收，vNext.3（治理/SLO）尚未开始实现。
- 因此按“全量 vNext goal”口径仍然是未完成；按阶段口径可判定：vNext.1 完成、vNext.2 部分完成（V2-4 已完成）。
+- vNext.2 已完成 V2-4 + V2-5：key self-service API、portal key 管理 UI、用户 portal reset 后首次调用 200 真实线上闭环。
+- vNext.3（治理/SLO）尚未开始实现。
+- 因此按“全量 vNext goal”口径仍然是未完成；按阶段口径可判定：vNext.1 完成、vNext.2 完成、vNext.3 未完成。

 ## 二、5 个核心问题 Checklist（全量 vNext 目标）

 真相源：`docs/EXECUTION_BOARD.md`

-| 问题                                                 | 规划要求                                     | 当前状态       | 证据                                                                                                                            |
-| ---------------------------------------------------- | -------------------------------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------- |
-| 1. 宿主协议稳定支持哪些主流大模型                    | 必须有真实协议矩阵 + 真实验收脚本 + 当前输出 | vNext.1 已闭环 | `verify_host_protocol_matrix.sh` 与相关 artifact 已存在                                                                         |
-| 2. 同模型多供应商池化                                | 模型池抽象 + 映射 + 真实池化验收             | vNext.1 已闭环 | `model_pool.go`、pool 测试、真实验收脚本已存在                                                                                  |
-| 3. 插件前端承接用户弱能力                            | Portal 能承接用户信息、模型、示例、key 信息  | V2-5 待完成    | `PORTAL_KEY_EXPERIENCE.md` 已审核通过，但 UI 闭环尚未完成                                                                       |
-| 4. 插件生成/申请 key 并交付 base URL/model/curl 示例 | key self-service API + 首次调用 200 闭环     | V2-4 已完成    | `KEY_SELF_SERVICE_API.md`、`verify_user_key_self_service.sh`、`artifacts/user-key-self-service/20260605_195408/99-summary.json` |
-| 5. key / 账号暂停、恢复、限额治理                    | 三态模型 + 管理页动作 + 真实治理验收         | V3-1 待完成    | `KEY_ACCOUNT_GOVERNANCE.md` 仅设计存在，真实治理实现未开始                                                                      |
+| 问题                                                 | 规划要求                                     | 当前状态         | 证据                                                                                                                                                                                     |
+| ---------------------------------------------------- | -------------------------------------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 1. 宿主协议稳定支持哪些主流大模型                    | 必须有真实协议矩阵 + 真实验收脚本 + 当前输出 | vNext.1 已闭环   | `verify_host_protocol_matrix.sh` 与相关 artifact 已存在                                                                                                                                  |
+| 2. 同模型多供应商池化                                | 模型池抽象 + 映射 + 真实池化验收             | vNext.1 已闭环   | `model_pool.go`、pool 测试、真实验收脚本已存在                                                                                                                                           |
+| 3. 插件前端承接用户弱能力                            | Portal 能承接用户信息、模型、示例、key 信息  | V2-5 已完成      | `PORTAL_KEY_EXPERIENCE.md`、`deploy/tksea-portal/index.html`、`artifacts/portal-ui-v25/20260606_1009/99-summary.json`                                                                    |
+| 4. 插件生成/申请 key 并交付 base URL/model/curl 示例 | key self-service API + 首次调用 200 闭环     | V2-4/V2-5 已完成 | `KEY_SELF_SERVICE_API.md`、`verify_user_key_self_service.sh`、`artifacts/user-key-self-service/20260605_195408/99-summary.json`、`artifacts/portal-ui-v25/20260606_1009/99-summary.json` |
+| 5. key / 账号暂停、恢复、限额治理                    | 三态模型 + 管理页动作 + 真实治理验收         | V3-1 待完成      | `KEY_ACCOUNT_GOVERNANCE.md` 仅设计存在，真实治理实现未开始                                                                                                                               |

 ## 三、vNext.1 发布范围 Checklist

@@ -83,12 +83,12 @@

 ### Phase 3（vNext.2）

- Task 3.1 用户信息架构设计：设计已存在
+- Task 3.1 用户信息架构设计：设计已存在并已按设计接线到 portal
 - Task 3.2 key 发放 API：已实现并上线验证
 - Task 3.3 用户首次调用闭环：已完成真实 `chat/completions=200`
- 尚缺：portal key 管理 UI（V2-5）
+- Task 3.4 portal key 管理 UI：已完成真实登录、已有 Key、reset、新明文、curl 示例与首呼 200 闭环

-状态：部分完成（V2-4 已闭环，V2-5 未完成）
+状态：vNext.2 已闭环

 ### Phase 4（vNext.3）

@@ -118,7 +118,7 @@

 ### vNext.2 尚缺

- `deploy/tksea-portal/` 中 portal key 管理 UI 的实现与真实前端验收（V2-5）
+- 无

 ### vNext.3 尚缺

@@ -130,22 +130,13 @@

 1. ✅ vNext.1 全部 5 项发布项已完成代码/文档/发布闭环
 2. ✅ V2-4 已完成后端实现、线上部署、真实 user-key 首呼 200 验收
-3. ✅ user-key artifact 已补齐：`artifacts/user-key-self-service/20260605_195408/99-summary.json`
-4. ⚠️ V2-5 portal key 管理 UI 未完成
+3. ✅ V2-5 已完成 portal 登录→已有 Key→reset 新明文→curl 示例更新→真实首呼 200 闭环
+4. ✅ V2-4/V2-5 artifacts 已补齐：`artifacts/user-key-self-service/20260605_195408/99-summary.json`、`artifacts/portal-ui-v25/20260606_1009/99-summary.json`
 5. ⚠️ V3-1 key/account governance + SLO 未完成

 ## 七、最短下一步路径

-### 立即执行：V2-5
-
-1. 实现 `deploy/tksea-portal/` 的 key 管理 UI
-2. 执行前端门禁：
-   - `bash ./scripts/test/test_tksea_portal_assets.sh`
-   - `bash ./scripts/test/verify_frontend_smoke.sh`
-   - 若涉及显式动作，执行 `bash ./scripts/acceptance/verify_provider_admin_actions.sh` 或对应 portal 验收
-3. 部署 remote43 并做公网页面验收
-
-### 然后执行：V3-1
+### 立即执行：V3-1

 1. 实现 key/account governance 状态模型
 2. 补治理 API / 测试 / 验收脚本
@@ -154,8 +145,8 @@
 ## 八、当前判定（唯一有效口径）

 - 按 vNext.1 发布范围：**完成**
- 按 vNext.2 当前执行项：**部分完成**（V2-4 完成，V2-5 未完成）
+- 按 vNext.2 当前执行项：**完成**（V2-4 + V2-5 已真实闭环）
 - 按全量 vNext 规划：**未完成**
 - 当前结论：
-  - V2-4 已真实闭环，可进入提交/推送
-  - 继续推进 V2-5（portal key UI）与 V3-1（governance）后，才能宣告全量 goal 完成
+  - V2-4 / V2-5 已真实闭环，可提交/推送
+  - 继续推进 V3-1（governance）后，才能宣告全量 goal 完成
--- a/docs/EXECUTION_BOARD.md
+++ b/docs/EXECUTION_BOARD.md
@@ -58,9 +58,38 @@
    - `POST https://sub.tksea.top/v1/chat/completions` with user key -> `200`
 - 当前结论：
  - vNext.2 / V2-4（key self-service API + 用户首次调用 200 闭环）已完成真实线上闭环
-  - 仍未完成的 vNext 范围为：
-    - V2-5 portal key 管理 UI
-    - V3-1 key/account governance + SLO/治理闭环
+  - 后续仍需完成 V2-5 portal key 管理 UI 与 V3-1 governance
+
+## 2026-06-06 vNext.2 / V2-5 真实闭环
+
+- portal key 管理 UI 已完成实现、部署和真实公网验收：
+  - 关键代码：
+    - `deploy/tksea-portal/index.html`
+    - `scripts/test/test_tksea_portal_assets.sh`
+  - 关键运行时接线：
+    - 页面使用 `/portal-admin-api/api/keys`
+    - `X-Portal-Subject` 由登录用户稳定生成（`portal-user:<id>` / `portal-email:<email>`）
+    - 已有 Key 列表展示 `masked_preview` / `allowed_models` / `quota_status`
+    - reset 动作回填新明文 key 与 curl 示例
+- 真实线上验收：
+  - 创建临时 smoke 用户（宿主管理 API）-> `200`
+  - 预发 CRM key `POST /portal-admin-api/api/keys` -> `201`
+  - 浏览器真实登录 `https://sub.tksea.top/portal/`：
+    - 已登录
+    - 已激活产品权限 = `1`
+    - 已有 KEY = `1`
+    - 列表出现 `ui smoke key`、masked preview `sk-****e2f0`
+    - 存在 `重置并显示新明文` 按钮
+  - 浏览器真实 reset 后：
+    - 结果区出现新明文 key
+    - 列表 masked preview 更新为 `sk-****99fa`
+    - curl 示例自动注入 reset 后新 key
+  - 使用 reset 后新 key 调用 `POST https://sub.tksea.top/v1/chat/completions` -> `200`，响应 `pong`
+- artifact：
+  - `artifacts/portal-ui-v25/20260606_1009/99-summary.json`
+- 当前结论：
+  - vNext.2 / V2-5（portal key 管理 UI）已完成真实线上闭环
+  - 剩余未完成范围：V3-1 key/account governance + SLO/治理闭环

 ## 2026-05-22 当前真相