package user import ( "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" "git.huangwc.com/pig/pig-farm-controller/internal/infra/logs" "github.com/labstack/echo/v4" ) // Controller 用户控制器 type Controller struct { userService service.UserService logger *logs.Logger } // NewController 创建用户控制器实例 func NewController( userService service.UserService, logger *logs.Logger, ) *Controller { return &Controller{ userService: userService, 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 echo.Context) error { var req dto.CreateUserRequest if err := ctx.Bind(&req); err != nil { c.logger.Errorf("创建用户: 参数绑定失败: %v", err) return controller.SendErrorResponse(ctx, controller.CodeBadRequest, err.Error()) } resp, err := c.userService.CreateUser(&req) if err != nil { c.logger.Errorf("创建用户: 服务层调用失败: %v", err) return controller.SendErrorResponse(ctx, controller.CodeInternalError, err.Error()) } return controller.SendResponse(ctx, controller.CodeCreated, "用户创建成功", resp) } // 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 echo.Context) error { var req dto.LoginRequest if err := ctx.Bind(&req); err != nil { c.logger.Errorf("登录: 参数绑定失败: %v", err) return controller.SendErrorResponse(ctx, controller.CodeBadRequest, err.Error()) } resp, err := c.userService.Login(&req) if err != nil { c.logger.Errorf("登录: 服务层调用失败: %v", err) return controller.SendErrorResponse(ctx, controller.CodeUnauthorized, err.Error()) } return controller.SendResponse(ctx, controller.CodeSuccess, "登录成功", resp) } // 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 echo.Context) error { 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) return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "无效的用户ID格式", actionType, "无效的用户ID格式", ctx.Param("id")) } // 2. 从请求体 (JSON Body) 中获取要测试的通知类型 var req dto.SendTestNotificationRequest if err := ctx.Bind(&req); err != nil { c.logger.Errorf("%s: 参数绑定失败: %v", actionType, err) return controller.SendErrorWithAudit(ctx, controller.CodeBadRequest, "请求体格式错误或缺少 'type' 字段: "+err.Error(), actionType, "请求体绑定失败", req) } // 3. 调用服务层 err = c.userService.SendTestNotification(uint(userID), &req) if err != nil { c.logger.Errorf("%s: 服务层调用失败: %v", actionType, err) return controller.SendErrorWithAudit(ctx, controller.CodeInternalError, "发送测试消息失败: "+err.Error(), actionType, "服务层调用失败", map[string]interface{}{"userID": userID, "type": req.Type}) } // 4. 返回成功响应 c.logger.Infof("%s: 成功为用户 %d 发送类型为 %s 的测试消息", actionType, userID, req.Type) return controller.SendSuccessWithAudit(ctx, controller.CodeSuccess, "测试消息已发送,请检查您的接收端。", nil, actionType, "测试消息发送成功", map[string]interface{}{"userID": userID, "type": req.Type}) }