# 存客宝 - 智能获客管理平台

## 📋 项目简介

存客宝是一个专业的微信获客和流量管理平台，提供智能化的客户获取、管理和运营解决方案。平台集成了多种自动化工具，帮助企业高效管理微信营销活动。

## 🚀 技术栈

### 前端框架
- **Next.js 15.3.5** - React 全栈框架，支持 SSR/SSG
- **React 19.1.0** - 用户界面库
- **TypeScript 5** - 类型安全的 JavaScript 超集

### UI 组件库
- **shadcn/ui** - 基于 Radix UI 的现代化组件库
- **Tailwind CSS 3.4.17** - 实用优先的 CSS 框架
- **Lucide React** - 精美的图标库
- **Framer Motion** - 动画库

### 状态管理与表单
- **React Hook Form** - 高性能表单库
- **Zod** - TypeScript 优先的模式验证
- **@hookform/resolvers** - 表单验证解析器

### 数据可视化
- **Recharts** - 基于 React 的图表库
- **Chart.js** - 灵活的图表库

### 开发工具
- **ESLint** - 代码质量检查
- **PostCSS** - CSS 后处理器
- **Autoprefixer** - CSS 前缀自动添加

## 📁 项目结构

```
Cunkebao/
├── app/                    # Next.js App Router 页面
│   ├── api/               # API 路由
│   ├── components/        # 页面级组件
│   ├── workspace/         # 工作台模块
│   ├── scenarios/         # 场景管理
│   ├── devices/           # 设备管理
│   ├── content/           # 内容管理
│   └── ...
├── components/            # 全局组件
│   ├── ui/               # shadcn/ui 组件
│   └── ...
├── lib/                  # 工具库
│   ├── api/              # API 封装
│   └── utils.ts          # 通用工具函数
├── hooks/                # 自定义 Hooks
├── types/                # TypeScript 类型定义
└── public/               # 静态资源
```

## 🎯 核心功能模块

### 工作台 (Workspace)
- **自动点赞** - 智能点赞管理
- **朋友圈同步** - 内容同步工具
- **群消息推送** - 群组消息管理
- **AI 对话助手** - 智能客服系统
- **自动建群** - 群组自动化管理
- **流量分发** - 流量分配策略

### 设备管理 (Devices)
- 设备状态监控
- 设备配置管理
- 设备性能分析

### 场景管理 (Scenarios)
- 营销场景配置
- 自动化流程设计
- 场景效果分析

### 内容管理 (Content)
- 内容创建与编辑
- 内容模板管理
- 内容发布调度

### 用户管理 (Users)
- 用户权限管理
- 角色分配
- 用户行为分析

## 🛠️ 开发指南

### 环境要求
- Node.js 18+ 
- npm 或 pnpm

### 安装依赖
```bash
npm install
# 或
pnpm install
```

### 开发环境启动
```bash
npm run dev
# 或
pnpm dev
```

### 构建生产版本
```bash
npm run build
npm start
```

### 代码检查
```bash
npm run lint
```

## 🔧 配置说明

### 环境变量
创建 `.env.local` 文件：
```env
NEXT_PUBLIC_API_BASE_URL=your_api_base_url
CUSTOM_KEY=your_custom_key
```

### Next.js 配置
- 支持图片优化和多种格式
- 配置了 API 代理和 CORS
- 启用了 SWC 压缩
- 支持包分析工具

### Tailwind CSS 配置
- 支持暗色模式
- 自定义颜色系统
- 响应式设计支持

## 📱 响应式设计

项目采用移动优先的响应式设计：
- 支持桌面端、平板端、移动端
- 自适应布局组件
- 触摸友好的交互设计

## 🎨 UI 设计系统

### 设计原则
- 简洁现代的设计风格
- 一致的用户体验
- 无障碍访问支持

### 组件库
- 50+ 个预构建组件
- 完整的表单组件
- 数据展示组件
- 导航和布局组件

## 🔒 安全特性

- 身份验证和授权
- API 请求拦截
- 数据验证和清理
- CORS 配置

## 📊 性能优化

- 代码分割和懒加载
- 图片优化
- 缓存策略
- 包大小优化

## 🤝 贡献指南

1. Fork 项目
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 创建 Pull Request

## 📄 许可证

本项目采用 MIT 许可证。

## 📞 联系方式

如有问题或建议，请联系开发团队。

---

**版本**: 0.1.0  
**最后更新**: 2024年12月