Matrix版权运维系统产品系统Vibe Coding

一、立项原因
短剧出海业务在多频道、多语种、多团队规模化管理上长期依赖人工和表格：剧目素材分发靠手工传递、版权归属难以逐条追溯、频道收入分账需要对账员逐笔核对，一旦出现盗用或收益争议，缺乏可验证的凭据。本项目（Matrix）正是为解决这些问题而立项——以「水印识别码 + 素材编号」为核心凭据，把素材生成端（DramaFlow 剪辑产出）与收入端（小五 Excel 账单）打通成可验证的业务闭环，实现从版权方、剧目、语种到频道收益的全链路数字化管理。

二、行业背景
近年来中国短剧加速出海，成为内容出海最活跃的赛道之一。海外观众（尤以东南亚、欧美市场为主）对本土语种译制短剧需求旺盛，YouTube 凭借成熟的变现体系（广告分账、Shorts 流量分成）成为短剧出海的主要分发阵地。行业普遍采用「矩阵化运营」打法：一个运营主体批量管理数十至上百个频道，按语种（印尼语、泰语、英语、西班牙语、汉语等）分发译制剧目，通过规模效应摊薄版权和制作成本。但与此同时，行业内素材盗用、跨渠道搬运频发，版权保护与收益归属凭证成为刚需；YouTube 平台规则（配额、审计、内容合规）也对运营工具的自动化和合规能力提出更高要求。

三、业务背景
平台的业务模式为：版权方提供剧目（1 个剧目可多语种）→ DramaFlow 按剧目语种剪辑产出带水印识别码的素材 → 基地（运营主体）负责管理、培训与结算 → OPC 客户领取剧目语种（独占，有效期 3 个自然月）→ 发布到自有 YouTube 频道（≥10 个）产生收入 → 导入小五结算账单，按频道/版权方双口径归因，进行四分账（频道 30% / 基地 10% / OPC 30% / CMS 资质方 30%）。

围绕这一闭环，系统落地为四个子项目：traceledger-service（后端，承担素材同步、额度计费、发布计划、数据分析、结算分账等核心逻辑）

Matrix（权流·TraceLedger）功能介绍
Matrix是面向短剧出海的一站式版权素材运营平台，由管理网页端、微信小程序、后端服务及对外开放API构成，覆盖"版权—素材—发布—数据—结算"全业务闭环。
一、版权与剧目库：管理版权方、剧目语种与标签，支持Excel批量导入与发布管线回调入库，剧目信息可通过开放API对外输出。
二、素材管理：对接DramaFlow按剧目语种产出素材，回调落库并同步云存储（含字幕），素材带唯一编号与水印识别码，通过片尾OCR匹配实现版权保护闭环；提供海报与封面制作工具。
三、组织权限：承载"平台管理员→基地→OPC客户→频道"四级账号体系，含OPC在线注册、频道申请审批、角色权限、审计日志与统一编号规则。
四、分发运营：OPC按频道语种领取剧目（同语种独占、有效期3个月），剧单跟踪素材产出；绑定YouTube频道后排期发布，支持长视频与Shorts混合排期、批量排期、1:3自动排期，发布任务幂等防重、断点续传、自动上传字幕，并提供AI文案生成与白名单全自动发布。
五、频道数据：自动拉取YouTube Analytics，提供频道数据、观众画像（年龄×性别）、视频转化分析（长视频CTR与Shorts千播涨粉分口径）、缩略图转存、违规自动检测与版权申诉、AI运营建议面板。
六、计费结算：OPC按点数下单，支持支付宝/微信充值、优惠套餐定金尾款与额度流水；导入小五收益账单，按频道/版权方双口径归因，四分账（频道30%/基地10%/OPC30%/CMS30%，比例可配置），覆盖对账与各方收益账单。
七、看板报表：管理端运营总览与待办、OPC周报（计划vs实际）、周度复盘分享、月报、剧目分析与视频转化分析。
八、培训考核：培训课表、报名管理、在线考核与小程序课堂。
九、小程序工作台：覆盖OPC日常全流程——选剧（按频道语种+观众画像）、素材与封面

Matrix 项目实现介绍

项目采用前后端分离的单体架构，一个后端服务同时支撑管理网页端、微信小程序与对外开放API三类调用方。

一、后端服务（traceledger-service）：Java 21 + Spring Boot 单体应用，按业务域划分模块（版权剧目、素材、分发发布、计费结算、数据看板、系统管理等）；MyBatis-Plus + MySQL 持久层，Flyway 管理 150+ 个版本的数据库演进；Spring Security + JWT 无状态鉴权，按"平台管理员/基地/OPC客户"多角色控权；并以 X-API-Token 鉴权对外输出剧目开放API；定时任务自动拉取频道数据、刷新观众画像与违规检测。

二、YouTube 集成：基于 Google OAuth 2.0 官方 SDK 实现频道授权与令牌自动刷新，调用 Data API 完成视频上传（幂等防重、断点续传）与字幕上传，Analytics API 拉取播放、订阅与观众画像数据。

三、外部系统对接：DramaFlow 素材回调 API（幂等落库）、小五收益账单 Excel 导入解析（EasyExcel）、支付宝/微信支付回调、腾讯云 COS 素材存储与缩略图转存、短信与邮件通知；水印版权闭环采用 OCR 识别比对；关键链路（支付回调、额度预占、外部回调）均做幂等处理与流水留痕，保证数据一致、可对账。

四、管理网页端（traceledger-web）：Vue 3 + TypeScript + Vite + Element Plus（pure-admin 框架），Tailwind CSS 样式，ECharts 数据可视化，共 160+ 页面，覆盖管理、运营、结算全场景。

五、微信小程序（traceledger-miniapp）：基于 uni-app（Vue 3 + TypeScript）编译