OPC/chorus
2
0
Fork 0
Code Issues 11 Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 记录工单 #16 验收通过 (#16)

Browse Source
This commit is contained in:
ila
2026-08-21 15:00:30 +08:00
parent 84eb980756
commit ca75c26e39
3 changed files with 16 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/02-architecture-and-code-map.md
+5 -4
View File
@@ -2,8 +2,8 @@
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
wiki_page: Architecture-and-Code-Map
wiki_url: https://git.ilapage.cn/OPC/chorus/wiki/Architecture-and-Code-Map.-
wiki_revision: 0cffbdd5470769d181732ee902888f7974359e04
synchronized_at: 2026-08-21T06:44:26Z
wiki_revision: c5a4385d79bfa1513b25cc35f2676e1e451336de
synchronized_at: 2026-08-21T06:59:19Z
<!-- gitea-wiki-mirror:end -->
# 架构与代码地图
@@ -119,9 +119,10 @@ MVP-0 第一张上传图自动作为 `primary`，其余为 `reference`；不提
- 网络传输错误和非 401 HTTP 错误保留当前结果并显示恢复提示；401 停止当前交互、显示登录失效对话框，并保留任务路径作为登录返回地址。
- 响应式断点为 375、768、1024 和 1440：手机按结果、输入、历史顺序单列；平板为历史加单列工作区；宽桌面为历史、结果、输入三列。交互目标至少 44px，支持键盘焦点、aria-live 和 reduced-motion。
- `portal/web/package.json` 与 `pnpm-lock.yaml` 固定前端构建依赖；构建生成的静态文件嵌入 Go 二进制。MySQL handler 测试覆盖真实状态片段，Playwright 覆盖四视口、输入错误、上传错误、断网提示和认证失效。
### #16 MVP-1 技术设计（待验收）
本节是工单 #16 的待验收技术设计。用户确认前，它只作为 #17/#18 原型的技术输入，不放行生产实现。
### #16 MVP-1 技术设计（2026-08-21 已确认）
本节是工单 #16 的已确认技术设计，用户于 2026-08-21 验收通过。它是 #17/#18 原型和后续生产实现工单的技术依据；两个 UI 原型仍须分别确认后才能放行对应生产实现。
#### 能力、路由与 Prompt 快照
docs/03-business-rules-and-glossary.md
+3 -3
View File
@@ -2,8 +2,8 @@
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
wiki_page: Business-Rules-and-Glossary
wiki_url: https://git.ilapage.cn/OPC/chorus/wiki/Business-Rules-and-Glossary.-
wiki_revision: 77242eab21bc1a91618d311a5e2933b0665c29d8
synchronized_at: 2026-08-21T06:39:05Z
wiki_revision: f7c84780525130d468b4e0b0ff84c412846a9fdc
synchronized_at: 2026-08-21T06:55:39Z
<!-- gitea-wiki-mirror:end -->
# 业务规则与术语
@@ -57,7 +57,7 @@ synchronized_at: 2026-08-21T06:39:05Z
16. 每次重定向重新验证 scheme、host、解析地址和端口并限制次数；上游响应中的结果 URL 按同一策略下载。只允许明确的 http/https，不允许凭 URL 绕过。
17. 真实连通性测试由管理员明确点击，单次低成本调用，记录操作者/目标/结果并设置冷却；自动测试和日常调试只用 mock。
#### MVP-1 已设计规则（#16，待验收）
#### MVP-1 已确认规则（#16，2026-08-21 验收通过）
- 路由能力只使用 `text`、`image_generate`、`image_edit`；ProviderModel 必须显式声明能力，路由池只包含同一能力且引用一个协议无关 PromptTemplate。
- 同步提交保存活动路由池、版本、模板和不含密钥的成员快照，只做数据库读取、校验、Prompt 渲染和 pending 持久化；仍不得调用上游。
docs/09-product-requirements-overview.md
+8 -8
View File
@@ -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: 376e592c33527aed0924b9ebccd820d2e09f322d
synchronized_at: 2026-08-21T06:39:26Z
wiki_revision: e832dfa2552c6cf97eda1927588bc85392f5fe8e
synchronized_at: 2026-08-21T06:59:52Z
<!-- gitea-wiki-mirror:end -->
# 产品需求总览
@@ -29,16 +29,16 @@ synchronized_at: 2026-08-21T06:39:26Z
## 当前需求索引
工单 [#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) 正在待验收，管理端原型 [#17](https://git.ilapage.cn/OPC/chorus/issues/17) 和用户端原型 [#18](https://git.ilapage.cn/OPC/chorus/issues/18) 以前者确认为前置。生产实现工单尚未建立或放行。当前已交付边界仍是 mock 验证的唯一 ProviderModel `chat`/`images_edits` 闭环。
工单 [#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) 和用户端原型 [#18](https://git.ilapage.cn/OPC/chorus/issues/18) 的前置门禁已满足，仍需分别制作和确认。生产实现工单尚未建立或放行。当前已交付边界仍是 mock 验证的唯一 ProviderModel `chat`/`images_edits` 闭环。
| 需求领域 | 用户与场景 | 需求状态 | MVP | 详细说明 | 实施工单 | 设计证据 |
|---|---|---|---|---|---|---|
| 核心生成域与单上游 | 用户提交提示词/原图得到结果 | 已交付（#6～#10、#13、#15 已验收） | [MVP-0 #4](https://git.ilapage.cn/OPC/chorus/issues/4) | [架构](Architecture-and-Code-Map.-)、[业务规则](Business-Rules-and-Glossary.-) | [#6 迁移](https://git.ilapage.cn/OPC/chorus/issues/6)、[#7 core](https://git.ilapage.cn/OPC/chorus/issues/7)、[#8 platform](https://git.ilapage.cn/OPC/chorus/issues/8)、[#9 queue](https://git.ilapage.cn/OPC/chorus/issues/9)、[#10 worker](https://git.ilapage.cn/OPC/chorus/issues/10) | 架构/数据/状态设计已确认 |
| 用户端生成页 | 种子用户登录并完成一次异步生成 | 已交付（#11～#13 已验收） | [MVP-0 #4](https://git.ilapage.cn/OPC/chorus/issues/4) | 本页“用户端布局与状态” | [#11 portal 后端](https://git.ilapage.cn/OPC/chorus/issues/11)、[#12 用户界面](https://git.ilapage.cn/OPC/chorus/issues/12) | [原型设计 #2](https://git.ilapage.cn/OPC/chorus/issues/2)；`prototypes/2/v1/index.html`，2026-08-20 用户已确认 |
| 默认 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/数据/状态草案待用户验收 |
| 管理端配置与记录 | 运营配置模型、路由池并排障 | 已确认（等待前置设计） | [MVP-1 #19](https://git.ilapage.cn/OPC/chorus/issues/19) | 本页“管理端页面” | [#17 管理端原型](https://git.ilapage.cn/OPC/chorus/issues/17) | 复用型/定制页原型待制作和确认 |
| 图片角色编辑 | 用户编辑 role_rule、角色、备注与顺序 | 已确认（等待前置设计） | [MVP-1 #19](https://git.ilapage.cn/OPC/chorus/issues/19) | 业务规则“提示词与上传” | [#18 用户端原型](https://git.ilapage.cn/OPC/chorus/issues/18) | 组件状态、键盘排序和无限滚动原型待制作和确认 |
| 多 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 已确认 |
| 管理端配置与记录 | 运营配置模型、路由池并排障 | 已确认（#16 已验收，待原型） | [MVP-1 #19](https://git.ilapage.cn/OPC/chorus/issues/19) | 本页“管理端页面” | [#17 管理端原型](https://git.ilapage.cn/OPC/chorus/issues/17) | 复用型/定制页原型待制作和确认 |
| 图片角色编辑 | 用户编辑 role_rule、角色、备注与顺序 | 已确认（#16 已验收，待原型） | [MVP-1 #19](https://git.ilapage.cn/OPC/chorus/issues/19) | 业务规则“提示词与上传” | [#18 用户端原型](https://git.ilapage.cn/OPC/chorus/issues/18) | 组件状态、键盘排序和无限滚动原型待制作和确认 |
| 点数只读与发放 | 用户看余额、管理员发放留痕 | 已确认 | MVP-2 | 业务规则“点数与范围” | 待建 | 原型待确认 |
| API Key 与程序调用 | 外部程序提交与查询任务 | 已确认 | MVP-2 | 本页“程序化调用” | 待建 | API/权限设计 |
| 限流、保留期、公开注册 | 治理滥用和磁盘；决定是否开放用户获取 | 待确认（阈值/流程） | MVP-2 或后续 | 业务规则“需要补充什么” | 待建 | 安全/运维/认证设计 |
@@ -84,11 +84,11 @@ MVP-0 非目标：
汇总工单为 [#19](https://git.ilapage.cn/OPC/chorus/issues/19)，当前处于设计门禁：
- [ ] [#16](https://git.ilapage.cn/OPC/chorus/issues/16) 路由、Provider、迁移、API、状态和测试设计（待验收）；
- [x] [#16](https://git.ilapage.cn/OPC/chorus/issues/16) 路由、Provider、迁移、API、状态和测试设计（2026-08-21 验收通过）；
- [ ] [#17](https://git.ilapage.cn/OPC/chorus/issues/17) 固定 go-admin/go-admin-ui 的 CRUD 与三个定制页原型；
- [ ] [#18](https://git.ilapage.cn/OPC/chorus/issues/18) 文生图、图片 role_rule/role/note/排序与历史无限滚动原型。
稳定范围仍包括加权路由、gobreaker、最多 N 家故障转移、`images`/`gemini`、受审计有冷却的单次真实连通性测试和完整 retryable 测试。技术设计与两个原型经用户确认后，才拆分数据库、路由/worker、协议、安全管理端、portal 和集成验收生产工单。
稳定范围仍包括加权路由、gobreaker、最多 N 家故障转移、`images`/`gemini`、受审计有冷却的单次真实连通性测试和完整 retryable 测试。技术设计已确认；两个原型经用户确认后，才拆分数据库、路由/worker、协议、安全管理端、portal 和集成验收生产工单。
#### MVP-2：治理与开放