pig-farm-controller/internal/app/controller/device/device_controller.go

package device

import (
	"encoding/json"
	"errors"
	"fmt"
	"strconv"
	"strings"
	"time"

	"git.huangwc.com/pig/pig-farm-controller/internal/app/controller"
	"git.huangwc.com/pig/pig-farm-controller/internal/infra/logs"
	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
	"git.huangwc.com/pig/pig-farm-controller/internal/infra/repository"
	"github.com/gin-gonic/gin"
	"gorm.io/gorm"
)

// Controller 设备控制器，封装了所有与设备和区域主控相关的业务逻辑
type Controller struct {
	deviceRepo         repository.DeviceRepository
	areaControllerRepo repository.AreaControllerRepository
	logger             *logs.Logger
}

// NewController 创建一个新的设备控制器实例
func NewController(
	deviceRepo repository.DeviceRepository,
	areaControllerRepo repository.AreaControllerRepository,
	logger *logs.Logger,
) *Controller {
	return &Controller{
		deviceRepo:         deviceRepo,
		areaControllerRepo: areaControllerRepo,
		logger:             logger,
	}
}

// --- Request DTOs ---

// CreateDeviceRequest 定义了创建设备时需要传入的参数
type CreateDeviceRequest struct {
	Name             string                 `json:"name" binding:"required"`
	DeviceTemplateID uint                   `json:"device_template_id" binding:"required"`
	AreaControllerID uint                   `json:"area_controller_id" binding:"required"`
	Location         string                 `json:"location,omitempty"`
	Properties       map[string]interface{} `json:"properties,omitempty"`
}

// UpdateDeviceRequest 定义了更新设备时需要传入的参数
type UpdateDeviceRequest struct {
	Name             string                 `json:"name" binding:"required"`
	DeviceTemplateID uint                   `json:"device_template_id" binding:"required"`
	AreaControllerID uint                   `json:"area_controller_id" binding:"required"`
	Location         string                 `json:"location,omitempty"`
	Properties       map[string]interface{} `json:"properties,omitempty"`
}

// CreateAreaControllerRequest 定义了创建区域主控时需要传入的参数
type CreateAreaControllerRequest struct {
	Name       string                 `json:"name" binding:"required"`
	NetworkID  string                 `json:"network_id" binding:"required"`
	Location   string                 `json:"location,omitempty"`
	Properties map[string]interface{} `json:"properties,omitempty"`
}

// UpdateAreaControllerRequest 定义了更新区域主控时需要传入的参数
type UpdateAreaControllerRequest struct {
	Name       string                 `json:"name" binding:"required"`
	NetworkID  string                 `json:"network_id" binding:"required"`
	Location   string                 `json:"location,omitempty"`
	Properties map[string]interface{} `json:"properties,omitempty"`
}

// --- Response DTOs ---

// DeviceResponse 定义了返回给客户端的单个设备信息的结构
type DeviceResponse struct {
	ID                 uint                   `json:"id"`
	Name               string                 `json:"name"`
	DeviceTemplateID   uint                   `json:"device_template_id"`
	DeviceTemplateName string                 `json:"device_template_name"`
	AreaControllerID   uint                   `json:"area_controller_id"`
	AreaControllerName string                 `json:"area_controller_name"`
	Location           string                 `json:"location"`
	Properties         map[string]interface{} `json:"properties"`
	CreatedAt          string                 `json:"created_at"`
	UpdatedAt          string                 `json:"updated_at"`
}

// AreaControllerResponse 定义了返回给客户端的单个区域主控信息的结构
type AreaControllerResponse struct {
	ID         uint                   `json:"id"`
	Name       string                 `json:"name"`
	NetworkID  string                 `json:"network_id"`
	Location   string                 `json:"location"`
	Status     string                 `json:"status"`
	Properties map[string]interface{} `json:"properties"`
	CreatedAt  string                 `json:"created_at"`
	UpdatedAt  string                 `json:"updated_at"`
}

// --- DTO 转换函数 ---

