247 lines
		
	
	
		
			9.6 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
			
		
		
	
	
			247 lines
		
	
	
		
			9.6 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
package user
 | 
						||
 | 
						||
import (
 | 
						||
	"errors"
 | 
						||
	"strconv"
 | 
						||
 | 
						||
	"git.huangwc.com/pig/pig-farm-controller/internal/app/controller"
 | 
						||
	"git.huangwc.com/pig/pig-farm-controller/internal/app/dto"
 | 
						||
	"git.huangwc.com/pig/pig-farm-controller/internal/app/service"
 | 
						||
	domain_notify "git.huangwc.com/pig/pig-farm-controller/internal/domain/notify"
 | 
						||
	"git.huangwc.com/pig/pig-farm-controller/internal/domain/token"
 | 
						||
	"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 {
 | 
						||
	userRepo       repository.UserRepository
 | 
						||
	monitorService service.MonitorService
 | 
						||
	tokenService   token.Service
 | 
						||
	notifyService  domain_notify.Service
 | 
						||
	logger         *logs.Logger
 | 
						||
}
 | 
						||
 | 
						||
// NewController 创建用户控制器实例
 | 
						||
func NewController(
 | 
						||
	userRepo repository.UserRepository,
 | 
						||
	monitorService service.MonitorService,
 | 
						||
	logger *logs.Logger,
 | 
						||
	tokenService token.Service,
 | 
						||
	notifyService domain_notify.Service,
 | 
						||
) *Controller {
 | 
						||
	return &Controller{
 | 
						||
		userRepo:       userRepo,
 | 
						||
		monitorService: monitorService,
 | 
						||
		tokenService:   tokenService,
 | 
						||
		notifyService:  notifyService,
 | 
						||
		logger:         logger,
 | 
						||
	}
 | 
						||
}
 | 
						||
 | 
						||
// --- Controller Methods ---
 | 
						||
 | 
						||
// CreateUser godoc
 | 
						||
// @Summary      创建新用户
 | 
						||
// @Description  根据用户名和密码创建一个新的系统用户。
 | 
						||
// @Tags         用户管理
 | 
						||
// @Accept       json
 | 
						||
// @Produce      json
 | 
						||
// @Param        user body dto.CreateUserRequest true "用户信息"
 | 
						||
// @Success      200 {object} controller.Response{data=dto.CreateUserResponse} "业务码为201代表创建成功"
 | 
						||
// @Router       /api/v1/users [post]
 | 
						||
func (c *Controller) CreateUser(ctx *gin.Context) {
 | 
						||
	var req dto.CreateUserRequest
 | 
						||
	if err := ctx.ShouldBindJSON(&req); err != nil {
 | 
						||
		c.logger.Errorf("创建用户: 参数绑定失败: %v", err)
 | 
						||
		controller.SendErrorResponse(ctx, controller.CodeBadRequest, err.Error())
 | 
						||
		return
 | 
						||
	}
 | 
						||
 | 
						||
	user := &models.User{
 | 
						||
		Username: req.Username,
 | 
						||
		Password: req.Password, // 密码会在 BeforeSave 钩子中哈希
 | 
						||
	}
 | 
						||
 | 
						||
	if err := c.userRepo.Create(user); err != nil {
 | 
						||
		c.logger.Errorf("创建用户: 创建用户失败: %v", err)
 | 
						||
 | 
						||
		// 尝试查询用户,以判断是否是用户名重复导致的错误
 | 
						||
		_, findErr := c.userRepo.FindByUsername(req.Username)
 | 
						||
		if findErr == nil { // 如果能找到用户,说明是用户名重复
 | 
						||
			controller.SendErrorResponse(ctx, controller.CodeConflict, "用户名已存在")
 | 
						||
			return
 | 
						||
		}
 | 
						||
 | 
						||
		// 其他创建失败的情况
 | 
						||
		controller.SendErrorResponse(ctx, controller.CodeInternalError, "创建用户失败")
 | 
						||
		return
 | 
						||
	}
 | 
						||
 | 
						||
	controller.SendResponse(ctx, controller.CodeCreated, "用户创建成功", dto.CreateUserResponse{
 | 
						||
		Username: user.Username,
 | 
						||
		ID:       user.ID,
 | 
						||
	})
 | 
						||
}
 | 
						||
 | 
						||
// Login godoc
 | 
						||
// @Summary      用户登录
 | 
						||
// @Description  用户可以使用用户名、邮箱、手机号、微信号或飞书账号进行登录,成功后返回 JWT 令牌。
 | 
						||
// @Tags         用户管理
 | 
						||
// @Accept       json
 | 
						||
// @Produce      json
 | 
						||
