yangy
f3e3e82f52
- 新增设备持久化定时任务，每5分钟将Redis中采集的设备信息同步数据库 - 新增UserDevice和UserActive模型及相应数据库表和操作接口 - 设备信息上报中获取客户端公网IP，替代原X-Forwarded-For头部 - 新建OTA功能模块，实现OTA固件升级信息查询接口 - 支持OTA黑名单过滤与定向升级设备判断 - 设计OTA相关数据库结构：ota、black_list、ota_target_device表 - 缓存预热新增按品牌分组预热型号缓存 - 依赖注入新增OTA Repository及Handler路由配置 - 实现客户端公网IP提取逻辑，支持多种代理头部优先级识别
app-api
基于 Gin 的 Go HTTP API 脚手架。
项目结构
app-api/
├── cmd/server/ # 程序入口
├── internal/
│ ├── config/ # 配置加载
│ ├── handler/ # HTTP 处理器
│ ├── middleware/ # 中间件（日志、CORS、Request ID）
│ ├── response/ # 统一 JSON 响应
│ └── router/ # 路由注册
└── pkg/logger/ # 可复用日志封装
快速开始
环境要求
- Go 1.22+
安装依赖
go mod tidy
配置（可选）
复制环境变量示例：
cp .env.example .env
| 变量 | 默认值 | 说明 |
|---|---|---|
APP_ENV |
development |
运行环境 |
APP_HOST |
0.0.0.0 |
监听地址 |
APP_PORT |
8080 |
监听端口 |
GIN_MODE |
debug |
Gin 运行模式 |
数据库
根据 APP_ENV 自动选择 MySQL 配置；也可通过 DATABASE_* 环境变量完全覆盖。
| 环境 | APP_ENV |
默认连接 |
|---|---|---|
| 开发 | development |
localhost:3306/audio，用户 root，密码 root123 |
| 正式 | production |
AWS RDS database-1.chmuueamo72p.eu-central-1.rds.amazonaws.com:3306/audio |
正式环境密码必须通过环境变量 DATABASE_PASSWORD 提供（不要写入代码仓库）。可参考 .env.production.example。
开发环境可在 .env 中覆盖：
DATABASE_HOST=localhost
DATABASE_PORT=3306
DATABASE_NAME=audio
DATABASE_USER=root
DATABASE_PASSWORD=root123
正式环境启动示例（PowerShell）：
$env:APP_ENV = "production"
$env:DATABASE_PASSWORD = "your-production-password"
go run ./cmd/server
运行
make run
# 或
go run ./cmd/server
健康检查
curl http://localhost:8080/api/v1/health
响应示例：
{
"code": 0,
"message": "ok",
"data": {
"status": "up"
}
}
品牌列表
# 查询全部
curl "http://localhost:8080/audio/getBrand"
# 按名称模糊查询
curl "http://localhost:8080/audio/getBrand?brandName=sony"
添加新接口
- 在
internal/handler/新建 handler - 在
internal/router/router.go的/api/v1分组下注册路由 - 使用
internal/response返回统一格式
构建
make build
./bin/server