// newDeviceResponse 从数据库模型创建一个新的设备响应 DTO
func newDeviceResponse(device *models.Device) (*DeviceResponse, error) {
	if device == nil {
		return nil, nil
	}

	var props map[string]interface{}
	if len(device.Properties) > 0 && string(device.Properties) != "null" {
		if err := device.ParseProperties(&props); err != nil {
			return nil, fmt.Errorf("解析设备属性失败 (ID: %d): %w", device.ID, err)
		}
	}

	// 确保 DeviceTemplate 和 AreaController 已预加载
	deviceTemplateName := ""
	if device.DeviceTemplate.ID != 0 {
		deviceTemplateName = device.DeviceTemplate.Name
	}

	areaControllerName := ""
	if device.AreaController.ID != 0 {
		areaControllerName = device.AreaController.Name
	}

	return &DeviceResponse{
		ID:                 device.ID,
		Name:               device.Name,
		DeviceTemplateID:   device.DeviceTemplateID,
		DeviceTemplateName: deviceTemplateName,
		AreaControllerID:   device.AreaControllerID,
		AreaControllerName: areaControllerName,
		Location:           device.Location,
		Properties:         props,
		CreatedAt:          device.CreatedAt.Format(time.RFC3339),
		UpdatedAt:          device.UpdatedAt.Format(time.RFC3339),
	}, nil
}

// newListDeviceResponse 从数据库模型切片创建一个新的设备列表响应 DTO 切片
func newListDeviceResponse(devices []*models.Device) ([]*DeviceResponse, error) {
	list := make([]*DeviceResponse, 0, len(devices))
	for _, device := range devices {
		resp, err := newDeviceResponse(device)
		if err != nil {
			return nil, err
		}
		list = append(list, resp)
	}
	return list, nil
}

// newAreaControllerResponse 从数据库模型创建一个新的区域主控响应 DTO
func newAreaControllerResponse(ac *models.AreaController) (*AreaControllerResponse, error) {
	if ac == nil {
		return nil, nil
	}

	var props map[string]interface{}
	if len(ac.Properties) > 0 && string(ac.Properties) != "null" {
		if err := json.Unmarshal(ac.Properties, &props); err != nil {
			return nil, fmt.Errorf("解析区域主控属性失败 (ID: %d): %w", ac.ID, err)
		}
	}

	return &AreaControllerResponse{
		ID:         ac.ID,
		Name:       ac.Name,
		NetworkID:  ac.NetworkID,
		Location:   ac.Location,
		Status:     ac.Status,
		Properties: props,
		CreatedAt:  ac.CreatedAt.Format(time.RFC3339),
		UpdatedAt:  ac.UpdatedAt.Format(time.RFC3339),
	}, nil
}

// newListAreaControllerResponse 从数据库模型切片创建一个新的区域主控列表响应 DTO 切片
func newListAreaControllerResponse(acs []*models.AreaController) ([]*AreaControllerResponse, error) {
	list := make([]*AreaControllerResponse, 0, len(acs))
	for _, ac := range acs {
		resp, err := newAreaControllerResponse(ac)
		if err != nil {
			return nil, err
		}
		list = append(list, resp)
	}
	return list, nil
}

// --- Controller Methods: Devices ---

