功能规格（FSD） on QMTV 产品文档

FSD M1 · 认证与用户

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

← 总则｜附录 → ｜上游：PRD §4 M1 实现落点：backend/internal/domain/auth/（service.go/model.go/repo.go）+ cmd/server/auth_handlers.go（handlers）+ cmd/server/routes.go:34-51（挂载）。事实基准=Go 代码；冻结版 qmtv/server/index.js:73-230 仅差异对拍参照。

FSD M10 · 导演与融合

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

← 总则｜附录 → ｜上游：PRD §4 M10 实现落点：backend/internal/domain/director/（model/split/repo/service/service_assets/export 单包多文件）+ cmd/server/director_handlers.go（28 handler）+ generation 侧双表通路三锚点（model.go:56-69 ShotView.Tbl / service_video.go:191-229 DirectorShotVideo / repo.go:261-283 LinkShotVideo）+ cmd/server/routes.go:203-238（挂载）。事实基准=Go 代码；冻结版 qmtv/server/director.js（11）/fusion.js（17）仅差异对拍参照。域内要点：双表通路——本域写 director_shots（M2 拆解台是 shots 表勿混），生成链经 ShotView.Tbl 显式表名打回；扣费面六处（三处硬编码照抄）；ZIP 导入导出；wire 全蛇形+派生视图尾插键；对账口径：routes.go:209/:223 注释「11+17」系冻结源文件口径（#1/#2 冻结在 fusion.js:221/:227 却排导演注释块），物理分组=导演 13+融合 15；PRD §4 M10 已登记差异 ①~⑮（prd-qmtv-v1.md:208）+v1.12 变更行三件（二十续 A1 form-tag/A2 空数组/A3 episodes 404 文案）引用不重立。ID 前缀 dpr_/dep_/dir_（tasks 侧 task_id=‘dir_’+project_id 约定=PRD ⑩）。

FSD M11 · 评估与工具

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

← 总则｜附录 → ｜上游：PRD §4 M11 实现落点：backend/internal/domain/evaluation/（model/service〔workbench+watchVideo〕/service_eval〔评估流水线〕/service_review〔审片双入口〕/service_viral/repo）+ cmd/server/workbench_handlers.go + cmd/server/evaluation_handlers.go + cmd/server/routes.go:239-267（挂载，审片 4 条 :264-267 物理居中）。事实基准=Go 代码；冻结版 qmtv/server/workbench.js/evaluation.js/index.js:490-513（viral）仅差异对拍参照。域内要点：评估冻结-结算是全站唯一 TypeReserve 台账面（总则 §1 词条的展开落点）；审片双入口 404 文案分叉（classic ’task not found’ vs director ’not found’）；审片面零 SSE 零通知；watchVideo 状态丢失不 emit；wire 全蛇形；PRD §4 M11 已登记差异 ①~⑭（prd-qmtv-v1.md:216）引用不重立。上传档位 up80（工作台）/up10（评估）。

FSD M12 · 管理后台

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

← 总则｜附录 → ｜上游：PRD §4 M12 实现落点：backend/internal/domain/admin/（model 276/repo 476/service 332/service_billing 416/service_prompts 250 单包多文件+三测试件）+ cmd/server/admin_handlers.go（562 行 39 handler）+ cmd/server/routes.go:268-318（挂载）。事实基准=Go 代码；冻结版 qmtv/server/index.js（admin 段 app.* 直挂非 router，19−withdrawals 2=17）+llmroutes.js（18）+routes2.js（admin 4）仅差异对拍参照。域内要点：39 条全部 amw+adminMw 双挂（403 forbidden，gateway/auth.go:133-141=冻结 adminRequired 逐字）；前端消费面≠端点族——AdminView 14 tab（AdminView.vue:667-682）中 submissions/withdrawals/scripts 三 tab 消费 M9/M7 域端点，本册 39 条按后端功能族 AH 组聚合；404 八态八哨兵刻意不同源（model.go:16-36：用户调整英文 “not found”/密码重置中文「用户不存在」/org approve 英文/指令 DELETE 英文/提示词删「版本不存在」/接入「接入不存在」/release「任务不存在或不是失败态」/重拆「任务不存在」）；bind 失败统一 400「请求体格式错误」（与 m08 裸传 return err 两域不同制）；api_key json:"-" masked-only（二十一期②收敛，PRD ④）；GetActivePrompt（整行+split 三级）↔activePromptContent（content-only 单级）两份同语义并存（二十二期 C1 裁决 a，task_assembly.go:188-189 注释「两处改动须同步对拍」）。PRD §4 M12 已登记差异 ①⑨（prd-qmtv-v1.md:222）引用不重立。

