# seawolf-admin-go

**Repository Path**: hackchen/seawolf-admin-go

## Basic Information

- **Project Name**: seawolf-admin-go
- **Description**: 海狼admin，golang版，基于goframe 2.x
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2023-04-10
- **Last Updated**: 2023-11-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 海狼admin后台GO版

### 环境要求
- [x] go 1.18+
- [x] mysql 5.7+
- [x] redis 5.0+

### 技术栈
- [x] [golang 1.18+](https://golang.org/)
- [x] [Goframe V2](https://goframe.org/)
- [x] [asynq](https://github.com/hibiken/asynq)

### 运行说明
- 安装 goframe v2 脚手架 
- 导入 sql 文件
- 修改配置文件
- cd 到 admin 项目(internal/app/admin) 下 运行 `gf run main.go` 启动项目

### 目录结构
```
│  go.mod
│  Makefile
│  README.MD
│  
├─api                                       # 接口
│  ├─admin                                  # 管理端接口
│  │  ├─v1
│  │  └─v2
│  └─client                                 # 用户端接口
│      └─v1
│              
├─db                                        # 数据库            
├─internal
│  ├─app
│  │  ├─admin                               # admin端项目
│  │  │  │  build_linux.bat                 # 编译linux版本
│  │  │  │  main.go                         # 管理端入口
│  │  │  │  
│  │  │  ├─config                           # 配置
│  │  │  │      config.yaml                 # 配置文件
│  │  │  │      
│  │  │  ├─controller                       # 控制器    
│  │  │  │  ├─cms                           # cms模块
│  │  │  │  ├─data                          # 数据模块
│  │  │  │  ├─sys                           # 系统模块
│  │  │  │          
│  │  │  ├─resource                         # 资源文件
│  │  │  │  │  comic.ttf                    # 验证码字体文件
│  │  │  │  │  
│  │  │  │  └─wwwroot                       # 静态资源
│  │  │  │      └─upload                    # 上传文件
│  │  │  ├─routers                          # 路由
│  │  │  │      CmsReg.go                   # cms路由
│  │  │  │      DataReg.go                  # 数据路由
│  │  │  │      Reg.go                      # 路由注册
│  │  │  │      SysReg.go                   # 系统路由
│  │  │  │      
│  │  │  └─tmp                              # 临时文件
│  │  │      ├─log                          # 日志
│  │  │      │  ├─router                    # 路由日志
│  │  │      │  ├─server                    # 服务日志
│  │  │      │  └─sql                       # sql日志
│  │  │      └─pieces                       # 分片上传临时文件
│  │  │              
│  │  └─client                              # 用户端项目，项目结构建议和admin类似
│  ├─model                                  # 模型
│  │  ├─entity                              # 实体
│  │  └─workflowEntity                      # 工作流实体
│  │          
│  ├─request                                # 入参
│  │  ├─AttachmentReq                       # 附件入参
│  │  │      MergeChunk.go                  # 合并分片入参
│  │  │      UploadCheck.go                 # 上传检查入参
│  │  │      UploadChunk.go                 # 上传分片入参
│  │  │      
│  │  ├─BaseReq                             # 基础入参
│  │  │      AdminLogin.go                  # 管理员登录入参
│  │  │      I.go                           # 基础入参curd类
│  │  │      MemberLogin.go                 # 会员登录入参
│  │  │      PageInfo.go                    # 分页入参
│  │          
│  ├─routers                                # 路由
│  │      MethodCall.go                     # 路由方法调用
│  │      MiddlewareErrorHandler.go         # 错误处理中间件
│  │      MiddlewareHandlerIsLogin.go       # 登录验证中间件
│  │      MiddlewareHandlerIsPermission.go  # 权限验证中间件
│  │      MiddlewareHandlerResponse.go      # 响应中间件
│  │      
│  └─service                                # 业务逻辑层
│      ├─AdminService                       # 管理员业务逻辑层
│      ├─ArticleService                     # 文章业务逻辑层
│      ├─AttachmentService                  # 附件业务逻辑层
│      ├─BaseService                        # 基础服务类
│      │      Add.go                        # 添加
│      │      Base.go                       # 基础类
│      │      Delete.go                     # 删除
│      │      Info.go                       # 详情
│      │      List.go                       # 列表
│      │      Page.go                       # 分页
│      │      Update.go                     # 更新
│      │      
│      ├─LinksService                       # 友情链接业务逻辑层
│      ├─OrgMemberService                   #  机构成员业务逻辑层
│      ├─RoleService                        # 角色业务逻辑层
│      ├─SlidesService                      # 幻灯片业务逻辑层
├─manifest                                  # 部署文件，暂时没用
└─utility
    ├─asynq                                 # asynq队列
    ├─db                                    # 数据库相关
    ├─fileTypeTest                          # 文件类型检测
    ├─myCaptcha                             # 我的验证码，需要用到字体文件
    ├─MyCfg                                 # 我的配置，帮助类
    ├─MyErrorCode                           # 我的错误码
    ├─response                              # 处理返回数据
    ├─token                                 # 仿 sa-token的一个token处理小库
    └─tools                                 # 通用小工具

```