leeforge-templates

Leeforge Templates 开发助手

项目定位

leeforge/templates 是基于 Leeforge Core 框架的 Gin HTTP 服务模板，用于快速搭建具备多租户/OU 权限的业务服务。

技术栈：Go 1.25+ / Gin / Chi（Core 管理）/ Ent ORM / PostgreSQL / Redis

新增业务模块（7 步）

详细代码模板见 references/module-guide.md

步骤操作文件

1 定义 Ent Schema ent/schema/<name>.go

2 运行代码生成 make generate

3 定义 DTO + 错误 modules/<name>/dto.go

4 实现 Service modules/<name>/service.go

5 实现 Handler（含 Swagger 注解） modules/<name>/handler.go

6 实现 Module（路由注册） modules/<name>/module.go

7 注册到 bootstrap bootstrap/app.go → ModuleFactories

注册后运行 make swagger 更新 Swagger 文档，make dev 启动服务验证。

参考文件导航

文件内容何时加载

references/module-guide.md

7步详细指南 + 完整代码模板新增/修改业务模块时

references/architecture.md

三层模型、请求生命周期、路由、认证上下文解释架构原理时

references/config.md

所有 yaml 配置字段说明回答配置问题时

references/deployment.md

Docker 构建、部署配置、remote-deploy 流程回答部署问题时

Source Transparency