FSD M13 · 火花计划

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

← 总则｜附录 → ｜上游：PRD §4 M13 实现落点：backend/internal/domain/spark/（model/service/repo_gorp 三件）+ cmd/server/spark_handlers.go（34 行）+ cmd/server/routes.go:259-262（挂载——物理嵌在 M11 段 :258 与 :263 之间）。事实基准=Go 代码；冻结版 qmtv/server/index.js:739-766 仅差异对拍参照。域内要点：二十六期补登域（P0 统计残留第八例——冻结 index.js:739-766 两条端点从未入任何模块行）；三阶梯 tier 表单数据源（per 系）；PRD §4 M13「逐字对齐无差异」——三十期新立 DIF-30（见 m09 册/99-附录 B）。E2E-SPK-01 已实现（spark.spec.ts，清单 :15）。

FSD M2 · 任务与拆解

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

← 总则｜附录 → ｜上游：PRD §4 M2 实现落点：backend/internal/domain/task/（model/repo/service/service_gen）+ cmd/server/task_handlers.go（38 handlers 全集）+ cmd/server/task_assembly.go（LLM/模板装配）+ cmd/server/routes.go:324-361（挂载）。事实基准=Go 代码；冻结版 qmtv/server/index.js:228-366/routes2.js/routes3.js 仅差异对拍参照。

FSD M3 · 生成与素材

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

← 总则｜附录 → ｜上游：PRD §4 M3 实现落点：backend/internal/domain/generation/（model/service/service_video/service_media/provider/repo）+ cmd/server/generation_handlers.go + cmd/server/generation_assembly.go + cmd/server/routes.go:53-77（挂载）。事实基准=Go 代码；冻结版 qmtv/server/index.js:369-451/providers.js/assets.js/routes2.js:40-67,408-429/routes3.js:33-55,379-428 仅差异对拍参照。

FSD M4 · 导出交付

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

← 总则｜附录 → ｜上游：PRD §4 M4 实现落点：backend/internal/domain/export/（model/repo/service）+ cmd/server/export_handlers.go + cmd/server/routes.go:82-92（挂载）。事实基准=Go 代码；冻结版 qmtv/server/index.js:434-471/routes2.js:318-439/routes3.js:347-376 仅差异对拍参照。前端消费：ExportView.vue（编排）+ VideoView.vue（批量/下载面）。

FSD M5 · 通知公告

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

← 总则｜附录 → ｜上游：PRD §4 M5 实现落点：backend/internal/domain/notification/（service.go 读侧 89 行+hub.go SSE 基座）+ cmd/server/notify_handlers.go + cmd/server/routes.go:96-102（挂载）。事实基准=Go 代码；冻结版 qmtv/server/index.js:474-485 仅差异对拍参照。域内要点：通知零 SSE（hub.go 属本包但通知读面不走事件——写入方五源自持 INSERT）；** announcements 公开面无 amw**；read 是 MySQL 保留字全 SQL 反引号（PRD ①）；对账勿混：routes.go:288-290 /admin/announcements* 3 条属 M12 管理后台组。

FSD M6 · 组织协同

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

