# ruoyi-go

**Repository Path**: coder-cui/ruoyi-go

## Basic Information

- **Project Name**: ruoyi-go
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-12
- **Last Updated**: 2025-06-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🚀 RuoYi-Go

基于Go+Vue+TypeScript的现代化后台管理系统，支持SQLite和MySQL双数据库。

## ✨ 特性

- 🔥 **现代技术栈**: Go + Gin + Vue3 + TypeScript + Element Plus
- 🗄️ **双数据库支持**: SQLite (开发) + MySQL (生产)
- 🔐 **JWT认证**: 完整的用户认证和权限管理
- 🌐 **跨域解决**: 完善的CORS配置
- 🐳 **容器化部署**: Docker一键部署
- 📱 **响应式设计**: 移动端适配

## 📋 技术栈

### 后端
- **Go 1.23** + Gin + GORM + JWT
- **数据库**: SQLite / MySQL
- **缓存**: Redis (可选)

### 前端
- **Vue3** + TypeScript + Element Plus
- **构建**: Vite + Vue Router + Pinia

## 🚀 快速开始

### 本地开发

```bash
# 1. 克隆项目
git clone <repository-url>
cd ruoyi-go

# 2. 启动后端
cd backend
go mod download
go run main.go
# 访问: http://localhost:8080

# 3. 启动前端 (新终端)
cd frontend
npm install
npm run dev  
# 访问: http://localhost:5173

# 4. 默认账号
# 用户名: admin
# 密码: admin123
```

### Docker部署

```bash
# 生产环境 (推荐)
./scripts/docker-start.sh prod

# 测试环境
./scripts/docker-start.sh test

# 访问应用
# 前端: http://localhost:8088
# 后端: http://localhost:8080
# 默认账号: admin / admin123
```

## 🔧 项目结构

```
ruoyi-go/
├── backend/              # Go后端
│   ├── main.go          # 程序入口
│   ├── config/          # 配置文件
│   ├── controllers/     # 控制器
│   ├── models/          # 数据模型
│   ├── middleware/      # 中间件
│   ├── services/        # 业务逻辑
│   ├── routes/          # 路由定义
│   └── utils/           # 工具函数
├── frontend/            # Vue前端
│   ├── src/            # 源代码
│   ├── public/         # 静态资源
│   └── package.json    # 依赖配置
├── scripts/            # 部署脚本
│   └── docker-start.sh # 部署脚本
└── docker-compose.yml  # Docker配置
```

## 🔧 开发配置

### 后端配置
配置文件: `backend/config/config.yaml`

```yaml
server:
  port: 8080
  mode: debug

database:
  # SQLite (开发推荐)
  driver: sqlite
  source: ./data/ruoyi.db
  
  # MySQL (生产环境)
  # driver: mysql
  # host: localhost
  # port: 3306
  # username: root
  # password: your_password
  # database: ruoyi_go

jwt:
  secret: "your-secret-key"
  expire: 168h # 7天
```

### 前端配置
配置文件: `frontend/vite.config.ts`

```typescript
export default defineConfig({
  server: {
    port: 5173,
    proxy: {
      '/api': {
        target: 'http://localhost:8080',
        changeOrigin: true
      }
    }
  }
})
```

## 🐳 Docker部署

### 部署命令

```bash
# 生产环境部署
./scripts/docker-start.sh prod

# 测试环境部署  
./scripts/docker-start.sh test

# 查看服务状态
./scripts/docker-start.sh status

# 查看日志
./scripts/docker-start.sh logs
./scripts/docker-start.sh logs backend

# 重启服务
./scripts/docker-start.sh restart

# 停止服务
./scripts/docker-start.sh stop

# 清理资源
./scripts/docker-start.sh clean
```

### 部署架构

```
┌─────────────────────────────────────────┐
│                服务器                    │
├─────────────────────────────────────────┤
│  ┌─────────┐  ┌─────────┐  ┌─────────┐  │
│  │ Nginx   │  │ Go API  │  │ MySQL   │  │
│  │ :8088   │  │ :8080   │  │ :3306   │  │
│  └─────────┘  └─────────┘  └─────────┘  │
│       │            │            │       │
│  ┌─────────────────────────────────────┐ │
│  │         Docker Network             │ │
│  └─────────────────────────────────────┘ │
│                                          │
│  ┌─────────┐      ┌─────────────────────┐ │
│  │ Redis   │      │      数据卷          │ │
│  │ :6379   │      │  mysql-data         │ │
│  └─────────┘      │  redis-data         │ │
│                   └─────────────────────┘ │
└─────────────────────────────────────────┘
```

## 📊 核心功能

### ✅ 已实现
- 用户登录/登出
- JWT身份认证
- 用户信息管理
- 密码修改功能
- 响应式UI设计
- 跨域问题解决
- Docker容器化

### 🚧 开发中
- RBAC权限管理
- 用户CRUD操作
- 角色管理
- 系统参数配置

### 📋 计划中
- 部门管理
- 菜单权限
- 操作日志
- 文件上传
- 系统监控

## 🛠️ 开发工具

### 推荐IDE
- **VS Code**: Go + Vue - Official 插件
- **GoLand**: JetBrains专业Go IDE

### 调试工具
- **后端**: pprof性能分析
- **前端**: Vue DevTools
- **API**: REST Client插件

## 🔍 故障排除

### 常见问题

1. **端口占用**
   ```bash
   lsof -i :8080  # 检查8080端口
   lsof -i :5173  # 检查5173端口
   ```

2. **Go模块问题**
   ```bash
   go clean -modcache
   go mod download
   ```

3. **npm依赖问题**
   ```bash
   rm -rf node_modules
   npm install
   ```

4. **Docker问题**
   ```bash
   docker system prune -f  # 清理资源
   docker-compose down      # 停止服务
   ```

### 性能优化

- **前端**: Nginx静态服务 + Gzip压缩
- **后端**: Gin高性能路由 + 连接池
- **数据库**: MySQL优化配置 + 索引
- **缓存**: Redis缓存热点数据

## 🔒 安全特性

- JWT Token认证
- 密码哈希存储
- CORS跨域限制
- SQL注入防护
- 容器网络隔离

## 🤝 贡献指南

1. Fork项目
2. 创建特性分支 (`git checkout -b feature/amazing-feature`)
3. 提交更改 (`git commit -m 'Add amazing feature'`)
4. 推送分支 (`git push origin feature/amazing-feature`)
5. 创建Pull Request

## 📄 开源协议

本项目基于 [MIT License](LICENSE) 开源协议。

## 🙏 致谢

- [RuoYi](https://ruoyi.vip/) - 原型系统设计
- [Gin](https://gin-gonic.com/) - Go Web框架
- [Vue](https://vuejs.org/) - 前端框架
- [Element Plus](https://element-plus.org/) - UI组件库

---

⭐ 如果这个项目对你有帮助，请给个Star支持一下！