191 lines
4.2 KiB
Markdown
191 lines
4.2 KiB
Markdown
# 存客宝 - 智能获客管理平台
|
|
|
|
## 📋 项目简介
|
|
|
|
存客宝是一个专业的微信获客和流量管理平台，提供智能化的客户获取、管理和运营解决方案。平台集成了多种自动化工具，帮助企业高效管理微信营销活动。
|
|
|
|
## 🚀 技术栈
|
|
|
|
### 前端框架
|
|
- **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月 |