// CreateDevice godoc
// @Summary      创建新设备
// @Description  根据提供的信息创建一个新设备
// @Tags         设备管理
// @Accept       json
// @Produce      json
// @Param        device body CreateDeviceRequest true "设备信息"
// @Success      200 {object} controller.Response{data=DeviceResponse}
// @Router       /api/v1/devices [post]
func (c *Controller) CreateDevice(ctx *gin.Context) {
	const actionType = "创建设备"
	var req CreateDeviceRequest
	if err := ctx.ShouldBindJSON(&req); err != nil {
		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的请求体: "+err.Error(), actionType, "请求体绑定失败", req)
		return
	}

	propertiesJSON, err := json.Marshal(req.Properties)
	if err != nil {
		c.logger.Errorf("%s: 序列化属性失败: %v", actionType, err)
		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "属性字段格式错误", actionType, "属性序列化失败", req.Properties)
		return
	}

	device := &models.Device{
		Name:             req.Name,
		DeviceTemplateID: req.DeviceTemplateID,
		AreaControllerID: req.AreaControllerID,
		Location:         req.Location,
		Properties:       propertiesJSON,
	}

	if err := device.SelfCheck(); err != nil {
		c.logger.Errorf("%s: 设备属性自检失败: %v", actionType, err)
		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "设备属性不符合要求: "+err.Error(), actionType, "设备属性自检失败", device)
		return
	}

	if err := c.deviceRepo.Create(device); err != nil {
		c.logger.Errorf("%s: 数据库操作失败: %v", actionType, err)
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "创建设备失败: "+err.Error(), actionType, "数据库创建失败", device)
		return
	}

	createdDevice, err := c.deviceRepo.FindByID(device.ID)
	if err != nil {
		c.logger.Errorf("%s: 重新加载创建的设备失败: %v", actionType, err)
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "设备创建成功，但重新加载设备失败", actionType, "重新加载设备失败", device)
		return
	}

	resp, err := newDeviceResponse(createdDevice)
	if err != nil {
		c.logger.Errorf("%s: 序列化响应失败: %v", actionType, err)
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "设备创建成功，但响应生成失败", actionType, "响应序列化失败", createdDevice)
		return
	}

	c.logger.Infof("%s: 设备创建成功, ID: %d", actionType, device.ID)
	controller.SendSuccessWithAudit(ctx, controller.CodeCreated, "设备创建成功", resp, actionType, "设备创建成功", resp)
}

// GetDevice godoc
// @Summary      获取设备信息
// @Description  根据设备ID获取单个设备的详细信息
// @Tags         设备管理
// @Produce      json
// @Param        id path string true "设备ID"
// @Success      200 {object} controller.Response{data=DeviceResponse}
// @Router       /api/v1/devices/{id} [get]
func (c *Controller) GetDevice(ctx *gin.Context) {
	const actionType = "获取设备"
	deviceID := ctx.Param("id")

	if deviceID == "" {
		c.logger.Errorf("%s: 设备ID为空", actionType)
		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "设备ID不能为空", actionType, "设备ID为空", nil)
		return
	}

	device, err := c.deviceRepo.FindByIDString(deviceID)
	if err != nil {
		if errors.Is(err, gorm.ErrRecordNotFound) {
			c.logger.Warnf("%s: 设备不存在, ID: %s", actionType, deviceID)
			controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "设备未找到", actionType, "设备不存在", deviceID)
			return
		}
		if strings.Contains(err.Error(), "无效的设备ID格式") {
			c.logger.Errorf("%s: 设备ID格式错误: %v, ID: %s", actionType, err, deviceID)
			controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, err.Error(), actionType, "设备ID格式错误", deviceID)
			return
		}
		c.logger.Errorf("%s: 数据库查询失败: %v, ID: %s", actionType, err, deviceID)
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取设备信息失败: "+err.Error(), actionType, "数据库查询失败", deviceID)
		return
	}

	resp, err := newDeviceResponse(device)
	if err != nil {
		c.logger.Errorf("%s: 序列化响应失败: %v, Device: %+v", actionType, err, device)
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取设备信息失败: 内部数据格式错误", actionType, "响应序列化失败", device)
		return
	}

	c.logger.Infof("%s: 获取设备信息成功, ID: %d", actionType, device.ID)
	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取设备信息成功", resp, actionType, "获取设备信息成功", resp)
}

