# 接口开发说明 - 存量场景优化建议接口

## 📋 接口基本信息

- **接口路径**: `/api/v1/value/scenario-optimization`
- **请求方法**: `POST`
- **接口功能**: 基于存量场景信息和截图，分析场景不足，提供优化建议和改进方向
- **涉及页面**: `ContextStep.vue` - 生成场景挖掘与优化建议按钮
- **是否涉及大模型**: ✅ **是**
- **工作量评估**: 8 人日
- **优先级**: 中

---

## 🎯 功能描述

该接口使用大模型技术分析存量场景的不足，并提供优化建议，支持：
1. **图片识别（OCR）**: 如果上传了场景截图，使用 OCR 识别内容
2. **场景分析**: 分析现有场景的功能和不足
3. **优化建议**: 提供具体的优化建议和改进方向
4. **价值提升**: 识别可提升的价值点

---

## 📥 请求格式

```json
{
  "existing_scenarios": [
    {
      "name": "月度销售经营报表",
      "description": "统计各区域门店的月度GMV，维度单一",
      "image_url": "https://example.com/screenshot.png"  // 可选
    }
  ],
  "data_assets": [...],
  "company_info": {...}
}
```

---

## 📤 响应格式

```json
{
  "success": true,
  "data": {
    "optimization_suggestions": [
      {
        "scenario_name": "月度销售经营报表",
        "current_status": "维度单一，仅统计GMV",
        "suggestions": [
          "增加时间维度分析（同比、环比）",
          "增加商品类别维度分析",
          "增加区域对比分析"
        ],
        "potential_value": "提升决策支持能力 30%"
      }
    ]
  }
}
```

---

## 💻 技术实现要点

1. **OCR 集成**: 使用 PaddleOCR 识别场景截图
2. **大模型分析**: 调用大模型分析场景不足
3. **建议生成**: 基于分析结果生成优化建议

---

## ⚠️ 注意事项

1. **图片处理**: 支持常见图片格式（PNG、JPG、JPEG）
2. **OCR 准确性**: 需要处理 OCR 识别错误的情况
3. **建议可操作性**: 优化建议必须具体、可执行

---

## 🔗 相关文档

- [接口清单表格](../Python接口清单表格.md)
- [Python技术人员工作量文档](../Python技术人员工作量文档.md)