Files
cunkebao_v3/Cunkebao
笔记本里的永平 dedf6be5a6 feat: 本次提交更新内容如下
更新了旧项目的代码和样式
2025-07-11 11:40:24 +08:00
..
2025-07-11 11:40:24 +08:00
2025-07-07 17:08:27 +08:00
2025-07-07 17:08:27 +08:00
2025-07-07 17:08:27 +08:00
2025-04-09 09:31:09 +08:00
2025-04-09 09:31:09 +08:00
2025-04-09 09:31:09 +08:00
2025-07-08 09:52:40 +08:00
2025-07-08 08:59:58 +08:00

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

📋 项目简介

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

🚀 技术栈

前端框架

  • 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 配置

📊 性能优化

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

🤝 贡献指南

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

📄 许可证

本项目采用 MIT 许可证。

📞 联系方式

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


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