Files
MAcode/3-task-IPTV-二期.md
T
selfrelease a329d4906b init: AIGC-Hub/AVCC 方案文档 + TCS-IPTV 内容可信锁定系统 MVP
- 方案文档: AVCC 体系建设、IPTV TCS 需求(0-req)/PRD(1-prd)/任务(2-task)/二三四期任务
- tcs-iptv: Go 后端(哈希SDK/MA码生成/可信数据空间mock/业务编排/HTTP API+HMAC鉴权)
- web-console: React+AntD 监管大屏(角色工作台/全流程演示/监管片库)
- 一剧一码+集级哈希, 集级下架/恢复, 全栈测试通过
2026-06-14 16:50:31 +08:00

8.7 KiB
Raw Blame History

TCS-IPTV 开发任务文档(二期:贯通)

版本:V1.0 上游文档:0-req-IPTV.md(需求)、1-prd-IPTV.mdPRD)、2-task-IPTV.md(一期/MVP 文档编号:3-task-IPTV-二期 周期:6 个月(M7-M12) 主题:多省多运营商、扩品类、强化权益(分账/追责/确权/追更/授权核验)+ MVP 遗留生产化


一、二期范围与功能映射

功能编号 功能 对应需求 本期
F08 终端播放哈希抽检 需求8
F09 统一维度数据上报与聚合 需求9
F13 跨省复用快速准入 需求13
F18 可信播放数据聚合与分账结算依据 需求21
F19 全链路责任界定与追责取证 需求22
F20 版权确权与维权举证 需求23
F21 追更与增量哈希更新 需求24
F22 授权链上链与发布前授权核验 需求25
MVP 遗留生产化(真实链/数据落库/BFF/CI)

二、二期技术栈增量

增量选型 说明
联盟链 长安链 ChainMaker 2.x 测试网(三组织节点) 替换 MVP 的 MemoryChain,落地真实合约
合约 tcs_registryGo 合约)正式部署 issueMA/registerMapping/verifyHash/revoke 等
数据回传 Kafka(可选)/ 批量 REST 海量播放数据回传与聚合
分析 ClickHouse / PostgreSQL 聚合表 以 MA 码为维度的播放/分账聚合
终端 播放器 SDKC/Go/JS 片段哈希抽检
监管大屏 控制台 BFFGo+ 会话令牌 密钥不下发浏览器(替换演示态直连)
CI/CD GitLab CI + 镜像扫描 自动构建测试发布

三、任务分解

进度图例:[ ] 未开始 · [~] 进行中 · [x] 已完成

工作包 A:真实联盟链落地(MVP 遗留)

  • A.1 ChainMaker 测试网搭建

    • 目标:三组织(监管/审核监管/运营商)节点组网,国密 SM2/SM3
    • 对应:需求16、需求20
    • 验收:节点正常出块;证书与权限配置就绪
    • 依赖:一期
  • A.2 tcs_registry 合约落地

    • 目标:按 contracts/tcs_registry 规格实现并部署 Go 合约
    • 对应:需求16-AC2、需求3、需求14
    • 验收:issueMA/registerMapping/verifyHash/revoke/revokeEpisode 全部链上可调用,规则与 MemoryChain 一致
    • 依赖:A.1
  • A.3 chain-svc 切换真实链

    • 目标:chain.Client 增加 ChainMaker 实现,配置切换 MemoryChain↔真实链
    • 对应:需求16
    • 验收:一期全部用例在真实链通过;异步上链与区块确认机制生效
    • 依赖:A.2
  • A.4 链上数据 PostgreSQL 镜像

    • 目标:content/hash/mapping/version 落 PG 镜像表,支撑高效查询
    • 对应:需求16-AC1
    • 验收:链为权威源,PG 为查询镜像,最终一致;监管查询走 PG
    • 依赖:A.3

工作包 B:监管大屏生产化(MVP 遗留)

  • B.1 控制台 BFF

    • 目标:新增 Go BFF,持有凭证,浏览器仅用会话令牌
    • 对应:需求20、需求14
    • 验收:密钥不出现在前端;登录态 + RBAC;审计登录操作
    • 依赖:一期
  • B.2 前端改造对接 BFF

    • 目标:web-console 去掉前端 HMAC 直连,改走 BFF 会话
    • 对应:需求20
    • 验收:演示态安全告警移除;功能不回退
    • 依赖:B.1

