shensheshou/开发文档/v0-神射手集成指南.md

神射手前后端集成指南

神射手前端项目与卡若AI神射手Skill后端的完整集成方案

项目概览

组件	路径	说明
前端	/Users/karuo/Documents/开发/2、私域银行/神射手	Next.js 14 应用
后端Skill	/Users/karuo/Documents/个人/卡若AI/04_卡火（火）/_团队成员/火炬/神射手	Python 查询引擎
数据库	MongoDB Docker	20亿+ 用户记录，207GB

已完成的集成

1. MongoDB 连接器

文件: lib/mongodb.ts

// 连接配置
const MONGODB_URI = 'mongodb://admin:admin123@localhost:27017/?authSource=admin'

// 核心功能
- getMongoClient()      // 获取连接（连接池复用）
- queryUserByPhone()    // 按手机号查询
- queryFullProfile()    // 跨库完整画像
- intelligentSearch()   // 智能搜索
- getDatabaseStats()    // 数据库统计

2. API 路由对接

API	功能	数据源
/api/users	用户列表查询	KR.用户估值
/api/search	智能搜索	多库联查
/api/system-status	系统状态	MongoDB 统计
/api/rfm/group_summary	RFM 分组	KR.用户估值
/api/rfm/analyze	RFM 分析	KR.用户估值

3. 数据库映射

前端字段	MongoDB 字段	说明
phone	phone (+86前缀)	支持多格式匹配
name	name	用户姓名
rfmScore	user_evaluation_score	估值分
userLevel	user_level	用户等级
province/city	province/city	地区

快速启动

# 1. 确保 MongoDB Docker 运行中
docker ps | grep mongodb

# 2. 安装依赖
cd /Users/karuo/Documents/开发/2、私域银行/神射手
pnpm install

# 3. 启动开发服务器
pnpm dev
# 访问 http://localhost:3001

验证测试

# 系统状态（应显示 20亿+ 记录）
curl http://localhost:3001/api/system-status

# 搜索用户
curl -X POST http://localhost:3001/api/search \
  -H "Content-Type: application/json" \
  -d '{"query":"13407000001","type":"all"}'

# RFM 统计
curl http://localhost:3001/api/rfm/group_summary

数据库概览

数据库	集合数	记录数	大小
KR	15	2926万	4.73 GB
KR_腾讯	180	7.56亿	62.45 GB
KR_微博	2	2.17亿	18.67 GB
KR_京东	2	1.42亿	20.12 GB
KR_酒店	5	2.31亿	36.36 GB
总计	400+	20亿+	207 GB

关键文件

神射手/
├── lib/
│   └── mongodb.ts              # MongoDB 连接器
├── app/api/
│   ├── users/route.ts          # 用户 API
│   ├── search/route.ts         # 搜索 API
│   ├── system-status/route.ts  # 系统状态 API
│   └── rfm/
│       ├── analyze/route.ts    # RFM 分析
│       └── group_summary/route.ts # RFM 分组
├── services/
│   └── rfm-mongodb-service.ts  # RFM MongoDB 服务
└── 开发文档/
    └── v0-神射手集成指南.md    # 本文档

手机号格式处理

数据库中手机号格式为 +8613800138000，系统自动处理多种格式：

// 输入任意格式，自动匹配
"13800138000"      -> 匹配 +8613800138000
"+8613800138000"   -> 直接匹配
"8613800138000"    -> 匹配 +8613800138000

后续开发建议

1. 添加 Redis 缓存 - 热数据缓存，提升响应速度
2. 完善用户画像页面 - 显示完整跨库信息
3. 添加 QQ/微博 查询 - 利用 KR_腾讯/KR_微博 数据
4. 实现数据导出 - CSV/Excel 批量导出

---

更新时间：2026-01-31 版本：v1.0