Hauth 项目安装与使用教程

1. 项目介绍

Hauth 项目不是一个前端或后台框架，而是一个集成权限管理、菜单资源管理、域管理、角色管理、用户管理、组织架构管理、操作日志管理等等的快速开发平台。Hauth 是一个基础产品，在这个基础产品上，根据业务需求，可以快速的开发应用服务。

主要功能模块

• 权限管理：集成权限控制，支持按钮级别的权限控制。
• 菜单资源管理：管理系统的菜单和路由信息。
• 域管理：管理不同的用户群体和组织架构。
• 角色管理：定义和管理系统中的角色。
• 用户管理：管理系统的用户信息。
• 操作日志管理：记录用户的每一个API请求。

2. 项目快速启动

2.1 环境准备

• Golang 版本：建议使用 Go SDK >= 1.8
• 数据库：支持 MySQL 和 MariaDB。

2.2 获取项目源代码

go get github.com/hzwy23/hauth

2.3 导入数据库

mysql -uroot -p 数据库名 < /init_hauth.sql

init_hauth.sql 文件位于 src/github.com/hzwy23/hauth/db 目录中。

2.4 编译项目

方法一：使用 build.sh 脚本

cd $GOPATH/src/github.com/hzwy23/hauth
./build.sh

方法二：手动编译

cd $GOPATH/src/github.com/hzwy23/hauth
go build -i main.go

2.5 修改配置文件

配置文件位于 conf 目录中，主要修改 app.conf 文件中的数据库连接信息。

DB_type=mysql
DB_tns="tcp(localhost:3306)/test"
DB_user=root
DB_passwd="your_password"

2.6 启动项目

Linux

nohup ./hauth &

Mac

sudo ./hauth

Windows

双击 hauth.exe 可执行文件。

2.7 访问项目

打开浏览器，访问 https://localhost:8090，使用默认账号 admin 和密码 123456 登录。

3. 应用案例和最佳实践

3.1 案例一：企业内部管理系统

Hauth 可以用于构建企业内部管理系统，集成用户管理、权限管理、日志管理等功能，帮助企业快速搭建安全、稳定的内部管理平台。

3.2 案例二：多租户应用

通过 Hauth 的域管理功能，可以轻松实现多租户应用，不同的租户信息相互隔离，同一租户内信息共享，适用于 SaaS 应用的开发。

4. 典型生态项目

4.1 Beego 框架

Hauth 基于 Beego 框架开发，Beego 是一个快速开发 Go 应用的 HTTP 框架，拥有丰富的插件和工具，适合快速构建 Web 应用。

4.2 MySQL/MariaDB

Hauth 支持 MySQL 和 MariaDB 数据库，这两种数据库都是开源的关系型数据库，广泛应用于各种应用场景。

4.3 Swagger UI

Hauth 提供 Swagger UI 界面，方便管理系统 API，开发者可以通过 Swagger UI 快速了解和测试 API 接口。

通过以上步骤，您可以快速启动并使用 Hauth 项目，结合实际应用场景，发挥其强大的功能。