RenHe

RenHe 是一个轻量级 Go Web 应用框架，基于成熟的第三方库组合而成，提供开箱即用的配置管理、日志、数据库、缓存、HTTP 服务和代码生成能力。

特性

• 统一门面 — 通过 r.Cfg() / r.Log() / r.DB() / r.Redis() / r.HttpSrv() 快速访问所有组件
• YAML 配置驱动 — 基于 Viper，按优先级搜索 manifest/config > manifest > config > . 目录
• 结构化日志 — 基于 gookit/slog，支持 text/JSON 格式、console/file/both 输出、文件轮转、调用栈打印
• PostgreSQL + 读写分离 — 基于 Bun ORM，支持主从多节点、Round-Robin 负载均衡、连接池健康检查
• Redis — 基于 go-redis，自动推断单机/集群模式，使用 UniversalClient 统一接口
• HTTP 服务 — 基于 Echo v4，支持结构体元数据驱动的控制器自动注册
• 参数校验 — 基于 go-playground/validator，内置 v / v2 双 tag 验证器
• CLI 工具 — rh 命令行，提供项目初始化、DAO/Service 代码生成（支持 typeMapping/fieldMapping）
• OpenTelemetry — 日志自动关联 Trace/Span ID

项目结构

renhe/
├── cmd/rh/                 # CLI 工具（rh init / rh gen dao / rh gen service）
├── database/
│   ├── rdb/                # PostgreSQL 数据库封装（Bun ORM，主从分离）
│   └── redis/              # Redis 封装（go-redis，单机/集群自适应）
├── example/                # 示例项目
├── frame/r/                # 门面包，全局组件快捷入口
├── net/rhttp/              # HTTP 服务封装（Echo v4，控制器自动注册）
├── os/
│   ├── rcfg/               # 配置管理（Viper）
│   └── rlog/               # 日志服务（gookit/slog）
└── util/rvalid/            # 参数校验（go-playground/validator）

快速开始

安装 CLI

go install github.com/cyjaysong/renhe/cmd/rh@latest

初始化项目

rh init myproject
cd myproject && go mod tidy

配置文件

在 manifest/config/config.yaml 中配置：

httpSrv:
  address: ":8000"

database:
  default:
    dsn: "postgres://user:pass@127.0.0.1:5432/dbname?sslmode=disable"
    maxOpenConns: 25
    maxIdleConns: 5
    connMaxLifetime: "1h"
    connMaxIdleTime: "30m"

redis:
  default:
    address: ["127.0.0.1:6379"]
    db: 0

logger:
  level: "info"              # trace/debug/info/notice/warn/error/fatal
  format: "text"             # text/json
  output: "console"          # console/file/both
  callerSkip: 7              # 调用栈跳过层数
  stack: false               # Error/Warn/Fatal 是否追加完整调用栈
  # file:
  #   path: "logs/app.log"
  #   maxSize: 128           # 单文件最大 MB
  #   rotateTime: "every_day"
  #   backupNum: 20
  #   backupTime: 168        # 小时（168 = 7天）
  #   compress: false
  #   buffSize: 8192

编写业务代码

package main

import (
    "github.com/cyjaysong/renhe/frame/r"
    "github.com/cyjaysong/renhe/net/rhttp"
    "github.com/labstack/echo/v4/middleware"
)

func main() {
    httpSrv := r.HttpSrv()
    httpSrv.Use(middleware.Recover())

    api := httpSrv.Group("/api")
    rhttp.EchoRegisterCtrlPointers(api, new(YourController))

    httpSrv.Logger.Fatal(httpSrv.Start(":8000"))
}

代码生成

# 生成 DAO（entity/do/table）
rh gen dao

# 生成 Service 接口
rh gen service

代码生成配置通过 hack/config.yaml 管理，支持 typeMapping 和 fieldMapping 自定义类型映射。

核心依赖

组件	库
HTTP	Echo v4
ORM	Bun + PostgreSQL
缓存	go-redis v9
日志	gookit/slog
配置	Viper
校验	go-playground/validator
CLI	Cobra

License

MIT