app_module

Common modules for zlsgo framework

安装

go get github.com/zlsgo/app_module

模块列表

Auth - 通用认证模块

提供面向业务站点的认证基础设施，使用服务端 session + cookie 管理登录态，并支持密码找回与 OAuth 绑定。

• 🍪 服务端会话与显式失效
• 📝 邮箱注册、登录、登出、当前用户
• 🔐 修改密码、找回密码、reset token
• 🌐 OAuth 登录、自动建号、绑定解绑
• 🚦 登录与找回密码限流

Account - 账户管理模块

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

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

Database - 数据库模块

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

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

HTML - HTML 渲染模块

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

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

Member - 会员资料模块

提供依赖 auth 登录态的会员资料接口；长期定位是业务 profile 层，而不是认证模块。

• 📊 会员资料管理
• 🍪 依赖 auth 会话态
• 🔗 auth user -> member profile 显式映射
• 🛡️ 认证中间件与访问限制

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）

Template - 模板引擎模块

提供基于 jet 的服务端模板渲染能力，与 znet 路由和 service.Module 生命周期集成。

• 🚀 jet 模板渲染
• 📁 模板目录加载（默认 ./views）
• 📦 静态资源托管
• 🛠️ 自定义模板函数
• 🔄 调试/开发热重载

目录结构

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

快速开始

package main

import (
    authmodule "github.com/zlsgo/app_module/auth"
    "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"
)

func main() {
    app := service.NewApp()(nil)

    // 注册模块
    dbMod := database.New()
    modelMod := model.New()
    authMod := authmodule.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, authMod, accMod, restApiMod}, app)
    if err != nil {
        panic(err)
    }

    service.RunWeb(app)
}

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