70 lines
1.8 KiB
Markdown
70 lines
1.8 KiB
Markdown
# 神射手 - 核心架构逻辑
|
||
|
||
> 📅 从 .apm/docs/architecture.md 与代码提取 | 2026-01-31
|
||
|
||
---
|
||
|
||
## 一、四层架构
|
||
|
||
```
|
||
客户端层 → 网关层 → 服务层 → 数据层
|
||
```
|
||
|
||
### 1.1 客户端层
|
||
- 浏览器 (localhost:3001)
|
||
- 飞书机器人
|
||
- 企业微信
|
||
- API调用方
|
||
|
||
### 1.2 网关层
|
||
- **Next.js 14**: 前端 + /api/* 接口
|
||
- **卡若AI Gateway**: /feishu/*, /wecom/*
|
||
|
||
### 1.3 服务层（核心逻辑）
|
||
|
||
| 服务 | 核心函数 | 文件 |
|
||
|:---|:---|:---|
|
||
| 用户查询 | queryFullProfile, intelligentSearch | lib/mongodb.ts |
|
||
| AI对话 | parseIntent, handleQuery | app/api/ai-chat/route.ts |
|
||
| 标签统计 | $sample 采样 | app/api/tags/route.ts |
|
||
| 流量池 | user_evaluation_score 分桶 | app/api/traffic-packages/route.ts |
|
||
| 人群圈选 | getProjectPools, getPoolUsers | app/api/crowd-pools/route.ts |
|
||
|
||
### 1.4 数据层
|
||
- MongoDB localhost:27017
|
||
- 26个KR_*数据库
|
||
- 20.13亿条记录
|
||
|
||
---
|
||
|
||
## 二、数据流向
|
||
|
||
```
|
||
数据源(KR_*) → AI标签引擎 → KR.用户估值 → 流量池分层 → 导出/发送
|
||
```
|
||
|
||
### 2.1 核心集合
|
||
- **KR.用户估值**: 统一画像、user_evaluation_score
|
||
- **KR_腾讯.QQ+手机**: QQ↔手机
|
||
- **KR_微博.微博uid+手机**: UID↔手机
|
||
- **KR_存客宝.用户资产统一视图**: 流量池、unified_tags
|
||
|
||
---
|
||
|
||
## 三、关键设计决策
|
||
|
||
| 决策 | 原因 |
|
||
|:---|:---|
|
||
| $sample 采样 | 大表聚合超时，采样后按比例估算 |
|
||
| user_evaluation_score | 实际字段，非rfm_composite_score |
|
||
| 按项目分类人群 | 存客宝/点了码/微博/QQ 各自结构不同 |
|
||
| 连接池复用 | getMongoClient 全局缓存 |
|
||
|
||
---
|
||
|
||
## 四、关联文档
|
||
|
||
- [系统架构.md](./系统架构.md)
|
||
- [技术选型.md](./技术选型.md)
|
||
- [../.apm/docs/architecture.md](../../.apm/docs/architecture.md)
|