工作包 C:终端播放哈希抽检(F08

  • C.1 播放器抽检 SDK

    • 目标:终端下载片段后计算哈希,与链上比对
    • 对应:需求8-AC1、AC4
    • 验收:多集按集增量校验;提供 C/Go/JS 绑定
    • 依赖:A.3
  • C.2 异常断流与上报

    • 目标:抽检不匹配断流、切备用源、上报异常日志
    • 对应:需求8-AC2、需求15-AC3
    • 验收:篡改片段被识别并切源;日志可查
    • 依赖:C.1
  • C.3 策略开关

    • 目标:按网络负载策略性开启/关闭抽检
    • 对应:需求8-AC3
    • 验收:可配置开关;高负载自动降级
    • 依赖:C.1

工作包 D:数据回传与统一聚合(F09)

  • D.1 播放数据回传接口

    • 目标:运营商以 MA 码为维度批量回传播放/消费事件
    • 对应:需求9-AC1
    • 验收:批量接收+校验;幂等
    • 依赖:A.3
  • D.2 MA 码维度聚合

    • 目标:CP 播放量/审核量/运营商分发量按 MA 码统一聚合
    • 对应:需求9-AC2、AC3
    • 验收:三方口径一致;提供统一数据视图
    • 依赖:D.1

工作包 E:可信播放数据与分账结算(F18 / 需求21)

  • E.1 链上可信播放数据

    • 目标:以 MA 码聚合的播放数据不可篡改上链/锚定
    • 对应:需求21-AC1、AC2
    • 验收:CP 与运营商所见数据口径一致
    • 依赖:D.2
  • E.2 分账结算依据

    • 目标:以链上可信播放数据作为统一结算依据
    • 对应:需求21-AC3、AC4、AC5
    • 验收:对账差异 <5%;可查询导出
    • 依赖:E.1

工作包 F:责任界定与追责取证(F19 / 需求22)

  • F.1 全链路存证查询

    • 目标:按 MA 码调取各节点哈希存证(送审/审核/转码/媒资/注入/抽检)
    • 对应:需求22-AC1、AC3
    • 验收:各节点带时间戳、操作方、不可篡改
    • 依赖:A.4
  • F.2 责任定位与取证报告

    • 目标:比对各节点哈希,定位首次变化节点与责任方,导出取证报告
    • 对应:需求22-AC2、AC4
    • 验收:能精确定位问题环节;报告可导出
    • 依赖:F.1

工作包 G:版权确权与维权举证(F20 / 需求23)

  • G.1 确权证据链

    • 目标:MA 码+哈希+上链时间戳形成不可抵赖确权证据
    • 对应:需求23-AC1、AC2、AC4
    • 验收:可导出用于投诉/诉讼的证据链
    • 依赖:A.4
  • G.2 感知哈希侵权比对

    • 目标:感知哈希相似度比对,标记疑似侵权并关联原 MA 码
    • 对应:需求23-AC3
    • 验收:相似内容(换皮/转码)可被识别
    • 依赖:G.1

工作包 H:追更与增量哈希更新(F21 / 需求24)

  • H.1 增量哈希更新

    • 目标:仅对变化集/片段重算哈希,Merkle 仅更新变化叶子
    • 对应:需求24-AC1、AC2、AC3
    • 验收:未变化部分复用原审核结论
    • 依赖:A.4
  • H.2 追更快速赋码

    • 目标:新增集快速赋码,不触发存量重审
    • 对应:需求24-AC4
    • 验收:追更秒级完成赋码与发布
    • 依赖:H.1

工作包 I:授权链与发布前核验(F22 / 需求25)

  • I.1 授权信息上链

    • 目标:信息网络传播权(地域/期限/平台)上链存证
    • 对应:需求25-AC1
    • 验收:授权范围可查;变更可追溯
    • 依赖:A.4
  • I.2 发布/注入前授权核验

    • 目标:发布与 CDN 注入前核验授权范围,越权拦截
    • 对应:需求25-AC2、AC3、AC4
    • 验收:超地域/过期/非授权平台分发被拦截
    • 依赖:I.1

工作包 J:跨省复用快速准入(F13 / 需求13)

  • J.1 跨省凭证准入

    • 目标:B 省凭 MA 码+哈希证书准入,不重传内容文件
    • 对应:需求13-AC1、AC2
    • 验收:三重校验(MA有效+哈希一致+非黑名单)通过
    • 依赖:A.4
  • J.2 简化抽检与映射注册

    • 目标:B 省审核简化为合规抽检,生成本省流水号+映射
    • 对应:需求13-AC3、AC4
    • 验收:复用周期 15-30天 → 3-5天
    • 依赖:J.1

工作包 K:平台接入扩展与 CI/CD

  • K.1 CI/CD 流水线

    • 目标:GitLab CI 自动构建/测试/镜像扫描/发布
    • 对应:全局
    • 验收:提交触发;测试不过阻断
    • 依赖:一期
  • K.2 多省多运营商接入

    • 目标:扩展至 3-5 省,接入主流 CP 10 家以上
    • 对应:PRD 二期目标
    • 验收:平台接入≥15家;网络剧/网络电影品类覆盖
    • 依赖:A.3

四、二期里程碑

  • M6:真实 ChainMaker 落地 + 监管大屏 BFF 化(工作包 A、B)
  • M7:数据回传聚合 + 可信分账(工作包 D、E)
  • M8:追责取证 + 确权举证 + 授权核验(工作包 F、G、I)
  • M9:追更 + 跨省复用 + 终端抽检(工作包 C、H、J)
  • M10:多省多运营商接入 + CI/CD(工作包 K);二期验收

五、二期验收标准

  • 真实联盟链替换 MemoryChain,一期全部用例在链上通过
  • 监管大屏密钥不下发浏览器(BFF 会话)
  • 分账对账差异 <5%;追责可定位到环节;确权证据可导出
  • 跨省复用周期 3-5 天;追更秒级;授权越权可拦截
  • 平台接入 ≥15 家;月赋码量 ≥5 万部;月度盈亏平衡