app_module

Common modules for zlsgo framework

安装

go get github.com/zlsgo/app_module

模块列表

Account - 账户管理模块

提供完整的用户认证、授权和权限管理功能，支持基于角色的访问控制（RBAC）。

• 🔐 用户认证（登录/登出）
• 👥 用户管理（增删改查）
• 🔑 权限管理（RBAC）
• 🛡️ 安全中间件
• 📝 操作日志
• 🚦 访问限制
• 🔄 会话管理
• 📡 服务器推送事件（SSE）

Database - 数据库模块

提供统一的数据库连接和管理功能，支持多种数据库驱动和高级特性。

• 🔌 多数据库支持（MySQL、PostgreSQL（构建标签启用）、SQLite）
• 🔄 数据库驱动管理
• 📊 基础连接池功能
• 🗃️ 数据库配置管理
• 🛠️ 模块化设计

HTML - HTML 渲染模块

提供基于 Go 语言的 HTML 组件化 DSL，与 znet 路由和 service.Module 生命周期集成。

• 声明式组件 DSL
• 模块化接入
• 多返回模式
• 错误兜底

Member - 会员模块

提供完整的会员注册、登录和第三方认证功能，支持多种认证提供商和灵活的用户管理。

• 📝 用户注册和登录
• 🔑 JWT 认证机制
• 🌐 第三方登录支持（微信小程序等）
• 🛡️ 安全中间件
• 📊 用户信息管理
• 🔒 访问限制
• 🔄 刷新Token机制

Model - 模型模块

提供数据建模与访问层，围绕 Schema 驱动的模型定义，统一处理字段校验、自动迁移、关联装载、查询过滤与数据前后处理。

• Schema 驱动
• 自动迁移
• 统一 CRUD
• 字段管线
• 关联装载
• Schema API

REST API - REST API 模块

提供基于已注册 model.Store 的通配路由转发与基础 CRUD helper。

• 🚀 通配路由自动分发（按 {prefix}/{model}/...）
• 📝 标准 CRUD 操作（GET/POST/PUT/PATCH/DELETE）
• 📁 文件上传封装（HanderUpload）
• 🛡️ 中间件支持（Options.Middleware）
• 🔄 响应钩子（Options.ResponseHook）

目录结构

app_module/
├── account/ # 账户管理模块
├── database/ # 数据库模块
├── member/ # 会员模块
├── model/ # 数据模型模块
├── restapi/ # REST API 模块
├── html/ # HTML 渲染模块
├── template/ # 模板引擎模块
├── go.mod # 模块定义
└── ...

快速开始

package main
import (
"github.com/zlsgo/app_module/account""github.com/zlsgo/app_module/database""github.com/zlsgo/app_module/model""github.com/zlsgo/app_module/restapi""github.com/zlsgo/app_core/service"
)
funcmain() {
app:=service.NewApp()(nil)
// 注册模块dbMod:=database.New()
modelMod:=model.New()
accMod:=account.New("your-secret-key", func(o*account.Options) {
o.ApiPrefix="/api"o.EnableRegister=true
})
restApiMod:=restapi.New(func(o*restapi.Options) {
o.Prefix="/api/v1"
})
// 初始化所有模块err:=service.InitModule([]service.Module{dbMod, modelMod, accMod, restApiMod}, app)
iferr!=nil {
panic(err)
}
service.RunWeb(app)
}

完整文档 https://docs.73zls.com/zls-go/#/