🍉 freekey admin 自由钥匙 - 后台管理系统

说明

freekey admin(自由钥匙) 一个V2EX风格 Golang+React+NextJS 写的后台管理系统，提供了权限管理、本地文件上传等基本功能。使用到的技术:

后台: GoFrame
前台: React, Nextjs, SWR, Axios, React-toastify, Js-cookie

如果对 React、Nextjs、SWR 不了解，请先学习这三个框架

React : 由Facebook开发的用于构建用户界面的JavaScript库。

next.js : 一个基于React的服务器端渲染框架，用于构建可扩展的React应用程序。

swr : 一种React Hooks库，用于在数据获取方面提供高度自动化和简化的体验。

🍒 内置功能

1. 系统

菜单, API, 角色, 管理员, 字典, 文件, 操作日志, 登录日志, 账变类型, 账变统计, 账变报表, banner

2. 用户业务

用户管理, 用户登录日志, 用户钱包, 充值类型, 账变记录, 账变统计, 账变报表, 充值订单

GoFrame框架支持全自动化的接口文档生成，保障代码与接口文档同步维护，自动生成的接口文档采用的是标准的OpenAPIv3协议。

相关文档 https://goframe.org/pages/viewpage.action?pageId=47703679

项目运行后在 http://127.0.0.1:2033/swagger 查看

3. 商品业务 todo

4. 小说业务 todo

5. 论坛业务 todo

6. 聊天业务 todo

🌸 环境安装

后台

golang环境安装
mysql 安装
redis 安装
gf 安装 https://goframe.org/pages/viewpage.action?pageId=1115782

前台

nodejs 安装

项目结构


├── backend                     后台项目 
│   ├── api                     对外接口	对外提供服务的输入/输出数据结构定义。考虑到版本管理需要，往往以api/xxx/v1...存在.
│   ├── hack                    工具脚本	存放项目开发工具、脚本等内容。例如，CLI工具的配置，各种shell/bat脚本等文件。
│   ├── internal                内部逻辑  业务逻辑存放目录。通过Golang internal特性对外部隐藏可见性。
│   │   ├── cmd                 入口指令  命令行管理目录。可以管理维护多个命令行。
│   │   ├── consts              常量定义  项目所有常量定义。
│   │   ├── controller          接口处理  接收/解析用户输入参数的入口/接口层。
│   │   ├── dao                 数据访问  数据访问对象，这是一层抽象对象，用于和底层数据库交互，仅包含最基础的 CURD 方法
│   │   ├── logic               业务封装  业务逻辑封装管理，特定的业务逻辑实现和封装。往往是项目中最复杂的部分。
│   │   ├── model               结构模型  数据结构管理模块，管理数据实体对象，以及输入与输出数据结构定义。
│   │   ├── packed
│   │   ├── service             业务层   负责业务逻辑的处理， 具体执行 logic 层
│   │   └── z_httptest          接口测试 
│   ├── manifest                交付清单  包含程序编译、部署、运行、配置的文件。常见内容如下：
│   │   └── config              配置管理  配置文件存放目录。
│   ├── resource                静态资源
│   └── utility                 公共工具  不同项目可公用的工具方法放此目录
└── frontend                    前台项目
    ├── compoents               组件
    ├── consts                  常量
    ├── data                    数据工具
    ├── libs                    业务工具
    ├── pages                   页面
    │   └── backend             后台页面
    └── public                  静态资源
        ├── css
        ├── fonts
        └── image