Skip to content

v0.1.0 · 微服务脚手架首个版本

Choose a tag to compare

View all tags
@SuperiorChuo SuperiorChuo released this 19 Jul 03:08
v0.1.0
2a2ba5b

v0.1.0 · 微服务脚手架首个版本

Go Admin Kit 微服务脚手架：只含平台无关的基础设施服务，不带业务耦合，是干净的二次开发起点。

Go + Gin + PostgreSQL 16 后端，React 19 + Ant Design 6 前端，Traefik 网关统一验签，Docker Compose 一键起全栈。

✨ 内置能力

🏗️ 基础设施

  • 认证鉴权：验证码 / TOTP 两步登录、JWT Access/Refresh 轮转与吊销、OAuth（GitHub / 微信）、登录限流
  • RBAC：用户 / 角色 / 权限 / 部门 / 菜单，角色数据范围（全部 / 部门及以下 / 仅本人）
  • 多租户：共享库 + tenant_id，登录带租户码，网关头透传
  • 系统管理：字典 / 公告 / 在线用户 / 文件上传（MinIO），系统设置走数据库热配置——控制台改完即生效，密钥不进代码
  • 审计与监控：登录 / 操作 / 审计三类日志（NATS 事件持久消费），服务器 / PG / Redis / 定时任务监控，Prometheus + Grafana + 可选 OTel 链路
  • 微服务架构：auth / identity / system / audit / file / monitor + shared 按域拆分，Traefik ForwardAuth 统一验签（业务服务只信任网关注入的 X-Auth-* 头），goose 版本化迁移，OpenAPI 3.1 契约随 CI 校验漂移

⚛️ 前端

React 19 + Ant Design 6，深空暗色 / 白蓝亮色双主题，玻璃拟态视觉，全模块一套设计语言。

⚙️ 工程化

  • GitHub Actions：各服务独立 test+vet、前端 lint+build+audit、OpenAPI 契约漂移校验、迁移彩排、compose 集成冒烟（API smoke + Playwright E2E 经网关）
  • pre-commit 密钥扫描钩子
  • 运维脚本：PG 每日备份、镜像回滚
  • Docker Compose 一键启动全栈；宿主机端口默认只绑 loopback

🚀 快速开始

git clone https://github.com/SuperiorChuo/go-admin-kit.git
cd go-admin-kit/microservices
cp .env.example .env
docker compose up -d --build
  • 统一网关：http://localhost:8000
  • 默认账号：admin / admin123（生产请立即改密并替换 JWT_SECRET）

🛠️ 如何扩展业务

这是干净的脚手架。加业务能力 = 在 services/ 下新建一个微服务 + 加 go.work + compose 服务块 + Traefik 路由标签，迁移落 monitor/migrations/，前端补页面/接口/菜单。底座保持通用，避免做成巨石。

详见 README 与 CHANGELOG。

Assets 2
Loading