eafonyang
dd92845bc2
- 增加设备持久化、阻抗数据持久化、分享码持久化定时任务 - 通过环境变量 ENABLE_PERSIST_TASK 和 ENABLE_IMPEDANCE_PERSIST_TASK 控制任务启用 - 分享码配置新增最大数量和TTL时间支持多种时间单位（m/h/d） - 实现任务批量处理、锁机制及失败重试保障数据一致性 - 定时任务启动集成至服务主流程，增强系统可配置性和运维便利性 feat(ota): 新增根据设备型号和版本号查询版本名称接口 - 实现 GET /audio/getVerName 接口返回唯一 OTA 版本名称 verName - 添加请求参数校验及错误处理逻辑 - 在仓库层新增按型号和版本号查询版本名称的方法 - 完善接口文档及Swagger定义，支持前端调用查询版本名称功能
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 |
192.168.9.127:3306/audio（可通过 DATABASE_HOST 覆盖），用户 root，密码 root123 |
| 正式 | production |
AWS RDS database-1.chmuueamo72p.eu-central-1.rds.amazonaws.com:3306/audio |
正式环境密码必须通过环境变量 DATABASE_PASSWORD 提供（不要写入代码仓库）。可参考 .env.production.example。
开发环境通过 .env 管理 MySQL / Redis 地址（host 变更时只需改 .env）：
DATABASE_HOST=192.168.9.127
DATABASE_PORT=3306
DATABASE_NAME=audio
DATABASE_USER=root
DATABASE_PASSWORD=root123
REDIS_HOST=192.168.9.127
REDIS_PORT=6379
REDIS_DATABASE=1
正式环境启动示例（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