设备的部分改造

2026-03-10 10:34:08 +08:00
parent 86f8d0b644
commit b5147d1acb
34 changed files with 1680 additions and 485 deletions
--- a/internal/routes/device.go
+++ b/internal/routes/device.go
@@ -29,12 +29,13 @@ func registerDeviceRoutes(router fiber.Router, handler *admin.DeviceHandler, imp
 		Auth:    true,
 	})

-	Register(devices, doc, groupPath, "GET", "/by-imei/:imei", handler.GetByIMEI, RouteSpec{
-		Summary: "通过设备号查询设备详情",
-		Tags:    []string{"设备管理"},
-		Input:   new(dto.GetDeviceByIMEIRequest),
-		Output:  new(dto.DeviceResponse),
-		Auth:    true,
+	Register(devices, doc, groupPath, "GET", "/by-identifier/:identifier", handler.GetByIdentifier, RouteSpec{
+		Summary:     "通过标识符查询设备详情",
+		Description: "支持通过虚拟号(device_no)、IMEI、SN 任意一个标识符查询设备。",
+		Tags:        []string{"设备管理"},
+		Input:       new(dto.GetDeviceByIdentifierRequest),
+		Output:      new(dto.DeviceResponse),
+		Auth:        true,
 	})

 	Register(devices, doc, groupPath, "DELETE", "/:id", handler.Delete, RouteSpec{
@@ -145,59 +146,66 @@ func registerDeviceRoutes(router fiber.Router, handler *admin.DeviceHandler, imp
 		Auth:        true,
 	})

-	Register(devices, doc, groupPath, "GET", "/by-imei/:imei/gateway-info", handler.GetGatewayInfo, RouteSpec{
-		Summary: "查询设备信息",
-		Tags:    []string{"设备管理"},
-		Input:   new(dto.GetDeviceByIMEIRequest),
-		Output:  new(gateway.DeviceInfoResp),
-		Auth:    true,
+	Register(devices, doc, groupPath, "GET", "/by-identifier/:identifier/gateway-info", handler.GetGatewayInfo, RouteSpec{
+		Summary:     "查询设备信息",
+		Description: "通过虚拟号/IMEI/SN 查询设备网关信息。设备必须已配置 IMEI。",
+		Tags:        []string{"设备管理"},
+		Input:       new(dto.GetDeviceByIdentifierRequest),
+		Output:      new(gateway.DeviceInfoResp),
+		Auth:        true,
 	})

-	Register(devices, doc, groupPath, "GET", "/by-imei/:imei/gateway-slots", handler.GetGatewaySlots, RouteSpec{
-		Summary: "查询卡槽信息",
-		Tags:    []string{"设备管理"},
-		Input:   new(dto.GetDeviceByIMEIRequest),
-		Output:  new(gateway.SlotInfoResp),
-		Auth:    true,
+	Register(devices, doc, groupPath, "GET", "/by-identifier/:identifier/gateway-slots", handler.GetGatewaySlots, RouteSpec{
+		Summary:     "查询卡槽信息",
+		Description: "通过虚拟号/IMEI/SN 查询设备卡槽信息。设备必须已配置 IMEI。",
+		Tags:        []string{"设备管理"},
+		Input:       new(dto.GetDeviceByIdentifierRequest),
+		Output:      new(gateway.SlotInfoResp),
+		Auth:        true,
 	})

-	Register(devices, doc, groupPath, "PUT", "/by-imei/:imei/speed-limit", handler.SetSpeedLimit, RouteSpec{
-		Summary: "设置限速",
-		Tags:    []string{"设备管理"},
-		Input:   new(dto.SetSpeedLimitRequest),
-		Output:  new(dto.EmptyResponse),
-		Auth:    true,
+	Register(devices, doc, groupPath, "PUT", "/by-identifier/:identifier/speed-limit", handler.SetSpeedLimit, RouteSpec{
+		Summary:     "设置限速",
+		Description: "通过虚拟号/IMEI/SN 设置设备限速。设备必须已配置 IMEI。",
+		Tags:        []string{"设备管理"},
+		Input:       new(dto.SetSpeedLimitRequest),
+		Output:      new(dto.EmptyResponse),
+		Auth:        true,
 	})

-	Register(devices, doc, groupPath, "PUT", "/by-imei/:imei/wifi", handler.SetWiFi, RouteSpec{
-		Summary: "设置 WiFi",
-		Tags:    []string{"设备管理"},
-		Input:   new(dto.SetWiFiRequest),
-		Output:  new(dto.EmptyResponse),
-		Auth:    true,
+	Register(devices, doc, groupPath, "PUT", "/by-identifier/:identifier/wifi", handler.SetWiFi, RouteSpec{
+		Summary:     "设置 WiFi",
+		Description: "通过虚拟号/IMEI/SN 设置设备 WiFi。设备必须已配置 IMEI。",
+		Tags:        []string{"设备管理"},
+		Input:       new(dto.SetWiFiRequest),
+		Output:      new(dto.EmptyResponse),
+		Auth:        true,
 	})

-	Register(devices, doc, groupPath, "POST", "/by-imei/:imei/switch-card", handler.SwitchCard, RouteSpec{
-		Summary: "切卡",
-		Tags:    []string{"设备管理"},
-		Input:   new(dto.SwitchCardRequest),
-		Output:  new(dto.EmptyResponse),
-		Auth:    true,
+	Register(devices, doc, groupPath, "POST", "/by-identifier/:identifier/switch-card", handler.SwitchCard, RouteSpec{
+		Summary:     "切卡",
+		Description: "通过虚拟号/IMEI/SN 切换设备当前使用的卡。设备必须已配置 IMEI。",
+		Tags:        []string{"设备管理"},
+		Input:       new(dto.SwitchCardRequest),
+		Output:      new(dto.EmptyResponse),
+		Auth:        true,
 	})

-	Register(devices, doc, groupPath, "POST", "/by-imei/:imei/reboot", handler.RebootDevice, RouteSpec{
-		Summary: "重启设备",
-		Tags:    []string{"设备管理"},
-		Input:   new(dto.GetDeviceByIMEIRequest),
-		Output:  new(dto.EmptyResponse),
-		Auth:    true,
+	Register(devices, doc, groupPath, "POST", "/by-identifier/:identifier/reboot", handler.RebootDevice, RouteSpec{
+		Summary:     "重启设备",
+		Description: "通过虚拟号/IMEI/SN 重启设备。设备必须已配置 IMEI。",
+		Tags:        []string{"设备管理"},
+		Input:       new(dto.GetDeviceByIdentifierRequest),
+		Output:      new(dto.EmptyResponse),
+		Auth:        true,
 	})

-	Register(devices, doc, groupPath, "POST", "/by-imei/:imei/reset", handler.ResetDevice, RouteSpec{
-		Summary: "恢复出厂",
-		Tags:    []string{"设备管理"},
-		Input:   new(dto.GetDeviceByIMEIRequest),
-		Output:  new(dto.EmptyResponse),
-		Auth:    true,
+	Register(devices, doc, groupPath, "POST", "/by-identifier/:identifier/reset", handler.ResetDevice, RouteSpec{
+		Summary:     "恢复出厂",
+		Description: "通过虚拟号/IMEI/SN 恢复设备出厂设置。设备必须已配置 IMEI。",
+		Tags:        []string{"设备管理"},
+		Input:       new(dto.GetDeviceByIdentifierRequest),
+		Output:      new(dto.EmptyResponse),
+		Auth:        true,
 	})
 }