1.8 KiB
1.8 KiB
神射手 - 核心架构逻辑
📅 从 .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 全局缓存 |