selfrelease
6.1 KiB
IPTV系统融合MA码 — 待补足任务清单
生成日期：2026-06-30 依据：
IPTV系统融合MA码方案介绍.md与现有 TCS-IPTV 代码库对比分析 整体匹配度：约 85%
一、高优先级缺口
1. 标识查询接口 — 补充多维度查询
现状：仅支持按 MA 码查询（GET /content/mappings?ma_code=），方案要求四种查询维度。
需补足：
- 按 Hash 查询接口 — 根据
file_sha256反查 MA 码及映射关系 - 按省级内容编码查询接口 — 根据省内内容编码反查 MA 码
- 按片库文件 ID 查询接口 — 根据
media_asset_id/ 片库文件 ID 反查 MA 码
涉及文件：
tcs-iptv/internal/api/handlers.go— 新增 3 个查询 handlertcs-iptv/internal/chain/chain.go—Client接口新增 3 个查询方法tcs-iptv/internal/chain/memory.go/persistent.go— 实现反查逻辑tcs-iptv/internal/service/service.go— 新增 service 层方法
参考方案原文：
标识查询接口支持以下查询方式：根据 MA 查询；根据 Hash 查询；根据省级内容编码查询；根据片库文件 ID 查询。
2. MA 管理模块 — 补充合并/拆分功能
现状：已实现 MA 创建、维护、失效、状态管理、一致性校验，但缺少合并与拆分。
需补足：
- MA 合并接口 — 将两个或多个 MA 码合并为一个（如同一内容重复发码后合并）
- MA 拆分接口 — 将一个 MA 码拆分为多个（如合集拆分为独立剧集）
- 合并/拆分后的映射关系迁移与一致性校验
涉及文件：
tcs-iptv/internal/chain/chain.go—Client接口新增MergeMA/SplitMA方法tcs-iptv/internal/chain/memory.go/persistent.go— 实现合并/拆分逻辑tcs-iptv/internal/service/service.go— 新增MergeMACodes/SplitMACode业务方法tcs-iptv/internal/api/handlers.go— 新增 HTTP 路由tcs-iptv/internal/model/model.go— 新增合并/拆分请求与结果模型
参考方案原文：
MA 管理模块负责 MA 标识的生命周期管理，包括 MA 创建、维护、合并、拆分、失效、状态管理和一致性校验。
二、中优先级缺口
3. 系统管理模块 — 补充用户管理/组织管理
现状：已实现权限管理（四角色 + HMAC 鉴权）、配置管理、日志管理（存证），但用户管理和组织管理不完整。
需补足：
- 用户管理 — 用户 CRUD、用户与角色绑定、用户状态管理
- 组织管理 — 组织/部门 CRUD、组织与号段关联
- RBAC 完善 — 从硬编码四角色扩展为可配置角色权限矩阵
涉及文件：
- 新建
tcs-iptv/internal/service/admin.go— 用户/组织管理业务逻辑 - 新建
tcs-iptv/internal/model/user.go— 用户与组织模型 tcs-iptv/internal/api/handlers.go— 新增管理路由组tcs-iptv/deploy/migrations/— 新增用户/组织表迁移
参考方案原文：
系统管理模块负责平台基础管理能力，包括用户管理、组织管理、权限管理、配置管理、日志管理和运行监控。
4. 目录库独立部署
现状：目录库功能通过 chain.Client（MemoryChain/PersistentChain）统一存储，未独立拆分为单独的目录库服务。
需补足：
- 评估是否需要将目录库从链客户端中拆分为独立服务
- 如拆分：新建
tcs-iptv/internal/catalog/包，独立存储 MA/Hash/文件ID/省内编码映射 - 目录库对外提供独立查询 API
参考方案原文：
目录库为本项目新增或扩展建设内容，负责存储 MA、Hash、片库文件 ID、省内内容编码等映射关系。
三、低优先级缺口（依赖外部环境或远期规划）
5. 全国目录中心与跨省数据同步
现状：已实现跨省复用准入（CrossProvinceAdmit）和全国统计（NationalStats），但缺少全国目录中心和省级数据同步机制。
需补足：
- 全国目录中心服务设计
- 省级目录库 ↔ 全国目录中心数据同步机制（增量/全量）
- 各省内容编码与全国统一 MA 之间的映射同步
- 跨省审核记录共享与审核结果回写
依赖：需多省实际接入环境，架构已预留扩展点。
参考方案原文：
建设全国目录中心，建立省级目录库与全国目录中心之间的数据同步机制，实现各省内容编码与全国统一 MA 之间的映射关系。
6. 运行监控
现状：未实现运行监控能力。
需补足：
- 接入 Prometheus 指标采集（API 延迟、错误率、链操作耗时）
- 接入 Grafana 监控面板
- 关键指标告警规则（4 金指标：Latency / Traffic / Errors / Saturation）
涉及文件：
tcs-iptv/cmd/api-svc/main.go— 嵌入 Prometheus middleware- 新建
tcs-iptv/deploy/monitoring/— Grafana 配置
参考方案原文：
系统管理模块…运行监控。该模块用于保障标识服务平台安全、稳定、可追溯运行。
7. 标识同步能力
现状：标识服务模块已实现 MA 生成、Hash 登记、标识查询、标识映射管理，但标识同步未实现。
需补足：
- 标识同步接口 — 多节点/多省间的标识数据同步
- 同步冲突检测与解决策略
依赖：与全国目录中心建设关联，属第三阶段范围。
参考方案原文：
标识服务模块…主要功能包括 MA 生成、Hash 登记、标识查询、标识映射管理和标识同步。
四、任务优先级总览
| 序号 | 任务 | 优先级 | 预估工作量 | 依赖 |
|---|---|---|---|---|
| 1 | 多维度标识查询接口 | 高 | 2-3 天 | 无 |
| 2 | MA 合并/拆分功能 | 高 | 3-5 天 | 无 |
| 3 | 用户管理/组织管理 | 中 | 5-7 天 | 无 |
| 4 | 目录库独立部署 | 中 | 3-5 天 | 架构评审 |
| 5 | 全国目录中心与数据同步 | 低 | 10+ 天 | 多省接入环境 |
| 6 | 运行监控 | 低 | 2-3 天 | 无 |
| 7 | 标识同步能力 | 低 | 5-7 天 | 全国目录中心 |