轻量化在线客服工具

项目简介

本项目是一个轻量化、易部署的基础在线客服工具，聚焦「常见问题自动回复（关键词匹配）、人工实时沟通、记录留存与基础统计」核心需求，适配应届生独立完成，重点验证前后端交互与基础功能落地能力。

核心功能

• 知识库管理：支持常见问题（FAQ）及标准回复的录入、修改、删除、查询，按「咨询类型」分类
• 智能问答：基于关键词匹配的自动回复功能，未匹配到内容时可转接人工客服
• 人工客服：支持实时文字沟通、发送知识库中的标准回复（一键选择）
• 沟通记录管理：自动留存所有沟通记录，支持按时间、客户昵称查询
• 基础统计：统计每日咨询量、常见问题TOP5，以简单柱状图、列表形式展示

技术栈

• 后端：Node.js + Express + Socket.io + SQLite
• 前端：HTML5 + CSS3 + JavaScript (原生) + Socket.io-client
• 数据库：SQLite

项目结构

├── server/              # 后端代码
│   ├── models/          # 数据模型
│   ├── routes/          # API路由
│   ├── utils/           # 工具函数
│   └── server.js        # 后端主入口
├── client/              # 前端代码
│   ├── public/          # 静态资源
│   ├── src/             # 源代码
│   │   ├── components/  # 组件
│   │   ├── pages/       # 页面
│   │   └── assets/      # 资源文件
│   └── index.html       # 前端主页面
├── docs/                # 文档
├── package.json         # 项目配置
├── .gitignore           # Git忽略文件
└── agent.md             # 开发规范

环境搭建

1. 安装依赖

npm install

2. 启动开发服务器

npm run dev

3. 启动生产服务器

npm start

开发规范

请参考 agent.md 文件了解详细的开发规范和统一要求。

文档

• 项目需求：请参考 docs/ 目录下的相关文档
• 开发规范：请参考 agent.md 文件

贡献指南

1. 克隆项目仓库
2. 创建功能分支
3. 实现功能
4. 提交代码
5. 提交 Pull Request

许可证

MIT