huang
477a9fc98d
Some checks failed
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Has been cancelled
- 新增 GET /api/admin/devices/by-imei/:imei 接口，支持通过设备号查询设备详情 - 新增 GET /api/admin/iot-cards/by-iccid/:iccid 接口，支持通过ICCID查询单卡详情 - 添加对应的 Service 层方法和 Handler - 更新 OpenAPI 文档 - 添加集成测试并修复测试环境配置（使用环境变量） - 归档已完成的 OpenSpec 变更记录 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
96 lines
3.1 KiB
Go
96 lines
3.1 KiB
Go
package routes
|
||
|
||
import (
|
||
"github.com/gofiber/fiber/v2"
|
||
|
||
"github.com/break/junhong_cmp_fiber/internal/handler/admin"
|
||
"github.com/break/junhong_cmp_fiber/internal/model/dto"
|
||
"github.com/break/junhong_cmp_fiber/pkg/openapi"
|
||
)
|
||
|
||
func registerIotCardRoutes(router fiber.Router, handler *admin.IotCardHandler, importHandler *admin.IotCardImportHandler, doc *openapi.Generator, basePath string) {
|
||
iotCards := router.Group("/iot-cards")
|
||
groupPath := basePath + "/iot-cards"
|
||
|
||
Register(iotCards, doc, groupPath, "GET", "/standalone", handler.ListStandalone, RouteSpec{
|
||
Summary: "单卡列表（未绑定设备）",
|
||
Tags: []string{"IoT卡管理"},
|
||
Input: new(dto.ListStandaloneIotCardRequest),
|
||
Output: new(dto.ListStandaloneIotCardResponse),
|
||
Auth: true,
|
||
})
|
||
|
||
Register(iotCards, doc, groupPath, "GET", "/by-iccid/:iccid", handler.GetByICCID, RouteSpec{
|
||
Summary: "通过ICCID查询单卡详情",
|
||
Tags: []string{"IoT卡管理"},
|
||
Input: new(dto.GetIotCardByICCIDRequest),
|
||
Output: new(dto.IotCardDetailResponse),
|
||
Auth: true,
|
||
})
|
||
|
||
Register(iotCards, doc, groupPath, "POST", "/import", importHandler.Import, RouteSpec{
|
||
Summary: "批量导入IoT卡（ICCID+MSISDN）",
|
||
Description: `## ⚠️ 接口变更说明（BREAKING CHANGE）
|
||
|
||
本接口已从 ` + "`multipart/form-data`" + ` 改为 ` + "`application/json`" + `。
|
||
|
||
### 完整导入流程
|
||
|
||
1. **获取上传 URL**: 调用 ` + "`POST /api/admin/storage/upload-url`" + `
|
||
2. **上传 CSV 文件**: 使用预签名 URL 上传文件到对象存储
|
||
3. **调用本接口**: 使用返回的 ` + "`file_key`" + ` 提交导入任务
|
||
|
||
### 请求示例
|
||
|
||
` + "```" + `json
|
||
{
|
||
"carrier_id": 1,
|
||
"batch_no": "BATCH-2025-01",
|
||
"file_key": "imports/2025/01/24/abc123.csv"
|
||
}
|
||
` + "```" + `
|
||
|
||
### CSV 文件格式
|
||
|
||
- 必须包含两列：` + "`iccid`" + `, ` + "`msisdn`" + `
|
||
- 首行为表头
|
||
- 编码：UTF-8`,
|
||
Tags: []string{"IoT卡管理"},
|
||
Input: new(dto.ImportIotCardRequest),
|
||
Output: new(dto.ImportIotCardResponse),
|
||
Auth: true,
|
||
})
|
||
|
||
Register(iotCards, doc, groupPath, "GET", "/import-tasks", importHandler.List, RouteSpec{
|
||
Summary: "导入任务列表",
|
||
Tags: []string{"IoT卡管理"},
|
||
Input: new(dto.ListImportTaskRequest),
|
||
Output: new(dto.ListImportTaskResponse),
|
||
Auth: true,
|
||
})
|
||
|
||
Register(iotCards, doc, groupPath, "GET", "/import-tasks/:id", importHandler.GetByID, RouteSpec{
|
||
Summary: "导入任务详情",
|
||
Tags: []string{"IoT卡管理"},
|
||
Input: new(dto.GetImportTaskRequest),
|
||
Output: new(dto.ImportTaskDetailResponse),
|
||
Auth: true,
|
||
})
|
||
|
||
Register(iotCards, doc, groupPath, "POST", "/standalone/allocate", handler.AllocateCards, RouteSpec{
|
||
Summary: "批量分配单卡",
|
||
Tags: []string{"IoT卡管理"},
|
||
Input: new(dto.AllocateStandaloneCardsRequest),
|
||
Output: new(dto.AllocateStandaloneCardsResponse),
|
||
Auth: true,
|
||
})
|
||
|
||
Register(iotCards, doc, groupPath, "POST", "/standalone/recall", handler.RecallCards, RouteSpec{
|
||
Summary: "批量回收单卡",
|
||
Tags: []string{"IoT卡管理"},
|
||
Input: new(dto.RecallStandaloneCardsRequest),
|
||
Output: new(dto.RecallStandaloneCardsResponse),
|
||
Auth: true,
|
||
})
|
||
}
|