# easy-go-gin-admin

**Repository Path**: 694243440/easy-go-gin-admin

## Basic Information

- **Project Name**: easy-go-gin-admin
- **Description**: 一个基于Go语言和Gin框架的轻量级后台管理项目，提供快速开发、高效管理和易于扩展的解决方案。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-10
- **Last Updated**: 2026-03-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 通用后台管理系统

基于 Go + Vue3 的企业级后台管理系统，为后续台球系统开发做准备。

## 📋 功能模块

- ✅ 用户管理
- ✅ 角色管理
- ✅ 权限管理 (RBAC)
- ✅ 部门管理
- ✅ 字典管理
- ✅ 日志管理
- ✅ 系统配置

## 🛠️ 技术栈

### 后端
- Go 1.21+
- Gin (Web 框架)
- GORM (ORM)
- MySQL 8.0
- JWT (认证)

### 前端
- Vue 3.4+
- TypeScript
- Element Plus
- Pinia (状态管理)
- Vue Router
- Axios

## 📁 项目结构

```
myPreject/
├── backend/                 # Go 后端
│   ├── cmd/
│   │   └── main.go         # 入口文件
│   ├── internal/
│   │   ├── config/         # 配置
│   │   ├── handler/        # HTTP 处理器
│   │   ├── middleware/     # 中间件
│   │   ├── model/          # 数据模型
│   │   └── service/        # 业务逻辑
│   ├── pkg/
│   │   ├── password/       # 密码工具
│   │   └── response/       # 响应工具
│   ├── config.yaml         # 配置文件
│   └── go.mod
│
└── frontend/               # Vue 前端
    ├── src/
    │   ├── api/            # API 接口
    │   ├── components/     # 组件
    │   ├── router/         # 路由
    │   ├── views/          # 页面
    │   └── main.ts
    ├── package.json
    └── vite.config.ts
```

## 🚀 快速开始

### 1. 数据库初始化

```sql
CREATE DATABASE admin_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

### 2. 后端启动

```bash
cd backend

# 修改 config.yaml 中的数据库配置
# db_dsn: "root:你的密码@tcp(localhost:3306)/admin_system?charset=utf8mb4&parseTime=True&loc=Local"

# 安装依赖
go mod download

# 运行
go run cmd/main.go
```

服务启动在 `http://localhost:8080`

### 3. 前端启动

```bash
cd frontend

# 安装依赖
npm install

# 开发模式
npm run dev
```

访问 `http://localhost:3000`

## 🔐 默认账号

- 用户名：`admin`
- 密码：`123456`

## 📝 API 文档

### 认证接口
- `POST /api/auth/login` - 登录
- `POST /api/auth/logout` - 登出
- `GET /api/auth/info` - 获取当前用户信息

### 用户接口
- `GET /api/users` - 用户列表
- `POST /api/users` - 创建用户
- `PUT /api/users/:id` - 更新用户
- `DELETE /api/users/:id` - 删除用户

### 角色接口
- `GET /api/roles` - 角色列表
- `POST /api/roles` - 创建角色
- `PUT /api/roles/:id/permissions` - 分配权限

### 权限接口
- `GET /api/permissions/tree` - 权限树
- `POST /api/permissions` - 创建权限

### 部门接口
- `GET /api/depts/tree` - 部门树
- `POST /api/depts` - 创建部门

### 字典接口
- `GET /api/dicts` - 字典列表
- `POST /api/dicts/:id/items` - 创建字典项

### 日志接口
- `GET /api/logs/operation` - 操作日志
- `GET /api/logs/login` - 登录日志

## 📊 数据库表

| 表名 | 说明 |
|------|------|
| sys_user | 用户表 |
| sys_role | 角色表 |
| sys_permission | 权限表 |
| sys_user_role | 用户角色关联 |
| sys_role_permission | 角色权限关联 |
| sys_dept | 部门表 |
| sys_dict | 字典表 |
| sys_dict_item | 字典项表 |
| sys_log | 操作日志 |
| sys_login_log | 登录日志 |
| sys_config | 系统配置 |

## 🎯 下一步

1. 完善角色权限分配功能
2. 完善字典项管理
3. 添加系统配置页面
4. 集成台球系统业务模块

## 📄 License

MIT