Go Web 框架

git clone https://cnb.cool/mliev/open/go-web
cd go-web

./init.sh

cp config.yaml.example config.yaml
vim config.yaml

go mod tidy

# 前台启动
go run main.go start

# 守护进程模式
go run main.go start -d

# 停止 / 重启 / 热重载 / 状态
go run main.go stop
go run main.go restart
go run main.go reload
go run main.go status

go-web/
├── main.go                          # 程序入口，嵌入静态资源
├── go.mod / go.sum                  # Go 模块定义
├── config.yaml.example              # 配置文件示例
├── init.sh                          # 项目初始化脚本（替换模块路径）
├── Dockerfile                       # Docker 构建文件
├── app/                             # 应用层代码
│   ├── controller/                  # 控制器（接受 RouterContextInterface）
│   │   ├── base_response.go         # 统一响应封装（Success/Error）
│   │   ├── health_controller.go     # 健康检查
│   │   └── index_controller.go      # 首页
│   ├── service/                     # 服务层（业务逻辑）
│   ├── dao/                         # 数据访问层
│   ├── model/                       # 数据模型（GORM）
│   ├── dto/                         # 数据传输对象
│   │   ├── health_dto.go
│   │   └── response_dto.go
│   ├── constants/                   # 常量与错误码
│   │   └── errors.go
│   └── middleware/                   # 中间件
│       └── cors_middleware.go
├── cmd/                             # 命令行入口
│   ├── run.go                       # 启动逻辑（信号处理、热重载）
│   ├── options.go                   # Functional Options
│   └── migrate/                     # 数据库迁移 CLI
│       └── main.go
├── config/                          # 配置管理
│   ├── app.go                       # AppProvider 实现（装配链 + 服务链）
│   ├── config.go                    # 配置加载清单
│   └── autoload/                    # 自动加载配置
│       ├── app.go                   # 应用配置
│       ├── cache.go                 # 缓存配置
│       ├── database.go              # 数据库配置
│       ├── http.go                  # HTTP 配置
│       ├── middleware.go            # 中间件注册
│       ├── migration.go             # 迁移配置
│       ├── redis.go                 # Redis 配置
│       ├── router.go                # 路由注册
│       └── static_fs.go            # 静态文件配置
├── migrations/                      # SQL 迁移文件目录
├── pkg/                             # 框架核心
│   ├── container/                   # DI 容器（懒加载单例 + 优先级覆盖）
│   ├── contract/                    # 服务契约（类型别名）
│   ├── driver/                      # 泛型驱动管理器
│   ├── helper/                      # 全局访问器（GetDatabase/GetLogger/...）
│   ├── interfaces/                  # 核心接口（AppProvider/Assembly/Server）
│   └── server/                      # 各基础设施实现
│       ├── cache/                   # 缓存（redis/memory/none 驱动）
│       ├── config/                  # 配置服务
│       ├── database/                # 数据库（mysql/postgresql/sqlite/memory 驱动）
│       ├── env/                     # 环境变量（Viper）
│       ├── http_server/             # HTTP 服务器（Gin）
│       ├── logger/                  # 日志（development/production 驱动）
│       ├── migration/               # 数据库迁移（Goose）
│       ├── redis/                   # Redis 客户端
│       └── reload/                  # 热重载信号通道
├── static/                          # 静态资源（go:embed）
├── templates/                       # 模板文件（go:embed）
└── docs/                            # 文档

main.go → gomander.Run() → cmd.Start(WithTemplateFs, WithWebStaticFs, WithApp)
  → Assembly 链: Env → Config → Logger → Database → Redis → Cache
  → Server 链:   Migration(goose.Up) → HttpServer(Gin)
  → 信号监听:     SIGINT/SIGTERM → 优雅关闭 | SIGHUP → 热重载

┌─────────────────────────────────┐
│        HTTP Layer (Gin)         │
├─────────────────────────────────┤
│      Controller Layer           │
│  (RouterContextInterface)       │
├─────────────────────────────────┤
│       Service Layer             │
│     (Business Logic)            │
├─────────────────────────────────┤
│        DAO Layer                │
│    (Data Access Objects)        │
├─────────────────────────────────┤
│       Model Layer               │
│    (GORM Models)                │
└─────────────────────────────────┘

// 获取服务
db := container.MustGet[*gorm.DB]()

// 或使用 helper 快捷方式
db := helper.GetDatabase()
logger := helper.GetLogger()
cache := helper.GetCache()

# 创建迁移文件
go run cmd/migrate/main.go create create_users_table

# 执行所有未应用的迁移
go run cmd/migrate/main.go up

# 回滚最近一次迁移
go run cmd/migrate/main.go down

# 查看迁移状态
go run cmd/migrate/main.go status

# 回滚并重新执行最近一次迁移
go run cmd/migrate/main.go redo

-- +goose Up
CREATE TABLE users (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    username VARCHAR(50) NOT NULL UNIQUE,
    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
);

-- +goose Down
DROP TABLE IF EXISTS users;

# 完整健康检查（数据库 + Redis）
GET /health

# 简单健康检查
GET /health/simple

{
  "code": 0,
  "message": "操作成功",
  "data": {
    "status": "UP",
    "timestamp": 1703123456,
    "services": {
      "database": { "status": "UP" },
      "redis": { "status": "UP" }
    }
  }
}

{
  "code": 0,
  "message": "操作成功",
  "data": {}
}

# 数据库配置
database:
  driver: "mysql"           # mysql, postgresql, sqlite, memory
  host: "127.0.0.1"
  port: 3306
  username: "root"
  password: "password"
  dbname: "mydb"
  migration:
    dir: "migrations"       # SQL 迁移文件目录

# Redis 配置
redis:
  host: "127.0.0.1"
  port: 6379
  password: ""
  db: 0

# 应用配置
app:
  mode: "debug"             # debug, release

export DATABASE_DRIVER=postgresql
export DATABASE_HOST=localhost
export DATABASE_PORT=5432
export DATABASE_USERNAME=myuser
export DATABASE_PASSWORD=mypass
export DATABASE_DBNAME=mydb
export DATABASE_MIGRATION_DIR=migrations
export REDIS_HOST=localhost
export REDIS_PORT=6379

# 构建镜像
docker build -t go-web-app .

# 运行容器
docker run -d -p 8080:8080 go-web-app

# 编译
go build -o bin/go-web main.go

# 前台运行
./bin/go-web start

# 守护进程运行
./bin/go-web start -d

// config/autoload/router.go
router.GET("/users", controller.UserController{}.List)
router.POST("/users", controller.UserController{}.Create)

// config/autoload/middleware.go
"http.middleware": []httpInterfaces.MiddlewareFunc{
    middleware.CorsMiddleware(),
    middleware.AuthMiddleware(),
},