180 lines
3.9 KiB
Plaintext
180 lines
3.9 KiB
Plaintext
---
|
||
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. **测试验证** - 功能开发后浏览器验证
|