From 024a949fc129ff44323c7500edc95fbbdd673bf2 Mon Sep 17 00:00:00 2001 From: ila Date: Sun, 23 Aug 2026 20:55:27 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=AE=B0=E5=BD=95=20portal=20=E6=8F=90?= =?UTF-8?q?=E4=BA=A4=E5=A5=91=E7=BA=A6=E9=AA=8C=E6=94=B6=20(#25)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/09-product-requirements-overview.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/09-product-requirements-overview.md b/docs/09-product-requirements-overview.md index 3205fe7..a84a344 100644 --- a/docs/09-product-requirements-overview.md +++ b/docs/09-product-requirements-overview.md @@ -2,8 +2,8 @@ generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Product-Requirements-Overview wiki_url: https://git.ilapage.cn/OPC/chorus/wiki/Product-Requirements-Overview.- -wiki_revision: 5453c2433c2b5036f6ee7b6f86f1fdbe0092725c -synchronized_at: 2026-08-22T04:06:22Z +wiki_revision: 789e2356d62592d8bd6e6d094036b9eaa99c3110 +synchronized_at: 2026-08-23T12:54:27Z # 产品需求总览 @@ -33,7 +33,7 @@ synchronized_at: 2026-08-22T04:06:22Z ## 当前需求索引 -工单 [#1](https://git.ilapage.cn/OPC/chorus/issues/1) 已完成长期技术基线整理和验收。项目由 [Epic #3](https://git.ilapage.cn/OPC/chorus/issues/3) 统一跟踪；[MVP-0 #4](https://git.ilapage.cn/OPC/chorus/issues/4) 已于 2026-08-21 验收完成。[MVP-1 #19](https://git.ilapage.cn/OPC/chorus/issues/19) 的设计门禁已完成：技术设计 [#16](https://git.ilapage.cn/OPC/chorus/issues/16) 已于 2026-08-21 验收通过；管理端原型 [#17](https://git.ilapage.cn/OPC/chorus/issues/17) 的 `prototypes/17/v1/index.html` 已于 2026-08-21 通过用户验收，用户端原型 [#18](https://git.ilapage.cn/OPC/chorus/issues/18) 的 `prototypes/18/v1/index.html` 已于 2026-08-21 通过用户验收。生产实现与集成验收单元工单已建立：[#20](https://git.ilapage.cn/OPC/chorus/issues/20)～[#28](https://git.ilapage.cn/OPC/chorus/issues/28)。#20、#21、#22、#23 和 #28 已于 2026-08-21～2026-08-22 验收完成；#24 已于 2026-08-22 验收交付；#25 已完成候选实现并等待用户验收，#26～#27 按声明依赖待实施。其中 #23 已交付管理 API 基线；#24 按 #30 风险决策改为明文凭据与单条回显，并完成固定 go-admin-ui 页面、Casbin/菜单集成、脱敏审计和默认禁用的连通性探测门禁；portal 的 MVP-1 提交契约与游标已由 #25 候选实现，用户页面仍待 #26 实现。 +工单 [#1](https://git.ilapage.cn/OPC/chorus/issues/1) 已完成长期技术基线整理和验收。项目由 [Epic #3](https://git.ilapage.cn/OPC/chorus/issues/3) 统一跟踪；[MVP-0 #4](https://git.ilapage.cn/OPC/chorus/issues/4) 已于 2026-08-21 验收完成。[MVP-1 #19](https://git.ilapage.cn/OPC/chorus/issues/19) 的设计门禁已完成：技术设计 [#16](https://git.ilapage.cn/OPC/chorus/issues/16) 已于 2026-08-21 验收通过；管理端原型 [#17](https://git.ilapage.cn/OPC/chorus/issues/17) 的 `prototypes/17/v1/index.html` 已于 2026-08-21 通过用户验收，用户端原型 [#18](https://git.ilapage.cn/OPC/chorus/issues/18) 的 `prototypes/18/v1/index.html` 已于 2026-08-21 通过用户验收。生产实现与集成验收单元工单已建立：[#20](https://git.ilapage.cn/OPC/chorus/issues/20)～[#28](https://git.ilapage.cn/OPC/chorus/issues/28)。#20、#21、#22、#23 和 #28 已于 2026-08-21～2026-08-22 验收完成；#24 已于 2026-08-22 验收交付；#25 已于 2026-08-23 验收交付，#26～#27 按声明依赖待实施。其中 #23 已交付管理 API 基线；#24 按 #30 风险决策改为明文凭据与单条回显，并完成固定 go-admin-ui 页面、Casbin/菜单集成、脱敏审计和默认禁用的连通性探测门禁；portal 的 MVP-1 提交契约与游标已由 #25 验收交付，用户页面仍待 #26 实现。 | 需求领域 | 用户与场景 | 需求状态 | MVP | 详细说明 | 实施工单 | 设计证据 | |---|---|---|---|---|---|---| @@ -42,7 +42,7 @@ synchronized_at: 2026-08-22T04:06:22Z | 默认 prompt template | 系统以数据配置而非硬编码合成提示词 | 已交付（#7/#13 已验收） | [MVP-0 #4](https://git.ilapage.cn/OPC/chorus/issues/4) | [业务规则](Business-Rules-and-Glossary.-) | [#7](https://git.ilapage.cn/OPC/chorus/issues/7) | 2026-08-20 已确认中性模板与 `{{.UserPrompt}}` | | 多 Provider 路由与故障转移 | 单上游故障时继续服务 | 已确认（#16 已验收，待实现） | [MVP-1 #19](https://git.ilapage.cn/OPC/chorus/issues/19) | [架构](Architecture-and-Code-Map.-)、[业务规则](Business-Rules-and-Glossary.-) | [#16 技术设计](https://git.ilapage.cn/OPC/chorus/issues/16) | #16 架构/API/数据/状态设计于 2026-08-21 已确认 | | 管理端配置与记录 | 运营配置模型、路由池并排障 | 已交付（#24 已验收） | [MVP-1 #19](https://git.ilapage.cn/OPC/chorus/issues/19) | 本页“管理端页面” | [#17 管理端原型](https://git.ilapage.cn/OPC/chorus/issues/17) | `prototypes/17/v1/index.html`，v1，2026-08-21 用户已确认 | -| 图片角色编辑 | 用户编辑 role_rule、角色、备注与顺序 | 后端候选实现待验收（#25），页面待 #26 | [MVP-1 #19](https://git.ilapage.cn/OPC/chorus/issues/19) | 业务规则“提示词与上传” | [#18 用户端原型](https://git.ilapage.cn/OPC/chorus/issues/18) | `prototypes/18/v1/index.html`，v1，2026-08-21 用户已确认 | +| 图片角色编辑 | 用户编辑 role_rule、角色、备注与顺序 | 后端已交付（#25 已验收），页面待 #26 | [MVP-1 #19](https://git.ilapage.cn/OPC/chorus/issues/19) | 业务规则“提示词与上传” | [#18 用户端原型](https://git.ilapage.cn/OPC/chorus/issues/18) | `prototypes/18/v1/index.html`，v1，2026-08-21 用户已确认 | | API Key 与程序调用 | 外部程序提交与查询任务 | 已确认 | MVP-2 | 本页“程序化调用” | 待建 | API/权限设计 | | 限流、保留期、公开注册 | 治理滥用和磁盘；决定是否开放用户获取 | 待确认（阈值/流程） | MVP-2 或后续 | 业务规则“需要补充什么” | 待建 | 安全/运维/认证设计 | @@ -85,7 +85,7 @@ MVP-0 非目标： #### MVP-1：可用性与运营 -汇总工单为 [#19](https://git.ilapage.cn/OPC/chorus/issues/19)，设计门禁已完成，生产实现单元工单已建立；#24 已于 2026-08-22 验收交付，#25 候选实现等待用户验收： +汇总工单为 [#19](https://git.ilapage.cn/OPC/chorus/issues/19)，设计门禁已完成，生产实现单元工单已建立；#24 已于 2026-08-22 验收交付，#25 已于 2026-08-23 验收交付： - [x] [#16](https://git.ilapage.cn/OPC/chorus/issues/16) 路由、Provider、迁移、API、状态和测试设计（2026-08-21 验收通过）； - [x] [#17](https://git.ilapage.cn/OPC/chorus/issues/17) 固定 go-admin/go-admin-ui 的 CRUD 与三个定制页原型（`prototypes/17/v1/index.html`，2026-08-21 用户验收通过）； @@ -270,6 +270,6 @@ MVP-2 的 API Key 存哈希、身份仍属于 `users`。提交、查询、幂等 固定 go-admin-ui 已导入仓库并实现 Provider、ProviderModel、PromptTemplate、Users CRUD，以及路由池、Provider 健康/主动探测和生成详情页面。Provider Key 按 #30 明文落库并仅在单条页面主动回显；用户页按 #31 完全移除点数、余额和配额。实现已通过 Go build/vet/test、前端 lint/32 个单测/生产构建、MySQL 8 migration up/down/up、管理 API 集成测试和真实账号密码/菜单/API 联调；浏览器实例不可用，未生成生产页面自动化截图，用户于 2026-08-22 完成人工验收并确认 #24 通过。 -## #25 portal 提交契约候选状态（2026-08-22，待验收） +## #25 portal 提交契约交付状态（2026-08-23，已验收） -portal 已按 #16/#18 实现活动路由与模板快照、image_generate/image_edit metadata、一一对应的图片角色备注、固定 Prompt 覆盖顺序，以及 user_id 作用域的 HMAC 游标历史。实现不调用上游，不包含用户点数，也不改变登录和页面交互；后者继续由 #26 负责。候选已通过 Go build/vet/test/race 和本机 MySQL 8.4.8 隔离集成测试，#25 保持待验收。 +portal 已按 #16/#18 实现活动路由与模板快照、image_generate/image_edit metadata、一一对应的图片角色备注、固定 Prompt 覆盖顺序，以及 user_id 作用域的 HMAC 游标历史。实现不调用上游，不包含用户点数，也不改变登录和页面交互；后者继续由 #26 负责。实现已通过 Go build/vet/test/race 和本机 MySQL 8.4.8 隔离集成测试，用户于 2026-08-23 明确确认 #25 验收通过。