# 报告生成编排 Pipeline

## 执行流程图

```
┌─────────────────────────────────────────────────────────────────┐
│                        输入参数                                  │
│  industryName + categoryKeywords + competitorBrands + vocAsins  │
└───────────┬────────────────┬────────────────┬───────────────────┘
            │                │                │
            ▼                ▼                ▼
┌───────────────┐ ┌──────────────────┐ ┌──────────────────┐
│   Stage 1     │ │    Stage 2       │ │    Stage 4       │
│ 品类市场数据   │ │  竞品品牌数据     │ │  社媒热度&趋势    │
│               │ │                  │ │                  │
│ 1.1 产品搜索  │ │ 2.1 竞品产品详情  │ │ 4.1 TikTok视频   │
│   ↓           │ │ 2.2 竞品IG画像   │ │ 4.2 关键词趋势    │
│ 1.2 产品详情  │ │ 2.3 竞品TikTok   │ │ 4.3 关键词搜索量  │
│ 1.3 销量数据  │ │ 2.4 IG帖子分析   │ │ 4.4 达人搜索     │
│               │ │                  │ │                  │
│ → marketOver  │ │ → competitor     │ │ → socialTrends   │
│    view       │ │    Benchmark     │ │                  │
└───────┬───────┘ └────────┬─────────┘ └────────┬─────────┘
        │                  │                     │
        │     ┌────────────┼─────────────────────┘
        │     │            │
        ▼     ▼            │
┌──────────────────┐       │
│    Stage 3       │       │
│  VOC评论采集      │       │
│                  │       │
│ 3.1 评论批量抓取  │       │
│   ↓              │       │
│ 3.2 AI情感分析   │       │
│                  │       │
│ → vocAnalysis    │       │
└────────┬─────────┘       │
         │                 │
         ▼                 │
┌──────────────────┐       │
│    Stage 5       │       │
│  广告关键词分析   │◄──────┘
│                  │
│ 5.1 ASIN反查词   │
│ 5.2 AI关键词推荐  │
│                  │
│ → adKeyword      │
│   Recommendations│
└────────┬─────────┘
         │
         ▼
┌──────────────────────────────────────┐
│           Stage 6                    │
│       AI 综合分析与策略生成            │
│                                      │
│  6.1 执行策略生成 (短/中/长期)         │
│  6.2 Listing 优化建议                 │
│  6.3 品类机会矩阵评估                 │
│                                      │
│  → strategyPlan                      │
│  → listingOptimization               │
│  → categoryMatrix                    │
└──────────────────┬───────────────────┘
                   │
                   ▼
┌──────────────────────────────────────┐
│           Stage 7                    │
│          报告渲染                     │
│                                      │
│  7.1 组装报告数据 (17个Slide)         │
│  7.2 渲染 HTML 报告                   │
│      - Chart.js 图表注入              │
│      - 数据卡片/表格填充              │
│      - 进度条/动画配置                │
│                                      │
│  → finalReport.html                  │
└──────────────────────────────────────┘
```

## 并行度说明

| 阶段 | 并行策略 | 预计耗时 |
|------|---------|---------|
| Stage 1 | 品类间并行，每品类内串行 | 30-60s |
| Stage 2 | 品牌间并行，IG/TikTok并行 | 15-30s |
| Stage 3 | ASIN间并行，分页串行 | 40-80s |
| Stage 4 | 品类词/趋势词全并行 | 15-20s |
| Stage 5 | 依赖Stage3+4，ASIN并行 | 15-25s |
| Stage 6 | 依赖全部前置Stage，3个AI分析并行 | 30-60s |
| Stage 7 | 串行组装+渲染 | 5-10s |
| **总计** | Stage 1/2/4 可并行 | **3-5分钟** |

## 数据依赖关系

```
Stage 1 (市场数据) ──────────────────────────────────────→ Stage 6
Stage 2 (竞品数据) ──────────────────────────────────────→ Stage 6
Stage 3 (VOC分析)  ──→ Stage 5 (广告关键词) ─────────────→ Stage 6
Stage 4 (社媒趋势) ──→ Stage 5 (广告关键词) ─────────────→ Stage 6
                                                           ↓
                                                        Stage 7 (渲染)
```

## 报告 Slide 与数据源映射

| Slide # | 页面名称 | 数据来源 Stage |
|---------|---------|---------------|
| 0 | 封面 | input |
| 1 | 目录 | 静态 |
| 2 | 执行摘要 | Stage 1 + 3 + 6 |
| 3 | 市场全景 | Stage 1 |
| 4 | 竞品对标 | Stage 2 |
| 5 | 用户VOC | Stage 3 |
| 6 | 线索清单 | Stage 4 + 6.3 |
| 7 | 执行策略 | Stage 6.1 |
| 8 | 总结展望 | Stage 6 |
| 9 | VOC系统价值 | 静态 |
| 10 | 智能仪表盘 | Stage 1 + 3 (实时数据Mock) |
| 11 | 知识中心 | Stage 2 + 4.4 |
| 12 | 趋势雷达 | Stage 4 |
| 13 | AI洞察 | Stage 3 + 5 |
| 14 | 社媒聆听 | Stage 4 |
| 15 | Listing优化 | Stage 5 + 6.2 |
| 16 | 致谢 | 静态 |

## API 调用量估算

以香薰行业（5品类, 3竞品, 3个VOC ASIN, 5个趋势词）为例:

| 接口类型 | 调用明细 | 次数 |
|---------|---------|------|
| product_search | 5品类 × 1页 | 5 |
| product_detail_query | 5品类 × 20产品 | 100 |
| asin_sales_volume | 5品类 × 10产品 | 50 |
| product_reviews_query | 3 ASIN × 10页 | 30 |
| keyword_search | 5趋势词 | 5 |
| keyword_search_trend | 5趋势词 | 5 |
| asin_reverse_keywords | 3 ASIN | 3 |
| **Sorftime 小计** | | **~198** |
| tiktok_video_search | 5品类 | 5 |
| tiktok_user_search | 3品类 | 3 |
| tiktok_user_profile | 2品牌(有TikTok的) | 2 |
| instagram_user_info | 3品牌 | 3 |
| instagram_user_posts | 3品牌 | 3 |
| **TikHub 小计** | | **~16** |
| AI 分析 | 5次 (VOC/策略/Listing/关键词/矩阵) | 5 |
| **总计** | | **~219** |