← 总则｜附录 → ｜上游：PRD §4 M6 实现落点：backend/internal/domain/org/（model 308/service 775/repo 209/repo_read 389/repo_groups 55/perms 53/code 24 单包多文件）+ cmd/server/org_handlers.go（460 行 29 handler）+ cmd/server/routes.go:103-136（挂载）。事实基准=Go 代码；冻结版 qmtv/server/index.js:513-597（组织段 9）+enterprise.js（20）仅差异对拍参照。域内要点：四零域（零上传/零扣费/零 SSE/零通知，无 BodyLimit——routes.go:105-106）；无组织分流四态谱：me·dashboard ok(null)｜folders·groups·perm-groups·material-perms·shared-projects ok([])｜folder create·assign·folder delete 400「您尚未加入企业」｜allocation-mode 404「未加入组织」——逐端点归属各异勿统一；owner-严格谱系（invites/remove/role/groups/perm-groups/assign 六面 ownerOnly vs material-perms 唯一 adminOrOwner 面）；「管理员」文案 vs owner 严格判定（PRD ⑩）；projectRank/memberRank 驼峰 wire 双键（同 M2 shotCount 族勿修正）；permGroups/materialPerms 响应经 map 重出（perms json:"-" 串解析为数组）。PRD §4 M6 已登记差异 ①~⑪+十九续勘正批注（prd-qmtv-v1.md:172-178）引用不重立。

FSD M7 · 分销提现

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

← 总则｜附录 → ｜上游：PRD §4 M7 实现落点：backend/internal/domain/distribution/（model 181/service 233/repo 214）+ cmd/server/distribution_handlers.go（184 行 11 handler）+ cmd/server/routes.go:137-151（挂载）。事实基准=Go 代码；冻结版 qmtv/server/index.js:598-638（用户面 7）+:708-737（状态机 4）两段不连续（中间隔 admin 段 :640-:703）仅差异对拍参照。域内要点：零域铁律——withdrawals/exchanges 全域不触 users.credits/credit_records/通知/SSE（「返佣写入方在 M8 approve 链」model.go:4-8，唯一写入方 M8 F8.03）；available 分母无 status 过滤（cancelled/rejected 永不释放额度——:715 note「收益已解锁」冻结谎言照抄）；settings 回退双 shape 不可合并（overview 三键 vs 提现面一键）；affiliate_threshold 980 硬编码与 M8 不同源勿统一；W_FLOW 严格邻接状态机（终态无键恒 400）；admin PUT 不限属主 vs cancel/confirm 属主强制。bind 形态：POST/PUT 三处裸传 return err（echo 默认 400 无统一信封——与 m12「请求体格式错误」两域不同制）。PRD §4 M7 已登记差异 ①~⑩（prd-qmtv-v1.md:180-184）引用不重立。

FSD M8 · 充值

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

← 总则｜附录 → ｜上游：PRD §4 M8 实现落点：backend/internal/domain/recharge/（model 118/repo 209/service 381）+ cmd/server/recharge_handlers.go（161 行 8 handler）+ cmd/server/routes.go:152-166（挂载，up8 := BodyLimit("8mb") :158 proof/pay-qrcode 共用）。事实基准=Go 代码；冻结版 qmtv/server/recharge.js（8 条 :28-:120，admin 4 条 router 内写死 /admin/ 前缀）仅差异对拍参照。域内要点：M8 是 M7 的返佣写入方（commission_records 唯一写入方在 approve 链——M7 零域的另一面）；404 文案三态分叉（「订单不存在或已处理」vs proof 面「订单不存在」vs 400「已处理不可重复提交凭证」——model.go:21-32 三哨兵）；approve 零事务补偿序七步（MarkPaid→到账→两级返佣→资格联动→通知→SSE——禁事务铁律顺合冻结补偿式一致性）；reject 双截断不同源（落库 200/通知 100）；orderNo=‘RCH’+毫秒+3 位随机非 uid 勿用 ids 包；recharge_orders.credits 刻意不 DECIMAL（0004 七列外——到账恒整数）；SSE recharge 仅发本人（M12 无 SSE 的对照面）。bind 形态：裸传 return err（与 m12「请求体格式错误」两域不同制）。PRD §4 M8 已登记差异 ①~⑧（prd-qmtv-v1.md:188）引用不重立。

FSD M9 · 剧本库与投稿

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

