EasyGoAdmin_GoFrame_EleVue/
├── main.go                     # 服务入口：注册五库驱动 + Redis 适配器 → cmd.Run
├── Makefile                    # run/build/test/vet/fmt/gen(gen-dao)/clean
├── api/                        # 全部请求/响应结构体（单包 v1，每模块一文件）
├── cmd/                        # CLI 入口
│   ├── generator/              #   代码生成器（文件+菜单+字典+路由，幂等）
│   └── migrator/               #   整库迁移（源库内省 → 五方言 DDL → 分批搬运）
├── internal/                   # 后端核心代码
│   ├── cmd/                    #   启动编排：cache.Init → 依赖接线 → 路由 → 调度器
│   ├── controller/             #   控制器（单包薄层，仅转发 service）
│   ├── logic/                  #   业务逻辑（单包，每模块一文件，同包 init 注册）
│   ├── service/                #   服务接口层（手维护，勿运行 gf gen service）
│   ├── dao/                    #   数据访问层（gf gen dao 产出，挂钩子 + Ctx 覆写）
│   ├── model/                  #   entity / do / hooks（审计盖章、软删、租户隔离）
│   ├── middleware/             #   中间件链：CORS→Response→RateLimit→Demo→JWT→Tenant→OperationLog
│   ├── router/                 #   路由注册（router.go）+ gmeta 反射绑定（bind.go）
│   ├── task/                   #   定时任务处理器（init 自注册，依赖单向 task→logic）
│   ├── consts/                 #   业务错误码 / 缓存键 / 日志类型枚举
│   └── migrate/                #   整库迁移引擎（内省/翻译/DDL 渲染/搬运）
├── utility/                    # 基础能力包（无业务依赖）
│   ├── jwt/ cache/ upload/     #   双令牌 / 缓存降级 / 两段式上传
│   ├── captcha/ crypto/ excel  #   图形验证码 / 加解密 / Excel 导入导出
│   └── ip2region/ response/ ua #   IP 归属地 / 统一响应 / 设备识别
├── templates/                  # 代码生成器模板（后端 {{ }} 定界；ui* 前端 [[ ]] 定界）
├── manifest/
│   ├── config/config.yaml      # 运行时配置（唯一配置文件，GF_ 环境变量可覆盖）
│   └── data/ip2region.xdb      # IP 归属地库
├── resource/
│   ├── static/                 # 验证码字体等静态资源
│   ├── swagger/                # 本地托管 API 文档页面
│   └── upload/                 # 上传文件静态服务根（/upload/**）
├── hack/                       # gf gen dao 配置、自定义模板、黄金样本回归基线
├── docker/                     # Docker 化文件（构建上下文为项目根）
│   ├── Dockerfile              #   多阶段构建：静态编译 → alpine 运行（非 root + 健康检查）
│   ├── docker-compose.yml      #   三服务编排：后端 + MySQL8 + Redis7
│   └── .env.example            #   compose 变量模板（复制为 .env，密钥不入库）
├── .dockerignore               # Docker 构建上下文排除清单
├── ui/                         # 前端工程（Vue3 + TypeScript + Element Plus + Vite）
├── document/                   # 项目文档（架构定稿、五方言 SQL、wiki）
├── upload/                     # 上传物理目录（file.uploadDir，挂载持久卷）
├── log/                        # 运行日志
└── bin/                        # 编译产物

# 1. 初始化数据库：导入定稿脚本
#    document/mysql/easygoadmin.goframe.elevue.sql → 库 easygoadmin.goframe.elevue

# 2. 启动后端（默认 :8000，配置见 manifest/config/config.yaml）
go run main.go

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

# 或 Docker 一条命令拉起全栈（后端 + MySQL + Redis）
cd docker && copy .env.example .env && docker compose up -d --build