// ListDevices godoc
// @Summary      获取设备列表
// @Description  获取系统中所有设备的列表
// @Tags         设备管理
// @Produce      json
// @Success      200 {object} controller.Response{data=[]DeviceResponse}
// @Router       /api/v1/devices [get]
func (c *Controller) ListDevices(ctx *gin.Context) {
	const actionType = "获取设备列表"
	devices, err := c.deviceRepo.ListAll()
	if err != nil {
		c.logger.Errorf("%s: 数据库查询失败: %v", actionType, err)
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取设备列表失败: "+err.Error(), actionType, "数据库查询失败", nil)
		return
	}

	resp, err := newListDeviceResponse(devices)
	if err != nil {
		c.logger.Errorf("%s: 序列化响应失败: %v, Devices: %+v", actionType, err, devices)
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取设备列表失败: 内部数据格式错误", actionType, "响应序列化失败", devices)
		return
	}

	c.logger.Infof("%s: 获取设备列表成功, 数量: %d", actionType, len(devices))
	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取设备列表成功", resp, actionType, "获取设备列表成功", resp)
}

// UpdateDevice godoc
// @Summary      更新设备信息
// @Description  根据设备ID更新一个已存在的设备信息
// @Tags         设备管理
// @Accept       json
// @Produce      json
// @Param        id path string true "设备ID"
// @Param        device body UpdateDeviceRequest true "要更新的设备信息"
// @Success      200 {object} controller.Response{data=DeviceResponse}
// @Router       /api/v1/devices/{id} [put]
func (c *Controller) UpdateDevice(ctx *gin.Context) {
	const actionType = "更新设备"
	deviceID := ctx.Param("id")

	existingDevice, err := c.deviceRepo.FindByIDString(deviceID)
	if err != nil {
		if errors.Is(err, gorm.ErrRecordNotFound) {
			c.logger.Warnf("%s: 设备不存在, ID: %s", actionType, deviceID)
			controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "设备未找到", actionType, "设备不存在", deviceID)
			return
		}
		if strings.Contains(err.Error(), "无效的设备ID格式") {
			c.logger.Errorf("%s: 设备ID格式错误: %v, ID: %s", actionType, err, deviceID)
			controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, err.Error(), actionType, "设备ID格式错误", deviceID)
			return
		}
		c.logger.Errorf("%s: 数据库查询失败: %v, ID: %s", actionType, err, deviceID)
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "更新设备失败: "+err.Error(), actionType, "数据库查询失败", deviceID)
		return
	}

	var req UpdateDeviceRequest
	if err := ctx.ShouldBindJSON(&req); err != nil {
		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的请求体: "+err.Error(), actionType, "请求体绑定失败", req)
		return
	}

	propertiesJSON, err := json.Marshal(req.Properties)
	if err != nil {
		c.logger.Errorf("%s: 序列化属性失败: %v", actionType, err)
		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "属性字段格式错误", actionType, "属性序列化失败", req.Properties)
		return
	}

	existingDevice.Name = req.Name
	existingDevice.DeviceTemplateID = req.DeviceTemplateID
	existingDevice.AreaControllerID = req.AreaControllerID
	existingDevice.Location = req.Location
	existingDevice.Properties = propertiesJSON

	if err := existingDevice.SelfCheck(); err != nil {
		c.logger.Errorf("%s: 设备属性自检失败: %v", actionType, err)
		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "设备属性不符合要求: "+err.Error(), actionType, "设备属性自检失败", existingDevice)
		return
	}

	if err := c.deviceRepo.Update(existingDevice); err != nil {
		c.logger.Errorf("%s: 数据库更新失败: %v, Device: %+v", actionType, err, existingDevice)
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "更新设备失败: "+err.Error(), actionType, "数据库更新失败", existingDevice)
		return
	}

	updatedDevice, err := c.deviceRepo.FindByID(existingDevice.ID)
	if err != nil {
		c.logger.Errorf("%s: 重新加载更新的设备失败: %v", actionType, err)
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "设备更新成功，但重新加载设备失败", actionType, "重新加载设备失败", existingDevice)
		return
	}

	resp, err := newDeviceResponse(updatedDevice)
	if err != nil {
		c.logger.Errorf("%s: 序列化响应失败: %v, Device: %+v", actionType, err, updatedDevice)
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "设备更新成功，但响应生成失败", actionType, "响应序列化失败", updatedDevice)
		return
	}

	c.logger.Infof("%s: 设备更新成功, ID: %d", actionType, existingDevice.ID)
	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "设备更新成功", resp, actionType, "设备更新成功", resp)
}

