# 为通用后台开发的go后端接口

**Repository Path**: xiaokang69/admin-glm-go

## Basic Information

- **Project Name**: 为通用后台开发的go后端接口
- **Description**: 为通用后台开发的go后端接口
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-17
- **Last Updated**: 2025-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Admin GLM Go

基于Go语言开发的后台管理系统，使用Gin框架和GORM ORM，实现了用户认证、权限管理、菜单管理、文章管理等功能。

## 功能特点

- 用户认证：JWT认证，支持登录、退出、获取当前用户信息
- 管理员管理：支持管理员列表、添加、修改、删除、重置密码
- 角色管理：支持角色列表、添加、修改、删除，支持角色权限分配
- 权限管理：支持权限列表、树形结构、添加、修改、删除
- 菜单管理：支持菜单列表、树形结构、用户菜单、添加、修改、删除
- 文章管理：支持文章列表、详情、添加、修改、删除，支持文章分类管理

## 技术栈

- Go 1.21
- Gin Web框架
- GORM ORM
- MySQL数据库
- JWT认证

## 项目结构

```
admin-glm-go/
├── main.go                 # 应用入口
├── go.mod                  # Go模块文件
├── go.sum                  # 依赖校验文件
├── .env.example            # 环境配置示例
├── api-documentation.md    # API接口文档
├── database.sql            # 数据库结构
├── go-coding-standards.md  # Go编码规范
└── internal/               # 内部包
    ├── config/             # 配置管理
    │   └── config.go
    ├── controllers/        # 控制器
    │   ├── auth.go         # 认证控制器
    │   ├── admin.go        # 管理员控制器
    │   ├── role.go         # 角色控制器
    │   ├── permission.go   # 权限控制器
    │   ├── menu.go         # 菜单控制器
    │   └── article.go      # 文章控制器
    ├── database/           # 数据库连接
    │   └── database.go
    ├── middleware/         # 中间件
    │   └── middleware.go
    ├── models/             # 数据模型
    │   └── models.go
    ├── response/           # 响应处理
    │   └── response.go
    ├── routes/             # 路由配置
    │   └── routes.go
    └── utils/              # 工具函数
        └── utils.go
```

## 安装与运行

### 环境要求

- Go 1.21+
- MySQL 5.7+

### 安装步骤

1. 克隆项目
```bash
git clone https://gitee.com/xiaokang69/admin-glm-go.git
cd admin-glm-go
```

2. 安装依赖
```bash
go mod tidy
```

3. 配置环境变量
```bash
cp .env.example .env
# 编辑 .env 文件，修改数据库连接等配置
```

4. 创建数据库
```sql
CREATE DATABASE admin_glm_go CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

5. 导入数据库结构
```bash
mysql -u root -p admin_glm_go < database.sql
```

6. 运行项目
```bash
go run main.go
```

7. 访问API文档
```
http://localhost:8080
```

## API接口

### 认证相关

- POST /api/auth/login - 用户登录
- POST /api/auth/logout - 用户退出
- GET /api/auth/current - 获取当前用户信息

### 管理员管理

- GET /api/admin/list - 获取管理员列表
- POST /api/admin/add - 添加管理员
- PUT /api/admin/update - 更新管理员
- DELETE /api/admin/delete/:id - 删除管理员
- PUT /api/admin/reset-password - 重置管理员密码

### 角色管理

- GET /api/role/list - 获取角色列表
- POST /api/role/add - 添加角色
- PUT /api/role/update - 更新角色
- DELETE /api/role/delete/:id - 删除角色
- GET /api/role/all - 获取所有角色

### 权限管理

- GET /api/permission/list - 获取权限列表
- GET /api/permission/tree - 获取权限树
- POST /api/permission/add - 添加权限
- PUT /api/permission/update - 更新权限
- DELETE /api/permission/delete/:id - 删除权限

### 菜单管理

- GET /api/menu/list - 获取菜单列表
- GET /api/menu/tree - 获取菜单树
- GET /api/menu/user-menu - 获取用户菜单
- POST /api/menu/add - 添加菜单
- PUT /api/menu/update - 更新菜单
- DELETE /api/menu/delete/:id - 删除菜单

### 文章管理

- GET /api/article/list - 获取文章列表
- GET /api/article/detail/:id - 获取文章详情
- POST /api/article/add - 添加文章
- PUT /api/article/update - 更新文章
- DELETE /api/article/delete/:id - 删除文章

#### 分类管理

- GET /api/article/category/list - 获取分类列表
- GET /api/article/category/all - 获取所有分类
- POST /api/article/category/add - 添加分类
- PUT /api/article/category/update - 更新分类
- DELETE /api/article/category/delete/:id - 删除分类

## 开发规范

请参考 `go-coding-standards.md` 文件中的Go编码规范。

## 许可证

MIT License