freedak/MAcode
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 更新CC码监管方案业务版文档，新增摘要、UGC专项、直播专项、存量处置、误判申诉、水印嵌入、CC码生命周期、组织保障等章节；同步macode到cccode重命名及其他代码变更

Browse Source
This commit is contained in:
freedakgmail
2026-07-20 22:25:40 +08:00
parent 9f1e2d0a21
commit eb4a82a877
76 changed files with 2600 additions and 2122 deletions
Download Patch File Download Diff File Expand all files Collapse all files
2-task-IPTV-MVP.md
+21 -21
View File
@@ -15,7 +15,7 @@
|---------|------|---------|:----:|
| F01 | 母版多维哈希生成SDK | 需求1 | ✅ |
| F02 | 送审申报与哈希上链 | 需求2 | ✅ |
| F03 | MA码签发与1:1强绑定 | 需求3 | ✅ |
| F03 | CC码签发与1:1强绑定 | 需求3 | ✅ |
| F04 | 送审文件验真 | 需求4 | ✅ |
| F05 | CSPS审核对接与转码版哈希绑定 | 需求5 | ✅ |
| F06 | 媒体资源库入库/发布与编码映射 | 需求6 | ✅ |
@@ -184,7 +184,7 @@
- [x] **T4.2 重复哈希识别（防换壳重发）**
- 对应：需求2-AC3、需求15-AC5
- 验收：重复哈希被拦截并返回原 MA码
- 验收：重复哈希被拦截并返回原 CC码
- ✅ 完成：HashExists 拦截，测试覆盖
- [x] **T4.3 哈希值包完整性校验**
@@ -196,23 +196,23 @@
---
### 工作包 5：MA码生成与签发（F03，模式B 自行发码）
### 工作包 5：CC码生成与签发（F03，模式B 自行发码）
- [x] **T5.0 MA码生成服务（号段管理 + 按规则发码）**
- [x] **T5.0 CC码生成服务（号段管理 + 按规则发码）**
- 目标：登记发码机构分配的码段，按内容类目原子发码，保证全局唯一
- 对应：需求3-AC1~AC4、AC10
- 验收：顺序唯一、并发不重号、号段耗尽报错、格式校验/解析
- ✅ 完成：`internal/macode`（Generator + Segment + MemoryStore + Parse），9项测试通过（含200并发无重号）
- ✅ 完成：`internal/cccode`（Generator + Segment + MemoryStore + Parse），9项测试通过（含200并发无重号）
- [x] **T5.1 签发编排服务**
- 目标：审核通过后生成 MA码、调用 issueMA 签发并绑定，记录内容主表
- 目标：审核通过后生成 CC码、调用 issueMA 签发并绑定，记录内容主表
- 对应：需求3-AC2、AC5、AC9
- 验收：签发成功并绑定；主表信息完整
- ✅ 完成：`service.ApproveAndIssue`（自动发码+强绑定），测试覆盖
- [x] **T5.2 MA码+哈希证书生成**
- [x] **T5.2 CC码+哈希证书生成**
- 对应：需求3-AC7
- 验收：证书含 MA码与哈希，可被验真校验
- 验收：证书含 CC码与哈希，可被验真校验
- ✅ 完成：Certificate 字段，测试覆盖
- [ ] **T5.3 未赋码内容准入拦截**
@@ -241,15 +241,15 @@
### 工作包 7：CSPS 对接与转码版哈希（F05）
- [ ] **T7.1 CSPS 审核结论对接适配器**
- 目标：与 CSPS 审核系统对接，关联审核结论至 MA码/哈希，不改造 CSPS
- 目标：与 CSPS 审核系统对接，关联审核结论至 CC码/哈希，不改造 CSPS
- 对应：需求5-AC1、AC2
- 验收：CSPS 结论可关联并查询；对接为外挂式不改 CSPS 流程；测试覆盖（含 Mock CSPS）
- 依赖：T2.1、对接规范确认
- [ ] **T7.2 转码版哈希绑定与父子关系**
- 目标：转码后各版本哈希绑定同一 MA码，建立母版-转码版父子关系
- 目标：转码后各版本哈希绑定同一 CC码，建立母版-转码版父子关系
- 对应：需求5-AC3、AC4、AC5
- 验收：多转码版共享 MA码独立哈希；父子关系可查；测试覆盖
- 验收：多转码版共享 CC码独立哈希；父子关系可查；测试覆盖
- 依赖：T7.1、T1.2
---
@@ -257,19 +257,19 @@
### 工作包 8：媒体资源库入库/发布与映射（F06）
- [ ] **T8.1 媒资库入库与映射建立**
- 目标：审核合格内容入媒资库，建立"媒资编码↔MA码↔文件哈希↔转码版哈希"映射
- 目标：审核合格内容入媒资库，建立"媒资编码↔CC码↔文件哈希↔转码版哈希"映射
- 对应：需求6-AC1、AC2
- 验收：入库后映射可查；保留媒资自有编码；测试覆盖
- 依赖：T7.2、T1.3
- [ ] **T8.2 可发布状态门禁**
- 目标：未审核通过/未绑定 MA码的内容不得进入可发布状态
- 目标：未审核通过/未绑定 CC码的内容不得进入可发布状态
- 对应：需求6-AC3
- 验收：不合规内容无法发布；测试覆盖
- 依赖：T8.1
- [ ] **T8.3 发布携带证书校验**
- 目标：向运营商发布必须携带 MA码+哈希证书，否则拒绝
- 目标：向运营商发布必须携带 CC码+哈希证书，否则拒绝
- 对应：需求6-AC4、AC5
- 验收：缺证书发布被拒；测试覆盖
- 依赖：T8.1
@@ -334,7 +334,7 @@
### 工作包 13：监管大屏与全链路查询（F10）
- [x] **T13.1 按 MA码全链路状态查询接口**
- [x] **T13.1 按 CC码全链路状态查询接口**
- 对应：需求10、需求17-AC3
- 验收：返回三方映射+CDN端点
- ✅ 完成：`GET /api/v1/content/mappings`，端到端验证
@@ -342,14 +342,14 @@
- [x] **T13.2 监管大屏前端**
- 对应：需求10、需求11
- 验收：可视化查询、验真、应急下架
- ✅ 完成：`web-console`（Vite+React18+AntD5），MA码查询/三方映射表/哈希验真/一键下架，`npm run build` 通过；浏览器端 Web Crypto HMAC 签名与后端一致
- ✅ 完成：`web-console`（Vite+React18+AntD5），CC码查询/三方映射表/哈希验真/一键下架，`npm run build` 通过；浏览器端 Web Crypto HMAC 签名与后端一致
---
### 工作包 14：违规应急下架（F11）
- [ ] **T14.1 下架指令解析与翻译**
- 目标：单一 MA码指令解析出三方编码+CDN端点，翻译为各方下架动作
- 目标：单一 CC码指令解析出三方编码+CDN端点，翻译为各方下架动作
- 对应：需求11-AC1、AC2、需求17-AC3
- 验收：一码解析出全部映射；翻译正确；测试覆盖
- 依赖：T8.1、T9.3
@@ -422,17 +422,17 @@ T0.* 基础设施
| 2026-06-14 | T3.1-T3.3 哈希SDK | 文件哈希/Merkle/感知哈希/SDK封装，13项测试通过 | CTID 概念落地 model.Content |
| 2026-06-14 | 环境 | psql 加入 PATH（~/.zshrc），Makefile 简化 | go vet/build/test 全绿 |
| 2026-06-14 | 架构决策：MA发码模式B | 与发码机构合作拿码段，TCS自行发码 | 需求3 改写为"生成+签发"，新增 T5.0 |
| 2026-06-14 | T5.0 MA码生成服务 | internal/macode：号段管理+原子发码+解析，9项测试（含200并发无重号） | 六段式 MA.156.{行业}.{机构}/{类目}/{年份}{序列} |
| 2026-06-14 | T5.0 CC码生成服务 | internal/cccode：号段管理+原子发码+解析，9项测试（含200并发无重号） | 六段式 MA.156.{行业}.{机构}/{类目}/{年份}{序列} |
| 2026-06-14 | T4.1-4.3 / T5.1-5.2 业务编排 | internal/service：送审→发码签发→验真，8项测试通过 | service 层完成，HTTP 路由后段接入 |
| 2026-06-14 | WP7-10 业务编排 | CSPS对接/转码绑定/媒资库入库发布/CDN注入/版本重审/下架，service 层 + 16项测试 | distribution.go |
| 2026-06-14 | WP4/9/13/14 HTTP接口 + 鉴权 | api-svc 11个路由 + HMAC鉴权中间件(T0.4)；端到端冒烟10步全绿 | scripts/e2e_smoke.sh |
| 2026-06-14 | MA码持久化 | PostgresStore 号段原子分配（行级UPSERT），200并发零重号；api-svc 优先PG回退内存 | migrations/0002，解决重启丢号/多实例重号 |
| 2026-06-14 | CC码持久化 | PostgresStore 号段原子分配（行级UPSERT），200并发零重号；api-svc 优先PG回退内存 | migrations/0002，解决重启丢号/多实例重号 |
| 2026-06-14 | T13.2 监管大屏 | web-console（React18+AntD5）：查询/验真/下架，build通过 | Web Crypto HMAC 与后端一致；演示模式安全提示 |
| 2026-06-14 | M5 集成测试 | api 集成测试5项全绿（全闭环/篡改拒绝/篡改定位/权限矩阵/下架时效） | 全仓60+测试通过，MVP 代码完成 |
| 2026-06-14 | 集级粒度补齐 | 一剧一码+集级哈希绑定+集级子标识(MA码#E07)+按集验真；新增 verify-episode/episodes 接口 | 需求3增AC11-13，migration 0003，3项集级测试通过，端到端验证 |
| 2026-06-14 | 集级粒度补齐 | 一剧一码+集级哈希绑定+集级子标识(CC码#E07)+按集验真；新增 verify-episode/episodes 接口 | 需求3增AC11-13，migration 0003，3项集级测试通过，端到端验证 |
| 2026-06-14 | 全流程演示前端 | web-console 新增"全流程演示"Tab：七步流水线一键执行+双锚定展示+篡改/下架按钮 | FlowDemo.jsx，四角色签名 |
| 2026-06-14 | 流程顺序修正 | 改为"先审核后发码"（CSPS审核前移，发码加审核门禁） | 需求3-AC2，全栈+测试+脚本同步 |
| 2026-06-14 | 集级面板 | 全流程页新增集级面板：各集独立哈希+集级子标识(MA码#E07)+按集验真/模拟篡改 | FlowDemo 集级表格 |
| 2026-06-14 | 集级面板 | 全流程页新增集级面板：各集独立哈希+集级子标识(CC码#E07)+按集验真/模拟篡改 | FlowDemo 集级表格 |
| 2026-06-14 | 多角色工作台 | RoleDesk：CP/审核监管/运营商 独立工作台+待办队列+全局看板，内容在各方桌面真实流转 | 新增 reviews/list 队列接口 + StatusIssued 状态 |
| 2026-06-14 | 监管片库 | RoleDesk 新增"监管片库"Tab：全片库列表+状态筛选+应急下架+三方映射/集级钻取详情 | LibraryDesk，content.file_hash 透出 |
| 2026-06-14 | 集级下架 | 子集级精准下架（RevokeEpisode），只下架某集不影响整剧；片库详情按集下架 | model.HashBinding.Revoked，TestEpisodeTakedown |