---
description: 神射手数据中台项目规则 - 每次对话前必读
globs: **/*
alwaysApply: true
---

# 神射手数据中台 - Cursor规则

## 一、对话前必读文档

每次开始对话前，必须先读取以下文档了解项目上下文：

```
1. 开发文档/00_项目核心文档.md  → 数据库结构、AI规则、API规范
2. 开发文档/01_开发进度文档.md  → 当前进度、待办任务、落地规范
3. 开发文档/02_提示词文档.md   → 历史对话提示词、默认规则
```

## 二、项目记忆要点

### 2.1 技术栈
- 前端: Next.js 14 + Radix UI + TailwindCSS + Recharts
- 后端: Python FastAPI + MongoDB
- AI模型: Qwen2.5(本地) / DeepSeek

### 2.2 数据库
- 地址: `mongodb://localhost:27017`
- 主库: `KR` (用户估值)
- 数据库: `KR_腾讯`(7亿), `KR_微博`(1.4亿), `KR_京东`, `KR_存客宝`

### 2.3 核心查询规则
```javascript
// 手机号: 11位 1[3-9]开头
// QQ号: 5-11位数字
// 微博UID: uid字段
// RFM评分: 0-100分
// 用户等级: S/A/B/C/D
```

### 2.4 AI Skill位置
```
/Users/karuo/Documents/个人/卡若AI/04_卡火（火）/_团队成员/火炬/神射手/SKILL.md
```

## 三、对话后更新规范

每次对话结束后，必须更新以下内容：

1. **开发进度文档**
   - 标记完成的任务 ✅
   - 添加完成日期
   - 更新待办任务

2. **提示词文档**
   - 记录用户提示词
   - 记录执行结果
   - 记录时间节点

3. **项目核心文档**
   - 新发现的规则
   - 数据库结构变更
   - API接口更新

## 四、UI设计规范

### 4.1 风格
- 苹果毛玻璃风格 (backdrop-blur)
- 渐变背景 (from-slate-50 via-blue-50/30 to-purple-50/20)
- 圆角卡片 (rounded-xl)
- 阴影效果 (shadow-lg)

### 4.2 颜色
```css
/* 主色调 */
purple-500 → purple-600  /* 主要按钮 */
blue-500 → blue-600      /* 次要按钮 */
green-500                 /* 成功状态 */
red-500                   /* 错误状态 */
yellow-500                /* 警告状态 */

/* 背景 */
bg-white/80              /* 卡片背景 */
bg-gradient-to-r         /* 渐变背景 */
```

### 4.3 图标
- 使用 lucide-react 图标库
- 每个模块有专属图标和emoji
- 状态有对应颜色图标

## 五、代码规范

### 5.1 文件结构
```
app/
├── page.tsx              # 首页
├── [module]/             # 功能模块
│   ├── page.tsx          # 模块首页
│   └── [subpage]/        # 子页面
│       └── page.tsx
```

### 5.2 组件规范
```typescript
"use client"  // 客户端组件必须声明

import { useState, useEffect } from "react"
import { Card, Button } from "@/components/ui"
import { Icon } from "lucide-react"

export default function PageName() {
  // 状态定义
  const [data, setData] = useState([])
  
  // 副作用
  useEffect(() => {
    // 初始化逻辑
  }, [])
  
  // 事件处理
  const handleAction = () => {
    // 处理逻辑
  }
  
  return (
    <div className="min-h-screen bg-gradient-to-br from-slate-50 via-blue-50/30 to-purple-50/20">
      {/* 页面内容 */}
    </div>
  )
}
```

## 六、API规范

### 6.1 基础路径
```
内部API: /api/[name]/route.ts
外部API: /api/shensheshou/[endpoint]
```

### 6.2 响应格式
```typescript
// 成功响应
{
  success: true,
  data: {...},
  message?: string
}

// 错误响应
{
  success: false,
  error: string,
  code?: number
}
```

## 七、调试与测试

### 7.1 开发服务器
```bash
pnpm dev  # 端口 3117，启动在 localhost:3117
./scripts/start.sh --kill  # 带端口冲突检查
# 本地端口登记: 卡若AI/00_本地端口登记.md
```

### 7.2 数据库测试
```bash
# 连接本地MongoDB
mongosh mongodb://localhost:27017
```

## 八、注意事项

1. **不要删除导航模块** - 保持5个主导航完整
2. **先读文档再开发** - 确保了解上下文
3. **及时更新文档** - 保持项目记忆
4. **中文注释** - 所有注释使用中文
5. **测试验证** - 功能开发后浏览器验证