本工程主要参考洋葱架构理念，提供开箱即用且易扩展的 Go Web 开发框架。主要技术选型如下：
本项目会定时更新:
- go.mod 中各依赖包升级到最新稳定版本。
- 依赖工具升级到最新稳定版本。
首先安装 go >= 1.17 版本（推荐使用 Go 1.19+ 版本），然后安装以下依赖工具：
# （仅用于国内环境，配置 Go 下载代理）
export GOPROXY=https://goproxy.cn
# 如下工具也可以使用 homebrew 或者直接下载对应的 binary 安装。
# swagger 命令行工具：
go install github.com/swaggo/swag/cmd/swag@latest
# sqlc 工具，注意 MacOS 上使用 brew 安装，其他系统请自行按照对应文档安装
brew install sqlc
# mockgen 工具
go install github.com/golang/mock/mockgen@v1.6.0
# goreleaser 工具
brew install goreleaser
# golangci-lint
brew install golangci-lint本地开发
# 只启动 MySQL / Redis 依赖服务
$ make compose-up
# Run app with migrations
$ make run集成测试（可以在 CI 中运行）
# DB, app + migrations, integration tests
# 执行之前，需要手动删除历史镜像： docker rm -f integration app redis mysql
$ make compose-up-integration-test程序入口，主要的功能在 internal/app/app.go 中。
本地开发环境启动命令：make run
sql是 sqlc 依赖的原始 SQL 语句。schema： 存放所有的建表语句query: 存放所有的查询语句，最好和 schema 相对应
sqlc.yaml是 sqlc 的配置文件。internal/dao是 sqlc 生成的代码，请不要修改。
生成方法：make sqlc
配置，首先读取 config/config.yml中的默认内容，然后读取环境变量里面有符合的变量，将其覆盖 yml 中的配置
配置的结构在 config.go中
env-required:true 标签强制你指定值（在 yml 文件或者环境变量中）
配置使用的cleanenv 库
make run会从 .env.example 中读取测试环境的变量。
Swagger 文档。由 swag 库自动生成 你不需要自己修改任何内容。
生成命令：make swag
测试环境访问：http://127.0.0.1:8080/swagger/index.html
功能测试目录，它会在应用容器旁启动独立的容器。具体的测试逻辑在 integration_test.go 文件中，主要对 Restful 接口进行测试。
使用了go-hit 库。
main_test.go为测试入口。xxxx_test.go等为各个功能的 Restful 测试用例。
启动功能测试命令：make integration-test （启动之前请确保服务启动在本地并且相关依赖 Ready）
同时该测试可以测试非本地环境，配置在main_test.go中，使用方法为传入环境变量ENV，目前有如下环境
# 远程测试环境
ENV=testing make integration-test
# 本地环境，不加ENV存放各种 API 规范（HTTP、GRPC 等），目前只有 HTTP API。
apis 是对外的的接口。
APP 主逻辑入口，其通过依赖注入的方式生成主要的业务逻辑对象，配置路由。 然后启动启动服务器并阻塞等待。
MVC 中的控制层，服务的路由用同样的风格进行编写
- handler 按照应用领域进行分组（有共同的基础）
- 对于每一个分组，创建自己的路由结构体和请求 path 路径
- 业务逻辑的结构被注入到路由器结构中，它将被处理程序调用
业务逻辑实体（模型），将所有实体统一定义在此处。注意实体的定义和internal/dao中的定义是不同的，前者更多使用在接口中，后者是数据库的原始结构。
所以此处增加转换逻辑（其实可以给 sqlc 配置生成的 model 带 json tags，但是为了隔离两层，所以宁愿人工转换）
业务逻辑的核心部分，以 Workspace 为例：
interfaces.go: 将所有业务接口放到一起user.go: 实现的业务逻辑（相当于 Service）user_test.go: 对应的单元测试
此处可以自动生成单测所依赖的 mock，具体使用方法：
- 生成 mock 代码：
make mock - 进行单元测试：
make test
和业务逻辑无关的库。
# 本地测试数据库的搭建
docker run -d --name go_webapp -p 3306:3306 -e MYSQL_ROOT_PASSWORD=go_webapp mysql:5.7
mysql -h127.0.0.1 -P3306 -uroot -pgo_webapp
CREATE DATABASE go_webapp CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
CREATE USER 'go_webapp'@'%' IDENTIFIED BY 'go_webapp';
GRANT ALL PRIVILEGES ON go_webapp.* TO 'go_webapp'@'%';
use go_webapp;
# 执行sql/schema/ 下的建表语句
基础镜像：
没有选择 distroless ，而是使用 ubuntu:22.04，可以自行替换 Dockerfile 中的基础镜像。
镜像仓库：
修改 .goreleaser.yaml 中 dockers 段中的镜像仓库地址。
本地编译： make build 构建多架构以及Docker镜像： make build-image ，会自动根据tag生成下一个版本的next版本。
在release 之前，需要使用git tag 来打上版本号，然后再执行 make release 来发布，此时同时也会上传到镜像仓库。