// @Param        credentials body dto.LoginRequest true "登录凭证"
 | 
						||
// @Success      200 {object} controller.Response{data=dto.LoginResponse} "业务码为200代表登录成功"
 | 
						||
// @Router       /api/v1/users/login [post]
 | 
						||
func (c *Controller) Login(ctx *gin.Context) {
 | 
						||
	var req dto.LoginRequest
 | 
						||
	if err := ctx.ShouldBindJSON(&req); err != nil {
 | 
						||
		c.logger.Errorf("登录: 参数绑定失败: %v", err)
 | 
						||
		controller.SendErrorResponse(ctx, controller.CodeBadRequest, err.Error())
 | 
						||
		return
 | 
						||
	}
 | 
						||
 | 
						||
	// 使用新的方法,通过唯一标识符(用户名、邮箱等)查找用户
 | 
						||
	user, err := c.userRepo.FindUserForLogin(req.Identifier)
 | 
						||
	if err != nil {
 | 
						||
		if err == gorm.ErrRecordNotFound {
 | 
						||
			controller.SendErrorResponse(ctx, controller.CodeUnauthorized, "登录凭证不正确")
 | 
						||
			return
 | 
						||
		}
 | 
						||
		c.logger.Errorf("登录: 查询用户失败: %v", err)
 | 
						||
		controller.SendErrorResponse(ctx, controller.CodeInternalError, "登录失败")
 | 
						||
		return
 | 
						||
	}
 | 
						||
 | 
						||
	if !user.CheckPassword(req.Password) {
 | 
						||
		controller.SendErrorResponse(ctx, controller.CodeUnauthorized, "登录凭证不正确")
 | 
						||
		return
 | 
						||
	}
 | 
						||
 | 
						||
	// 登录成功,生成 JWT token
 | 
						||
	tokenString, err := c.tokenService.GenerateToken(user.ID)
 | 
						||
	if err != nil {
 | 
						||
		c.logger.Errorf("登录: 生成令牌失败: %v", err)
 | 
						||
		controller.SendErrorResponse(ctx, controller.CodeInternalError, "登录失败,无法生成认证信息")
 | 
						||
		return
 | 
						||
	}
 | 
						||
 | 
						||
	controller.SendResponse(ctx, controller.CodeSuccess, "登录成功", dto.LoginResponse{
 | 
						||
		Username: user.Username,
 | 
						||
		ID:       user.ID,
 | 
						||
		Token:    tokenString,
 | 
						||
	})
 | 
						||
}
 | 
						||
 | 
						||
// ListUserHistory godoc
 | 
						||
// @Summary      获取指定用户的操作历史
 | 
						||
// @Description  根据用户ID,分页获取该用户的操作审计日志。支持与通用日志查询接口相同的过滤和排序参数。
 | 
						||
// @Tags         用户管理
 | 
						||
// @Security     BearerAuth
 | 
						||
// @Produce      json
 | 
						||
// @Param        id    path      int  true  "用户ID"
 | 
						||
// @Param        query query     dto.ListUserActionLogRequest false "查询参数 (除了 user_id,它被路径中的ID覆盖)"
 | 
						||
// @Success      200   {object}  controller.Response{data=dto.ListUserActionLogResponse} "业务码为200代表成功获取"
 | 
						||
// @Router       /api/v1/users/{id}/history [get]
 | 
						||