// DeleteDevice godoc
// @Summary      删除设备
// @Description  根据设备ID删除一个设备（软删除）
// @Tags         设备管理
// @Produce      json
// @Param        id path string true "设备ID"
// @Success      200 {object} controller.Response
// @Router       /api/v1/devices/{id} [delete]
func (c *Controller) DeleteDevice(ctx *gin.Context) {
	const actionType = "删除设备"
	deviceID := ctx.Param("id")

	idUint, err := strconv.ParseUint(deviceID, 10, 64)
	if err != nil {
		c.logger.Errorf("%s: 设备ID格式错误: %v, ID: %s", actionType, err, deviceID)
		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的设备ID格式", actionType, "设备ID格式错误", deviceID)
		return
	}

	_, err = c.deviceRepo.FindByIDString(deviceID)
	if err != nil {
		if errors.Is(err, gorm.ErrRecordNotFound) {
			c.logger.Warnf("%s: 设备不存在, ID: %s", actionType, deviceID)
			controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "设备未找到", actionType, "设备不存在", deviceID)
			return
		}
		c.logger.Errorf("%s: 查找设备失败: %v, ID: %s", actionType, err, deviceID)
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "删除设备失败: 查找设备时发生内部错误", actionType, "数据库查询失败", deviceID)
		return
	}

	if err := c.deviceRepo.Delete(uint(idUint)); err != nil {
		c.logger.Errorf("%s: 数据库删除失败: %v, ID: %d", actionType, err, idUint)
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "删除设备失败: "+err.Error(), actionType, "数据库删除失败", deviceID)
		return
	}

	c.logger.Infof("%s: 设备删除成功, ID: %d", actionType, idUint)
	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "设备删除成功", nil, actionType, "设备删除成功", deviceID)
}

// --- Controller Methods: Area Controllers ---

// CreateAreaController godoc
// @Summary      创建新区域主控
// @Description  根据提供的信息创建一个新区域主控
// @Tags         区域主控管理
// @Accept       json
// @Produce      json
// @Param        areaController body CreateAreaControllerRequest true "区域主控信息"
// @Success      200 {object} controller.Response{data=AreaControllerResponse}
// @Router       /api/v1/area-controllers [post]
func (c *Controller) CreateAreaController(ctx *gin.Context) {
	const actionType = "创建区域主控"
	var req CreateAreaControllerRequest
	if err := ctx.ShouldBindJSON(&req); err != nil {
		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的请求体: "+err.Error(), actionType, "请求体绑定失败", req)
		return
	}

	propertiesJSON, err := json.Marshal(req.Properties)
	if err != nil {
		c.logger.Errorf("%s: 序列化属性失败: %v", actionType, err)
		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "属性字段格式错误", actionType, "属性序列化失败", req.Properties)
		return
	}

	ac := &models.AreaController{
		Name:       req.Name,
		NetworkID:  req.NetworkID,
		Location:   req.Location,
		Properties: propertiesJSON,
	}

	if err := ac.SelfCheck(); err != nil {
		c.logger.Errorf("%s: 区域主控自检失败: %v", actionType, err)
		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "区域主控参数不符合要求: "+err.Error(), actionType, "区域主控自检失败", ac)
		return
	}

	if err := c.areaControllerRepo.Create(ac); err != nil {
		c.logger.Errorf("%s: 数据库操作失败: %v", actionType, err)
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "创建区域主控失败: "+err.Error(), actionType, "数据库创建失败", ac)
		return
	}

	resp, err := newAreaControllerResponse(ac)
	if err != nil {
		c.logger.Errorf("%s: 序列化响应失败: %v", actionType, err)
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "区域主控创建成功，但响应生成失败", actionType, "响应序列化失败", ac)
		return
	}

	c.logger.Infof("%s: 区域主控创建成功, ID: %d", actionType, ac.ID)
	controller.SendSuccessWithAudit(ctx, controller.CodeCreated, "区域主控创建成功", resp, actionType, "区域主控创建成功", resp)
}

