# 神射手 - 核心需求提取

> 📅 从项目代码与文档提取 | 2026-01-31

---

## 一、项目目标（金）

| 目标 | 描述 |
|:---|:---|
| 核心能力 | 输入手机号/QQ/UID → 秒级返回用户画像 |
| 数据规模 | 20亿+ 用户记录 |
| 业务价值 | 用户资产数字化、流量池管理、精准营销 |

---

## 二、五大模块需求（木）

| 模块 | 核心功能 | 验收标准 |
|:---|:---|:---|
| 数据概览 | AI对话、系统状态、数据统计 | 输入手机号可查用户 |
| 数据接入 | 数据源、AI引擎、清洗、任务、血缘 | 真实MongoDB连接 |
| 标签画像 | 标签、画像、人群圈选 | 按项目分类流量池 |
| AI Agent | 渠道、打标、清洗、报告 | 飞书/企微对接 |
| 数据市场 | 流量包、API服务 | 导出CSV、发送群 |

---

## 三、用户故事（从代码提取）

### US-001: 手机号查询
```
As a 运营人员
I want 输入11位手机号
So that 秒级获取用户画像（姓名、QQ、等级、标签）
验收: parseIntent 识别手机号 → queryFullProfile 跨库查询
```

### US-002: QQ号查询
```
As a 运营人员
I want 输入QQ号
So that 获取关联手机号及用户信息
验收: parseIntent 识别QQ → KR_腾讯.QQ+手机 → KR.用户估值
```

### US-003: 人群圈选
```
As a 营销人员
I want 按项目选择流量池
So that 查看真实用户列表
验收: /api/crowd-pools 按存客宝/点了码/微博/QQ分类
```

### US-004: 流量包导出
```
As a 运营人员
I want 点击下载按钮
So that 导出CSV格式用户数据
验收: /api/traffic-packages?action=export → 前端Blob下载
```

---

## 四、MVP边界

```yaml
已实现:
  - AI对话（手机/QQ/状态/RFM/高价值）
  - 5大模块前端页面
  - 25个API端点
  - MongoDB真实数据对接
  - 飞书/企微渠道配置

待完善:
  - 飞书机器人环境变量配置
  - Redis缓存层
  - 更多业务指标
```

---

## 五、关联文档

- [业务需求.md](./业务需求.md)
- [成本.md](./成本.md)
- [../2、架构/核心架构逻辑.md](../2、架构/核心架构逻辑.md)