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.TokenService notifyService domain_notify.Service logger *logs.Logger } // NewController 创建用户控制器实例 func NewController( userRepo repository.UserRepository, monitorService service.MonitorService, logger *logs.Logger, tokenService token.TokenService, 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}) }