# 神射手数据中台 - 系统架构

> 📅 更新: 2026-01-31

---

## 一、四层架构

```
客户端层 → 网关层 → 服务层 → 数据层
```

### 1.1 客户端层
- 浏览器 (localhost:3001)
- 飞书机器人
- 企业微信
- API调用方

### 1.2 网关层
- **Next.js 14**：前端 + /api/* 接口
- **卡若AI Gateway**：/feishu/*, /wecom/*

### 1.3 服务层
- 用户查询：queryFullProfile, intelligentSearch
- AI对话：parseIntent, handleQuery
- 标签统计：$sample 采样
- 流量池：user_evaluation_score 分桶
- 人群圈选：按项目 getProjectPools

### 1.4 数据层
- MongoDB localhost:27017
- 26个KR_*数据库
- 20.13亿条记录

---

## 二、架构图

```mermaid
graph TB
    subgraph 客户端
        A[浏览器] 
        B[飞书]
        C[企微]
    end
    
    subgraph 网关
        D[Next.js :3001]
        E[卡若AI Gateway :8000]
    end
    
    subgraph 服务
        F[用户查询]
        G[AI对话]
        H[标签引擎]
        I[流量池]
    end
    
    subgraph 数据
        J[(MongoDB :27017)]
    end
    
    A --> D
    B --> E
    C --> E
    D --> F
    D --> G
    D --> H
    D --> I
    E --> G
    F --> J
    G --> J
    H --> J
    I --> J
```

---

## 三、数据流向
```
数据源(KR_*) → AI标签引擎 → KR.用户估值 → 流量池分层 → 导出/发送
```

---

## 四、关联文档
- [核心架构逻辑.md](./核心架构逻辑.md)
- [技术选型.md](./技术选型.md)
- [数据库.md](./数据库.md)