# 中小企业轻量级 CRM 系统

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

[![Version](https://img.shields.io/badge/version-1.0.0-blue)](https://github.com)
[![License](https://img.shields.io/badge/license-MIT-green)](https://github.com)

---

## ✨ 功能特性

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

---

## 🚀 快速开始

### 1. 安装依赖

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

### 2. 启动服务

```bash
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

---

## 🔧 开发命令

```bash
# 启动服务
npm start

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

# 运行测试
npm test
```

---

## 📝 使用场景

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

### 销售团队
- 分配销售线索
- 跟踪转化进度
- 统计销售业绩

### 个体商户
- 维护老客户复购
- 记录客户偏好
- 生日/节日提醒

---

## ✅ 已完成功能 (100%)

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

## 🚀 未来优化

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

---

## 📄 许可证

MIT License

---

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