← 总则｜附录 → ｜上游：PRD §4 M9 实现落点：backend/internal/domain/scriptlib/（model/repo/service〔scriptlib.js 9+ensureSeed〕/service_studio〔studio.js 16〕/seeds）+ cmd/server/scriptlib_handlers.go + cmd/server/routes.go:167-202（挂载）。事实基准=Go 代码；冻结版 qmtv/server/scriptlib.js/studio.js 仅差异对拍参照。域内要点：admin 9 端点叠 AdminMiddleware（403 forbidden）；wire 全蛇形（model.go json tag 亲证零驼峰）；两套正则刻意勿合并（seedEpisodeRe 带 \s* service.go:78 vs catalogRe 无 :196）；两套Genres 清单（scriptlib.js 11 项 service.go:25 vs studio.js studioGenres 11 项 service_studio.go:21——冻结死导出未消费，Go 不移植）；ID 前缀 sl_/su_/sub_/wp_/up_/na_（ids.go:29-50）。

FSD 附录 · PRD 对照 / 代码域索引 / 差异台账

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

← 总则｜上游：PRD（§3 模块清单 / §4 差异登记）

附录 A1：PRD 模块 → FSD 分册对照（权威）

PRD 模块	分册	F-ID 段	端点数	覆盖期
基础（SSE/health/release-mode）	总则 §2.2/§2.5 覆盖，无独立分册	—	3	骨架期
M1 认证与用户	m01-认证与用户	F1.01~	9	二十八期
M2 任务与拆解	m02-任务与拆解	F2.01~	38	二十九期
M3 生成与素材	m03-生成与素材	F3.01~	19	二十九期
M4 导出交付	m04-导出交付	F4.01~	10	二十九期
M5 通知公告	m05-通知公告	F5.01~	4	三十期
M6 组织协同	m06-组织协同	F6.01~	29	三十一期
M7 分销提现	m07-分销提现	F7.01~	11	三十一期
M8 充值	m08-充值	F8.01~	8	三十一期
M9 剧本库与投稿	m09-剧本库与投稿	F9.01~	25	三十期
M10 导演与融合	m10-导演与融合	F10.01~	28	三十期
M11 评估与工具	m11-评估与工具	F11.01~	14	三十期
M12 管理后台	m12-管理后台	F12.01~	39	三十一期
M13 火花计划	m13-火花计划	F13.01~	2	三十期

附录 A2：代码域 → 分册反向索引

backend 域包	分册
`internal/domain/auth`	m01
`internal/domain/task`	m02
`internal/domain/generation`	m03
`internal/domain/export`	m04
`internal/domain/notification`	m05
`internal/domain/org`	m06
`internal/domain/distribution`	m07
`internal/domain/recharge`	m08
`internal/domain/scriptlib`	m09
`internal/domain/director`	m10
`internal/domain/evaluation`	m11
`internal/domain/admin` + `internal/domain/llm`	m12
`internal/domain/spark`	m13
`internal/domain/credits`（计费横切）	总则 §2.3 + 各分册扣费节
`internal/infra/{hub,ids,storage}` + `internal/gateway`	总则 §2.2/§2.5/§2.7
`cmd/server/routes.go`（基础 3 条：/api/events、/api/health、release-mode）	总则 §2.2/§2.5
`internal/recovery`（启动恢复四扫描）	跨域，见总则 §2.3 退款唯一口 + m02/m03

附录 B：实现差异台账（DIF）

格式 DIF-<期>-<序号>；FSD 撰写期新发现逐条登记。PRD §4 已登记的移植差异不重复立目，功能节内直接引用（如「差异⑤族」）。处置列：登记（有意保真）/待裁决/已修。

QMTV 功能规格说明书（FSD）v1.0 · 总则

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

上游文档：prd-qmtv-v1.md（需求与契约）。本文档以 Go 实现代码为事实基准（backend/，239/239 收官），按模块还原系统真实运转规则；与 PRD 的差异以 > ⚠️ 差异 DIF-<批次>-<序号> 注记并登记 99-附录 B。冻结版 Express（qmtv/server/）仅作差异对拍参照，不再单独展开。功能 ID 规则：F<m>.<两位序号>（m = PRD 模块号 M1~M13）。ID 全局唯一、只增不改号；分册文件 m<m>-<中文名>.md。