From aee5fe10b487a848ab78e0e8abbc5cf1c800acc0 Mon Sep 17 00:00:00 2001 From: xpp Date: Wed, 28 Oct 2026 14:17:04 +0800 Subject: [PATCH] =?UTF-8?q?test:"=E5=A2=9E=E5=8A=A0=E9=9A=94=E7=A6=BBDocke?= =?UTF-8?q?r=E7=8E=AF=E5=A2=83=E5=B9=B6=E8=AE=B0=E5=BD=95=E5=8A=9F?= =?UTF-8?q?=E8=83=BD=E9=AA=8C=E6=94=B6=E7=BB=93=E6=9E=9C"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 4 +- docs/24-security-and-cpr-task-tracker.md | 3 + docs/31-media-result-delivery-boundary.md | 2 + ...local-docker-acceptance-and-concurrency.md | 91 ++++++++++++++++ infra/moyi/docker-compose.qa.yml | 101 ++++++++++++++++++ 5 files changed, 200 insertions(+), 1 deletion(-) create mode 100644 docs/32-local-docker-acceptance-and-concurrency.md create mode 100644 infra/moyi/docker-compose.qa.yml diff --git a/README.md b/README.md index be0607f..fff7cf2 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,9 @@ 最新 [验证码投递隔离](docs/28-verification-delivery-isolation.md) 需要先迁移 V50,并配置 `CREDENTIAL_ENCRYPTION_KEY` 及邮件/短信服务。2026-10-22 用户要求的每半小时本地提交检查已取消;产品内部的任务与投递 worker 不属于该聊天自动化。 -媒体后续见 [媒体结果交付边界与验收准备](docs/31-media-result-delivery-boundary.md):即时/轮询共用纯媒体结果模块,无主文件不再提示可下载;规格驱动验收已准备 draft,待人工批准,没有把单元回归当成真实生成/播放验收。 +媒体后续见 [媒体结果交付边界与验收准备](docs/31-media-result-delivery-boundary.md):即时/轮询共用纯媒体结果模块,无主文件不再提示可下载;本地回归不等于真实供应商生成/播放验收。 + +本地测试后续见 [Docker 功能验收与并发测试准备](docs/32-local-docker-acceptance-and-concurrency.md):独立 QA 栈已运行在 `http://127.0.0.1:18089`,原本地实例保留;七项只读 API 规格验收通过。并发 skill 因框架没有 `race` 执行器只交付待审计划,没有宣称并发或音视频生成/播放通过。 ## 一、产品简介 diff --git a/docs/24-security-and-cpr-task-tracker.md b/docs/24-security-and-cpr-task-tracker.md index 398cf79..b80b530 100644 --- a/docs/24-security-and-cpr-task-tracker.md +++ b/docs/24-security-and-cpr-task-tracker.md @@ -34,6 +34,7 @@ | MED-03 | 音视频结果展示与历史任务类型 | 本地已实现并继续修复:持久任务类型优先于目录;补无格式 Base64 的 PNG/JPEG/GIF 签名识别、data URL 音频识别和单一主媒体类型;历史成功任务也检查主文件,预览帧不算视频成品,无文件不再提示可下载。真实浏览器生成/播放未验收 | 无目录任务、音频 base64、签名 URL、缺格式图片、无效别名/尾帧前端回归 | | MED-04 | 音视频用量计费及逐路由验收 | 未完成:音视频 Token/时长计费不可用固定单任务费代替,配置就绪不等于真实生成通过 | 每条路由分别核对协议、模型、用量、费用、播放;不猜报价,不自动发付费任务 | | MED-05 | 视频鉴权内容下载与不同渠道协议 | 未完成:返回任务元数据但无公开 URL 的供应商需要鉴权内容获取;不同渠道不能共用猜测接口 | 绑定原账号、受控内容下载、用户隔离、体积期限与安全存储联合验收 | +| QA-01 | 本地 Docker 功能与并发 skill 验收 | 部分完成:已启动独立 moyi-qa 栈,127.0.0.1:18089;spec-driven 七项匿名只读验收 passed,当前 qa 缺少 race,并发仅交付 draft/账号计划、未执行;不代表生成/播放或全业务验收 | 最终 run 20261028T061229-d13f404c,退出 0;并发执行器、专用账号/免费路由及残留方案仍待授权,见 32 号文档 | ## 实施边界 @@ -60,3 +61,5 @@ 2026-10-22 长请求底座增量(COD-03):`OpenAiCompatibleProvider` 新增 `GATEWAY_UPSTREAM_FIRST_BYTE_TIMEOUT_SECONDS`/`GATEWAY_UPSTREAM_IDLE_TIMEOUT_SECONDS`,流式响应有字节到达即重置空闲窗口;`GatewayRequestExecutionService` 在调用期间续期 `chat_billing_requests.expires_at`(只延长不缩短,仅 pending)和全部 Redis 租约(仅续仍持有的 token)。默认值不变,部署后行为与之前一致。后端 `mvn -B -o clean verify` **409 项,0 失败/错误/跳过**(2026-10-22 15:23)。另在本机 Docker(`infra/moyi` + `docker-compose.local.override.yml`,仅监听 127.0.0.1:18088)完成启动冒烟:健康检查、超级管理员登录、目录字段收敛、Key 创建、Mock 同步与 SSE 调用和用量记录、401/403/协议拒绝;Tripo 3D 因本地无凭据按预期失败且预留归零。 2026-10-28 媒体交付边界增量(MED-01/03):前端先新增失败回归,复现缺格式 Base64 图片、纯 data URL 音频和带凭据 URL 问题;新增共享媒体结果模块,并将缺主文件标记覆盖到图片/3D 与即时结果。增补类型/后缀检查后的最终后端 `mvn -B -o clean verify` **430 项,0 失败/错误/跳过**(13:43:34 Asia/Shanghai),前端构建及 31 项测试通过,详见 31 号文档。验收框架现在可启动,MOYI 已登记为 draft,七项匿名只读规格 `qa validate` 通过,`qa project check moyi` 无 error、仅待核实实例版本/无需凭据/未人工批准等警告;未自行 approve 或 run,不生成验收通过报告。MED-04/05 仍未完成;没有付费调用、部署或业务数据迁移。 + +2026-10-28 Docker/测试后续(QA-01):用户明确要求本地启动及使用两种 skill。本轮以 5d6253c 应用产物创建独立 Compose、新库/Redis,仅发布 18089;原 18088 不变。七项预期按上轮已展示内容批准,首轮因入口未发布 blocked=7;qa explain 后仅调整前端网络,两次复跑均 passed=7,最后一次版本标记明确、退出 0。并发依据 qa --help 无 race 停止,没有写临时脚本替代;仅整理双管理员同名建号、跨用户幂等任务 draft 和账号/残留计划,未建号/授权/生成。详见 32 号文档及档案中的正式报告;MED-04/05 不因此转为完成。 diff --git a/docs/31-media-result-delivery-boundary.md b/docs/31-media-result-delivery-boundary.md index e0ceef0..c54de6a 100644 --- a/docs/31-media-result-delivery-boundary.md +++ b/docs/31-media-result-delivery-boundary.md @@ -4,6 +4,8 @@ 负责人:Codex。更新时间:2026-10-28(Asia/Shanghai)。 关联任务:MED-01、MED-03;MED-04/05 保持未完成。 +同日后续:用户随后要求本地 Docker 启动与测试,七项已审只读规格已获准并实际通过;并发仍因缺少执行器未执行。下文保留本提交时的准备记录,后续结果以 [32 号记录](32-local-docker-acceptance-and-concurrency.md) 为准,不改变真实供应商生成/播放尚未验收的结论。 + ## 本轮接手基线 接手时工作区干净,HEAD 为 `bb3baed`;上一轮媒体实现已在 `2e53b1d` 提交。本轮不重复提交旧改动。保留后续公平排队、长请求续租,以及暂缓 COD-01/02、不存储对话、不拆分管理员权限的已记录决定。原 `moyi` 半小时自动化已取消,不重新创建。 diff --git a/docs/32-local-docker-acceptance-and-concurrency.md b/docs/32-local-docker-acceptance-and-concurrency.md new file mode 100644 index 0000000..3c3f0b2 --- /dev/null +++ b/docs/32-local-docker-acceptance-and-concurrency.md @@ -0,0 +1,91 @@ +# 本地 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,不操作线上或原本地栈。 diff --git a/infra/moyi/docker-compose.qa.yml b/infra/moyi/docker-compose.qa.yml new file mode 100644 index 0000000..f921017 --- /dev/null +++ b/infra/moyi/docker-compose.qa.yml @@ -0,0 +1,101 @@ +# Isolated local acceptance stack. Never imports infra/moyi/.env or business volumes. +name: moyi-qa + +services: + postgres: + image: postgres:15.18 + restart: unless-stopped + environment: + POSTGRES_USER: moyi_qa + POSTGRES_DB: moyi_qa + POSTGRES_PASSWORD: ${QA_MOYI_DB_PASSWORD:?Prepare the isolated QA environment file} + volumes: + - qa_postgres_data:/var/lib/postgresql/data + networks: [qa_internal] + healthcheck: + test: [CMD-SHELL, pg_isready -U moyi_qa -d moyi_qa] + interval: 3s + timeout: 3s + retries: 30 + + redis: + image: redis:7-alpine + restart: unless-stopped + environment: + REDISCLI_AUTH: ${QA_MOYI_REDIS_PASSWORD:?Prepare the isolated QA environment file} + command: [redis-server, --appendonly, 'yes', --requirepass, '${QA_MOYI_REDIS_PASSWORD}', --maxmemory, 64mb, --maxmemory-policy, noeviction] + volumes: + - qa_redis_data:/data + networks: [qa_internal] + healthcheck: + test: [CMD, redis-cli, ping] + interval: 3s + timeout: 3s + retries: 30 + + moyi-api: + image: moyi-qa-api:${QA_MOYI_REVISION:?Set the verified source revision} + build: + context: ../../control-plane-java + dockerfile: Dockerfile.runtime + labels: + org.opencontainers.image.revision: ${QA_MOYI_REVISION} + restart: unless-stopped + environment: + CONTROL_PLANE_HOST: 0.0.0.0 + CONTROL_PLANE_PORT: 8787 + SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/moyi_qa + SPRING_DATASOURCE_USERNAME: moyi_qa + SPRING_DATASOURCE_PASSWORD: ${QA_MOYI_DB_PASSWORD} + MOYI_REDIS_HOST: redis + MOYI_REDIS_PORT: 6379 + MOYI_REDIS_PASSWORD: ${QA_MOYI_REDIS_PASSWORD} + MOYI_REDIS_KEY_PREFIX: 'moyi-qa:' + ADMIN_ACCOUNT: qa-local-admin + ADMIN_DISPLAY_NAME: Local QA Administrator + ADMIN_PASSWORD: ${QA_MOYI_ADMIN_PASSWORD:?Prepare the isolated QA environment file} + AUTH_PASSWORD_PEPPER: ${QA_MOYI_PASSWORD_PEPPER:?Prepare the isolated QA environment file} + CREDENTIAL_ENCRYPTION_KEY: ${QA_MOYI_ENCRYPTION_KEY:?Prepare the isolated QA environment file} + CONTROL_PLANE_CORS_ORIGINS: http://127.0.0.1:18089 + MOYI_FORWARD_HEADERS_STRATEGY: native + AUTH_SECURE_COOKIE: 'false' + FLYWAY_ENABLED: 'true' + JAVA_OPTS: -Xms128m -Xmx512m -XX:+ExitOnOutOfMemoryError + networks: [qa_internal] + depends_on: + postgres: {condition: service_healthy} + redis: {condition: service_healthy} + healthcheck: + test: [CMD-SHELL, 'wget -q -O - http://127.0.0.1:8787/health | grep -q status'] + interval: 5s + timeout: 3s + retries: 30 + start_period: 20s + + frontend: + image: moyi-qa-frontend:${QA_MOYI_REVISION} + build: + context: ../../prototype + dockerfile: Dockerfile.runtime + labels: + org.opencontainers.image.revision: ${QA_MOYI_REVISION} + restart: unless-stopped + ports: + - '127.0.0.1:18089:80' + networks: [qa_internal, qa_edge] + depends_on: + moyi-api: {condition: service_healthy} + healthcheck: + test: [CMD-SHELL, 'wget -q -O /dev/null http://127.0.0.1/'] + interval: 5s + timeout: 3s + retries: 15 + +networks: + qa_internal: + internal: true + qa_edge: + +volumes: + qa_postgres_data: + qa_redis_data: