统计分析开发文档
1. 概述
统计域由 DataCubeBundle 承载，关联 YoushuBundle（腾讯有数等外部分析）。
2. 相关 Bundle
| Bundle | 职责 |
|---|---|
| DataCubeBundle | 公司/商品/门店数据、来源追踪、页面监控 |
| YoushuBundle | 有数平台对接 |
| OrdersBundle | 订单数据源（TradeFinishEvent 等 Listener 写统计） |
3. 核心文件结构
src/DataCubeBundle/
├── Http/Api/V1/Action/CompanyData.php
├── Http/Api/V1/Action/GoodsData.php
├── Http/Api/V1/Action/Sources.php
├── Http/Api/V1/Action/Monitors.php
├── Services/CompanyDataService.php
├── Services/TrackService.php
├── Jobs/StatisticJob.php
└── Jobs/GoodsDataJob.php表：datacube_monitors 等。
4. 路由与代表性 API
| 文件 | 方法 | 路径 | Action |
|---|---|---|---|
routes/api/datacube.php | GET | /api/datacube/companydata | CompanyData@getCompanyData |
| GET | /api/datacube/goodsdata | GoodsData@getGoodsData | |
| POST | /api/datacube/sources | Sources@createSources | |
routes/frontapi/datacube.php | — | C 端埋点/上报 | FrontApi Action |
routes/super/datacube.php | — | 超管侧统计 | SuperApi Action |
5. 队列
| Job | 说明 |
|---|---|
StatisticJob | 异步统计汇总 |
GoodsDataJob | 商品维度统计 |
订单支付完成等事件也会触发统计 Listener（见 OrdersBundle TradeFinishEvent 下游）。