smart-customer-service/QUICK_START.md

🚀 智能客服系统 - 快速启动指南

一键启动（推荐）

# 克隆项目
git clone https://giter.top/openclaw/smart-customer-service.git
cd smart-customer-service

# 一键启动所有服务
./scripts/start-dev.sh

手动启动

1. 启动基础设施

# 启动数据库和缓存
docker-compose up -d postgres redis adminer

# 等待数据库就绪
sleep 10

2. 启动后端服务

cd backend
go run cmd/server/main.go
# 或使用预编译版本
# ./cmd/server/main

3. 启动前端服务

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测试

# 健康检查
curl http://localhost:8080/health

# 用户登录
curl -X POST http://localhost:8080/api/v1/auth/login

# 获取用户资料
curl http://localhost:8080/api/v1/users/profile

🛠️ 开发命令

# 前端开发
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/              # 文档

🔄 更新项目

# 拉取最新代码
git pull origin main

# 重启服务
docker-compose restart

🚨 故障排除

# 查看服务状态
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