docs: 添加快速启动指南
📝 新增QUICK_START.md文档,包含:
- 一键启动脚本使用说明
- 手动启动步骤
- 访问地址和默认账号
- API测试示例
- 开发命令参考
- 故障排除指南
方便用户快速上手和部署系统
This commit is contained in:
115
QUICK_START.md
Normal file
115
QUICK_START.md
Normal file
@@ -0,0 +1,115 @@
|
|||||||
|
# 🚀 智能客服系统 - 快速启动指南
|
||||||
|
|
||||||
|
## 一键启动(推荐)
|
||||||
|
```bash
|
||||||
|
# 克隆项目
|
||||||
|
git clone https://giter.top/openclaw/smart-customer-service.git
|
||||||
|
cd smart-customer-service
|
||||||
|
|
||||||
|
# 一键启动所有服务
|
||||||
|
./scripts/start-dev.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
## 手动启动
|
||||||
|
|
||||||
|
### 1. 启动基础设施
|
||||||
|
```bash
|
||||||
|
# 启动数据库和缓存
|
||||||
|
docker-compose up -d postgres redis adminer
|
||||||
|
|
||||||
|
# 等待数据库就绪
|
||||||
|
sleep 10
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. 启动后端服务
|
||||||
|
```bash
|
||||||
|
cd backend
|
||||||
|
go run cmd/server/main.go
|
||||||
|
# 或使用预编译版本
|
||||||
|
# ./cmd/server/main
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. 启动前端服务
|
||||||
|
```bash
|
||||||
|
cd frontend
|
||||||
|
pnpm dev
|
||||||
|
```
|
||||||
|
|
||||||
|
## 📍 访问地址
|
||||||
|
- **前端界面**: http://localhost:5173
|
||||||
|
- **后端API**: http://localhost:8080
|
||||||
|
- **健康检查**: http://localhost:8080/health
|
||||||
|
- **数据库管理**: http://localhost:8082 (用户名: postgres, 密码: postgres)
|
||||||
|
|
||||||
|
## 🔧 默认账号
|
||||||
|
- **邮箱**: admin@example.com
|
||||||
|
- **密码**: admin123
|
||||||
|
|
||||||
|
## 📞 API测试
|
||||||
|
```bash
|
||||||
|
# 健康检查
|
||||||
|
curl http://localhost:8080/health
|
||||||
|
|
||||||
|
# 用户登录
|
||||||
|
curl -X POST http://localhost:8080/api/v1/auth/login
|
||||||
|
|
||||||
|
# 获取用户资料
|
||||||
|
curl http://localhost:8080/api/v1/users/profile
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🛠️ 开发命令
|
||||||
|
```bash
|
||||||
|
# 前端开发
|
||||||
|
cd frontend
|
||||||
|
pnpm dev # 启动开发服务器
|
||||||
|
pnpm build # 构建生产版本
|
||||||
|
pnpm lint # 代码检查
|
||||||
|
|
||||||
|
# 后端开发
|
||||||
|
cd backend
|
||||||
|
go run cmd/server/main.go # 启动开发服务器
|
||||||
|
go test ./... # 运行测试
|
||||||
|
go build ./cmd/server # 构建可执行文件
|
||||||
|
```
|
||||||
|
|
||||||
|
## 📦 项目结构
|
||||||
|
```
|
||||||
|
smart-customer-service/
|
||||||
|
├── frontend/ # React前端
|
||||||
|
├── backend/ # Golang后端
|
||||||
|
├── scripts/ # 工具脚本
|
||||||
|
├── docker-compose.yml # Docker配置
|
||||||
|
└── docs/ # 文档
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🔄 更新项目
|
||||||
|
```bash
|
||||||
|
# 拉取最新代码
|
||||||
|
git pull origin main
|
||||||
|
|
||||||
|
# 重启服务
|
||||||
|
docker-compose restart
|
||||||
|
```
|
||||||
|
|
||||||
|
## 🚨 故障排除
|
||||||
|
```bash
|
||||||
|
# 查看服务状态
|
||||||
|
docker-compose ps
|
||||||
|
|
||||||
|
# 查看日志
|
||||||
|
docker-compose logs -f
|
||||||
|
|
||||||
|
# 重启服务
|
||||||
|
docker-compose restart
|
||||||
|
|
||||||
|
# 完全重置
|
||||||
|
docker-compose down -v
|
||||||
|
./scripts/start-dev.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**最后更新**: 2026-02-27
|
||||||
|
**版本**: v0.1.0
|
||||||
|
**状态**: 🟢 可运行
|
||||||
|
**仓库**: https://giter.top/openclaw/smart-customer-service
|
||||||
Reference in New Issue
Block a user