# InsightFlow Phase 8 Task 5 - 运营与增长工具开发

## 完成内容

### 1. 创建 `growth_manager.py` - 运营与增长管理模块

实现了完整的运营与增长工具模块，包含以下核心功能：

#### 1.1 用户行为分析（Mixpanel/Amplitude 集成）
- **事件追踪**: `track_event()` - 支持页面浏览、功能使用、转化漏斗等事件类型
- **用户画像**: `UserProfile` 数据类 - 包含活跃度、留存率、LTV 等指标
- **转化漏斗**: `create_funnel()`, `analyze_funnel()` - 创建和分析多步骤转化漏斗
- **留存率计算**: `calculate_retention()` - 支持同期群留存分析
- **实时仪表板**: `get_realtime_dashboard()` - 提供实时分析数据

#### 1.2 A/B 测试框架
- **实验管理**: 
  - `create_experiment()` - 创建实验，支持多变体
  - `start_experiment()`, `stop_experiment()` - 启动/停止实验
  - `list_experiments()` - 列出所有实验
- **流量分配**:
  - 随机分配 (Random)
  - 分层分配 (Stratified) - 基于用户属性
  - 定向分配 (Targeted) - 基于目标受众条件
- **结果分析**: `analyze_experiment()` - 计算统计显著性和提升幅度

#### 1.3 邮件营销自动化
- **邮件模板管理**:
  - `create_email_template()` - 创建 HTML/文本模板
  - `render_template()` - 渲染模板变量
  - 支持多种类型：欢迎邮件、引导邮件、流失挽回等
- **营销活动**: `create_email_campaign()` - 创建和管理批量邮件发送
- **自动化工作流**: `create_automation_workflow()` - 基于触发器的自动化邮件序列

#### 1.4 推荐系统
- **推荐计划**:
  - `create_referral_program()` - 创建邀请返利计划
  - `generate_referral_code()` - 生成唯一推荐码
  - `apply_referral_code()` - 应用推荐码追踪转化
  - `get_referral_stats()` - 获取推荐统计数据
- **团队升级激励**:
  - `create_team_incentive()` - 创建团队规模激励
  - `check_team_incentive_eligibility()` - 检查激励资格

### 2. 更新 `schema.sql` - 添加数据库表

添加了以下 13 张新表：

1. **analytics_events** - 分析事件表
2. **user_profiles** - 用户画像表
3. **funnels** - 转化漏斗表
4. **experiments** - A/B 测试实验表
5. **experiment_assignments** - 实验分配记录表
6. **experiment_metrics** - 实验指标记录表
7. **email_templates** - 邮件模板表
8. **email_campaigns** - 邮件营销活动表
9. **email_logs** - 邮件发送记录表
10. **automation_workflows** - 自动化工作流表
11. **referral_programs** - 推荐计划表
12. **referrals** - 推荐记录表
13. **team_incentives** - 团队升级激励表

以及相关的索引优化。

### 3. 更新 `main.py` - 添加 API 端点

添加了完整的 REST API 端点，包括：

#### 用户行为分析 API
- `POST /api/v1/analytics/track` - 追踪事件
- `GET /api/v1/analytics/dashboard/{tenant_id}` - 实时仪表板
- `GET /api/v1/analytics/summary/{tenant_id}` - 分析汇总
- `GET /api/v1/analytics/user-profile/{tenant_id}/{user_id}` - 用户画像

#### 转化漏斗 API
- `POST /api/v1/analytics/funnels` - 创建漏斗
- `GET /api/v1/analytics/funnels/{funnel_id}/analyze` - 分析漏斗
- `GET /api/v1/analytics/retention/{tenant_id}` - 留存率计算

#### A/B 测试 API
- `POST /api/v1/experiments` - 创建实验
- `GET /api/v1/experiments` - 列出实验
- `GET /api/v1/experiments/{experiment_id}` - 获取实验详情
- `POST /api/v1/experiments/{experiment_id}/assign` - 分配变体
- `POST /api/v1/experiments/{experiment_id}/metrics` - 记录指标
- `GET /api/v1/experiments/{experiment_id}/analyze` - 分析结果
- `POST /api/v1/experiments/{experiment_id}/start` - 启动实验
- `POST /api/v1/experiments/{experiment_id}/stop` - 停止实验

#### 邮件营销 API
- `POST /api/v1/email/templates` - 创建模板
- `GET /api/v1/email/templates` - 列出模板
- `GET /api/v1/email/templates/{template_id}` - 获取模板
- `POST /api/v1/email/templates/{template_id}/render` - 渲染模板
- `POST /api/v1/email/campaigns` - 创建营销活动
- `POST /api/v1/email/campaigns/{campaign_id}/send` - 发送活动
- `POST /api/v1/email/workflows` - 创建工作流

#### 推荐系统 API
- `POST /api/v1/referral/programs` - 创建推荐计划
- `POST /api/v1/referral/programs/{program_id}/generate-code` - 生成推荐码
- `POST /api/v1/referral/apply` - 应用推荐码
- `GET /api/v1/referral/programs/{program_id}/stats` - 推荐统计
- `POST /api/v1/team-incentives` - 创建团队激励
- `GET /api/v1/team-incentives/check` - 检查激励资格

### 4. 创建 `test_phase8_task5.py` - 测试脚本

完整的测试脚本，覆盖所有功能模块：
- 24 个测试用例
- 涵盖用户行为分析、A/B 测试、邮件营销、推荐系统
- 测试通过率：100%

## 技术实现特点

1. **代码风格一致性**: 参考 `ai_manager.py` 和 `subscription_manager.py` 的代码风格
2. **类型注解**: 使用 Python 类型注解提高代码可读性
3. **异步支持**: 事件追踪和邮件发送支持异步操作
4. **第三方集成**: 预留 Mixpanel、Amplitude、SendGrid 等集成接口
5. **统计显著性**: A/B 测试结果包含置信区间和 p 值计算
6. **流量分配策略**: 支持随机、分层、定向三种分配方式

## 运行测试

```bash
cd /root/.openclaw/workspace/projects/insightflow/backend
python3 test_phase8_task5.py
```

## 文件清单

1. `growth_manager.py` - 运营与增长管理模块 (71462 bytes)
2. `schema.sql` - 更新后的数据库 schema
3. `main.py` - 更新后的 FastAPI 主文件
4. `test_phase8_task5.py` - 测试脚本 (25169 bytes)