// GetAreaController godoc
// @Summary      获取区域主控信息
// @Description  根据ID获取单个区域主控的详细信息
// @Tags         区域主控管理
// @Produce      json
// @Param        id path string true "区域主控ID"
// @Success      200 {object} controller.Response{data=AreaControllerResponse}
// @Router       /api/v1/area-controllers/{id} [get]
func (c *Controller) GetAreaController(ctx *gin.Context) {
	const actionType = "获取区域主控"
	acID := ctx.Param("id")

	idUint, err := strconv.ParseUint(acID, 10, 64)
	if err != nil {
		c.logger.Errorf("%s: 区域主控ID格式错误: %v, ID: %s", actionType, err, acID)
		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的区域主控ID格式", actionType, "ID格式错误", acID)
		return
	}

	ac, err := c.areaControllerRepo.FindByID(uint(idUint))
	if err != nil {
		if errors.Is(err, gorm.ErrRecordNotFound) {
			c.logger.Warnf("%s: 区域主控不存在, ID: %s", actionType, acID)
			controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "区域主控未找到", actionType, "区域主控不存在", acID)
			return
		}
		c.logger.Errorf("%s: 数据库查询失败: %v, ID: %s", actionType, err, acID)
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取区域主控信息失败: "+err.Error(), actionType, "数据库查询失败", acID)
		return
	}

	resp, err := newAreaControllerResponse(ac)
	if err != nil {
		c.logger.Errorf("%s: 序列化响应失败: %v, AreaController: %+v", actionType, err, ac)
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取区域主控信息失败: 内部数据格式错误", actionType, "响应序列化失败", ac)
		return
	}

	c.logger.Infof("%s: 获取区域主控信息成功, ID: %d", actionType, ac.ID)
	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取区域主控信息成功", resp, actionType, "获取区域主控信息成功", resp)
}

// ListAreaControllers godoc
// @Summary      获取所有区域主控列表
// @Description  获取系统中所有区域主控的列表
// @Tags         区域主控管理
// @Produce      json
// @Success      200 {object} controller.Response{data=[]AreaControllerResponse}
// @Router       /api/v1/area-controllers [get]
func (c *Controller) ListAreaControllers(ctx *gin.Context) {
	const actionType = "获取区域主控列表"
	acs, err := c.areaControllerRepo.ListAll()
	if err != nil {
		c.logger.Errorf("%s: 数据库查询失败: %v", actionType, err)
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取区域主控列表失败: "+err.Error(), actionType, "数据库查询失败", nil)
		return
	}

	resp, err := newListAreaControllerResponse(acs)
	if err != nil {
		c.logger.Errorf("%s: 序列化响应失败: %v, AreaControllers: %+v", actionType, err, acs)
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取区域主控列表失败: 内部数据格式错误", actionType, "响应序列化失败", acs)
		return
	}

	c.logger.Infof("%s: 获取区域主控列表成功, 数量: %d", actionType, len(acs))
	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取区域主控列表成功", resp, actionType, "获取区域主控列表成功", resp)
}