func (c *Controller) ListUserHistory(ctx *gin.Context) {
 | 
						||
	const actionType = "获取用户操作历史"
 | 
						||
 | 
						||
	// 1. 解析路径中的用户ID,它的优先级最高
 | 
						||
	userIDStr := ctx.Param("id")
 | 
						||
	userID, err := strconv.ParseUint(userIDStr, 10, 64)
 | 
						||
	if err != nil {
 | 
						||
		c.logger.Errorf("%s: 无效的用户ID格式: %v, ID: %s", actionType, err, userIDStr)
 | 
						||
		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的用户ID格式", actionType, "无效的用户ID格式", userIDStr)
 | 
						||
		return
 | 
						||
	}
 | 
						||
 | 
						||
	// 2. 绑定通用的查询请求 DTO
 | 
						||
	var req dto.ListUserActionLogRequest
 | 
						||
	if err := ctx.ShouldBindQuery(&req); err != nil {
 | 
						||
		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
 | 
						||
		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的查询参数: "+err.Error(), actionType, "参数绑定失败", req)
 | 
						||
		return
 | 
						||
	}
 | 
						||
 | 
						||
	// 3. 准备 Service 调用参数,并强制使用路径中的 UserID
 | 
						||
	uid := uint(userID)
 | 
						||
	req.UserID = &uid // 强制覆盖
 | 
						||
 | 
						||
	opts := repository.UserActionLogListOptions{
 | 
						||
		UserID:     req.UserID,
 | 
						||
		Username:   req.Username,
 | 
						||
		ActionType: req.ActionType,
 | 
						||
		OrderBy:    req.OrderBy,
 | 
						||
		StartTime:  req.StartTime,
 | 
						||
		EndTime:    req.EndTime,
 | 
						||
	}
 | 
						||
	if req.Status != nil {
 | 
						||
		status := models.AuditStatus(*req.Status)
 | 
						||
		opts.Status = &status
 | 
						||
	}
 | 
						||
 | 
						||
	// 4. 调用 monitorService,复用其业务逻辑
 | 
						||
	data, total, err := c.monitorService.ListUserActionLogs(opts, req.Page, req.PageSize)
 | 
						||
	if err != nil {
 | 
						||
		if errors.Is(err, repository.ErrInvalidPagination) {
 | 
						||
			c.logger.Warnf("%s: 无效的分页参数: %v", actionType, err)
 | 
						||
			controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的分页参数: "+err.Error(), actionType, "无效分页参数", opts)
 | 
						||
			return
 | 
						||
		}
 | 
						||
		c.logger.Errorf("%s: 服务层查询失败: %v", actionType, err)
 | 
						||
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "获取用户历史记录失败", actionType, "服务层查询失败", opts)
 | 
						||
		return
 | 
						||
	}
 | 
						||
 | 
						||
	// 5. 使用复用的 DTO 构建并发送成功响应
 | 
						||
	resp := dto.NewListUserActionLogResponse(data, total, req.Page, req.PageSize)
 | 
						||
	c.logger.Infof("%s: 成功获取用户 %d 的操作历史, 数量: %d", actionType, userID, len(data))
 | 
						||
	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "获取用户操作历史成功", resp, actionType, "获取用户操作历史成功", opts)
 | 
						||
}
 | 
						||
 | 
						||
// SendTestNotification godoc
 | 
						||
// @Summary      发送测试通知
 | 
						||
// @Description  为指定用户发送一条特定渠道的测试消息,以验证其配置是否正确。
 | 
						||
// @Tags         用户管理
 | 
						||
// @Security     BearerAuth
 | 
						||
// @Accept       json
 | 
						||
// @Produce      json
 | 
						||
// @Param        id   path      int  true  "用户ID"
 | 
						||
// @Param        body body      dto.SendTestNotificationRequest  true  "请求体"
 | 
						||
// @Success      200  {object}  controller.Response{data=string}  "成功响应"
 | 
						||
// @Router       /api/v1/users/{id}/notifications/test [post]
 | 
						||
func (c *Controller) SendTestNotification(ctx *gin.Context) {
 | 
						||
	const actionType = "发送测试通知"
 | 
						||
 | 
						||
	// 1. 从 URL 中获取用户 ID
 | 
						||
	userID, err := strconv.ParseUint(ctx.Param("id"), 10, 32)
 | 
						||
	if err != nil {
 | 
						||
		c.logger.Errorf("%s: 无效的用户ID格式: %v", actionType, err)
 | 
						||
		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的用户ID格式", actionType, "无效的用户ID格式", ctx.Param("id"))
 | 
						||
		return
 | 
						||
	}
 | 
						||
 | 
						||
	// 2. 从请求体 (JSON Body) 中获取要测试的通知类型
 | 
						||
	var req dto.SendTestNotificationRequest
 | 
						||
	if err := ctx.ShouldBindJSON(&req); err != nil {
 | 
						||
		c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err)
 | 
						||
		controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "请求体格式错误或缺少 'type' 字段: "+err.Error(), actionType, "请求体绑定失败", req)
 | 
						||
		return
 | 
						||
	}
 | 
						||
 | 
						||
	// 3. 调用领域服务
 | 
						||
	err = c.notifyService.SendTestMessage(uint(userID), req.Type)
 | 
						||
	if err != nil {
 | 
						||
		c.logger.Errorf("%s: 服务层调用失败: %v", actionType, err)
 | 
						||
		controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "发送测试消息失败: "+err.Error(), actionType, "服务层调用失败", gin.H{"userID": userID, "type": req.Type})
 | 
						||
		return
 | 
						||
	}
 | 
						||
 | 
						||
	// 4. 返回成功响应
 | 
						||
	c.logger.Infof("%s: 成功为用户 %d 发送类型为 %s 的测试消息", actionType, userID, req.Type)
 | 
						||
	controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "测试消息已发送,请检查您的接收端。", nil, actionType, "测试消息发送成功", gin.H{"userID": userID, "type": req.Type})
 | 
						||
}
 |