使用手册 on QMTV 产品文档

QMTV 使用说明书(页面图解版)

Mon, 01 Jan 0001 00:00:00 +0000

本手册面向 QMTV 平台的三类用户:工作台用户(拆解-出图-成片创作者)、企业管理员(组织与分销)、平台管理员(/admin 运营方)。演示环境:http://localhost:3300(启动见 docs/DEPLOY.md §2.5);演示账号 admin@qmtv.com / admin123456(管理员)、demo@qmtv.com / demo123456、producer@xingmang.cn / demo123456。截图来自 Playwright 截图管线(frontend/e2e/snapshots.spec.ts,重跑 cd frontend && npm run test:snapshots);Mock 模式下素材图为占位 SVG,真实供应商接入后为实际生成结果。配套文档:人工测试清单(QA 走查底稿)· e2e 场景清单(自动化覆盖地图)。

人工测试清单(QMTV QA 走查底稿)

Mon, 01 Jan 0001 00:00:00 +0000

自动化升格映射(场景 → E2E/人工三向归类)见 docs/test/e2e-qmtv-场景清单.md;操作说明见 QMTV使用说明书_中文.md。

用法:按 T0→T7 顺序执行,每步 ☐ 打勾,实际:____ 填真实观察值/截图编号。失败即记 bug 编号。测试数据:seed 三账号 admin@qmtv.com / admin123456(管理员,10 万积分)、demo@qmtv.com / demo123456(1335 积分,seed 含欢迎通知+admin→demo 分销关系)、producer@xingmang.cn / demo123456(制片视角);计费走内置 Mock(未配置 model_endpoints 时全站同步 Mock,生成图/视频为占位素材)。前置:环境已起——生产形态 bash scripts/dev-up.sh(:3300)或 e2e 形态 bash scripts/dev/e2e/e2e-up.sh(:3301,独立库,推荐——每次 up 全量重建,水位确定);登录 admin。图例:🟢E2E-XX-NN=该用例主链路已被 Playwright 断言用例覆盖(frontend/e2e/assertion/);🟡待实现·E2E-XX-NN=场景已登记场景清单、用例待写;无标=纯人工。 ⚠️ E2E 只断 API 链路与关键业务结果(toast 存在/台账行/状态翻转):页面交互流、视觉布局、文案细节、跨页联动仍需按下表人工执行。

QMTV 使用手册 · 文档索引

Mon, 01 Jan 0001 00:00:00 +0000

本目录面向最终用户与 QA;与开发面文档(DEPLOY.md/测试规划)互补。发布视图见 my-docs Hugo 站「QMTV 文档」分区。

文件	读者	用途
QMTV使用说明书_中文.md	工作台用户/企业管理员/平台管理员	页面图解版操作手册:24 路由五段卡片(入口→截图→做什么→操作步骤→规则与注意)+ 计费速查表 + FAQ
人工测试清单.md	QA	走查底稿:T0~T7 旅程分层 ☐/实际填空表;🟢 已被 e2e 覆盖 / 🟡 待实现 / 无标纯人工三态映射
images/	—	截图 24 张(login/register/home/…/admin),由截图管线产出

截图重跑

bash scripts/dev/e2e/e2e-up.sh # 起 e2e 环境(:3301/qmtv_e2e,强制重建 frontend/dist)
cd frontend && npm run test:snapshots # 24 图全量刷新 → docs/manual/images/
bash scripts/dev/e2e/e2e-down.sh # 停环境

截图纪律:纯只读遍历+截图(dashboard 仅填表单文本不提交,零造数);信号驱动 settle(innerText>80)。