// UpdateAreaController godoc
// @Summary      更新区域主控信息
// @Description  根据ID更新一个已存在的区域主控信息
// @Tags         区域主控管理
// @Accept       json
// @Produce      json
// @Param        id path string true "区域主控ID"
// @Param        areaController body UpdateAreaControllerRequest true "要更新的区域主控信息"
// @Success      200 {object} controller.Response{data=AreaControllerResponse}
// @Router       /api/v1/area-controllers/{id} [put]
func (c *Controller) UpdateAreaController(ctx *gin.Context) {
	const actionType = "更新区域主控"
	acID := ctx.Param("id")

	idUint, err := strconv.ParseUint(acID, 10, 64)
	if err != nil {
		c.logger.Errorf("%s: 区域主控ID格式错误: %v, ID: %s", actionType, err, acID)
		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的区域主控ID格式", actionType, "ID格式错误", acID)
		return
	}

	existingAC, err := c.areaControllerRepo.FindByID(uint(idUint))
	if err != nil {
		if errors.Is(err, gorm.ErrRecordNotFound) {
			c.logger.Warnf("%s: 区域主控不存在, ID: %s", actionType, acID)
			controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "区域主控未找到", actionType, "区域主控不存在", acID)
			return
		}
		c.logger.Errorf("%s: 数据库查询失败: %v, ID: %s", actionType, err, acID)
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "更新区域主控失败: "+err.Error(), actionType, "数据库查询失败", acID)
		return
	}

	var req UpdateAreaControllerRequest
	if err := ctx.ShouldBindJSON(&req); err != nil {
		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的请求体: "+err.Error(), actionType, "请求体绑定失败", req)
		return
	}

	propertiesJSON, err := json.Marshal(req.Properties)
	if err != nil {
		c.logger.Errorf("%s: 序列化属性失败: %v", actionType, err)
		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "属性字段格式错误", actionType, "属性序列化失败", req.Properties)
		return
	}

	existingAC.Name = req.Name
	existingAC.NetworkID = req.NetworkID
	existingAC.Location = req.Location
	existingAC.Properties = propertiesJSON

	if err := existingAC.SelfCheck(); err != nil {
		c.logger.Errorf("%s: 区域主控自检失败: %v", actionType, err)
		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "区域主控参数不符合要求: "+err.Error(), actionType, "区域主控自检失败", existingAC)
		return
	}

	if err := c.areaControllerRepo.Update(existingAC); err != nil {
		c.logger.Errorf("%s: 数据库更新失败: %v, AreaController: %+v", actionType, err, existingAC)
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "更新区域主控失败: "+err.Error(), actionType, "数据库更新失败", existingAC)
		return
	}

	resp, err := newAreaControllerResponse(existingAC)
	if err != nil {
		c.logger.Errorf("%s: 序列化响应失败: %v, AreaController: %+v", actionType, err, existingAC)
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "区域主控更新成功，但响应生成失败", actionType, "响应序列化失败", existingAC)
		return
	}

	c.logger.Infof("%s: 区域主控更新成功, ID: %d", actionType, existingAC.ID)
	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "区域主控更新成功", resp, actionType, "区域主控更新成功", resp)
}

// DeleteAreaController godoc
// @Summary      删除区域主控
// @Description  根据ID删除一个区域主控（软删除）
// @Tags         区域主控管理
// @Produce      json
// @Param        id path string true "区域主控ID"
// @Success      200 {object} controller.Response
// @Router       /api/v1/area-controllers/{id} [delete]
func (c *Controller) DeleteAreaController(ctx *gin.Context) {
	const actionType = "删除区域主控"
	acID := ctx.Param("id")

	idUint, err := strconv.ParseUint(acID, 10, 64)
	if err != nil {
		c.logger.Errorf("%s: 区域主控ID格式错误: %v, ID: %s", actionType, err, acID)
		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的区域主控ID格式", actionType, "ID格式错误", acID)
		return
	}

	_, err = c.areaControllerRepo.FindByID(uint(idUint))
	if err != nil {
		if errors.Is(err, gorm.ErrRecordNotFound) {
			c.logger.Warnf("%s: 区域主控不存在, ID: %s", actionType, acID)
			controller.SendErrorWithAudit(ctx, controller.CodeNotFound, "区域主控未找到", actionType, "区域主控不存在", acID)
			return
		}
		c.logger.Errorf("%s: 查找区域主控失败: %v, ID: %s", actionType, err, acID)
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "删除区域主控失败: 查找时发生内部错误", actionType, "数据库查询失败", acID)
		return
	}

	if err := c.areaControllerRepo.Delete(uint(idUint)); err != nil {
		c.logger.Errorf("%s: 数据库删除失败: %v, ID: %d", actionType, err, idUint)
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "删除区域主控失败: "+err.Error(), actionType, "数据库删除失败", acID)
		return
	}

	c.logger.Infof("%s: 区域主控删除成功, ID: %d", actionType, idUint)
	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "区域主控删除成功", nil, actionType, "区域主控删除成功", acID)
}