Launcher 广告配置与播放数据

Launcher 服务解决三件事：运营人员配置桌面广告位及素材，设备按自身条件取得已生效配置，设备回传下载、安装和播放结果供运营查看。配置保存在 MySQL，执行反馈和设备播放统计保存在 TDengine；Redis 缓存服务于下发和统计去重，不是配置的唯一来源。

配置侧已演进到规则中心匹配广告位，并保留旧的渠道、地区和 MAC 条件分支。这里按当前源码解释业务，不把保留的表、旧注释或旧 SQL 一律当成已经废弃的设计。运行分支还取决于 infra 系统配置及 Nacos 配置，本次未读取运行中的配置值。

阅读导航

• 配置、素材、审批和投放关系：为什么有主配置、广告位和素材三层，规则中心与旧条件表如何共存。
• 设备执行、播放明细与统计：下发后的反馈闭环、时序子表划分与统计口径。
• 源码字段映射与结构差异：完整实体持久字段、实库额外列及需保留的兼容语义。
• MySQL 完整物理字典：类型、默认值、索引和约束。

数据源与覆盖

本服务数据源别名	实测库与对象	用途	采集覆盖
master	MySQL ik_yudao_launcher，8 张表	配置、资源关系、汇总统计	8 张表全部对应当前实体，无额外未归属表
tdLauncherAdPlayDetail	launcher_ad_play.launcher_ad_play_detail	单次播放明细	1 个超级表，74 张子表
tdLauncherAdPlayDeviceCountDay	launcher_ad_play_device_count_day.launcher_ad_play_device_count	设备日统计	1 个超级表，307 张子表
tdLauncherAdPlayDeviceCountMonth	launcher_ad_play_device_count_month.launcher_ad_play_device_count	设备月统计	1 个超级表，76 张子表
tdLauncherAdPlayDeviceCountYear	launcher_ad_play_device_count_year.launcher_ad_play_device_count	设备年统计	1 个超级表，58 张子表
tdLauncherExec	launcher_exec.launcher_exec_record	下载、安装反馈	1 个超级表，981 张子表

本次覆盖 11 个 DO：8 个 MySQL DO、3 个 TDengine DO（其中设备统计 DO 复用于日、月、年三库）。TDengine 共 5 个超级表、1496 张子表；采集的是超级表列/TAG 结构及子表数量，不包含逐子表标签值和业务记录。不能据此声称每张子表的实际命名、历史标签值都已经核验。

业务关系全景

Mermaid Diagram Code:

flowchart LR
  B[主配置：包名与适用版本] --> I[广告位：位置与分组]
  I --> A[素材配置：资源与 APK]
  F[infra 文件元数据] -.资源引用与元数据带入.-> A
  R[rule 业务绑定] -.以广告位 ID 匹配.-> I
  P[bpm 审批流程] -.主配置 ID 与审批结果.-> B
  D[device 设备属性] --> R
  I --> Q[设备获取有效配置]
  Q --> E[下载或安装回传]
  Q --> T[播放上报]
  E --> X[TDengine 执行记录]
  T --> Y[明细或设备日统计]
  Y --> Z[设备月年统计与 MySQL 汇总]

图中关联全部是业务代码、ID 或消息形成的逻辑关系。实测 MySQL 的外键清单为空；跨服务引用也没有数据库外键保障。

证据与边界

核验日期为 2026-09-18。结构依据主代理统一采集的 mysql-ik_yudao_launcher.json、5 份 tdengine-launcher*.json 及 manifest.json；采集详情见采集说明。配置绑定依据 doc/数据库设计管理/nacos/launcher-server.yaml，源码常量依据 framework/core/DataSourceConstants.java。

本目录中的 Java 相对路径均以 ik_project/yudao-cloud/yudao-module-launcher/yudao-module-launcher-biz/src/main/java/cn/iocoder/yudao/module/launcher/ 为根；Mapper XML 以同一模块的 src/main/resources/mapper/ 为根。未启动服务、运行任务、读取业务记录或检查线上 Redis 值，结构成功采集不代表业务链路运行验证通过。