# IPTV系统融合CC码 — 待补足任务清单

> 生成日期：2026-06-30
> 依据：`IPTV系统融合CC码方案介绍.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 个查询 handler
- `tcs-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` — 新增 `MergeCCCodes` / `SplitCCCode` 业务方法
- `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 天 | 全国目录中心 |