HENGYING·CINEPILOT · 产品线文档 02 / 09

票房监控

三级大盘 · 影片榜单 · 竞对对比 · 经营日报 · AI 归因 · 经营大屏

产品定位

票房监控是平台数据最密集的业务线(路由 /boxoffice),为经营操作系统提供「看清市场」的信号层:按 全国 → 区域 → 门店 三级维度级联筛选票房大盘,结合影片 Top 榜、区域排名、门店明细与竞对对比,支撑总部与门店的每日经营研判;经营大屏(/bigscreen)提供全屏汇报视图。

功能清单

编号功能说明状态
BO-01三级大盘 KPI全国/区域/门店级票房、人次、上座率、均价;筛选工具栏含「重置」按钮一键恢复全国视图已实现
BO-02票房趋势近 7 日票房与大盘对比曲线(随维度联动)已实现
BO-03区域排名分区票房/人次/均价/门店数统计,票房降序已实现
BO-04门店票房明细门店影片维度明细(影片/票房/占比/上座率/均价),无种子数据时确定性生成兜底已实现
BO-05影片票房 Top 榜区间影片票房排行(空数据自动兜底生成)已实现
BO-06竞对双表门店周边竞对对比(今日/昨日票房、环比)已实现
BO-07经营日报日报生成、列表、订阅推送(P0 补齐:推送订阅管理)已实现
BO-08AI 归因票房异动归因分布(口碑/档期/排片/价格/天气)已实现
BO-09经营大屏全屏汇报视图(KPI 轮播/趋势/榜单/预警流),1:1 复刻 Demo 交互已实现

关键实现

接口

接口说明
GET /api/boxoffice/overview三级大盘 KPI + 趋势(level=nation/region/store,支持 regionId/storeId)
GET /api/boxoffice/region-summary区域票房大盘表
GET /api/boxoffice/store-detail门店影片明细
GET /api/boxoffice/film-rank影片票房 Top 榜
GET /api/boxoffice/competitors竞对列表(按门店)
GET /api/boxoffice/warnings实时预警流
POST/GET /api/boxoffice/daily-report/*日报生成、列表、订阅、推送
GET /api/boxoffice/attributionAI 归因分布
GET /api/boxoffice/bigscreen经营大屏聚合数据

数据表

核心表:box_office_daily(按 dim_level 1/2/3 聚合)、box_office_film(影片维度)、box_office_hourly、competitor_store、daily_report、daily_report_subscribe、ai_attribution。

兜底策略:门店级无聚合数据时,用 DemoDataGen 按门店名/ID 哈希生成确定性数据(种子固定、每次一致),保证任何门店演示都有趋势与明细。

交互要点

场景交互
维度切换筛选栏「全国/区域/门店」级联:选区域联动门店列表,选门店展示单店视图
重置点击「重置」清空全部筛选条件并恢复全国视图
经营大屏全屏沉浸式展示,数据定时刷新,支持跳转详情
提示 IconKPI 与图表标题均有提示 Icon,按实际实现口径说明(数据源、聚合层级、兜底逻辑)