# 神射手数据中台 - 后端开发规范

> 📅 更新: 2026-01-31

---

## 一、技术栈

| 项目 | 选型 |
|:---|:---|
| 运行时 | Node.js (Next.js API Routes) |
| 数据库 | MongoDB |
| 连接 | lib/mongodb.ts |

---

## 二、代码规范

| 要求 | 说明 |
|:---|:---|
| 连接池 | getMongoClient 全局缓存 |
| 查询 | 参数化，无硬编码 |
| 大表 | $sample 采样 |
| 超时 | maxTimeMS: 10000 |

---

## 三、目录结构

```
app/api/
├── ai-chat/route.ts       # AI对话
├── data-sources/route.ts  # 数据源
├── tags/route.ts          # 标签
├── traffic-packages/route.ts
├── crowd-pools/route.ts
├── monitoring/route.ts
└── ...

lib/
└── mongodb.ts             # 连接器
```

---

## 四、关联文档
- [MongoDB连接器核心.md](./MongoDB连接器核心.md)
- [../7、数据库/ER与查询逻辑.md](../7、数据库/ER与查询逻辑.md)