EasyGoAdmin 敏捷开发框架 Gin+EleVue 版本 v2.8.0 发布

EasyGoAdmin_Gin_EleVue/
├── cmd/                        # 可执行入口
│   ├── api/                    #   服务入口（make run → go run ./cmd/api）
│   ├── gen/                    #   代码生成器（后端四件套+前端+菜单/路由，幂等）
│   └── migrator/               #   整库迁移（源库内省 → 五方言 DDL → 分批搬运；oracle 构建标签启用）
├── internal/                   # 后端核心代码
│   ├── server/                 #   启动编排：cache.Init → 依赖接线 → 路由 → 调度器
│   ├── handler/                #   控制器（极薄委托，仅转发 service）
│   ├── service/                #   业务逻辑（每模块一文件）+ ModuleSpec 声明式 CRUD 基座
│   ├── repository/             #   数据访问（NewXxxRepo().Ctx(ctx) 唯一入口，自动挂软删/租户过滤）
│   ├── model/                  #   dto / db / hooks（审计盖章、软删、租户隔离）
│   ├── middleware/             #   中间件链：trace→CORS→metrics→response→ratelimit→demo→JWT→tenant→authz→operation_log
│   ├── router/                 #   路由注册（router.go）+ 反射绑定（bind.go）+ OpenAPI 输出
│   ├── task/                   #   定时任务处理器（init 自注册，依赖单向 task→service）
│   ├── consts/                 #   业务错误码 / 缓存键 / 日志类型枚举
│   └── migrate/                #   整库迁移引擎（内省/翻译/DDL 渲染/搬运）
├── utility/                    # 基础能力包（无业务依赖）
│   ├── jwt/ cache/ upload/     #   双令牌 / 缓存降级 / 两段式上传
│   ├── captcha/ crypto/ excel  #   图形验证码 / 加解密 / Excel 导入导出
│   └── ip2region/ response/ ua #   IP 归属地 / 统一响应 / 设备识别
├── templates/                  # 代码生成器模板（后端 {{ }} 定界；ui|ui2 前端 [[ ]] 定界）
├── config/config.yaml          # 运行时配置（唯一配置文件，APP_ 环境变量可覆盖）
├── resource/
│   ├── data/ip2region.xdb      # IP 归属地库
│   └── fonts/                  # 验证码字体
├── deploy/                     # Docker 化文件
│   ├── Dockerfile              #   多阶段构建：静态编译 → alpine 运行（非 root + 时区 + 健康检查）
│   ├── docker-compose.yaml     #   四服务编排：应用 + MySQL8 + Redis7 + Nginx（MySQL 首启自动建库，服务健康依赖）
│   └── nginx.conf              #   上传文件直供配置（temp 临时目录封禁）
├── .env.example                # compose 变量模板 + 应用 env 覆盖样例（复制为 .env，密钥不入库）
├── .dockerignore               # Docker 构建上下文排除清单
├── ui/                         # 前端工程（Vue3 + TypeScript + Element Plus + Vite）
├── document/                   # 项目文档（模块结构规约、五方言定稿 SQL、架构设计）
├── upload/                     # 上传物理目录（file.uploadDir，bind 挂载至容器 /data/upload，应用 rw / nginx ro）
├── log/                        # 运行日志
└── bin/                        # 编译产物

# 1. 初始化数据库：导入定稿脚本
# document/mysql/easygoadmin.gin.elevue.sql → 库 easygoadmin.gin.elevue
# （仅本机 make run 需要手工导入；Docker 全栈首启会自动导入，
# 仅在 MySQL 数据卷为空时执行一次）

# 2. 启动后端（默认 :8000，配置见 config/config.yaml）
make run
# Windows 无 make 时：make.bat run，或 go run ./cmd/api

# 3. 启动前端（默认 :8001，代理转发至 :8000）
cd ui && pnpm install && pnpm dev

# 或 Docker 一条命令拉起全栈（应用 + MySQL + Redis + Nginx）
# 在项目根执行；首启含建库 SQL 导入，健康检查就绪约需 1-3 分钟
copy .env.example .env && docker compose --env-file .env -f deploy/docker-compose.yaml up -d --build

# 验证就绪（返回 {"status":"up"} 即正常）
curl http://127.0.0.1:8000/api/health