Files
moyi-model-intelligence-hub/docs/32-local-docker-acceptance-and-concurrency.md
xpp aee5fe10b4
Repository verification / backend (push) Canceled after 0s
Repository verification / frontend (push) Canceled after 0s
test:"增加隔离Docker环境并记录功能验收结果"
2026-10-28 14:17:04 +08:00

92 lines
7.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 本地 Docker 功能验收与并发测试准备
状态:隔离栈已启动;七项只读 API 验收通过;并发执行器缺失,未执行并发测试。
负责人:Codex。日期:2026-10-28(Asia/Shanghai)。
关联:用户要求本地 Docker 启动并使用 `spec-driven-acceptance-testing`、`concurrency-testing`。
## 环境与版本证据
- 入口:`http://127.0.0.1:18089`,Compose 项目 `moyi-qa`;原 `18088` 项目不重建、不重启、不共享业务卷。
- 定义:`infra/moyi/docker-compose.qa.yml`,仅使用本地已构建的 Java/Vue 产物,不读取业务 `.env`。
- API 与前端镜像以完整应用源码版本 `5d6253cbf10d8fae5c3248fdee3516210cc42203` 标记,并写入 OCI revision 标签。前端重新以 `VITE_CONTROL_PLANE_URL=/`、`VITE_AUTH_MODE=remote` 构建,通过类型检查及 Vite 构建。
- 容器内与本地 JAR 的 SHA256 均为 `eab406b7c67ff8d5fc05c404c83bb3b51ad9170a2c281f96a5ea446549a23a51`。
- PostgreSQL 15.18、Redis 7、API 仅加入 `qa_internal`(internal=true);只有前端还加入 `qa_edge`,并发布 `127.0.0.1:18089:80`。四个服务最终均 healthy;后端无外网出口,数据库/Redis/API 没有宿主发布端口。
- 新数据库 `moyi_qa` 完成 V50 迁移。它是本轮新建的专用测试库,不是业务数据库迁移。
- 启动必需的初始化管理员为 `qa-local-admin`,本轮未登录。启动秘密由 `qa-projects/moyi/scripts/prepare-local-env.ps1` 随机生成,仅存该档案受忽略的 `.env.local`,不打印、不提交;没有复用用户或旧实例凭据。
已保留新测试栈运行,卷名为 `moyi-qa_qa_postgres_data`、`moyi-qa_qa_redis_data`。未执行清库/销毁卷,不影响其他项目 Docker 资源。
## 启动与运行命令
在本仓库执行(密钥值不出现在命令中):
```powershell
docker compose --project-name moyi-qa --env-file 'D:\PROJECT\xpp_dev_agent\qa-projects\moyi\.env.local' --file infra/moyi/docker-compose.qa.yml config --quiet
docker compose --project-name moyi-qa --env-file 'D:\PROJECT\xpp_dev_agent\qa-projects\moyi\.env.local' --file infra/moyi/docker-compose.qa.yml build --pull=false
docker compose --project-name moyi-qa --env-file 'D:\PROJECT\xpp_dev_agent\qa-projects\moyi\.env.local' --file infra/moyi/docker-compose.qa.yml up --detach --no-build --wait --wait-timeout 120
```
三个命令最终均退出 0。不要打印完整 `docker compose config` 或容器 environment,避免输出启动密钥。
在 `D:\PROJECT\xpp_dev_agent\dev-test` 执行:
```powershell
.\.venv\Scripts\python.exe -m qa project check moyi
.\.venv\Scripts\python.exe -m qa run --project moyi
```
档案在 `D:\PROJECT\xpp_dev_agent\qa-projects\moyi`。目标 URL 和 `app_version: 5d6253c-docker-qa` 来自该项目的 `project.yaml`;没有用手工 HTTP 请求或 pytest workers 替代验收。
## 功能验收结果
沿用上一轮已向用户展示的七项预期,用户随后要求启动 Docker 并测试,本轮据此记录该范围的批准;预期没有修改。实际检查:
| 请求 | 预期与最终实际结果 |
| --- | --- |
| GET /health | 200,status=ok |
| GET /v1/tasks | 匿名 401,UNAUTHENTICATED,无 tasks |
| GET /v1/tasks/qa-media-absent | 匿名 401,UNAUTHENTICATED,无 task |
| GET /api/tasks | 无会话 401,UNAUTHENTICATED,无 tasks |
| GET /v1/models | 无 Key 401,UNAUTHENTICATED,无 data |
| GET /api/models | 无会话 401,UNAUTHENTICATED,无 models/providers |
| GET /api/admin/providers | 无会话 401,UNAUTHENTICATED,无 providers |
执行记录保留全部轮次:
| Run ID | 退出码 | 结果与说明 |
| --- | --- | --- |
| 20261028T060740-de7bbb69 | 1 | blocked=7;qa explain 确认 ConnectError。仅 internal 网络未对宿主发布入口,不能算业务失败或通过 |
| 20261028T060925-1cb7cff2 | 0 | passed=7;只修前端入口网络后按相同预期重跑 |
| 20261028T061229-d13f404c | 0 | passed=7,其他状态全部 0;14:12:29 起,明确 app_version,与上一轮七项 unchanged |
最终正式证据目录:`D:\PROJECT\xpp_dev_agent\qa-projects\moyi\artifacts\20261028T061229-d13f404c`,包含 `report.html`、`summary.json`、`junit.xml`、各 API 结果 JSON 与已批准规格快照。框架 `qa 0.2.0+308cb958fd7c`,dirty=false。此次为 API-only,没有浏览器截图、Trace 或实际播放验证。
新库只读计数确认:用户 1(初始化管理员)、任务 0、平台 Key 0、已配置供应商凭据 0。没有登录、批量建号、角色授予、付费生成或真实邮件/短信投递。本轮只证明这些入口行为,不代表媒体生成/播放或完整产品验收。
## 并发 skill 的执行边界
实际命令 `.\.venv\Scripts\python.exe -m qa --help` 退出 0,但子命令没有 `race`。按 `concurrency-testing` 第 5 步,交付场景草稿与账号计划,停止执行;禁止临时脚本发并发请求、用 `--workers` 冒充竞态证据,或把之前 Java 数据库单测当成本轮 skill 并发验收。
交付物:
- `qa-projects/moyi/specs/race-scenarios.draft.yaml`:两个场景,`status: draft`;仅用 PyYAML 确认语法和场景 ID,没有通过不存在的 race schema 校验,也未执行。
- `qa-projects/moyi/accounts.md`:认证源码取证、方案 D 固定账号池、串行登录、独立 Cookie jar/Key、限流、权限与清理风险。
待用户审阅的五项:
1. 不变量:不同管理员同时创建同一账号只能一条;不同用户使用同一幂等串不能合并任务或看到对方结果。
2. 预期:同名建号每轮 201×1、409×1、无 5xx,读回精确 count=1;跨用户任务均 202、ID 不同、各自列表不串户、读对方返回 404、后续重放仍为各自原 ID。每轮必须有发出离散度和正的重叠窗口,否则 inconclusive/blocked;没有竞争证据不能判 passed。
3. 账号:两个专用 admin,正常管理 API 新建 user 后由本栈超级管理员授予 admin;一账号仅一参与者。此登录/批量建号/授权尚未获准、没有执行。Cookie 登录不返回 JSON token,未来 runner 必须正式支持独立 Cookie jar。
4. 地址:仅上述 18089 隔离栈,每轮并发 2、每场景 3 轮,不是压测。
5. 残留:未来最多两个固定测试管理员、三条同名创建成功的普通账号、六个免费 mock 任务、Key/审计等。用户/任务没有删除或停用接口,Key 只能停用后软删除,不假称零残留;是否销毁独立测试卷必须另行确认。
重要准备风险:新库的 `model-mock-3d` 实际绑定 `provider-vast`,不是免费异步 mock。任务场景必须先经批准配置独立的 `provider-mock` async 路由,不能调用现有 Tripo 或其他真实模型。集合过滤计数、跨参与者 ID 关联和清理记录也需未来执行器实现,不能只断言列表为数组即判通过。
本轮未发送任何并发竞争请求;没有每轮状态分布/重叠/清理结果,因而没有“并发测试通过”结论。Mock 零费路径也不能证明人民币扣费、余额不足或结算冲突正确;这些需独立场景。
## 后续范围
MED-04/05(音视频用量计费、鉴权成品下载、逐供应商生成/播放)继续未完成。若要真实推进两个 skill 的完整业务测试,下一步需要用户明确授权:在 testingflow 的 qa 模块正式实现并发执行器及其单测/故意带竞态的演示验证,并批准上述账号/路由/残留计划;不在本次“使用 skill 测试”的请求下擅自扩展另一个项目。
仅本地审查提交,不 push,不操作线上或原本地栈。