91 lines
7.5 KiB
Markdown
91 lines
7.5 KiB
Markdown
# 本地 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,不操作线上或原本地栈。
|