存客宝 - 智能获客管理平台
📋 项目简介
存客宝是一个专业的微信获客和流量管理平台,提供智能化的客户获取、管理和运营解决方案。平台集成了多种自动化工具,帮助企业高效管理微信营销活动。
🚀 技术栈
前端框架
- 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
安装依赖
npm install
# 或
pnpm install
开发环境启动
npm run dev
# 或
pnpm dev
构建生产版本
npm run build
npm start
代码检查
npm run lint
🔧 配置说明
环境变量
创建 .env.local 文件:
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 配置
📊 性能优化
- 代码分割和懒加载
- 图片优化
- 缓存策略
- 包大小优化
🤝 贡献指南
- Fork 项目
- 创建功能分支
- 提交更改
- 推送到分支
- 创建 Pull Request
📄 许可证
本项目采用 MIT 许可证。
📞 联系方式
如有问题或建议,请联系开发团队。
版本: 0.1.0
最后更新: 2024年12月