docs: 记录 MVP-1 集成候选状态 (#27)

This commit is contained in:
ila
2026-08-23 23:52:40 +08:00
parent 69057a1b95
commit 5c835e1b6c
+10 -6
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: 5f38cd4d4e6006fc6eec5d3622121e56433bf46d
synchronized_at: 2026-08-23T15:08:54Z
wiki_revision: 431dd38d145fa7eeb7e8c77e6c606c7fcfa02760
synchronized_at: 2026-08-23T15:51:56Z
<!-- gitea-wiki-mirror:end -->
# 产品需求总览
@@ -33,14 +33,14 @@ synchronized_at: 2026-08-23T15:08:54Z
## 当前需求索引
工单 [#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 已于 2026-08-23 通过用户验收,#27 已具备实施条件。其中 #23 已交付管理 API 基线;#24 按 #30 风险决策改为明文凭据与单条回显,并完成固定 go-admin-ui 页面、Casbin/菜单集成、脱敏审计和默认禁用的连通性探测门禁;portal 的 MVP-1 提交契约与游标已由 #25 验收交付,用户页面已由 #26 于 2026-08-23 验收交付。
工单 [#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 已于 2026-08-23 通过用户验收;#27 及集成验收发现的 #32、#33、#34 已完成实现和自动化验证,当前均待用户验收。其中 #23 已交付管理 API 基线;#24 按 #30 风险决策改为明文凭据与单条回显,并完成固定 go-admin-ui 页面、Casbin/菜单集成、脱敏审计和默认禁用的连通性探测门禁;portal 的 MVP-1 提交契约与游标已由 #25 验收交付,用户页面已由 #26 于 2026-08-23 验收交付。
| 需求领域 | 用户与场景 | 需求状态 | 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/数据/状态设计于 2026-08-21 已确认 |
| 多 Provider 路由与故障转移 | 单上游故障时继续服务 | 待验收(#27 集成候选已完成) | [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 用户已确认 |
| API Key 与程序调用 | 外部程序提交与查询任务 | 已确认 | MVP-2 | 本页“程序化调用” | 待建 | API/权限设计 |
@@ -85,13 +85,13 @@ MVP-0 非目标:
#### MVP-1:可用性与运营
汇总工单为 [#19](https://git.ilapage.cn/OPC/chorus/issues/19),设计门禁已完成,生产实现单元工单已建立;#24 已于 2026-08-22 验收交付,#25 已于 2026-08-23 验收交付:
汇总工单为 [#19](https://git.ilapage.cn/OPC/chorus/issues/19),设计门禁与 #20~#26、#28 的单元验收已完成;#27 集成候选及其发现的 #32~#34 已完成实现和自动化验证,当前待用户验收:
- [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 用户验收通过);
- [x] [#18](https://git.ilapage.cn/OPC/chorus/issues/18) 文生图、图片 role_rule/role/note/排序与历史无限滚动原型(`prototypes/18/v1/index.html`,2026-08-21 用户验收通过)。
稳定范围仍包括加权路由、gobreaker、最多 N 家故障转移、`images`/`gemini`、受审计有冷却的单次真实连通性测试和完整 retryable 测试。技术设计与两个原型均已确认;生产工单已按数据库、路由/worker、协议、安全管理端、portal 和集成验收拆分;新增 #28 以仓库外环境变量和显式 bootstrap 命令安全初始化管理员账号。执行须遵守各自依赖。
稳定范围仍包括加权路由、gobreaker、最多 N 家故障转移、`images`/`gemini`、受审计有冷却的单次真实连通性测试和完整 retryable 测试。技术设计与两个原型均已确认;生产工单已按数据库、路由/worker、协议、安全管理端、portal 和集成验收完成拆分与实现;#28 以仓库外环境变量和显式 bootstrap 命令安全初始化管理员账号。#27 已在隔离 MySQL 8 与 mock 上游覆盖 `images`、`images_edits`、`gemini` 全链路,并完成管理端与 portal 浏览器回归;未获单独授权,因此没有调用真实 Provider。
#### MVP-2:治理与开放
@@ -277,3 +277,7 @@ portal 已按 #16/#18 实现活动路由与模板快照、image_generate/image_e
## #26 portal 用户界面交付状态(2026-08-23,已验收)
portal 已按 #18 v1 原型实现文生图与图片编辑切换、role_rule、每图 primary/reference 角色、备注、拖动及键盘等价排序、Prompt 构成说明,以及基于 #25 HMAC 游标的历史无限加载。提交继续保持同步落库且不调用上游,不包含用户点数。候选已通过前端生产构建、Go build/vet/test/race、本机 MySQL 8.4.8 隔离集成,以及 375/768/1024/1440 Playwright E2E;浏览器覆盖提交、角色顺序与备注落库、增量历史失败恢复、终态、认证失效、44px 目标、reduced-motion 和无横向溢出。#26 已于 2026-08-23 通过用户验收;MVP-1 跨模块集成验收由 #27 收口。
## #27 MVP-1 集成候选状态(2026-08-23,待验收)
#27 已使用 `admin/config/settings.yml` 只读派生的固定隔离库 `chorus_test`,完成 MVP-0 数据 up/down/up、根模块和 admin 模块 build/vet/test、worker race、admin-ui 正式构建与 Chromium 登录、portal 多视口 Playwright、Harness 严格检查。新增 MySQL + mock worker 覆盖 `images`、`images_edits`、`gemini`,并核对 generation、attempt、output、对象归属、权限和敏感信息边界。集成验收发现的 admin-ui 验证码残留 #32、生产 runtime 缺失 #33、SCSS 运行时导入白屏 #34 均已单独建单、最小修复并通过回归,当前与 #27 一并等待用户验收。未调用真实 Provider;该项只有在用户单独授权后才能执行。