water-management-system/中小企业需要轻量级.../README.md

中小企业轻量级 CRM 系统

📊 简单易用的客户关系管理系统，专为小企业设计

---

✨ 功能特性

• 👥 客户管理 - 添加、编辑、删除客户信息，支持标签分类
• 📞 跟进记录 - 记录每次客户沟通内容，设置下次跟进时间
• 🎯 线索管理 - 跟踪潜在客户，一键转化为客户
• 🌊 公海池 - 无人跟进客户共享池，领取后成为专属客户
• 📊 数据看板 - 实时统计客户数、跟进数等关键指标
• 🎯 销售目标 - 日/周/月目标跟踪，进度可视化
• ⏰ 跟进提醒 - 自动显示今日需跟进的客户
• 🔍 搜索筛选 - 快速查找客户
• 📥 数据导出 - 导出客户数据为 CSV 文件
• 💾 本地存储 - SQLite 数据库，单文件部署
• 📱 移动端适配 - 响应式设计，支持手机访问

---

🚀 快速开始

1. 安装依赖

cd /root/.openclaw/workspace/中小企业需要轻量级-crm-系统
npm install

2. 启动服务

npm start

3. 访问系统

打开浏览器访问：http://localhost:3001

---

📁 项目结构

中小企业需要轻量级-crm-系统/
├── src/
│   ├── backend/
│   │   ├── server.js      # Express 服务器 (13 个 API)
│   │   └── database.js    # SQLite 数据库操作 (5 张表)
│   └── data/
│       └── crm.db         # SQLite 数据库文件
├── frontend/
│   ├── index.html         # 首页/数据看板
│   ├── customers.html     # 客户管理
│   ├── leads.html         # 线索管理
│   ├── public-pool.html   # 公海池
│   └── sales-target.html  # 销售目标
├── docs/
│   └── PRD.md             # 产品需求文档
├── package.json
└── README.md

---

📋 API 接口

客户 API

方法	路径	描述
GET	/api/customers	获取客户列表
GET	/api/customers/:id	获取客户详情
POST	/api/customers	创建客户
PUT	/api/customers/:id	更新客户
DELETE	/api/customers/:id	删除客户
GET	/api/customers/:id/followups	获取跟进历史
POST	/api/customers/:id/followups	添加跟进

线索 API

方法	路径	描述
GET	/api/leads	获取线索列表
POST	/api/leads	创建线索
PUT	/api/leads/:id/convert	线索转化
DELETE	/api/leads/:id	关闭线索

公海池 API

方法	路径	描述
GET	/api/public-pool	获取公海池列表
POST	/api/customers/:id/release	放入公海池
POST	/api/public-pool/:id/claim	领取客户
GET	/api/stats/pool	公海池统计

统计 API

方法	路径	描述
GET	/api/stats/overview	概览统计
GET	/api/stats/sales	销售目标统计
GET	/api/tags	获取所有标签
GET	/api/export/customers	导出客户 CSV
GET	/api/reminders/followups	跟进提醒

---

💻 技术栈

层级	技术
后端	Node.js + Express
数据库	SQLite3
前端	HTML + TailwindCSS + Vanilla JS
部署	单进程运行

---

📊 数据模型

客户表 (customers)

• id, name, company, phone, wechat, email, tags, source, status, created_at, updated_at

跟进记录表 (followups)

• id, customer_id, content, method, result, next_followup_at, created_at

线索表 (leads)

• id, name, company, phone, requirement, status, customer_id, created_at

---

🔧 开发命令

# 启动服务
npm start

# 开发模式 (自动重启)
npm run dev

# 运行测试
npm test

---

📝 使用场景

小微企业

• 老板亲自管理几十个客户
• 记录每次沟通内容
• 不错过任何跟进机会

销售团队

• 分配销售线索
• 跟踪转化进度
• 统计销售业绩

个体商户

• 维护老客户复购
• 记录客户偏好
• 生日/节日提醒

---

✅ 已完成功能 (100%)

• 客户管理 (CRUD + 搜索 + 筛选 + 标签)
• 跟进记录 (添加/查看/提醒)
• 线索管理 (创建/转化/关闭)
• 公海池 (释放/领取)
• 销售目标 (日/周/月跟踪)
• 数据导出 (CSV)
• 移动端适配 (响应式)
• 数据看板 (实时统计)

🚀 未来优化

• 多用户/权限管理
• 邮件/短信集成
• 数据备份/恢复
• API 访问令牌

---

📄 许可证

MIT License

---

项目由 SaaS Insight 自动创建 | 最后更新：2026-03-11