diff --git a/keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userinvites/KeyboardUserInvitesController.java b/keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userinvites/KeyboardUserInvitesController.java new file mode 100644 index 0000000..8f8c84e --- /dev/null +++ b/keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userinvites/KeyboardUserInvitesController.java @@ -0,0 +1,104 @@ +package com.yolo.keyboard.controller.admin.userinvites; + +import org.springframework.web.bind.annotation.*; +import jakarta.annotation.Resource; +import org.springframework.validation.annotation.Validated; +import org.springframework.security.access.prepost.PreAuthorize; +import io.swagger.v3.oas.annotations.tags.Tag; +import io.swagger.v3.oas.annotations.Parameter; +import io.swagger.v3.oas.annotations.Operation; + +import jakarta.validation.constraints.*; +import jakarta.validation.*; +import jakarta.servlet.http.*; +import java.util.*; +import java.io.IOException; + +import com.yolo.keyboard.framework.common.pojo.PageParam; +import com.yolo.keyboard.framework.common.pojo.PageResult; +import com.yolo.keyboard.framework.common.pojo.CommonResult; +import com.yolo.keyboard.framework.common.util.object.BeanUtils; +import static com.yolo.keyboard.framework.common.pojo.CommonResult.success; + +import com.yolo.keyboard.framework.excel.core.util.ExcelUtils; + +import com.yolo.keyboard.framework.apilog.core.annotation.ApiAccessLog; +import static com.yolo.keyboard.framework.apilog.core.enums.OperateTypeEnum.*; + +import com.yolo.keyboard.controller.admin.userinvites.vo.*; +import com.yolo.keyboard.dal.dataobject.userinvites.KeyboardUserInvitesDO; +import com.yolo.keyboard.service.userinvites.KeyboardUserInvitesService; + +@Tag(name = "管理后台 - 用户邀请关系绑定台账表，记录新用户最终归属的邀请人") +@RestController +@RequestMapping("/keyboard/user-invites") +@Validated +public class KeyboardUserInvitesController { + + @Resource + private KeyboardUserInvitesService userInvitesService; + + @PostMapping("/create") + @Operation(summary = "创建用户邀请关系绑定台账表，记录新用户最终归属的邀请人") + @PreAuthorize("@ss.hasPermission('keyboard:user-invites:create')") + public CommonResult createUserInvites(@Valid @RequestBody KeyboardUserInvitesSaveReqVO createReqVO) { + return success(userInvitesService.createUserInvites(createReqVO)); + } + + @PutMapping("/update") + @Operation(summary = "更新用户邀请关系绑定台账表，记录新用户最终归属的邀请人") + @PreAuthorize("@ss.hasPermission('keyboard:user-invites:update')") + public CommonResult updateUserInvites(@Valid @RequestBody KeyboardUserInvitesSaveReqVO updateReqVO) { + userInvitesService.updateUserInvites(updateReqVO); + return success(true); + } + + @DeleteMapping("/delete") + @Operation(summary = "删除用户邀请关系绑定台账表，记录新用户最终归属的邀请人") + @Parameter(name = "id", description = "编号", required = true) + @PreAuthorize("@ss.hasPermission('keyboard:user-invites:delete')") + public CommonResult deleteUserInvites(@RequestParam("id") Long id) { + userInvitesService.deleteUserInvites(id); + return success(true); + } + + @DeleteMapping("/delete-list") + @Parameter(name = "ids", description = "编号", required = true) + @Operation(summary = "批量删除用户邀请关系绑定台账表，记录新用户最终归属的邀请人") + @PreAuthorize("@ss.hasPermission('keyboard:user-invites:delete')") + public CommonResult deleteUserInvitesList(@RequestParam("ids") List ids) { + userInvitesService.deleteUserInvitesListByIds(ids); + return success(true); + } + + @GetMapping("/get") + @Operation(summary = "获得用户邀请关系绑定台账表，记录新用户最终归属的邀请人") + @Parameter(name = "id", description = "编号", required = true, example = "1024") + @PreAuthorize("@ss.hasPermission('keyboard:user-invites:query')") + public CommonResult getUserInvites(@RequestParam("id") Long id) { + KeyboardUserInvitesDO userInvites = userInvitesService.getUserInvites(id); + return success(BeanUtils.toBean(userInvites, KeyboardUserInvitesRespVO.class)); + } + + @GetMapping("/page") + @Operation(summary = "获得用户邀请关系绑定台账表，记录新用户最终归属的邀请人分页") + @PreAuthorize("@ss.hasPermission('keyboard:user-invites:query')") + public CommonResult> getUserInvitesPage(@Valid KeyboardUserInvitesPageReqVO pageReqVO) { + PageResult pageResult = userInvitesService.getUserInvitesPage(pageReqVO); + return success(BeanUtils.toBean(pageResult, KeyboardUserInvitesRespVO.class)); + } + + @GetMapping("/export-excel") + @Operation(summary = "导出用户邀请关系绑定台账表，记录新用户最终归属的邀请人 Excel") + @PreAuthorize("@ss.hasPermission('keyboard:user-invites:export')") + @ApiAccessLog(operateType = EXPORT) + public void exportUserInvitesExcel(@Valid KeyboardUserInvitesPageReqVO pageReqVO, + HttpServletResponse response) throws IOException { + pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE); + List list = userInvitesService.getUserInvitesPage(pageReqVO).getList(); + // 导出 Excel + ExcelUtils.write(response, "用户邀请关系绑定台账表，记录新用户最终归属的邀请人.xls", "数据", KeyboardUserInvitesRespVO.class, + BeanUtils.toBean(list, KeyboardUserInvitesRespVO.class)); + } + +} \ No newline at end of file diff --git a/keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userinvites/vo/KeyboardUserInvitesPageReqVO.java b/keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userinvites/vo/KeyboardUserInvitesPageReqVO.java new file mode 100644 index 0000000..8a2e698 --- /dev/null +++ b/keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userinvites/vo/KeyboardUserInvitesPageReqVO.java @@ -0,0 +1,55 @@ +package com.yolo.keyboard.controller.admin.userinvites.vo; + +import lombok.*; +import java.util.*; +import io.swagger.v3.oas.annotations.media.Schema; +import com.yolo.keyboard.framework.common.pojo.PageParam; +import org.springframework.format.annotation.DateTimeFormat; +import java.time.LocalDateTime; + +import static com.yolo.keyboard.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND; + +@Schema(description = "管理后台 - 用户邀请关系绑定台账表，记录新用户最终归属的邀请人分页 Request VO") +@Data +public class KeyboardUserInvitesPageReqVO extends PageParam { + + @Schema(description = "邀请人用户ID", example = "11992") + private Long inviterUserId; + + @Schema(description = "被邀请人用户ID（新注册用户）", example = "28499") + private Long inviteeUserId; + + @Schema(description = "使用的邀请码ID", example = "30340") + private Long inviteCodeId; + + @Schema(description = "绑定时关联的点击Token（通过邀请链接自动绑定时使用）") + private String clickToken; + + @Schema(description = "绑定方式：1=手动填写邀请码，2=邀请链接自动绑定，3=其他方式", example = "2") + private Short bindType; + + @Schema(description = "邀请关系绑定完成时间") + private LocalDateTime boundAt; + + @Schema(description = "绑定 iP") + private String bindIp; + + @Schema(description = "userAgent") + private String bindUserAgent; + + @Schema(description = "邀请码类型快照：USER=普通用户邀请，AGENT=代理邀请", example = "2") + private String inviteType; + + @Schema(description = "收益结算归属租户ID（代理结算用，绑定时固化）", example = "25223") + private Long profitTenantId; + + @Schema(description = "收益归因员工ID（用于区分租户员工/渠道，绑定时固化）", example = "31236") + private Long profitEmployeeId; + + @Schema(description = "邀请人所属租户ID快照（便于审计/对账，可选）", example = "17028") + private Long inviterTenantId; + + @Schema(description = "邀请码字符串快照（便于排查，可选）") + private String inviteCode; + +} \ No newline at end of file diff --git a/keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userinvites/vo/KeyboardUserInvitesRespVO.java b/keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userinvites/vo/KeyboardUserInvitesRespVO.java new file mode 100644 index 0000000..d6b2885 --- /dev/null +++ b/keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userinvites/vo/KeyboardUserInvitesRespVO.java @@ -0,0 +1,71 @@ +package com.yolo.keyboard.controller.admin.userinvites.vo; + +import io.swagger.v3.oas.annotations.media.Schema; +import lombok.*; +import java.util.*; +import org.springframework.format.annotation.DateTimeFormat; +import java.time.LocalDateTime; +import cn.idev.excel.annotation.*; + +@Schema(description = "管理后台 - 用户邀请关系绑定台账表，记录新用户最终归属的邀请人 Response VO") +@Data +@ExcelIgnoreUnannotated +public class KeyboardUserInvitesRespVO { + + @Schema(description = "邀请绑定记录主键ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "7254") + @ExcelProperty("邀请绑定记录主键ID") + private Long id; + + @Schema(description = "邀请人用户ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "11992") + @ExcelProperty("邀请人用户ID") + private Long inviterUserId; + + @Schema(description = "被邀请人用户ID（新注册用户）", requiredMode = Schema.RequiredMode.REQUIRED, example = "28499") + @ExcelProperty("被邀请人用户ID（新注册用户）") + private Long inviteeUserId; + + @Schema(description = "使用的邀请码ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "30340") + @ExcelProperty("使用的邀请码ID") + private Long inviteCodeId; + + @Schema(description = "绑定时关联的点击Token（通过邀请链接自动绑定时使用）") + @ExcelProperty("绑定时关联的点击Token（通过邀请链接自动绑定时使用）") + private String clickToken; + + @Schema(description = "绑定方式：1=手动填写邀请码，2=邀请链接自动绑定，3=其他方式", requiredMode = Schema.RequiredMode.REQUIRED, example = "2") + @ExcelProperty("绑定方式：1=手动填写邀请码，2=邀请链接自动绑定，3=其他方式") + private Short bindType; + + @Schema(description = "邀请关系绑定完成时间", requiredMode = Schema.RequiredMode.REQUIRED) + @ExcelProperty("邀请关系绑定完成时间") + private LocalDateTime boundAt; + + @Schema(description = "绑定 iP") + @ExcelProperty("绑定 iP") + private String bindIp; + + @Schema(description = "userAgent") + @ExcelProperty("userAgent") + private String bindUserAgent; + + @Schema(description = "邀请码类型快照：USER=普通用户邀请，AGENT=代理邀请", requiredMode = Schema.RequiredMode.REQUIRED, example = "2") + @ExcelProperty("邀请码类型快照：USER=普通用户邀请，AGENT=代理邀请") + private String inviteType; + + @Schema(description = "收益结算归属租户ID（代理结算用，绑定时固化）", example = "25223") + @ExcelProperty("收益结算归属租户ID（代理结算用，绑定时固化）") + private Long profitTenantId; + + @Schema(description = "收益归因员工ID（用于区分租户员工/渠道，绑定时固化）", example = "31236") + @ExcelProperty("收益归因员工ID（用于区分租户员工/渠道，绑定时固化）") + private Long profitEmployeeId; + + @Schema(description = "邀请人所属租户ID快照（便于审计/对账，可选）", example = "17028") + @ExcelProperty("邀请人所属租户ID快照（便于审计/对账，可选）") + private Long inviterTenantId; + + @Schema(description = "邀请码字符串快照（便于排查，可选）") + @ExcelProperty("邀请码字符串快照（便于排查，可选）") + private String inviteCode; + +} \ No newline at end of file diff --git a/keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userinvites/vo/KeyboardUserInvitesSaveReqVO.java b/keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userinvites/vo/KeyboardUserInvitesSaveReqVO.java new file mode 100644 index 0000000..79cafd5 --- /dev/null +++ b/keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userinvites/vo/KeyboardUserInvitesSaveReqVO.java @@ -0,0 +1,62 @@ +package com.yolo.keyboard.controller.admin.userinvites.vo; + +import io.swagger.v3.oas.annotations.media.Schema; +import lombok.*; +import java.util.*; +import jakarta.validation.constraints.*; +import org.springframework.format.annotation.DateTimeFormat; +import java.time.LocalDateTime; + +@Schema(description = "管理后台 - 用户邀请关系绑定台账表，记录新用户最终归属的邀请人新增/修改 Request VO") +@Data +public class KeyboardUserInvitesSaveReqVO { + + @Schema(description = "邀请绑定记录主键ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "7254") + private Long id; + + @Schema(description = "邀请人用户ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "11992") + @NotNull(message = "邀请人用户ID不能为空") + private Long inviterUserId; + + @Schema(description = "被邀请人用户ID（新注册用户）", requiredMode = Schema.RequiredMode.REQUIRED, example = "28499") + @NotNull(message = "被邀请人用户ID（新注册用户）不能为空") + private Long inviteeUserId; + + @Schema(description = "使用的邀请码ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "30340") + @NotNull(message = "使用的邀请码ID不能为空") + private Long inviteCodeId; + + @Schema(description = "绑定时关联的点击Token（通过邀请链接自动绑定时使用）") + private String clickToken; + + @Schema(description = "绑定方式：1=手动填写邀请码，2=邀请链接自动绑定，3=其他方式", requiredMode = Schema.RequiredMode.REQUIRED, example = "2") + @NotNull(message = "绑定方式：1=手动填写邀请码，2=邀请链接自动绑定，3=其他方式不能为空") + private Short bindType; + + @Schema(description = "邀请关系绑定完成时间", requiredMode = Schema.RequiredMode.REQUIRED) + @NotNull(message = "邀请关系绑定完成时间不能为空") + private LocalDateTime boundAt; + + @Schema(description = "绑定 iP") + private String bindIp; + + @Schema(description = "userAgent") + private String bindUserAgent; + + @Schema(description = "邀请码类型快照：USER=普通用户邀请，AGENT=代理邀请", requiredMode = Schema.RequiredMode.REQUIRED, example = "2") + @NotEmpty(message = "邀请码类型快照：USER=普通用户邀请，AGENT=代理邀请不能为空") + private String inviteType; + + @Schema(description = "收益结算归属租户ID（代理结算用，绑定时固化）", example = "25223") + private Long profitTenantId; + + @Schema(description = "收益归因员工ID（用于区分租户员工/渠道，绑定时固化）", example = "31236") + private Long profitEmployeeId; + + @Schema(description = "邀请人所属租户ID快照（便于审计/对账，可选）", example = "17028") + private Long inviterTenantId; + + @Schema(description = "邀请码字符串快照（便于排查，可选）") + private String inviteCode; + +} \ No newline at end of file diff --git a/keyboard-server/src/main/java/com/yolo/keyboard/dal/dataobject/userinvites/KeyboardUserInvitesDO.java b/keyboard-server/src/main/java/com/yolo/keyboard/dal/dataobject/userinvites/KeyboardUserInvitesDO.java new file mode 100644 index 0000000..2176324 --- /dev/null +++ b/keyboard-server/src/main/java/com/yolo/keyboard/dal/dataobject/userinvites/KeyboardUserInvitesDO.java @@ -0,0 +1,84 @@ +package com.yolo.keyboard.dal.dataobject.userinvites; + +import com.yolo.keyboard.framework.tenant.core.aop.TenantIgnore; +import lombok.*; +import java.util.*; +import java.time.LocalDateTime; +import com.baomidou.mybatisplus.annotation.*; +import com.yolo.keyboard.framework.mybatis.core.dataobject.BaseDO; + +/** + * 用户邀请关系绑定台账表，记录新用户最终归属的邀请人 DO + * + * @author ziin + */ +@TableName("keyboard_user_invites") +@KeySequence("keyboard_user_invites_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。 +@Data +@ToString(callSuper = true) +@Builder +@NoArgsConstructor +@AllArgsConstructor +@TenantIgnore +public class KeyboardUserInvitesDO { + + /** + * 邀请绑定记录主键ID + */ + @TableId + private Long id; + /** + * 邀请人用户ID + */ + private Long inviterUserId; + /** + * 被邀请人用户ID（新注册用户） + */ + private Long inviteeUserId; + /** + * 使用的邀请码ID + */ + private Long inviteCodeId; + /** + * 绑定时关联的点击Token（通过邀请链接自动绑定时使用） + */ + private String clickToken; + /** + * 绑定方式：1=手动填写邀请码，2=邀请链接自动绑定，3=其他方式 + */ + private Short bindType; + /** + * 邀请关系绑定完成时间 + */ + private LocalDateTime boundAt; + /** + * 绑定 iP + */ + private String bindIp; + /** + * userAgent + */ + private String bindUserAgent; + /** + * 邀请码类型快照：USER=普通用户邀请，AGENT=代理邀请 + */ + private String inviteType; + /** + * 收益结算归属租户ID（代理结算用，绑定时固化） + */ + private Long profitTenantId; + /** + * 收益归因员工ID（用于区分租户员工/渠道，绑定时固化） + */ + private Long profitEmployeeId; + /** + * 邀请人所属租户ID快照（便于审计/对账，可选） + */ + private Long inviterTenantId; + /** + * 邀请码字符串快照（便于排查，可选） + */ + private String inviteCode; + + +} \ No newline at end of file diff --git a/keyboard-server/src/main/java/com/yolo/keyboard/dal/mysql/userinvites/KeyboardUserInvitesMapper.java b/keyboard-server/src/main/java/com/yolo/keyboard/dal/mysql/userinvites/KeyboardUserInvitesMapper.java new file mode 100644 index 0000000..3c1cc19 --- /dev/null +++ b/keyboard-server/src/main/java/com/yolo/keyboard/dal/mysql/userinvites/KeyboardUserInvitesMapper.java @@ -0,0 +1,38 @@ +package com.yolo.keyboard.dal.mysql.userinvites; + +import java.util.*; + +import com.yolo.keyboard.framework.common.pojo.PageResult; +import com.yolo.keyboard.framework.mybatis.core.query.LambdaQueryWrapperX; +import com.yolo.keyboard.framework.mybatis.core.mapper.BaseMapperX; +import com.yolo.keyboard.dal.dataobject.userinvites.KeyboardUserInvitesDO; +import org.apache.ibatis.annotations.Mapper; +import com.yolo.keyboard.controller.admin.userinvites.vo.*; + +/** + * 用户邀请关系绑定台账表，记录新用户最终归属的邀请人 Mapper + * + * @author ziin + */ +@Mapper +public interface KeyboardUserInvitesMapper extends BaseMapperX { + + default PageResult selectPage(KeyboardUserInvitesPageReqVO reqVO) { + return selectPage(reqVO, new LambdaQueryWrapperX() + .eqIfPresent(KeyboardUserInvitesDO::getInviterUserId, reqVO.getInviterUserId()) + .eqIfPresent(KeyboardUserInvitesDO::getInviteeUserId, reqVO.getInviteeUserId()) + .eqIfPresent(KeyboardUserInvitesDO::getInviteCodeId, reqVO.getInviteCodeId()) + .eqIfPresent(KeyboardUserInvitesDO::getClickToken, reqVO.getClickToken()) + .eqIfPresent(KeyboardUserInvitesDO::getBindType, reqVO.getBindType()) + .eqIfPresent(KeyboardUserInvitesDO::getBoundAt, reqVO.getBoundAt()) + .eqIfPresent(KeyboardUserInvitesDO::getBindIp, reqVO.getBindIp()) + .eqIfPresent(KeyboardUserInvitesDO::getBindUserAgent, reqVO.getBindUserAgent()) + .eqIfPresent(KeyboardUserInvitesDO::getInviteType, reqVO.getInviteType()) + .eqIfPresent(KeyboardUserInvitesDO::getProfitTenantId, reqVO.getProfitTenantId()) + .eqIfPresent(KeyboardUserInvitesDO::getProfitEmployeeId, reqVO.getProfitEmployeeId()) + .eqIfPresent(KeyboardUserInvitesDO::getInviterTenantId, reqVO.getInviterTenantId()) + .eqIfPresent(KeyboardUserInvitesDO::getInviteCode, reqVO.getInviteCode()) + .orderByDesc(KeyboardUserInvitesDO::getId)); + } + +} \ No newline at end of file diff --git a/keyboard-server/src/main/java/com/yolo/keyboard/service/userinvites/KeyboardUserInvitesService.java b/keyboard-server/src/main/java/com/yolo/keyboard/service/userinvites/KeyboardUserInvitesService.java new file mode 100644 index 0000000..3904cf8 --- /dev/null +++ b/keyboard-server/src/main/java/com/yolo/keyboard/service/userinvites/KeyboardUserInvitesService.java @@ -0,0 +1,62 @@ +package com.yolo.keyboard.service.userinvites; + +import java.util.*; +import jakarta.validation.*; +import com.yolo.keyboard.controller.admin.userinvites.vo.*; +import com.yolo.keyboard.dal.dataobject.userinvites.KeyboardUserInvitesDO; +import com.yolo.keyboard.framework.common.pojo.PageResult; +import com.yolo.keyboard.framework.common.pojo.PageParam; + +/** + * 用户邀请关系绑定台账表，记录新用户最终归属的邀请人 Service 接口 + * + * @author ziin + */ +public interface KeyboardUserInvitesService { + + /** + * 创建用户邀请关系绑定台账表，记录新用户最终归属的邀请人 + * + * @param createReqVO 创建信息 + * @return 编号 + */ + Long createUserInvites(@Valid KeyboardUserInvitesSaveReqVO createReqVO); + + /** + * 更新用户邀请关系绑定台账表，记录新用户最终归属的邀请人 + * + * @param updateReqVO 更新信息 + */ + void updateUserInvites(@Valid KeyboardUserInvitesSaveReqVO updateReqVO); + + /** + * 删除用户邀请关系绑定台账表，记录新用户最终归属的邀请人 + * + * @param id 编号 + */ + void deleteUserInvites(Long id); + + /** + * 批量删除用户邀请关系绑定台账表，记录新用户最终归属的邀请人 + * + * @param ids 编号 + */ + void deleteUserInvitesListByIds(List ids); + + /** + * 获得用户邀请关系绑定台账表，记录新用户最终归属的邀请人 + * + * @param id 编号 + * @return 用户邀请关系绑定台账表，记录新用户最终归属的邀请人 + */ + KeyboardUserInvitesDO getUserInvites(Long id); + + /** + * 获得用户邀请关系绑定台账表，记录新用户最终归属的邀请人分页 + * + * @param pageReqVO 分页查询 + * @return 用户邀请关系绑定台账表，记录新用户最终归属的邀请人分页 + */ + PageResult getUserInvitesPage(KeyboardUserInvitesPageReqVO pageReqVO); + +} \ No newline at end of file diff --git a/keyboard-server/src/main/java/com/yolo/keyboard/service/userinvites/KeyboardUserInvitesServiceImpl.java b/keyboard-server/src/main/java/com/yolo/keyboard/service/userinvites/KeyboardUserInvitesServiceImpl.java new file mode 100644 index 0000000..8cde041 --- /dev/null +++ b/keyboard-server/src/main/java/com/yolo/keyboard/service/userinvites/KeyboardUserInvitesServiceImpl.java @@ -0,0 +1,80 @@ +package com.yolo.keyboard.service.userinvites; + +import com.yolo.keyboard.controller.admin.userinvites.vo.KeyboardUserInvitesPageReqVO; +import com.yolo.keyboard.controller.admin.userinvites.vo.KeyboardUserInvitesSaveReqVO; +import com.yolo.keyboard.dal.dataobject.userinvites.KeyboardUserInvitesDO; +import com.yolo.keyboard.dal.mysql.userinvites.KeyboardUserInvitesMapper; +import com.yolo.keyboard.framework.common.pojo.PageResult; +import com.yolo.keyboard.framework.common.util.object.BeanUtils; +import jakarta.annotation.Resource; +import org.springframework.stereotype.Service; +import org.springframework.validation.annotation.Validated; + +import java.util.List; + +import static com.yolo.keyboard.framework.common.exception.util.ServiceExceptionUtil.exception; +import static com.yolo.keyboard.module.infra.enums.ErrorCodeConstants.USER_INVITES_NOT_EXISTS; + +/** + * 用户邀请关系绑定台账表，记录新用户最终归属的邀请人 Service 实现类 + * + * @author ziin + */ +@Service +@Validated +public class KeyboardUserInvitesServiceImpl implements KeyboardUserInvitesService { + + @Resource + private KeyboardUserInvitesMapper userInvitesMapper; + + @Override + public Long createUserInvites(KeyboardUserInvitesSaveReqVO createReqVO) { + // 插入 + KeyboardUserInvitesDO userInvites = BeanUtils.toBean(createReqVO, KeyboardUserInvitesDO.class); + userInvitesMapper.insert(userInvites); + + // 返回 + return userInvites.getId(); + } + + @Override + public void updateUserInvites(KeyboardUserInvitesSaveReqVO updateReqVO) { + // 校验存在 + validateUserInvitesExists(updateReqVO.getId()); + // 更新 + KeyboardUserInvitesDO updateObj = BeanUtils.toBean(updateReqVO, KeyboardUserInvitesDO.class); + userInvitesMapper.updateById(updateObj); + } + + @Override + public void deleteUserInvites(Long id) { + // 校验存在 + validateUserInvitesExists(id); + // 删除 + userInvitesMapper.deleteById(id); + } + + @Override + public void deleteUserInvitesListByIds(List ids) { + // 删除 + userInvitesMapper.deleteByIds(ids); + } + + + private void validateUserInvitesExists(Long id) { + if (userInvitesMapper.selectById(id) == null) { + throw exception(USER_INVITES_NOT_EXISTS); + } + } + + @Override + public KeyboardUserInvitesDO getUserInvites(Long id) { + return userInvitesMapper.selectById(id); + } + + @Override + public PageResult getUserInvitesPage(KeyboardUserInvitesPageReqVO pageReqVO) { + return userInvitesMapper.selectPage(pageReqVO); + } + +} \ No newline at end of file diff --git a/keyboard-server/src/main/resources/mapper/userinvites/KeyboardUserInvitesMapper.xml b/keyboard-server/src/main/resources/mapper/userinvites/KeyboardUserInvitesMapper.xml new file mode 100644 index 0000000..b2ca52d --- /dev/null +++ b/keyboard-server/src/main/resources/mapper/userinvites/KeyboardUserInvitesMapper.xml @@ -0,0 +1,12 @@ + + + + + + + \ No newline at end of file diff --git a/yolo-module-infra/src/main/java/com/yolo/keyboard/module/infra/enums/ErrorCodeConstants.java b/yolo-module-infra/src/main/java/com/yolo/keyboard/module/infra/enums/ErrorCodeConstants.java index 4938dd1..ee1905f 100644 --- a/yolo-module-infra/src/main/java/com/yolo/keyboard/module/infra/enums/ErrorCodeConstants.java +++ b/yolo-module-infra/src/main/java/com/yolo/keyboard/module/infra/enums/ErrorCodeConstants.java @@ -92,6 +92,6 @@ public interface ErrorCodeConstants { ErrorCode TENANT_BALANCE_WITHDRAW_CONFIG_NOT_EXISTS = new ErrorCode(1_001_202_018, "提现配置不存在"); ErrorCode TENANT_WITHDRAW_ORDER_NOT_EXISTS = new ErrorCode(1_001_202_019, "租户提现订单表（申请-审核-打款-完成/失败）不存在"); ErrorCode USER_INVITE_CODES_NOT_EXISTS = new ErrorCode(1_001_202_020, "用户生成的邀请码表，用于邀请新用户注册/安装并建立邀请关系不存在"); - + ErrorCode USER_INVITES_NOT_EXISTS = new ErrorCode(1_001_202_021, "用户邀请关系绑定台账表，记录新用户最终归属的邀请人不存在"); }