商城模块集成

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/address/AddressController.java

+package org.dromara.mall.controller.member.admin.address;
+
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import org.dromara.common.core.domain.R;
+import org.dromara.mall.controller.member.admin.address.vo.AddressRespVO;
+import org.dromara.mall.convert.member.AddressConvert;
+import org.dromara.mall.domain.member.MemberAddressDO;
+import org.dromara.mall.service.member.AddressService;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+
+@Tag(name = "管理后台 - 用户收件地址")
+@RestController
+@RequestMapping("/admin/member/address")
+@Validated
+public class AddressController {
+
+    @Resource
+    private AddressService addressService;
+
+    @GetMapping("/list")
+    @Operation(summary = "获得用户收件地址列表")
+    @Parameter(name = "userId", description = "用户编号", required = true)
+    @SaCheckPermission("member:user:query")
+    public R<List<AddressRespVO>> getAddressList(@RequestParam("userId") Long userId) {
+        List<MemberAddressDO> list = addressService.getAddressList(userId);
+        return R.ok(AddressConvert.INSTANCE.convertList2(list));
+    }
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/address/vo/AddressBaseVO.java

+package org.dromara.mall.controller.member.admin.address.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+/**
+ * 用户收件地址 Base VO，提供给添加、修改、详细的子 VO 使用
+ * 如果子 VO 存在差异的字段，请不要添加到这里，影响 Swagger 文档生成
+ */
+@Data
+public class AddressBaseVO {
+
+    @Schema(description = "收件人名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "张三")
+    @NotNull(message = "收件人名称不能为空")
+    private String name;
+
+    @Schema(description = "手机号", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "手机号不能为空")
+    private String mobile;
+
+    @Schema(description = "地区编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "15716")
+    @NotNull(message = "地区编码不能为空")
+    private Long areaId;
+
+    @Schema(description = "收件详细地址", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "收件详细地址不能为空")
+    private String detailAddress;
+
+    @Schema(description = "是否默认", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    @NotNull(message = "是否默认不能为空")
+    private Boolean defaultStatus;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/address/vo/AddressRespVO.java

+package org.dromara.mall.controller.member.admin.address.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 用户收件地址 Response VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class AddressRespVO extends AddressBaseVO {
+
+    @Schema(description = "收件地址编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "7380")
+    private Long id;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/config/MemberConfigController.java

+package org.dromara.mall.controller.member.admin.config;
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.dromara.common.core.domain.R;
+import org.dromara.mall.controller.member.admin.config.vo.MemberConfigRespVO;
+import org.dromara.mall.controller.member.admin.config.vo.MemberConfigSaveReqVO;
+import org.dromara.mall.convert.member.MemberConfigConvert;
+import org.dromara.mall.domain.member.MemberConfigDO;
+import org.dromara.mall.service.member.MemberConfigService;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+
+
+@Tag(name = "管理后台 - 会员设置")
+@RestController
+@RequestMapping("/admin/member/config")
+@Validated
+public class MemberConfigController {
+
+    @Resource
+    private MemberConfigService memberConfigService;
+
+    @PutMapping("/save")
+    @Operation(summary = "保存会员配置")
+    @SaCheckPermission("member:config:save")
+    public R<Boolean> saveConfig(@Valid @RequestBody MemberConfigSaveReqVO saveReqVO) {
+        memberConfigService.saveConfig(saveReqVO);
+        return R.ok(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得会员配置")
+    @SaCheckPermission("member:config:query")
+    public R<MemberConfigRespVO> getConfig() {
+        MemberConfigDO config = memberConfigService.getConfig();
+        return R.ok(MemberConfigConvert.INSTANCE.convert(config));
+    }
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/config/vo/MemberConfigBaseVO.java

+package org.dromara.mall.controller.member.admin.config.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+/**
+ * 会员配置 Base VO，提供给添加、修改、详细的子 VO 使用
+ * 如果子 VO 存在差异的字段，请不要添加到这里，影响 Swagger 文档生成
+ */
+@Data
+public class MemberConfigBaseVO {
+
+    @Schema(description = "积分抵扣开关", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    @NotNull(message = "积分抵扣开发不能为空")
+    private Boolean pointTradeDeductEnable;
+
+    @Schema(description = "积分抵扣，单位：分", requiredMode = Schema.RequiredMode.REQUIRED, example = "13506")
+    @NotNull(message = "积分抵扣不能为空")
+    private Integer pointTradeDeductUnitPrice;
+
+    @Schema(description = "积分抵扣最大值", requiredMode = Schema.RequiredMode.REQUIRED, example = "32428")
+    @NotNull(message = "积分抵扣最大值不能为空")
+    private Integer pointTradeDeductMaxPrice;
+
+    @Schema(description = "1 元赠送多少分", requiredMode = Schema.RequiredMode.REQUIRED, example = "100")
+    @NotNull(message = "1 元赠送积分不能为空")
+    private Integer pointTradeGivePoint;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/config/vo/MemberConfigRespVO.java

+package org.dromara.mall.controller.member.admin.config.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - 会员配置 Response VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MemberConfigRespVO extends MemberConfigBaseVO {
+
+    @Schema(description = "自增主键", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/config/vo/MemberConfigSaveReqVO.java

+package org.dromara.mall.controller.member.admin.config.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - 会员配置保存 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MemberConfigSaveReqVO extends MemberConfigBaseVO {
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/group/MemberGroupController.java

+package org.dromara.mall.controller.member.admin.group;
+
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.dromara.common.core.domain.R;
+import org.dromara.common.mybatis.core.page.PageResult;
+import org.dromara.mall.controller.member.admin.group.vo.*;
+import org.dromara.mall.convert.member.MemberGroupConvert;
+import org.dromara.mall.domain.member.MemberGroupDO;
+import org.dromara.mall.service.member.MemberGroupService;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+
+
+@Tag(name = "管理后台 - 用户分组")
+@RestController
+@RequestMapping("/admin/member/group")
+@Validated
+public class MemberGroupController {
+
+    @Resource
+    private MemberGroupService groupService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建用户分组")
+    @SaCheckPermission("member:group:create")
+    public R<Long> createGroup(@Valid @RequestBody MemberGroupCreateReqVO createReqVO) {
+        return R.ok(groupService.createGroup(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新用户分组")
+    @SaCheckPermission("member:group:update")
+    public R<Boolean> updateGroup(@Valid @RequestBody MemberGroupUpdateReqVO updateReqVO) {
+        groupService.updateGroup(updateReqVO);
+        return R.ok(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除用户分组")
+    @Parameter(name = "id", description = "编号", required = true)
+    @SaCheckPermission("member:group:delete")
+    public R<Boolean> deleteGroup(@RequestParam("id") Long id) {
+        groupService.deleteGroup(id);
+        return R.ok(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得用户分组")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @SaCheckPermission("member:group:query")
+    public R<MemberGroupRespVO> getGroup(@RequestParam("id") Long id) {
+        MemberGroupDO group = groupService.getGroup(id);
+        return R.ok(MemberGroupConvert.INSTANCE.convert(group));
+    }
+
+    @GetMapping("/list-all-simple")
+    @Operation(summary = "获取会员分组精简信息列表", description = "只包含被开启的会员分组，主要用于前端的下拉选项")
+    public R<List<MemberGroupSimpleRespVO>> getSimpleGroupList() {
+        // 获用户列表，只要开启状态的
+        List<MemberGroupDO> list = groupService.getEnableGroupList();
+        return R.ok(MemberGroupConvert.INSTANCE.convertSimpleList(list));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得用户分组分页")
+    @SaCheckPermission("member:group:query")
+    public R<PageResult<MemberGroupRespVO>> getGroupPage(@Valid MemberGroupPageReqVO pageVO) {
+        PageResult<MemberGroupDO> pageResult = groupService.getGroupPage(pageVO);
+        return R.ok(MemberGroupConvert.INSTANCE.convertPage(pageResult));
+    }
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/group/vo/MemberGroupBaseVO.java

+package org.dromara.mall.controller.member.admin.group.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import org.dromara.common.mall.enums.CommonStatusEnum;
+import org.dromara.common.mall.validation.InEnum;
+
+/**
+ * 用户分组 Base VO，提供给添加、修改、详细的子 VO 使用
+ * 如果子 VO 存在差异的字段，请不要添加到这里，影响 Swagger 文档生成
+ */
+@Data
+public class MemberGroupBaseVO {
+
+    @Schema(description = "名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "购物达人")
+    @NotNull(message = "名称不能为空")
+    private String name;
+
+    @Schema(description = "备注", requiredMode = Schema.RequiredMode.REQUIRED, example = "你猜")
+    private String remark;
+
+    @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "状态不能为空")
+    @InEnum(CommonStatusEnum.class)
+    private Integer status;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/group/vo/MemberGroupCreateReqVO.java

+package org.dromara.mall.controller.member.admin.group.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - 用户分组创建 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MemberGroupCreateReqVO extends MemberGroupBaseVO {
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/group/vo/MemberGroupPageReqVO.java

+package org.dromara.mall.controller.member.admin.group.vo;
+
+import cn.hutool.core.date.DatePattern;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+import org.dromara.common.mybatis.core.page.PageParam;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+
+@Schema(description = "管理后台 - 用户分组分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MemberGroupPageReqVO extends PageParam {
+
+    @Schema(description = "名称", example = "购物达人")
+    private String name;
+
+    @Schema(description = "状态", example = "1")
+    private Integer status;
+
+    @Schema(description = "创建时间")
+    @DateTimeFormat(pattern = DatePattern.NORM_DATETIME_PATTERN)
+    private LocalDateTime[] createTime;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/group/vo/MemberGroupRespVO.java

+package org.dromara.mall.controller.member.admin.group.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 用户分组 Response VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MemberGroupRespVO extends MemberGroupBaseVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "20357")
+    private Long id;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/group/vo/MemberGroupSimpleRespVO.java

+package org.dromara.mall.controller.member.admin.group.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - 用户分组 Response VO")
+@Data
+@ToString(callSuper = true)
+public class MemberGroupSimpleRespVO {
+
+    @Schema(description = "编号", example = "6103")
+    private Long id;
+
+    @Schema(description = "等级名称", example = "芋艿")
+    private String name;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/group/vo/MemberGroupUpdateReqVO.java

+package org.dromara.mall.controller.member.admin.group.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - 用户分组更新 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MemberGroupUpdateReqVO extends MemberGroupBaseVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "20357")
+    @NotNull(message = "编号不能为空")
+    private Long id;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/level/MemberExperienceRecordController.java

+package org.dromara.mall.controller.member.admin.level;
+
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.dromara.common.core.domain.R;
+import org.dromara.common.mybatis.core.page.PageResult;
+import org.dromara.mall.controller.member.admin.level.vo.experience.MemberExperienceRecordPageReqVO;
+import org.dromara.mall.controller.member.admin.level.vo.experience.MemberExperienceRecordRespVO;
+import org.dromara.mall.convert.member.MemberExperienceRecordConvert;
+import org.dromara.mall.domain.member.MemberExperienceRecordDO;
+import org.dromara.mall.service.member.MemberExperienceRecordService;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+
+
+@Tag(name = "管理后台 - 会员经验记录")
+@RestController
+@RequestMapping("/admin/member/experience-record")
+@Validated
+public class MemberExperienceRecordController {
+
+    @Resource
+    private MemberExperienceRecordService experienceLogService;
+
+    @GetMapping("/get")
+    @Operation(summary = "获得会员经验记录")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @SaCheckPermission("member:experience-record:query")
+    public R<MemberExperienceRecordRespVO> getExperienceRecord(@RequestParam("id") Long id) {
+        MemberExperienceRecordDO experienceLog = experienceLogService.getExperienceRecord(id);
+        return R.ok(MemberExperienceRecordConvert.INSTANCE.convert(experienceLog));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得会员经验记录分页")
+    @SaCheckPermission("member:experience-record:query")
+    public R<PageResult<MemberExperienceRecordRespVO>> getExperienceRecordPage(
+            @Valid MemberExperienceRecordPageReqVO pageVO) {
+        PageResult<MemberExperienceRecordDO> pageResult = experienceLogService.getExperienceRecordPage(pageVO);
+        return R.ok(MemberExperienceRecordConvert.INSTANCE.convertPage(pageResult));
+    }
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/level/MemberLevelController.java

+package org.dromara.mall.controller.member.admin.level;
+
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.dromara.common.core.domain.R;
+import org.dromara.mall.controller.member.admin.level.vo.level.*;
+import org.dromara.mall.convert.member.MemberLevelConvert;
+import org.dromara.mall.domain.member.MemberLevelDO;
+import org.dromara.mall.service.member.MemberLevelService;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+
+@Tag(name = "管理后台 - 会员等级")
+@RestController
+@RequestMapping("/admin/member/level")
+@Validated
+public class MemberLevelController {
+
+    @Resource
+    private MemberLevelService levelService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建会员等级")
+    @SaCheckPermission("member:level:create")
+    public R<Long> createLevel(@Valid @RequestBody MemberLevelCreateReqVO createReqVO) {
+        return R.ok(levelService.createLevel(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新会员等级")
+    @SaCheckPermission("member:level:update")
+    public R<Boolean> updateLevel(@Valid @RequestBody MemberLevelUpdateReqVO updateReqVO) {
+        levelService.updateLevel(updateReqVO);
+        return R.ok(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除会员等级")
+    @Parameter(name = "id", description = "编号", required = true)
+    @SaCheckPermission("member:level:delete")
+    public R<Boolean> deleteLevel(@RequestParam("id") Long id) {
+        levelService.deleteLevel(id);
+        return R.ok(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得会员等级")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @SaCheckPermission("member:level:query")
+    public R<MemberLevelRespVO> getLevel(@RequestParam("id") Long id) {
+        MemberLevelDO level = levelService.getLevel(id);
+        return R.ok(MemberLevelConvert.INSTANCE.convert(level));
+    }
+
+    @GetMapping("/list-all-simple")
+    @Operation(summary = "获取会员等级精简信息列表", description = "只包含被开启的会员等级，主要用于前端的下拉选项")
+    public R<List<MemberLevelSimpleRespVO>> getSimpleLevelList() {
+        // 获用户列表，只要开启状态的
+        List<MemberLevelDO> list = levelService.getEnableLevelList();
+        // 排序后，返回给前端
+        return R.ok(MemberLevelConvert.INSTANCE.convertSimpleList(list));
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得会员等级列表")
+    @SaCheckPermission("member:level:query")
+    public R<List<MemberLevelRespVO>> getLevelList(@Valid MemberLevelListReqVO listReqVO) {
+        List<MemberLevelDO> result = levelService.getLevelList(listReqVO);
+        return R.ok(MemberLevelConvert.INSTANCE.convertList(result));
+    }
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/level/MemberLevelRecordController.java

+package org.dromara.mall.controller.member.admin.level;
+
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.dromara.common.core.domain.R;
+import org.dromara.common.mybatis.core.page.PageResult;
+import org.dromara.mall.controller.member.admin.level.vo.record.MemberLevelRecordPageReqVO;
+import org.dromara.mall.controller.member.admin.level.vo.record.MemberLevelRecordRespVO;
+import org.dromara.mall.convert.member.MemberLevelRecordConvert;
+import org.dromara.mall.domain.member.MemberLevelRecordDO;
+import org.dromara.mall.service.member.MemberLevelRecordService;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+
+@Tag(name = "管理后台 - 会员等级记录")
+@RestController
+@RequestMapping("/admin/member/level-record")
+@Validated
+public class MemberLevelRecordController {
+
+    @Resource
+    private MemberLevelRecordService levelLogService;
+
+    @GetMapping("/get")
+    @Operation(summary = "获得会员等级记录")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @SaCheckPermission("member:level-record:query")
+    public R<MemberLevelRecordRespVO> getLevelRecord(@RequestParam("id") Long id) {
+        MemberLevelRecordDO levelLog = levelLogService.getLevelRecord(id);
+        return R.ok(MemberLevelRecordConvert.INSTANCE.convert(levelLog));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得会员等级记录分页")
+    @SaCheckPermission("member:level-record:query")
+    public R<PageResult<MemberLevelRecordRespVO>> getLevelRecordPage(
+            @Valid MemberLevelRecordPageReqVO pageVO) {
+        PageResult<MemberLevelRecordDO> pageResult = levelLogService.getLevelRecordPage(pageVO);
+        return R.ok(MemberLevelRecordConvert.INSTANCE.convertPage(pageResult));
+    }
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/level/vo/experience/MemberExperienceRecordBaseVO.java

+package org.dromara.mall.controller.member.admin.level.vo.experience;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+/**
+ * 会员经验记录 Base VO，提供给添加、修改、详细的子 VO 使用
+ * 如果子 VO 存在差异的字段，请不要添加到这里，影响 Swagger 文档生成
+ */
+@Data
+public class MemberExperienceRecordBaseVO {
+
+    @Schema(description = "用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "3638")
+    @NotNull(message = "用户编号不能为空")
+    private Long userId;
+
+    @Schema(description = "业务编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "12164")
+    @NotNull(message = "业务编号不能为空")
+    private String bizId;
+
+    @Schema(description = "业务类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "业务类型不能为空")
+    private Integer bizType;
+
+    @Schema(description = "标题", requiredMode = Schema.RequiredMode.REQUIRED, example = "增加经验")
+    @NotNull(message = "标题不能为空")
+    private String title;
+
+    @Schema(description = "经验", requiredMode = Schema.RequiredMode.REQUIRED, example = "100")
+    @NotNull(message = "经验不能为空")
+    private Integer experience;
+
+    @Schema(description = "变更后的经验", requiredMode = Schema.RequiredMode.REQUIRED, example = "200")
+    @NotNull(message = "变更后的经验不能为空")
+    private Integer totalExperience;
+
+    @Schema(description = "描述", requiredMode = Schema.RequiredMode.REQUIRED, example = "下单增加 100 经验")
+    @NotNull(message = "描述不能为空")
+    private String description;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/level/vo/experience/MemberExperienceRecordPageReqVO.java

+package org.dromara.mall.controller.member.admin.level.vo.experience;
+
+import cn.hutool.core.date.DatePattern;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+import org.dromara.common.mybatis.core.page.PageParam;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 会员经验记录分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MemberExperienceRecordPageReqVO extends PageParam {
+
+    @Schema(description = "用户编号", example = "3638")
+    private Long userId;
+
+    @Schema(description = "业务编号", example = "12164")
+    private String bizId;
+
+    @Schema(description = "业务类型", example = "1")
+    private Integer bizType;
+
+    @Schema(description = "标题", example = "增加经验")
+    private String title;
+
+    @Schema(description = "创建时间")
+    @DateTimeFormat(pattern = DatePattern.NORM_DATETIME_PATTERN)
+    private LocalDateTime[] createTime;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/level/vo/experience/MemberExperienceRecordRespVO.java

+package org.dromara.mall.controller.member.admin.level.vo.experience;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 会员经验记录 Response VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MemberExperienceRecordRespVO extends MemberExperienceRecordBaseVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "19610")
+    private Long id;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/level/vo/level/MemberLevelBaseVO.java

+package org.dromara.mall.controller.member.admin.level.vo.level;
+
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Positive;
+import lombok.Data;
+import org.dromara.common.mall.enums.CommonStatusEnum;
+import org.dromara.common.mall.validation.InEnum;
+import org.hibernate.validator.constraints.Range;
+import org.hibernate.validator.constraints.URL;
+
+/**
+ * 会员等级 Base VO，提供给添加、修改、详细的子 VO 使用
+ * 如果子 VO 存在差异的字段，请不要添加到这里，影响 Swagger 文档生成
+ */
+@Data
+public class MemberLevelBaseVO {
+
+    @Schema(description = "等级名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "芋艿")
+    @NotBlank(message = "等级名称不能为空")
+    private String name;
+
+    @Schema(description = "升级经验", requiredMode = Schema.RequiredMode.REQUIRED, example = "100")
+    @NotNull(message = "升级经验不能为空")
+    @Positive(message = "升级经验必须大于 0")
+    private Integer experience;
+
+    @Schema(description = "等级", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "等级不能为空")
+    @Positive(message = "等级必须大于 0")
+    private Integer level;
+
+    @Schema(description = "享受折扣", requiredMode = Schema.RequiredMode.REQUIRED, example = "98")
+    @NotNull(message = "享受折扣不能为空")
+    @Range(min = 0, max = 100, message = "享受折扣的范围为 0-100")
+    private Integer discountPercent;
+
+    @Schema(description = "等级图标", example = "https://www.iocoder.cn/yudao.jpg")
+    @URL(message = "等级图标必须是 URL 格式")
+    private String icon;
+
+    @Schema(description = "等级背景图", example = "https://www.iocoder.cn/yudao.jpg")
+    @URL(message = "等级背景图必须是 URL 格式")
+    private String backgroundUrl;
+
+    @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "状态不能为空")
+    @InEnum(CommonStatusEnum.class)
+    private Integer status;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/level/vo/level/MemberLevelCreateReqVO.java

+package org.dromara.mall.controller.member.admin.level.vo.level;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - 会员等级创建 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MemberLevelCreateReqVO extends MemberLevelBaseVO {
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/level/vo/level/MemberLevelListReqVO.java

+package org.dromara.mall.controller.member.admin.level.vo.level;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - 会员等级列表筛选 Request VO")
+@Data
+@ToString(callSuper = true)
+public class MemberLevelListReqVO {
+
+    @Schema(description = "等级名称", example = "芋艿")
+    private String name;
+
+    @Schema(description = "状态", example = "1")
+    private Integer status;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/level/vo/level/MemberLevelRespVO.java

+package org.dromara.mall.controller.member.admin.level.vo.level;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 会员等级 Response VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MemberLevelRespVO extends MemberLevelBaseVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "6103")
+    private Long id;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/level/vo/level/MemberLevelSimpleRespVO.java

+package org.dromara.mall.controller.member.admin.level.vo.level;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - 会员等级 Response VO")
+@Data
+@ToString(callSuper = true)
+public class MemberLevelSimpleRespVO {
+
+    @Schema(description = "编号", example = "6103")
+    private Long id;
+
+    @Schema(description = "等级名称", example = "芋艿")
+    private String name;
+
+    @Schema(description = "等级图标", example = "https://www.iocoder.cn/yudao.jpg")
+    private String icon;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/level/vo/level/MemberLevelUpdateReqVO.java

+package org.dromara.mall.controller.member.admin.level.vo.level;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - 会员等级更新 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MemberLevelUpdateReqVO extends MemberLevelBaseVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "6103")
+    @NotNull(message = "编号不能为空")
+    private Long id;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/level/vo/record/MemberLevelRecordBaseVO.java

+package org.dromara.mall.controller.member.admin.level.vo.record;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+/**
+ * 会员等级记录 Base VO，提供给添加、修改、详细的子 VO 使用
+ * 如果子 VO 存在差异的字段，请不要添加到这里，影响 Swagger 文档生成
+ */
+@Data
+public class MemberLevelRecordBaseVO {
+
+    @Schema(description = "用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "25923")
+    @NotNull(message = "用户编号不能为空")
+    private Long userId;
+
+    @Schema(description = "等级编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "25985")
+    @NotNull(message = "等级编号不能为空")
+    private Long levelId;
+
+    @Schema(description = "会员等级", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "会员等级不能为空")
+    private Integer level;
+
+    @Schema(description = "享受折扣", requiredMode = Schema.RequiredMode.REQUIRED, example = "13319")
+    @NotNull(message = "享受折扣不能为空")
+    private Integer discountPercent;
+
+    @Schema(description = "升级经验", requiredMode = Schema.RequiredMode.REQUIRED, example = "13319")
+    @NotNull(message = "升级经验不能为空")
+    private Integer experience;
+
+    @Schema(description = "会员此时的经验", requiredMode = Schema.RequiredMode.REQUIRED, example = "13319")
+    @NotNull(message = "会员此时的经验不能为空")
+    private Integer userExperience;
+
+    @Schema(description = "备注", requiredMode = Schema.RequiredMode.REQUIRED, example = "推广需要")
+    @NotNull(message = "备注不能为空")
+    private String remark;
+
+    @Schema(description = "描述", requiredMode = Schema.RequiredMode.REQUIRED, example = "升级为金牌会员")
+    @NotNull(message = "描述不能为空")
+    private String description;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/level/vo/record/MemberLevelRecordPageReqVO.java

+package org.dromara.mall.controller.member.admin.level.vo.record;
+
+import cn.hutool.core.date.DatePattern;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+import org.dromara.common.mybatis.core.page.PageParam;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+
+@Schema(description = "管理后台 - 会员等级记录分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MemberLevelRecordPageReqVO extends PageParam {
+
+    @Schema(description = "用户编号", example = "25923")
+    private Long userId;
+
+    @Schema(description = "等级编号", example = "25985")
+    private Long levelId;
+
+    @Schema(description = "创建时间")
+    @DateTimeFormat(pattern = DatePattern.NORM_DATETIME_PATTERN)
+    private LocalDateTime[] createTime;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/level/vo/record/MemberLevelRecordRespVO.java

+package org.dromara.mall.controller.member.admin.level.vo.record;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 会员等级记录 Response VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MemberLevelRecordRespVO extends MemberLevelRecordBaseVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "8741")
+    private Long id;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/point/MemberPointRecordController.java

+package org.dromara.mall.controller.member.admin.point;
+
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.dromara.common.core.domain.R;
+import org.dromara.common.mybatis.core.page.PageResult;
+import org.dromara.mall.controller.member.admin.point.vo.recrod.MemberPointRecordPageReqVO;
+import org.dromara.mall.controller.member.admin.point.vo.recrod.MemberPointRecordRespVO;
+import org.dromara.mall.convert.member.MemberPointRecordConvert;
+import org.dromara.mall.domain.member.MemberPointRecordDO;
+import org.dromara.mall.domain.member.MemberUserDO;
+import org.dromara.mall.service.member.MemberPointRecordService;
+import org.dromara.mall.service.member.MemberUserService;
+import org.springframework.util.CollectionUtils;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static org.dromara.common.mall.util.collection.CollectionUtils.convertSet;
+
+
+@Tag(name = "管理后台 - 签到记录")
+@RestController
+@RequestMapping("/admin/member/point/record")
+@Validated
+public class MemberPointRecordController {
+
+    @Resource
+    private MemberPointRecordService pointRecordService;
+
+    @Resource
+    private MemberUserService memberUserService;
+
+    @GetMapping("/page")
+    @Operation(summary = "获得用户积分记录分页")
+    @SaCheckPermission("point:record:query")
+    public R<PageResult<MemberPointRecordRespVO>> getPointRecordPage(@Valid MemberPointRecordPageReqVO pageVO) {
+        // 执行分页查询
+        PageResult<MemberPointRecordDO> pageResult = pointRecordService.getPointRecordPage(pageVO);
+        if (CollectionUtils.isEmpty(pageResult.getList())) {
+            return R.ok(PageResult.empty(pageResult.getTotal()));
+        }
+
+        // 拼接结果返回
+        List<MemberUserDO> users = memberUserService.getUserList(
+                convertSet(pageResult.getList(), MemberPointRecordDO::getUserId));
+        return R.ok(MemberPointRecordConvert.INSTANCE.convertPage(pageResult, users));
+    }
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/point/vo/recrod/MemberPointRecordPageReqVO.java

+package org.dromara.mall.controller.member.admin.point.vo.recrod;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+import org.dromara.common.mybatis.core.page.PageParam;
+
+@Schema(description = "管理后台 - 用户积分记录分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MemberPointRecordPageReqVO extends PageParam {
+
+    @Schema(description = "用户昵称", example = "张三")
+    private String nickname;
+
+    @Schema(description = "用户编号", example = "123")
+    private Long userId;
+
+    @Schema(description = "业务类型", example = "1")
+    private Integer bizType;
+
+    @Schema(description = "积分标题", example = "呵呵")
+    private String title;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/point/vo/recrod/MemberPointRecordRespVO.java

+package org.dromara.mall.controller.member.admin.point.vo.recrod;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.experimental.Accessors;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 用户积分记录 Response VO")
+@Data
+@Accessors(chain = true)
+public class MemberPointRecordRespVO {
+
+    @Schema(description = "自增主键", requiredMode = Schema.RequiredMode.REQUIRED, example = "31457")
+    private Long id;
+
+    @Schema(description = "用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long userId;
+
+    @Schema(description = "昵称", example = "张三")
+    private String nickname;
+
+    @Schema(description = "业务编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "22706")
+    private String bizId;
+
+    @Schema(description = "业务类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer bizType;
+
+    @Schema(description = "积分标题", requiredMode = Schema.RequiredMode.REQUIRED, example = "你猜")
+    private String title;
+
+    @Schema(description = "积分描述", example = "你猜")
+    private String description;
+
+    @Schema(description = "积分", requiredMode = Schema.RequiredMode.REQUIRED, example = "100")
+    private Integer point;
+
+    @Schema(description = "变动后的积分", requiredMode = Schema.RequiredMode.REQUIRED, example = "200")
+    private Integer totalPoint;
+
+    @Schema(description = "发生时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/signin/MemberSignInConfigController.java

+package org.dromara.mall.controller.member.admin.signin;
+
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.dromara.common.core.domain.R;
+import org.dromara.mall.controller.member.admin.signin.vo.config.MemberSignInConfigCreateReqVO;
+import org.dromara.mall.controller.member.admin.signin.vo.config.MemberSignInConfigRespVO;
+import org.dromara.mall.controller.member.admin.signin.vo.config.MemberSignInConfigUpdateReqVO;
+import org.dromara.mall.convert.member.MemberSignInConfigConvert;
+import org.dromara.mall.domain.member.MemberSignInConfigDO;
+import org.dromara.mall.service.member.MemberSignInConfigService;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+
+// TODO 芋艿：url
+@Tag(name = "管理后台 - 签到规则")
+@RestController
+@RequestMapping("/admin/member/sign-in/config")
+@Validated
+public class MemberSignInConfigController {
+
+    @Resource
+    private MemberSignInConfigService signInConfigService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建签到规则")
+    @SaCheckPermission("point:sign-in-config:create")
+    public R<Long> createSignInConfig(@Valid @RequestBody MemberSignInConfigCreateReqVO createReqVO) {
+        return R.ok(signInConfigService.createSignInConfig(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新签到规则")
+    @SaCheckPermission("point:sign-in-config:update")
+    public R<Boolean> updateSignInConfig(@Valid @RequestBody MemberSignInConfigUpdateReqVO updateReqVO) {
+        signInConfigService.updateSignInConfig(updateReqVO);
+        return R.ok(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除签到规则")
+    @Parameter(name = "id", description = "编号", required = true)
+    @SaCheckPermission("point:sign-in-config:delete")
+    public R<Boolean> deleteSignInConfig(@RequestParam("id") Long id) {
+        signInConfigService.deleteSignInConfig(id);
+        return R.ok(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得签到规则")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @SaCheckPermission("point:sign-in-config:query")
+    public R<MemberSignInConfigRespVO> getSignInConfig(@RequestParam("id") Long id) {
+        MemberSignInConfigDO signInConfig = signInConfigService.getSignInConfig(id);
+        return R.ok(MemberSignInConfigConvert.INSTANCE.convert(signInConfig));
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得签到规则列表")
+    @SaCheckPermission("point:sign-in-config:query")
+    public R<List<MemberSignInConfigRespVO>> getSignInConfigList() {
+        List<MemberSignInConfigDO> list = signInConfigService.getSignInConfigList();
+        return R.ok(MemberSignInConfigConvert.INSTANCE.convertList(list));
+    }
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/signin/MemberSignInRecordController.java

+package org.dromara.mall.controller.member.admin.signin;
+
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.dromara.common.core.domain.R;
+import org.dromara.common.mybatis.core.page.PageResult;
+import org.dromara.mall.controller.member.admin.signin.vo.record.MemberSignInRecordPageReqVO;
+import org.dromara.mall.controller.member.admin.signin.vo.record.MemberSignInRecordRespVO;
+import org.dromara.mall.convert.member.MemberSignInRecordConvert;
+import org.dromara.mall.domain.member.MemberSignInRecordDO;
+import org.dromara.mall.domain.member.MemberUserDO;
+import org.dromara.mall.service.member.MemberSignInRecordService;
+import org.dromara.mall.service.member.MemberUserService;
+import org.springframework.util.CollectionUtils;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static org.dromara.common.mall.util.collection.CollectionUtils.convertSet;
+
+
+@Tag(name = "管理后台 - 签到记录")
+@RestController
+@RequestMapping("/admin/member/sign-in/record")
+@Validated
+public class MemberSignInRecordController {
+
+    @Resource
+    private MemberSignInRecordService signInRecordService;
+
+    @Resource
+    private MemberUserService memberUserService;
+
+    @GetMapping("/page")
+    @Operation(summary = "获得签到记录分页")
+    @SaCheckPermission("point:sign-in-record:query")
+    public R<PageResult<MemberSignInRecordRespVO>> getSignInRecordPage(@Valid MemberSignInRecordPageReqVO pageVO) {
+        // 执行分页查询
+        PageResult<MemberSignInRecordDO> pageResult = signInRecordService.getSignInRecordPage(pageVO);
+        if (CollectionUtils.isEmpty(pageResult.getList())) {
+            return R.ok(PageResult.empty(pageResult.getTotal()));
+        }
+
+        // 拼接结果返回
+        List<MemberUserDO> users = memberUserService.getUserList(
+                convertSet(pageResult.getList(), MemberSignInRecordDO::getUserId));
+        return R.ok(MemberSignInRecordConvert.INSTANCE.convertPage(pageResult, users));
+    }
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/signin/vo/config/MemberSignInConfigBaseVO.java

+package org.dromara.mall.controller.member.admin.signin.vo.config;
+
+import cn.hutool.core.util.ObjUtil;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.PositiveOrZero;
+import lombok.Data;
+import org.dromara.common.mall.enums.CommonStatusEnum;
+import org.dromara.common.mall.validation.InEnum;
+
+/**
+ * 签到规则 Base VO，提供给添加、修改、详细的子 VO 使用
+ * 如果子 VO 存在差异的字段，请不要添加到这里，影响 Swagger 文档生成
+ */
+@Data
+public class MemberSignInConfigBaseVO {
+
+    @Schema(description = "签到第 x 天", requiredMode = Schema.RequiredMode.REQUIRED, example = "7")
+    @NotNull(message = "签到天数不能为空")
+    private Integer day;
+
+    @Schema(description = "奖励积分", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+    @NotNull(message = "奖励积分不能为空")
+    @PositiveOrZero(message = "奖励积分不能小于 0")
+    private Integer point;
+
+    @Schema(description = "奖励经验", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+    @NotNull(message = "奖励经验不能为空")
+    @PositiveOrZero(message = "奖励经验不能小于 0")
+    private Integer experience;
+
+    @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "状态不能为空")
+    @InEnum(CommonStatusEnum.class)
+    private Integer status;
+
+    @AssertTrue(message = "签到奖励积分和经验不能同时为空")
+    @JsonIgnore
+    public boolean isConfigAward() {
+        return ObjUtil.notEqual(point, 0) || ObjUtil.notEqual(experience, 0);
+    }
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/signin/vo/config/MemberSignInConfigCreateReqVO.java

+package org.dromara.mall.controller.member.admin.signin.vo.config;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - 签到规则创建 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MemberSignInConfigCreateReqVO extends MemberSignInConfigBaseVO {
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/signin/vo/config/MemberSignInConfigRespVO.java

+package org.dromara.mall.controller.member.admin.signin.vo.config;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 签到规则 Response VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MemberSignInConfigRespVO extends MemberSignInConfigBaseVO {
+
+    @Schema(description = "自增主键", requiredMode = Schema.RequiredMode.REQUIRED, example = "20937")
+    private Integer id;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/signin/vo/config/MemberSignInConfigUpdateReqVO.java

+package org.dromara.mall.controller.member.admin.signin.vo.config;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - 签到规则更新 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MemberSignInConfigUpdateReqVO extends MemberSignInConfigBaseVO {
+
+    @Schema(description = "规则自增主键", requiredMode = Schema.RequiredMode.REQUIRED, example = "13653")
+    @NotNull(message = "规则自增主键不能为空")
+    private Long id;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/signin/vo/record/MemberSignInRecordPageReqVO.java

+package org.dromara.mall.controller.member.admin.signin.vo.record;
+
+import cn.hutool.core.date.DatePattern;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+import org.dromara.common.mybatis.core.page.PageParam;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 签到记录分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MemberSignInRecordPageReqVO extends PageParam {
+
+    @Schema(description = "签到用户", example = "土豆")
+    private String nickname;
+
+    @Schema(description = "第几天签到", example = "10")
+    private Integer day;
+
+    @Schema(description = "用户编号", example = "123")
+    private Long userId;
+
+    @Schema(description = "签到时间")
+    @DateTimeFormat(pattern = DatePattern.NORM_DATETIME_PATTERN)
+    private LocalDateTime[] createTime;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/signin/vo/record/MemberSignInRecordRespVO.java

+package org.dromara.mall.controller.member.admin.signin.vo.record;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 签到记录 Response VO")
+@Data
+public class MemberSignInRecordRespVO {
+
+    @Schema(description = "签到自增 id", requiredMode = Schema.RequiredMode.REQUIRED, example = "11903")
+    private Long id;
+
+    @Schema(description = "签到用户", requiredMode = Schema.RequiredMode.REQUIRED, example = "6507")
+    private Long userId;
+
+    @Schema(description = "昵称", example = "张三")
+    private String nickname;
+
+    @Schema(description = "第几天签到", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer day;
+
+    @Schema(description = "签到的积分", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+    private Integer point;
+
+    @Schema(description = "签到时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/tag/MemberTagController.java

+package org.dromara.mall.controller.member.admin.tag;
+
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.dromara.common.core.domain.R;
+import org.dromara.common.mybatis.core.page.PageResult;
+import org.dromara.mall.controller.member.admin.tag.vo.MemberTagCreateReqVO;
+import org.dromara.mall.controller.member.admin.tag.vo.MemberTagPageReqVO;
+import org.dromara.mall.controller.member.admin.tag.vo.MemberTagRespVO;
+import org.dromara.mall.controller.member.admin.tag.vo.MemberTagUpdateReqVO;
+import org.dromara.mall.convert.member.MemberTagConvert;
+import org.dromara.mall.domain.member.MemberTagDO;
+import org.dromara.mall.service.member.MemberTagService;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.Collection;
+import java.util.List;
+
+
+@Tag(name = "管理后台 - 会员标签")
+@RestController
+@RequestMapping("/admin/member/tag")
+@Validated
+public class MemberTagController {
+
+    @Resource
+    private MemberTagService tagService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建会员标签")
+    @SaCheckPermission("member:tag:create")
+    public R<Long> createTag(@Valid @RequestBody MemberTagCreateReqVO createReqVO) {
+        return R.ok(tagService.createTag(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新会员标签")
+    @SaCheckPermission("member:tag:update")
+    public R<Boolean> updateTag(@Valid @RequestBody MemberTagUpdateReqVO updateReqVO) {
+        tagService.updateTag(updateReqVO);
+        return R.ok(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除会员标签")
+    @Parameter(name = "id", description = "编号", required = true)
+    @SaCheckPermission("member:tag:delete")
+    public R<Boolean> deleteTag(@RequestParam("id") Long id) {
+        tagService.deleteTag(id);
+        return R.ok(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得会员标签")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @SaCheckPermission("member:tag:query")
+    public R<MemberTagRespVO> getMemberTag(@RequestParam("id") Long id) {
+        MemberTagDO tag = tagService.getTag(id);
+        return R.ok(MemberTagConvert.INSTANCE.convert(tag));
+    }
+
+    @GetMapping("/list-all-simple")
+    @Operation(summary = "获取会员标签精简信息列表", description = "只包含被开启的会员标签，主要用于前端的下拉选项")
+    public R<List<MemberTagRespVO>> getSimpleTagList() {
+        // 获用户列表，只要开启状态的
+        List<MemberTagDO> list = tagService.getTagList();
+        // 排序后，返回给前端
+        return R.ok(MemberTagConvert.INSTANCE.convertList(list));
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得会员标签列表")
+    @Parameter(name = "ids", description = "编号列表", required = true, example = "1024,2048")
+    @SaCheckPermission("member:tag:query")
+    public R<List<MemberTagRespVO>> getMemberTagList(@RequestParam("ids") Collection<Long> ids) {
+        List<MemberTagDO> list = tagService.getTagList(ids);
+        return R.ok(MemberTagConvert.INSTANCE.convertList(list));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得会员标签分页")
+    @SaCheckPermission("member:tag:query")
+    public R<PageResult<MemberTagRespVO>> getTagPage(@Valid MemberTagPageReqVO pageVO) {
+        PageResult<MemberTagDO> pageResult = tagService.getTagPage(pageVO);
+        return R.ok(MemberTagConvert.INSTANCE.convertPage(pageResult));
+    }
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/tag/vo/MemberTagBaseVO.java

+package org.dromara.mall.controller.member.admin.tag.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+/**
+ * 会员标签 Base VO，提供给添加、修改、详细的子 VO 使用
+ * 如果子 VO 存在差异的字段，请不要添加到这里，影响 Swagger 文档生成
+ */
+@Data
+public class MemberTagBaseVO {
+
+    @Schema(description = "标签名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "李四")
+    @NotNull(message = "标签名称不能为空")
+    private String name;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/tag/vo/MemberTagCreateReqVO.java

+package org.dromara.mall.controller.member.admin.tag.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - 会员标签创建 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MemberTagCreateReqVO extends MemberTagBaseVO {
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/tag/vo/MemberTagPageReqVO.java

+package org.dromara.mall.controller.member.admin.tag.vo;
+
+import cn.hutool.core.date.DatePattern;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+import org.dromara.common.mybatis.core.page.PageParam;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 会员标签分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MemberTagPageReqVO extends PageParam {
+
+    @Schema(description = "标签名称", example = "李四")
+    private String name;
+
+    @Schema(description = "创建时间")
+    @DateTimeFormat(pattern = DatePattern.NORM_DATETIME_PATTERN)
+    private LocalDateTime[] createTime;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/tag/vo/MemberTagRespVO.java

+package org.dromara.mall.controller.member.admin.tag.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 会员标签 Response VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MemberTagRespVO extends MemberTagBaseVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "907")
+    private Long id;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/tag/vo/MemberTagUpdateReqVO.java

+package org.dromara.mall.controller.member.admin.tag.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - 会员标签更新 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MemberTagUpdateReqVO extends MemberTagBaseVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "907")
+    @NotNull(message = "编号不能为空")
+    private Long id;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/user/MemberUserController.java

+package org.dromara.mall.controller.member.admin.user;
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import cn.hutool.core.collection.CollUtil;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.dromara.common.core.domain.R;
+import org.dromara.common.mybatis.core.page.PageResult;
+import org.dromara.common.satoken.utils.LoginHelper;
+import org.dromara.mall.controller.member.admin.user.vo.*;
+import org.dromara.mall.convert.member.MemberUserConvert;
+import org.dromara.mall.domain.member.MemberGroupDO;
+import org.dromara.mall.domain.member.MemberLevelDO;
+import org.dromara.mall.domain.member.MemberTagDO;
+import org.dromara.mall.domain.member.MemberUserDO;
+import org.dromara.mall.enums.member.point.MemberPointBizTypeEnum;
+import org.dromara.mall.service.member.*;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Objects;
+import java.util.Set;
+import java.util.stream.Collectors;
+
+import static org.dromara.common.mall.util.collection.CollectionUtils.convertSet;
+
+
+@Tag(name = "管理后台 - 会员用户")
+@RestController
+@RequestMapping("/admin/member/user")
+@Validated
+public class MemberUserController {
+
+    @Resource
+    private MemberUserService memberUserService;
+    @Resource
+    private MemberTagService memberTagService;
+    @Resource
+    private MemberLevelService memberLevelService;
+    @Resource
+    private MemberGroupService memberGroupService;
+    @Resource
+    private MemberPointRecordService memberPointRecordService;
+
+    @PutMapping("/update")
+    @Operation(summary = "更新会员用户")
+    @SaCheckPermission("member:user:update")
+    public R<Boolean> updateUser(@Valid @RequestBody MemberUserUpdateReqVO updateReqVO) {
+        memberUserService.updateUser(updateReqVO);
+        return R.ok(true);
+    }
+
+    @PutMapping("/update-level")
+    @Operation(summary = "更新会员用户等级")
+    @SaCheckPermission("member:user:update-level")
+    public R<Boolean> updateUserLevel(@Valid @RequestBody MemberUserUpdateLevelReqVO updateReqVO) {
+        memberLevelService.updateUserLevel(updateReqVO);
+        return R.ok(true);
+    }
+
+    @PutMapping("/update-point")
+    @Operation(summary = "更新会员用户积分")
+    @SaCheckPermission("member:user:update-point")
+    public R<Boolean> updateUserPoint(@Valid @RequestBody MemberUserUpdatePointReqVO updateReqVO) {
+        memberPointRecordService.createPointRecord(updateReqVO.getId(), updateReqVO.getPoint(),
+            MemberPointBizTypeEnum.ADMIN, String.valueOf(LoginHelper.getMemberId()));
+        return R.ok(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得会员用户")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @SaCheckPermission("member:user:query")
+    public R<MemberUserRespVO> getUser(@RequestParam("id") Long id) {
+        MemberUserDO user = memberUserService.getUser(id);
+        return R.ok(MemberUserConvert.INSTANCE.convert03(user));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得会员用户分页")
+    @SaCheckPermission("member:user:query")
+    public R<PageResult<MemberUserRespVO>> getUserPage(@Valid MemberUserPageReqVO pageVO) {
+        PageResult<MemberUserDO> pageResult = memberUserService.getUserPage(pageVO);
+        if (CollUtil.isEmpty(pageResult.getList())) {
+            return R.ok(PageResult.empty());
+        }
+
+        // 处理用户标签返显
+        Set<Long> tagIds = pageResult.getList().stream()
+            .map(MemberUserDO::getTagIds)
+            .filter(Objects::nonNull)
+            .flatMap(Collection::stream)
+            .collect(Collectors.toSet());
+        List<MemberTagDO> tags = memberTagService.getTagList(tagIds);
+        // 处理用户级别返显
+        List<MemberLevelDO> levels = memberLevelService.getLevelList(
+            convertSet(pageResult.getList(), MemberUserDO::getLevelId));
+        // 处理用户分组返显
+        List<MemberGroupDO> groups = memberGroupService.getGroupList(
+            convertSet(pageResult.getList(), MemberUserDO::getGroupId));
+        return R.ok(MemberUserConvert.INSTANCE.convertPage(pageResult, tags, levels, groups));
+    }
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/user/vo/MemberUserBaseVO.java

+package org.dromara.mall.controller.member.admin.user.vo;
+
+import cn.hutool.core.date.DatePattern;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import org.hibernate.validator.constraints.URL;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+
+/**
+ * 会员用户 Base VO，提供给添加、修改、详细的子 VO 使用
+ * 如果子 VO 存在差异的字段，请不要添加到这里，影响 Swagger 文档生成
+ */
+@Data
+public class MemberUserBaseVO {
+
+    @Schema(description = "手机号", requiredMode = Schema.RequiredMode.REQUIRED, example = "15601691300")
+    @NotNull(message = "手机号不能为空")
+    private String mobile;
+
+    @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    @NotNull(message = "状态不能为空")
+    private Byte status;
+
+    @Schema(description = "用户昵称", requiredMode = Schema.RequiredMode.REQUIRED, example = "李四")
+    @NotNull(message = "用户昵称不能为空")
+    private String nickname;
+
+    @Schema(description = "头像", requiredMode = Schema.RequiredMode.REQUIRED, example = "https://www.iocoder.cn/x.png")
+    @URL(message = "头像必须是 URL 格式")
+    private String avatar;
+
+    @Schema(description = "用户昵称", example = "李四")
+    private String name;
+
+    @Schema(description = "用户性别", example = "1")
+    private Integer sex;
+
+    @Schema(description = "所在地编号", example = "4371")
+    private Long areaId;
+
+    @Schema(description = "所在地全程", example = "上海上海市普陀区")
+    private String areaName;
+
+    @Schema(description = "出生日期", example = "2023-03-12")
+    @DateTimeFormat(pattern = DatePattern.NORM_DATE_PATTERN)
+    private LocalDateTime birthday;
+
+    @Schema(description = "会员备注", example = "我是小备注")
+    private String mark;
+
+    @Schema(description = "会员标签", example = "[1, 2]")
+    private List<Long> tagIds;
+
+    @Schema(description = "会员等级编号", example = "1")
+    private Long levelId;
+
+    @Schema(description = "用户分组编号", example = "1")
+    private Long groupId;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/user/vo/MemberUserPageReqVO.java

+package org.dromara.mall.controller.member.admin.user.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+import org.dromara.common.mybatis.core.page.PageParam;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+import static org.dromara.common.mall.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+
+@Schema(description = "管理后台 - 会员用户分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MemberUserPageReqVO extends PageParam {
+
+    @Schema(description = "手机号", example = "15601691300")
+    private String mobile;
+
+    @Schema(description = "用户昵称", example = "李四")
+    private String nickname;
+
+    @Schema(description = "最后登录时间")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] loginDate;
+
+    @Schema(description = "创建时间")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] createTime;
+
+    @Schema(description = "会员标签编号列表", example = "[1, 2]")
+    private List<Long> tagIds;
+
+    @Schema(description = "会员等级编号", example = "1")
+    private Long levelId;
+
+    @Schema(description = "用户分组编号", example = "1")
+    private Long groupId;
+
+    // TODO 芋艿：注册用户类型；
+
+    // TODO 芋艿：登录用户类型；
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/user/vo/MemberUserRespVO.java

+package org.dromara.mall.controller.member.admin.user.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - 会员用户 Response VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MemberUserRespVO extends MemberUserBaseVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "23788")
+    private Long id;
+
+    @Schema(description = "注册 IP", requiredMode = Schema.RequiredMode.REQUIRED, example = "127.0.0.1")
+    private String registerIp;
+
+    @Schema(description = "最后登录IP", requiredMode = Schema.RequiredMode.REQUIRED, example = "127.0.0.1")
+    private String loginIp;
+
+    @Schema(description = "最后登录时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime loginDate;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+    // ========== 其它信息 ==========
+
+    @Schema(description = "积分", requiredMode  = Schema.RequiredMode.REQUIRED, example = "100")
+    private Integer point;
+
+    @Schema(description = "总积分", requiredMode = Schema.RequiredMode.REQUIRED, example = "2000")
+    private Integer totalPoint;
+
+    @Schema(description = "会员标签", example = "[红色, 快乐]")
+    private List<String> tagNames;
+
+    @Schema(description = "会员等级", example = "黄金会员")
+    private String levelName;
+
+    @Schema(description = "用户分组", example = "购物达人")
+    private String groupName;
+
+    @Schema(description = "用户经验值", requiredMode  = Schema.RequiredMode.REQUIRED, example = "200")
+    private Integer experience;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/user/vo/MemberUserUpdateLevelReqVO.java

+package org.dromara.mall.controller.member.admin.user.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - 用户修改等级 Request VO")
+@Data
+@ToString(callSuper = true)
+public class MemberUserUpdateLevelReqVO {
+
+    @Schema(description = "用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "23788")
+    @NotNull(message = "用户编号不能为空")
+    private Long id;
+
+    /**
+     * 取消用户等级时，值为空
+     */
+    @Schema(description = "用户等级编号", example = "1")
+    private Long levelId;
+
+    @Schema(description = "修改原因", requiredMode = Schema.RequiredMode.REQUIRED, example = "推广需要")
+    @NotBlank(message = "修改原因不能为空")
+    private String reason;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/user/vo/MemberUserUpdatePointReqVO.java

+package org.dromara.mall.controller.member.admin.user.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - 用户修改积分 Request VO")
+@Data
+@ToString(callSuper = true)
+public class MemberUserUpdatePointReqVO {
+
+    @Schema(description = "用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "23788")
+    @NotNull(message = "用户编号不能为空")
+    private Long id;
+
+    @Schema(description = "变动积分，正数为增加，负数为减少", requiredMode = Schema.RequiredMode.REQUIRED, example = "100")
+    @NotNull(message = "变动积分不能为空")
+    private Integer point;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/admin/user/vo/MemberUserUpdateReqVO.java

+package org.dromara.mall.controller.member.admin.user.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - 会员用户更新 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class MemberUserUpdateReqVO extends MemberUserBaseVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "23788")
+    @NotNull(message = "编号不能为空")
+    private Long id;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/address/AppAddressController.java

+package org.dromara.mall.controller.member.app.address;
+
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.dromara.common.core.domain.R;
+import org.dromara.common.satoken.utils.LoginHelper;
+import org.dromara.mall.controller.member.app.address.vo.AppAddressCreateReqVO;
+import org.dromara.mall.controller.member.app.address.vo.AppAddressRespVO;
+import org.dromara.mall.controller.member.app.address.vo.AppAddressUpdateReqVO;
+import org.dromara.mall.convert.member.AddressConvert;
+import org.dromara.mall.domain.member.MemberAddressDO;
+import org.dromara.mall.service.member.AddressService;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+
+@Tag(name = "用户 APP - 用户收件地址")
+@RestController
+@RequestMapping("/app/member/address")
+@Validated
+public class AppAddressController {
+
+    @Resource
+    private AddressService addressService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建用户收件地址")
+    public R<Long> createAddress(@Valid @RequestBody AppAddressCreateReqVO createReqVO) {
+        return R.ok(addressService.createAddress(LoginHelper.getMemberId(), createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新用户收件地址")
+    public R<Boolean> updateAddress(@Valid @RequestBody AppAddressUpdateReqVO updateReqVO) {
+        addressService.updateAddress(LoginHelper.getMemberId(), updateReqVO);
+        return R.ok(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除用户收件地址")
+    @Parameter(name = "id", description = "编号", required = true)
+    public R<Boolean> deleteAddress(@RequestParam("id") Long id) {
+        addressService.deleteAddress(LoginHelper.getMemberId(), id);
+        return R.ok(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得用户收件地址")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    public R<AppAddressRespVO> getAddress(@RequestParam("id") Long id) {
+        MemberAddressDO address = addressService.getAddress(LoginHelper.getMemberId(), id);
+        return R.ok(AddressConvert.INSTANCE.convert(address));
+    }
+
+    @GetMapping("/get-default")
+    @Operation(summary = "获得默认的用户收件地址")
+    public R<AppAddressRespVO> getDefaultUserAddress() {
+        MemberAddressDO address = addressService.getDefaultUserAddress(LoginHelper.getMemberId());
+        return R.ok(AddressConvert.INSTANCE.convert(address));
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得用户收件地址列表")
+    public R<List<AppAddressRespVO>> getAddressList() {
+        List<MemberAddressDO> list = addressService.getAddressList(LoginHelper.getMemberId());
+        return R.ok(AddressConvert.INSTANCE.convertList(list));
+    }
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/address/vo/AppAddressBaseVO.java

+package org.dromara.mall.controller.member.app.address.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+// TODO 芋艿：example 缺失
+/**
+* 用户收件地址 Base VO，提供给添加、修改、详细的子 VO 使用
+* 如果子 VO 存在差异的字段，请不要添加到这里，影响 Swagger 文档生成
+*/
+@Data
+public class AppAddressBaseVO {
+
+    @Schema(description = "收件人名称", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "收件人名称不能为空")
+    private String name;
+
+    @Schema(description = "手机号", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "手机号不能为空")
+    private String mobile;
+
+    @Schema(description = "地区编号", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "地区编号不能为空")
+    private Long areaId;
+
+    @Schema(description = "收件详细地址", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "收件详细地址不能为空")
+    private String detailAddress;
+
+    @Schema(description = "是否默认地址", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "是否默认地址不能为空")
+    private Boolean defaultStatus;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/address/vo/AppAddressCreateReqVO.java

+package org.dromara.mall.controller.member.app.address.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "用户 APP - 用户收件地址创建 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class AppAddressCreateReqVO extends AppAddressBaseVO {
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/address/vo/AppAddressRespVO.java

+package org.dromara.mall.controller.member.app.address.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "用户 APP - 用户收件地址 Response VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class AppAddressRespVO extends AppAddressBaseVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "地区名字", requiredMode = Schema.RequiredMode.REQUIRED, example = "上海上海市普陀区")
+    private String areaName;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/address/vo/AppAddressUpdateReqVO.java

+package org.dromara.mall.controller.member.app.address.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "用户 APP - 用户收件地址更新 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class AppAddressUpdateReqVO extends AppAddressBaseVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "编号不能为空")
+    private Long id;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/auth/AppAuthController.java

+//package org.dromara.mall.controller.member.app.auth;
+//
+//import cn.hutool.core.util.StrUtil;
+//import io.swagger.v3.oas.annotations.Operation;
+//import io.swagger.v3.oas.annotations.Parameter;
+//import io.swagger.v3.oas.annotations.Parameters;
+//import io.swagger.v3.oas.annotations.tags.Tag;
+//import jakarta.annotation.Resource;
+//import jakarta.annotation.security.PermitAll;
+//import jakarta.servlet.http.HttpServletRequest;
+//import jakarta.validation.Valid;
+//import lombok.extern.slf4j.Slf4j;
+//import org.dromara.mall.controller.member.app.auth.vo.*;
+//import org.dromara.mall.convert.member.AuthConvert;
+//import org.springframework.boot.autoconfigure.security.SecurityProperties;
+//import org.springframework.validation.annotation.Validated;
+//import org.springframework.web.bind.annotation.*;
+//
+//
+//
+//@Tag(name = "用户 APP - 认证")
+//@RestController
+//@RequestMapping("/member/auth")
+//@Validated
+//@Slf4j
+//public class AppAuthController {
+//
+//    @Resource
+//    private MemberAuthService authService;
+//
+//    @Resource
+//    private SocialClientApi socialClientApi;
+//
+//    @Resource
+//    private SecurityProperties securityProperties;
+//
+//    @PostMapping("/login")
+//    @Operation(summary = "使用手机 + 密码登录")
+//    @PermitAll
+//    public R<AppAuthLoginRespVO> login(@RequestBody @Valid AppAuthLoginReqVO reqVO) {
+//        return R.ok(authService.login(reqVO));
+//    }
+//
+//    @PostMapping("/logout")
+//    @Operation(summary = "登出系统")
+//    @PermitAll
+//    public R<Boolean> logout(HttpServletRequest request) {
+//        String token = SecurityFrameworkUtils.obtainAuthorization(request,
+//                securityProperties.getTokenHeader(), securityProperties.getTokenParameter());
+//        if (StrUtil.isNotBlank(token)) {
+//            authService.logout(token);
+//        }
+//        return R.ok(true);
+//    }
+//
+//    @PostMapping("/refresh-token")
+//    @Operation(summary = "刷新令牌")
+//    @Parameter(name = "refreshToken", description = "刷新令牌", required = true)
+//    @PermitAll
+//    public R<AppAuthLoginRespVO> refreshToken(@RequestParam("refreshToken") String refreshToken) {
+//        return R.ok(authService.refreshToken(refreshToken));
+//    }
+//
+//    // ========== 短信登录相关 ==========
+//
+//    @PostMapping("/sms-login")
+//    @Operation(summary = "使用手机 + 验证码登录")
+//    @PermitAll
+//    public R<AppAuthLoginRespVO> smsLogin(@RequestBody @Valid AppAuthSmsLoginReqVO reqVO) {
+//        return R.ok(authService.smsLogin(reqVO));
+//    }
+//
+//    @PostMapping("/send-sms-code")
+//    @Operation(summary = "发送手机验证码")
+//    @PermitAll
+//    public R<Boolean> sendSmsCode(@RequestBody @Valid AppAuthSmsSendReqVO reqVO) {
+//        authService.sendSmsCode(LoginHelper.getMemberId(), reqVO);
+//        return R.ok(true);
+//    }
+//
+//    @PostMapping("/validate-sms-code")
+//    @Operation(summary = "校验手机验证码")
+//    @PermitAll
+//    public R<Boolean> validateSmsCode(@RequestBody @Valid AppAuthSmsValidateReqVO reqVO) {
+//        authService.validateSmsCode(LoginHelper.getMemberId(), reqVO);
+//        return R.ok(true);
+//    }
+//
+//    // ========== 社交登录相关 ==========
+//
+//    @GetMapping("/social-auth-redirect")
+//    @Operation(summary = "社交授权的跳转")
+//    @Parameters({
+//            @Parameter(name = "type", description = "社交类型", required = true),
+//            @Parameter(name = "redirectUri", description = "回调路径")
+//    })
+//    @PermitAll
+//    public R<String> socialAuthRedirect(@RequestParam("type") Integer type,
+//                                                   @RequestParam("redirectUri") String redirectUri) {
+//        return CommonResult.success(authService.getSocialAuthorizeUrl(type, redirectUri));
+//    }
+//
+//    @PostMapping("/social-login")
+//    @Operation(summary = "社交快捷登录，使用 code 授权码", description = "适合未登录的用户，但是社交账号已绑定用户")
+//    @PermitAll
+//    public R<AppAuthLoginRespVO> socialLogin(@RequestBody @Valid AppAuthSocialLoginReqVO reqVO) {
+//        return R.ok(authService.socialLogin(reqVO));
+//    }
+//
+//    @PostMapping("/weixin-mini-app-login")
+//    @Operation(summary = "微信小程序的一键登录")
+//    @PermitAll
+//    public R<AppAuthLoginRespVO> weixinMiniAppLogin(@RequestBody @Valid AppAuthWeixinMiniAppLoginReqVO reqVO) {
+//        return R.ok(authService.weixinMiniAppLogin(reqVO));
+//    }
+//
+//    @PostMapping("/create-weixin-jsapi-signature")
+//    @Operation(summary = "创建微信 JS SDK 初始化所需的签名",
+//            description = "参考 https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/JS-SDK.html 文档")
+//    @PermitAll
+//    public R<SocialWxJsapiSignatureRespDTO> createWeixinMpJsapiSignature(@RequestParam("url") String url) {
+//        SocialWxJsapiSignatureRespDTO signature = socialClientApi.createWxMpJsapiSignature(
+//                UserTypeEnum.MEMBER.getValue(), url);
+//        return R.ok(AuthConvert.INSTANCE.convert(signature));
+//    }
+//
+//}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/auth/vo/AppAuthCheckCodeReqVO.java

+package org.dromara.mall.controller.member.app.auth.vo;
+
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Pattern;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import org.dromara.common.mall.validation.Mobile;
+import org.hibernate.validator.constraints.Length;
+
+// TODO 芋艿：code review 相关逻辑
+@Schema(description = "用户 APP - 校验验证码 Request VO")
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class AppAuthCheckCodeReqVO {
+
+    @Schema(description = "手机号", example = "15601691234")
+    @NotBlank(message = "手机号不能为空")
+    @Mobile
+    private String mobile;
+
+    @Schema(description = "手机验证码", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotBlank(message = "手机验证码不能为空")
+    @Length(min = 4, max = 6, message = "手机验证码长度为 4-6 位")
+    @Pattern(regexp = "^[0-9]+$", message = "手机验证码必须都是数字")
+    private String code;
+
+    @Schema(description = "发送场景,对应 SmsSceneEnum 枚举", example = "1")
+    @NotNull(message = "发送场景不能为空")
+//TODO 待修改    @InEnum(SmsSceneEnum.class)
+    private Integer scene;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/auth/vo/AppAuthLoginReqVO.java

+package org.dromara.mall.controller.member.app.auth.vo;
+
+import cn.hutool.core.util.StrUtil;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.NotEmpty;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import org.dromara.common.mall.validation.Mobile;
+import org.hibernate.validator.constraints.Length;
+
+@Schema(description = "用户 APP - 手机 + 密码登录 Request VO,如果登录并绑定社交用户，需要传递 social 开头的参数")
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class AppAuthLoginReqVO {
+
+    @Schema(description = "手机号", requiredMode = Schema.RequiredMode.REQUIRED, example = "15601691300")
+    @NotEmpty(message = "手机号不能为空")
+    @Mobile
+    private String mobile;
+
+    @Schema(description = "密码", requiredMode = Schema.RequiredMode.REQUIRED, example = "buzhidao")
+    @NotEmpty(message = "密码不能为空")
+    @Length(min = 4, max = 16, message = "密码长度为 4-16 位")
+    private String password;
+
+    // ========== 绑定社交登录时，需要传递如下参数 ==========
+
+    @Schema(description = "社交平台的类型，参见 SocialTypeEnum 枚举值", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+//TODO 待修改    @InEnum(SocialTypeEnum.class)
+    private Integer socialType;
+
+    @Schema(description = "授权码", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private String socialCode;
+
+    @Schema(description = "state", requiredMode = Schema.RequiredMode.REQUIRED, example = "9b2ffbc1-7425-4155-9894-9d5c08541d62")
+    private String socialState;
+
+    @AssertTrue(message = "授权码不能为空")
+    public boolean isSocialCodeValid() {
+        return socialType == null || StrUtil.isNotEmpty(socialCode);
+    }
+
+    @AssertTrue(message = "授权 state 不能为空")
+    public boolean isSocialState() {
+        return socialType == null || StrUtil.isNotEmpty(socialState);
+    }
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/auth/vo/AppAuthLoginRespVO.java

+package org.dromara.mall.controller.member.app.auth.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "用户 APP - 登录 Response VO")
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class AppAuthLoginRespVO {
+
+    @Schema(description = "用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long userId;
+
+    @Schema(description = "访问令牌", requiredMode = Schema.RequiredMode.REQUIRED, example = "happy")
+    private String accessToken;
+
+    @Schema(description = "刷新令牌", requiredMode = Schema.RequiredMode.REQUIRED, example = "nice")
+    private String refreshToken;
+
+    @Schema(description = "过期时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime expiresTime;
+
+    /**
+     * 仅社交登录、社交绑定时会返回
+     *
+     * 为什么需要返回？微信公众号、微信小程序支付需要传递 openid 给支付接口
+     */
+    @Schema(description = "社交用户 openid", example = "qq768")
+    private String openid;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/auth/vo/AppAuthSmsLoginReqVO.java

+package org.dromara.mall.controller.member.app.auth.vo;
+
+import cn.hutool.core.util.StrUtil;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.Pattern;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import org.dromara.common.mall.validation.Mobile;
+import org.hibernate.validator.constraints.Length;
+
+@Schema(description = "用户 APP - 手机 + 验证码登录 Request VO,如果登录并绑定社交用户，需要传递 social 开头的参数")
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class AppAuthSmsLoginReqVO {
+
+    @Schema(description = "手机号", requiredMode = Schema.RequiredMode.REQUIRED, example = "15601691300")
+    @NotEmpty(message = "手机号不能为空")
+    @Mobile
+    private String mobile;
+
+    @Schema(description = "手机验证码", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotEmpty(message = "手机验证码不能为空")
+    @Length(min = 4, max = 6, message = "手机验证码长度为 4-6 位")
+    @Pattern(regexp = "^[0-9]+$", message = "手机验证码必须都是数字")
+    private String code;
+
+    // ========== 绑定社交登录时，需要传递如下参数 ==========
+
+    @Schema(description = "社交平台的类型，参见 SocialTypeEnum 枚举值", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+//TODO 待修改      @InEnum(SocialTypeEnum.class)
+    private Integer socialType;
+
+    @Schema(description = "授权码", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private String socialCode;
+
+    @Schema(description = "state", requiredMode = Schema.RequiredMode.REQUIRED, example = "9b2ffbc1-7425-4155-9894-9d5c08541d62")
+    private String socialState;
+
+    @AssertTrue(message = "授权码不能为空")
+    public boolean isSocialCodeValid() {
+        return socialType == null || StrUtil.isNotEmpty(socialCode);
+    }
+
+    @AssertTrue(message = "授权 state 不能为空")
+    public boolean isSocialState() {
+        return socialType == null || StrUtil.isNotEmpty(socialState);
+    }
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/auth/vo/AppAuthSmsSendReqVO.java

+package org.dromara.mall.controller.member.app.auth.vo;
+
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import lombok.experimental.Accessors;
+import org.dromara.common.mall.validation.Mobile;
+
+@Schema(description = "用户 APP - 发送手机验证码 Request VO")
+@Data
+@Accessors(chain = true)
+public class AppAuthSmsSendReqVO {
+
+    @Schema(description = "手机号", example = "15601691234")
+    @Mobile
+    private String mobile;
+
+    @Schema(description = "发送场景,对应 SmsSceneEnum 枚举", example = "1")
+    @NotNull(message = "发送场景不能为空")
+//TODO 待修改      @InEnum(SmsSceneEnum.class)
+    private Integer scene;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/auth/vo/AppAuthSmsValidateReqVO.java

+package org.dromara.mall.controller.member.app.auth.vo;
+
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Pattern;
+import lombok.Data;
+import lombok.experimental.Accessors;
+import org.dromara.common.mall.validation.Mobile;
+import org.hibernate.validator.constraints.Length;
+
+@Schema(description = "用户 APP - 校验手机验证码 Request VO")
+@Data
+@Accessors(chain = true)
+public class AppAuthSmsValidateReqVO {
+
+    @Schema(description = "手机号", example = "15601691234")
+    @Mobile
+    private String mobile;
+
+    @Schema(description = "发送场景,对应 SmsSceneEnum 枚举", example = "1")
+    @NotNull(message = "发送场景不能为空")
+//TODO 待修改      @InEnum(SmsSceneEnum.class)
+    private Integer scene;
+
+    @Schema(description = "手机验证码", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotEmpty(message = "手机验证码不能为空")
+    @Length(min = 4, max = 6, message = "手机验证码长度为 4-6 位")
+    @Pattern(regexp = "^[0-9]+$", message = "手机验证码必须都是数字")
+    private String code;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/auth/vo/AppAuthSocialLoginReqVO.java

+package org.dromara.mall.controller.member.app.auth.vo;
+
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Schema(description = "用户 APP - 社交快捷登录 Request VO，使用 code 授权码")
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class AppAuthSocialLoginReqVO {
+
+    @Schema(description = "社交平台的类型，参见 SocialTypeEnum 枚举值", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+//TODO 待修改      @InEnum(SocialTypeEnum.class)
+    @NotNull(message = "社交平台的类型不能为空")
+    private Integer type;
+
+    @Schema(description = "授权码", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotEmpty(message = "授权码不能为空")
+    private String code;
+
+    @Schema(description = "state", requiredMode = Schema.RequiredMode.REQUIRED, example = "9b2ffbc1-7425-4155-9894-9d5c08541d62")
+    @NotEmpty(message = "state 不能为空")
+    private String state;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/auth/vo/AppAuthWeixinMiniAppLoginReqVO.java

+package org.dromara.mall.controller.member.app.auth.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Schema(description = "用户 APP - 微信小程序手机登录 Request VO")
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class AppAuthWeixinMiniAppLoginReqVO {
+
+    @Schema(description = "手机 code，小程序通过 wx.getPhoneNumber 方法获得", requiredMode = Schema.RequiredMode.REQUIRED, example = "hello")
+    @NotEmpty(message = "手机 code 不能为空")
+    private String phoneCode;
+
+    @Schema(description = "登录 code，小程序通过 wx.login 方法获得", requiredMode = Schema.RequiredMode.REQUIRED, example = "word")
+    @NotEmpty(message = "登录 code 不能为空")
+    private String loginCode;
+
+    @Schema(description = "state", requiredMode = Schema.RequiredMode.REQUIRED, example = "9b2ffbc1-7425-4155-9894-9d5c08541d62")
+    @NotEmpty(message = "state 不能为空")
+    private String state;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/auth/vo/AuthWeixinJsapiSignatureRespVO.java

+package org.dromara.mall.controller.member.app.auth.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Schema(description = "用户 APP - 微信公众号 JSAPI 签名 Response VO")
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class AuthWeixinJsapiSignatureRespVO {
+
+    @Schema(description = "微信公众号的 appId", requiredMode = Schema.RequiredMode.REQUIRED, example = "hello")
+    private String appId;
+
+    @Schema(description = "匿名串", requiredMode = Schema.RequiredMode.REQUIRED, example = "world")
+    private String nonceStr;
+
+    @Schema(description = "时间戳", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long timestamp;
+
+    @Schema(description = "URL", requiredMode = Schema.RequiredMode.REQUIRED, example = "https://www.iocoder.cn")
+    private String url;
+
+    @Schema(description = "签名", requiredMode = Schema.RequiredMode.REQUIRED, example = "阿巴阿巴")
+    private String signature;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/level/AppMemberExperienceRecordController.java

+package org.dromara.mall.controller.member.app.level;
+
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.dromara.common.core.domain.R;
+import org.dromara.common.mybatis.core.page.PageParam;
+import org.dromara.common.mybatis.core.page.PageResult;
+import org.dromara.common.satoken.utils.LoginHelper;
+import org.dromara.mall.controller.member.app.level.vo.experience.AppMemberExperienceRecordRespVO;
+import org.dromara.mall.convert.member.MemberExperienceRecordConvert;
+import org.dromara.mall.domain.member.MemberExperienceRecordDO;
+import org.dromara.mall.service.member.MemberExperienceRecordService;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+
+@Tag(name = "用户 App - 会员经验记录")
+@RestController
+@RequestMapping("/app/member/experience-record")
+@Validated
+public class AppMemberExperienceRecordController {
+
+    @Resource
+    private MemberExperienceRecordService experienceLogService;
+
+    @GetMapping("/page")
+    @Operation(summary = "获得会员经验记录分页")
+    public R<PageResult<AppMemberExperienceRecordRespVO>> getExperienceRecordPage(
+        @Valid PageParam pageParam) {
+        PageResult<MemberExperienceRecordDO> pageResult = experienceLogService.getExperienceRecordPage(
+            LoginHelper.getMemberId(), pageParam);
+        return R.ok(MemberExperienceRecordConvert.INSTANCE.convertPage02(pageResult));
+    }
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/level/AppMemberLevelController.java

+package org.dromara.mall.controller.member.app.level;
+
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.annotation.security.PermitAll;
+import org.dromara.common.core.domain.R;
+import org.dromara.mall.controller.member.app.level.vo.level.AppMemberLevelRespVO;
+import org.dromara.mall.convert.member.MemberLevelConvert;
+import org.dromara.mall.domain.member.MemberLevelDO;
+import org.dromara.mall.service.member.MemberLevelService;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+
+
+@Tag(name = "用户 App - 会员等级")
+@RestController
+@RequestMapping("/app/member/level")
+@Validated
+public class AppMemberLevelController {
+
+    @Resource
+    private MemberLevelService levelService;
+
+    @GetMapping("/list")
+    @Operation(summary = "获得会员等级列表")
+    @PermitAll
+    public R<List<AppMemberLevelRespVO>> getLevelList() {
+        List<MemberLevelDO> result = levelService.getEnableLevelList();
+        return R.ok(MemberLevelConvert.INSTANCE.convertList02(result));
+    }
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/level/vo/experience/AppMemberExperienceRecordRespVO.java

+package org.dromara.mall.controller.member.app.level.vo.experience;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "用户 App - 会员经验记录 Response VO")
+@Data
+public class AppMemberExperienceRecordRespVO {
+
+    @Schema(description = "标题", requiredMode = Schema.RequiredMode.REQUIRED, example = "增加经验")
+    private String title;
+
+    @Schema(description = "经验", requiredMode = Schema.RequiredMode.REQUIRED, example = "100")
+    private Integer experience;
+
+    @Schema(description = "描述", requiredMode = Schema.RequiredMode.REQUIRED, example = "下单增加 100 经验")
+    private String description;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/level/vo/level/AppMemberLevelRespVO.java

+package org.dromara.mall.controller.member.app.level.vo.level;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Schema(description = "用户 App - 会员等级 Response VO")
+@Data
+public class AppMemberLevelRespVO {
+
+    @Schema(description = "等级名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "芋艿")
+    private String name;
+
+    @Schema(description = "等级", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer level;
+
+    @Schema(description = "升级经验", requiredMode = Schema.RequiredMode.REQUIRED, example = "100")
+    private Integer experience;
+
+    @Schema(description = "享受折扣", requiredMode = Schema.RequiredMode.REQUIRED, example = "98")
+    private Integer discountPercent;
+
+    @Schema(description = "等级图标", example = "https://www.iocoder.cn/yudao.jpg")
+    private String icon;
+
+    @Schema(description = "等级背景图", example = "https://www.iocoder.cn/yudao.jpg")
+    private String backgroundUrl;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/point/AppMemberPointRecordController.java

+package org.dromara.mall.controller.member.app.point;
+
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.dromara.common.core.domain.R;
+import org.dromara.common.mybatis.core.page.PageResult;
+import org.dromara.common.mybatis.util.BeanUtils;
+import org.dromara.common.satoken.utils.LoginHelper;
+import org.dromara.mall.controller.member.app.point.vo.AppMemberPointRecordPageReqVO;
+import org.dromara.mall.controller.member.app.point.vo.AppMemberPointRecordRespVO;
+import org.dromara.mall.domain.member.MemberPointRecordDO;
+import org.dromara.mall.service.member.MemberPointRecordService;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+
+@Tag(name = "用户 App - 签到记录")
+@RestController
+@RequestMapping("/app/member/point/record")
+@Validated
+public class AppMemberPointRecordController {
+
+    @Resource
+    private MemberPointRecordService pointRecordService;
+
+    @GetMapping("/page")
+    @Operation(summary = "获得用户积分记录分页")
+    public R<PageResult<AppMemberPointRecordRespVO>> getPointRecordPage(
+        @Valid AppMemberPointRecordPageReqVO pageReqVO) {
+        PageResult<MemberPointRecordDO> pageResult = pointRecordService.getPointRecordPage(LoginHelper.getMemberId(), pageReqVO);
+        return R.ok(BeanUtils.toBean(pageResult, AppMemberPointRecordRespVO.class));
+    }
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/point/vo/AppMemberPointRecordPageReqVO.java

+package org.dromara.mall.controller.member.app.point.vo;
+
+import cn.hutool.core.date.DatePattern;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import org.dromara.common.mybatis.core.page.PageParam;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "用户 App - 用户积分记录分页 Request VO")
+@Data
+public class AppMemberPointRecordPageReqVO extends PageParam {
+
+    @Schema(description = "是否增加积分", example = "true")
+    private Boolean addStatus; // true - 增加；false - 减少；null - 不筛选
+
+    @DateTimeFormat(pattern = DatePattern.NORM_DATETIME_PATTERN)
+    @Schema(description = "创建时间")
+    private LocalDateTime[] createTime;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/point/vo/AppMemberPointRecordRespVO.java

+package org.dromara.mall.controller.member.app.point.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "用户 App - 用户积分记录 Response VO")
+@Data
+public class AppMemberPointRecordRespVO {
+
+    @Schema(description = "自增主键", requiredMode = Schema.RequiredMode.REQUIRED, example = "31457")
+    private Long id;
+
+    @Schema(description = "积分标题", requiredMode = Schema.RequiredMode.REQUIRED, example = "你猜")
+    private String title;
+
+    @Schema(description = "积分描述", example = "你猜")
+    private String description;
+
+    @Schema(description = "积分", requiredMode = Schema.RequiredMode.REQUIRED, example = "100")
+    private Integer point;
+
+    @Schema(description = "发生时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/signin/AppMemberSignInConfigController.java

+package org.dromara.mall.controller.member.app.signin;
+
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.annotation.security.PermitAll;
+import org.dromara.common.core.domain.R;
+import org.dromara.common.mall.enums.CommonStatusEnum;
+import org.dromara.mall.controller.member.app.signin.vo.config.AppMemberSignInConfigRespVO;
+import org.dromara.mall.convert.member.MemberSignInConfigConvert;
+import org.dromara.mall.domain.member.MemberSignInConfigDO;
+import org.dromara.mall.service.member.MemberSignInConfigService;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+
+
+@Tag(name = "用户 App - 签到规则")
+@RestController
+@RequestMapping("/app/member/sign-in/config")
+@Validated
+public class AppMemberSignInConfigController {
+
+    @Resource
+    private MemberSignInConfigService signInConfigService;
+
+    @GetMapping("/list")
+    @Operation(summary = "获得签到规则列表")
+    @PermitAll
+    public R<List<AppMemberSignInConfigRespVO>> getSignInConfigList() {
+        List<MemberSignInConfigDO> pageResult = signInConfigService.getSignInConfigList(CommonStatusEnum.ENABLE.getStatus());
+        return R.ok(MemberSignInConfigConvert.INSTANCE.convertList02(pageResult));
+    }
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/signin/AppMemberSignInRecordController.java

+package org.dromara.mall.controller.member.app.signin;
+
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import org.dromara.common.core.domain.R;
+import org.dromara.common.mybatis.core.page.PageParam;
+import org.dromara.common.mybatis.core.page.PageResult;
+import org.dromara.common.satoken.utils.LoginHelper;
+import org.dromara.mall.controller.member.app.signin.vo.record.AppMemberSignInRecordRespVO;
+import org.dromara.mall.controller.member.app.signin.vo.record.AppMemberSignInRecordSummaryRespVO;
+import org.dromara.mall.convert.member.MemberSignInRecordConvert;
+import org.dromara.mall.domain.member.MemberSignInRecordDO;
+import org.dromara.mall.service.member.MemberSignInRecordService;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+
+
+@Tag(name = "用户 App - 签到记录")
+@RestController
+@RequestMapping("/app/member/sign-in/record")
+@Validated
+public class AppMemberSignInRecordController {
+
+    @Resource
+    private MemberSignInRecordService signInRecordService;
+
+    @GetMapping("/get-summary")
+    @Operation(summary = "获得个人签到统计")
+    public R<AppMemberSignInRecordSummaryRespVO> getSignInRecordSummary() {
+        return R.ok(signInRecordService.getSignInRecordSummary(LoginHelper.getMemberId()));
+    }
+
+    @PostMapping("/create")
+    @Operation(summary = "签到")
+    public R<AppMemberSignInRecordRespVO> createSignInRecord() {
+        MemberSignInRecordDO recordDO = signInRecordService.createSignRecord(LoginHelper.getMemberId());
+        return R.ok(MemberSignInRecordConvert.INSTANCE.coverRecordToAppRecordVo(recordDO));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得签到记录分页")
+    public R<PageResult<AppMemberSignInRecordRespVO>> getSignRecordPage(PageParam pageParam) {
+        PageResult<MemberSignInRecordDO> pageResult = signInRecordService.getSignRecordPage(LoginHelper.getMemberId(), pageParam);
+        return R.ok(MemberSignInRecordConvert.INSTANCE.convertPage02(pageResult));
+    }
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/signin/vo/config/AppMemberSignInConfigRespVO.java

+package org.dromara.mall.controller.member.app.signin.vo.config;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Schema(description = "用户 App - 签到规则 Response VO")
+@Data
+public class AppMemberSignInConfigRespVO {
+
+    @Schema(description = "签到第 x 天", requiredMode = Schema.RequiredMode.REQUIRED, example = "7")
+    private Integer day;
+
+    @Schema(description = "奖励积分", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+    private Integer point;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/signin/vo/record/AppMemberSignInRecordRespVO.java

+package org.dromara.mall.controller.member.app.signin.vo.record;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "用户 App - 签到记录 Response VO")
+@Data
+public class AppMemberSignInRecordRespVO {
+
+    @Schema(description = "第几天签到", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer day;
+
+    @Schema(description = "签到的分数", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+    private Integer point;
+
+    @Schema(description = "签到的经验", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+    private Integer experience;
+
+    @Schema(description = "签到时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/signin/vo/record/AppMemberSignInRecordSummaryRespVO.java

+package org.dromara.mall.controller.member.app.signin.vo.record;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Schema(description = "用户 App - 个人签到统计 Response VO")
+@Data
+public class AppMemberSignInRecordSummaryRespVO {
+
+    @Schema(description = "总签到天数", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+    private Integer totalDay;
+
+    @Schema(description = "连续签到第 x 天", requiredMode = Schema.RequiredMode.REQUIRED, example = "3")
+    private Integer continuousDay;
+
+    @Schema(description = "今天是否已签到", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    private Boolean todaySignIn;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/social/AppSocialUserController.java

+//package org.dromara.mall.controller.member.app.social;
+//
+//import cn.hutool.core.codec.Base64;
+//import cn.iocoder.yudao.framework.common.enums.UserTypeEnum;
+//import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+//import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+//import cn.iocoder.yudao.module.member.controller.app.social.vo.*;
+//import cn.iocoder.yudao.module.system.api.social.SocialClientApi;
+//import cn.iocoder.yudao.module.system.api.social.SocialUserApi;
+//import cn.iocoder.yudao.module.system.api.social.dto.*;
+//import io.swagger.v3.oas.annotations.Operation;
+//import io.swagger.v3.oas.annotations.Parameter;
+//import io.swagger.v3.oas.annotations.tags.Tag;
+//import jakarta.annotation.Resource;
+//import jakarta.annotation.security.PermitAll;
+//import jakarta.validation.Valid;
+//import org.springframework.validation.annotation.Validated;
+//import org.springframework.web.bind.annotation.*;
+//
+//import java.util.List;
+//
+//import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+//import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.LoginHelper.getMemberId;
+//
+//@Tag(name = "用户 App - 社交用户")
+//@RestController
+//@RequestMapping("/member/social-user")
+//@Validated
+//public class AppSocialUserController {
+//
+//    @Resource
+//    private SocialUserApi socialUserApi;
+//    @Resource
+//    private SocialClientApi socialClientApi;
+//
+//    @PostMapping("/bind")
+//    @Operation(summary = "社交绑定，使用 code 授权码")
+//    @PermitAll
+//    public R<String> socialBind(@RequestBody @Valid AppSocialUserBindReqVO reqVO) {
+//        SocialUserBindReqDTO reqDTO = new SocialUserBindReqDTO(LoginHelper.getMemberId(), UserTypeEnum.MEMBER.getValue(),
+//                reqVO.getType(), reqVO.getCode(), reqVO.getState());
+//        String openid = socialUserApi.bindSocialUser(reqDTO);
+//        return R.ok(openid);
+//    }
+//
+//    @DeleteMapping("/unbind")
+//    @Operation(summary = "取消社交绑定")
+//    public R<Boolean> socialUnbind(@RequestBody AppSocialUserUnbindReqVO reqVO) {
+//        SocialUserUnbindReqDTO reqDTO = new SocialUserUnbindReqDTO(LoginHelper.getMemberId(), UserTypeEnum.MEMBER.getValue(),
+//                reqVO.getType(), reqVO.getOpenid());
+//        socialUserApi.unbindSocialUser(reqDTO);
+//        return R.ok(true);
+//    }
+//
+//    @GetMapping("/get")
+//    @Operation(summary = "获得社交用户")
+//    @Parameter(name = "type", description = "社交平台的类型，参见 SocialTypeEnum 枚举值", required = true, example = "10")
+//    public R<AppSocialUserRespVO> getSocialUser(@RequestParam("type") Integer type) {
+//        SocialUserRespDTO socialUser = socialUserApi.getSocialUserByUserId(UserTypeEnum.MEMBER.getValue(), LoginHelper.getMemberId(), type);
+//        return R.ok(BeanUtils.toBean(socialUser, AppSocialUserRespVO.class));
+//    }
+//
+//    @PostMapping("/wxa-qrcode")
+//    @Operation(summary = "获得微信小程序码(base64 image)")
+//    @PermitAll
+//    public R<String> getWxaQrcode(@RequestBody @Valid AppSocialWxaQrcodeReqVO reqVO) {
+//        byte[] wxQrcode = socialClientApi.getWxaQrcode(BeanUtils.toBean(reqVO, SocialWxQrcodeReqDTO.class));
+//        return R.ok(Base64.encode(wxQrcode));
+//    }
+//
+//    @GetMapping("/get-subscribe-template-list")
+//    @Operation(summary = "获得微信小程订阅模板列表")
+//    @PermitAll
+//    public R<List<AppSocialWxaSubscribeTemplateRespVO>> getSubscribeTemplateList() {
+//        List<SocialWxaSubscribeTemplateRespDTO> template = socialClientApi.getWxaSubscribeTemplateList(UserTypeEnum.MEMBER.getValue());
+//        return R.ok(BeanUtils.toBean(template, AppSocialWxaSubscribeTemplateRespVO.class));
+//    }
+//
+//}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/social/vo/AppSocialUserBindReqVO.java

+package org.dromara.mall.controller.member.app.social.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "用户 APP - 社交绑定 Request VO，使用 code 授权码")
+@Data
+public class AppSocialUserBindReqVO {
+
+    @Schema(description = "社交平台的类型，参见 SocialTypeEnum 枚举值", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+//TODO 待修改    @InEnum(SocialTypeEnum.class)
+    @NotNull(message = "社交平台的类型不能为空")
+    private Integer type;
+
+    @Schema(description = "授权码", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotEmpty(message = "授权码不能为空")
+    private String code;
+
+    @Schema(description = "state", requiredMode = Schema.RequiredMode.REQUIRED, example = "9b2ffbc1-7425-4155-9894-9d5c08541d62")
+    @NotEmpty(message = "state 不能为空")
+    private String state;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/social/vo/AppSocialUserRespVO.java

+package org.dromara.mall.controller.member.app.social.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Schema(description = "用户 APP - 社交用户 Response VO")
+@Data
+public class AppSocialUserRespVO {
+
+    @Schema(description = "社交用户的 openid", requiredMode = Schema.RequiredMode.REQUIRED, example = "IPRmJ0wvBptiPIlGEZiPewGwiEiE")
+    private String openid;
+
+    @Schema(description = "社交用户的昵称", requiredMode = Schema.RequiredMode.REQUIRED, example = "芋道源码")
+    private String nickname;
+
+    @Schema(description = "社交用户的头像", requiredMode = Schema.RequiredMode.REQUIRED, example = "https://www.iocoder.cn/1.png")
+    private String avatar;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/social/vo/AppSocialUserUnbindReqVO.java

+package org.dromara.mall.controller.member.app.social.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "用户 APP - 取消社交绑定 Request VO")
+@Data
+public class AppSocialUserUnbindReqVO {
+
+    @Schema(description = "社交平台的类型，参见 SocialTypeEnum 枚举值", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+//TODO 待修改    @InEnum(SocialTypeEnum.class)
+    @NotNull(message = "社交平台的类型不能为空")
+    private Integer type;
+
+    @Schema(description = "社交用户的 openid", requiredMode = Schema.RequiredMode.REQUIRED, example = "IPRmJ0wvBptiPIlGEZiPewGwiEiE")
+    @NotEmpty(message = "社交用户的 openid 不能为空")
+    private String openid;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/social/vo/AppSocialWxaQrcodeReqVO.java

+package org.dromara.mall.controller.member.app.social.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import lombok.Data;
+
+
+@Schema(description = "用户 APP - 获得获取小程序码 Request VO")
+@Data
+public class AppSocialWxaQrcodeReqVO {
+
+    /**
+     * 页面路径不能携带参数（参数请放在scene字段里）
+     */
+    @Schema(description = "场景值", requiredMode = Schema.RequiredMode.REQUIRED, example = "1001")
+    private String scene;
+
+    /**
+     * 默认是主页，页面 page，例如 pages/index/index，根路径前不要填加 /，不能携带参数（参数请放在scene字段里），
+     * 如果不填写这个字段，默认跳主页面。scancode_time为系统保留参数，不允许配置
+     */
+    @Schema(description = "页面路径", requiredMode = Schema.RequiredMode.REQUIRED, example = "pages/goods/index")
+    @NotEmpty(message = "页面路径不能为空")
+    private String path;
+
+    @Schema(description = "二维码宽度", requiredMode = Schema.RequiredMode.REQUIRED, example = "430")
+    private Integer width;
+
+    @Schema(description = "是/否自动配置线条颜色", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    private Boolean autoColor;
+
+    @Schema(description = "是/否检查 page 是否存在", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    private Boolean checkPath;
+
+    @Schema(description = "是/否需要透明底色", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    private Boolean hyaline;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/social/vo/AppSocialWxaSubscribeTemplateRespVO.java

+package org.dromara.mall.controller.member.app.social.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Schema(description = "用户 APP - 获得小程序订阅模版 Response VO")
+@Data
+public class AppSocialWxaSubscribeTemplateRespVO {
+
+    @Schema(description = "模版编号", requiredMode = Schema.RequiredMode.REQUIRED,
+            example = "9Aw5ZV1j9xdWTFEkqCpZ7mIBbSC34khK55OtzUPl0rU")
+    private String id;
+
+    @Schema(description = "模版标题", requiredMode = Schema.RequiredMode.REQUIRED, example = "订单支付通知")
+    private String title;
+
+    @Schema(description = "模版内容", requiredMode = Schema.RequiredMode.REQUIRED,
+            example = "{ {result.DATA} }\\n\\n领奖金额:{ {withdrawMoney.DATA} }\\n领奖时间:    { {withdrawTime.DATA} }")
+    private String content;
+
+    @Schema(description = "模板内容示例", requiredMode = Schema.RequiredMode.REQUIRED, example = "下单时间:2016年8月8日")
+    private String example;
+
+    @Schema(description = "模版类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    private Integer type; // 2 为一次性订阅，3 为长期订阅
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/user/AppMemberUserController.java

+package org.dromara.mall.controller.member.app.user;
+
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.annotation.security.PermitAll;
+import jakarta.validation.Valid;
+import lombok.extern.slf4j.Slf4j;
+import org.dromara.common.core.domain.R;
+import org.dromara.common.satoken.utils.LoginHelper;
+import org.dromara.mall.controller.member.app.user.vo.*;
+import org.dromara.mall.convert.member.MemberUserConvert;
+import org.dromara.mall.domain.member.MemberLevelDO;
+import org.dromara.mall.domain.member.MemberUserDO;
+import org.dromara.mall.service.member.MemberLevelService;
+import org.dromara.mall.service.member.MemberUserService;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+
+
+@Tag(name = "用户 APP - 用户个人中心")
+@RestController
+@RequestMapping("/app/member/user")
+@Validated
+@Slf4j
+public class AppMemberUserController {
+
+    @Resource
+    private MemberUserService userService;
+    @Resource
+    private MemberLevelService levelService;
+
+    @GetMapping("/get")
+    @Operation(summary = "获得基本信息")
+    public R<AppMemberUserInfoRespVO> getUserInfo() {
+        MemberUserDO user = userService.getUser(LoginHelper.getMemberId());
+        MemberLevelDO level = levelService.getLevel(user.getLevelId());
+        return R.ok(MemberUserConvert.INSTANCE.convert(user, level));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "修改基本信息")
+    public R<Boolean> updateUser(@RequestBody @Valid AppMemberUserUpdateReqVO reqVO) {
+        userService.updateUser(LoginHelper.getMemberId(), reqVO);
+        return R.ok(true);
+    }
+
+    @PutMapping("/update-mobile")
+    @Operation(summary = "修改用户手机")
+    public R<Boolean> updateUserMobile(@RequestBody @Valid AppMemberUserUpdateMobileReqVO reqVO) {
+        userService.updateUserMobile(LoginHelper.getMemberId(), reqVO);
+        return R.ok(true);
+    }
+
+    @PutMapping("/update-mobile-by-weixin")
+    @Operation(summary = "基于微信小程序的授权码，修改用户手机")
+    public R<Boolean> updateUserMobileByWeixin(@RequestBody @Valid AppMemberUserUpdateMobileByWeixinReqVO reqVO) {
+        userService.updateUserMobileByWeixin(LoginHelper.getMemberId(), reqVO);
+        return R.ok(true);
+    }
+
+    @PutMapping("/update-password")
+    @Operation(summary = "修改用户密码", description = "用户修改密码时使用")
+    public R<Boolean> updateUserPassword(@RequestBody @Valid AppMemberUserUpdatePasswordReqVO reqVO) {
+        userService.updateUserPassword(LoginHelper.getMemberId(), reqVO);
+        return R.ok(true);
+    }
+
+    @PutMapping("/reset-password")
+    @Operation(summary = "重置密码", description = "用户忘记密码时使用")
+    @PermitAll
+    public R<Boolean> resetUserPassword(@RequestBody @Valid AppMemberUserResetPasswordReqVO reqVO) {
+        userService.resetUserPassword(reqVO);
+        return R.ok(true);
+    }
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/user/vo/AppMemberUserInfoRespVO.java

+package org.dromara.mall.controller.member.app.user.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Schema(description = "用户 APP - 用户个人信息 Response VO")
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+public class AppMemberUserInfoRespVO {
+
+    @Schema(description = "用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long id;
+
+    @Schema(description = "用户昵称", requiredMode = Schema.RequiredMode.REQUIRED, example = "芋艿")
+    private String nickname;
+
+    @Schema(description = "用户头像", requiredMode = Schema.RequiredMode.REQUIRED, example = "https://www.iocoder.cn/xxx.png")
+    private String avatar;
+
+    @Schema(description = "用户手机号", requiredMode = Schema.RequiredMode.REQUIRED, example = "15601691300")
+    private String mobile;
+
+    @Schema(description = "用户性别", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer sex;
+
+    @Schema(description = "积分", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+    private Integer point;
+
+    @Schema(description = "经验值", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Integer experience;
+
+    @Schema(description = "用户等级")
+    private Level level;
+
+    @Schema(description = "是否成为推广员", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    private Boolean brokerageEnabled;
+
+    @Schema(description = "用户 App - 会员等级")
+    @Data
+    public static class Level {
+
+        @Schema(description = "等级编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+        private Long id;
+
+        @Schema(description = "等级名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "芋艿")
+        private String name;
+
+        @Schema(description = "等级", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+        private Integer level;
+
+        @Schema(description = "等级图标", example = "https://www.iocoder.cn/yudao.jpg")
+        private String icon;
+
+    }
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/user/vo/AppMemberUserResetPasswordReqVO.java

+package org.dromara.mall.controller.member.app.user.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.Pattern;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import org.dromara.common.mall.validation.Mobile;
+import org.hibernate.validator.constraints.Length;
+
+@Schema(description = "用户 APP - 重置密码 Request VO")
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class AppMemberUserResetPasswordReqVO {
+
+    @Schema(description = "新密码", requiredMode = Schema.RequiredMode.REQUIRED, example = "buzhidao")
+    @NotEmpty(message = "新密码不能为空")
+    @Length(min = 4, max = 16, message = "密码长度为 4-16 位")
+    private String password;
+
+    @Schema(description = "手机验证码", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotEmpty(message = "手机验证码不能为空")
+    @Length(min = 4, max = 6, message = "手机验证码长度为 4-6 位")
+    @Pattern(regexp = "^[0-9]+$", message = "手机验证码必须都是数字")
+    private String code;
+
+    @Schema(description = "手机号",requiredMode = Schema.RequiredMode.REQUIRED,example = "15878962356")
+    @NotBlank(message = "手机号不能为空")
+    @Mobile
+    private String mobile;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/user/vo/AppMemberUserUpdateMobileByWeixinReqVO.java

+package org.dromara.mall.controller.member.app.user.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import lombok.Data;
+
+@Schema(description = "用户 APP - 基于微信小程序的授权码，修改手机 Request VO")
+@Data
+public class AppMemberUserUpdateMobileByWeixinReqVO {
+
+    @Schema(description = "手机 code，小程序通过 wx.getPhoneNumber 方法获得",
+            requiredMode = Schema.RequiredMode.REQUIRED, example = "hello")
+    @NotEmpty(message = "手机 code 不能为空")
+    private String code;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/user/vo/AppMemberUserUpdateMobileReqVO.java

+package org.dromara.mall.controller.member.app.user.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.Pattern;
+import lombok.Data;
+import org.dromara.common.mall.validation.Mobile;
+import org.hibernate.validator.constraints.Length;
+
+@Schema(description = "用户 APP - 修改手机 Request VO")
+@Data
+public class AppMemberUserUpdateMobileReqVO {
+
+    @Schema(description = "手机验证码", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotEmpty(message = "手机验证码不能为空")
+    @Length(min = 4, max = 6, message = "手机验证码长度为 4-6 位")
+    @Pattern(regexp = "^[0-9]+$", message = "手机验证码必须都是数字")
+    private String code;
+
+    @Schema(description = "手机号",requiredMode = Schema.RequiredMode.REQUIRED, example = "15823654487")
+    @NotBlank(message = "手机号不能为空")
+    @Length(min = 8, max = 11, message = "手机号码长度为 8-11 位")
+    @Mobile
+    private String mobile;
+
+    @Schema(description = "原手机验证码", example = "1024")
+    @Length(min = 4, max = 6, message = "手机验证码长度为 4-6 位")
+    @Pattern(regexp = "^[0-9]+$", message = "手机验证码必须都是数字")
+    private String oldCode;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/user/vo/AppMemberUserUpdatePasswordReqVO.java

+package org.dromara.mall.controller.member.app.user.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.Pattern;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import org.hibernate.validator.constraints.Length;
+
+@Schema(description = "用户 APP - 修改密码 Request VO")
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class AppMemberUserUpdatePasswordReqVO {
+
+    @Schema(description = "新密码", requiredMode = Schema.RequiredMode.REQUIRED, example = "buzhidao")
+    @NotEmpty(message = "新密码不能为空")
+    @Length(min = 4, max = 16, message = "密码长度为 4-16 位")
+    private String password;
+
+    @Schema(description = "手机验证码", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotEmpty(message = "手机验证码不能为空")
+    @Length(min = 4, max = 6, message = "手机验证码长度为 4-6 位")
+    @Pattern(regexp = "^[0-9]+$", message = "手机验证码必须都是数字")
+    private String code;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/member/app/user/vo/AppMemberUserUpdateReqVO.java

+package org.dromara.mall.controller.member.app.user.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import org.hibernate.validator.constraints.URL;
+
+@Schema(description = "用户 App - 会员用户更新 Request VO")
+@Data
+public class AppMemberUserUpdateReqVO {
+
+    @Schema(description = "用户昵称", requiredMode = Schema.RequiredMode.REQUIRED, example = "李四")
+    private String nickname;
+
+    @Schema(description = "头像", requiredMode = Schema.RequiredMode.REQUIRED, example = "https://www.iocoder.cn/x.png")
+    @URL(message = "头像必须是 URL 格式")
+    private String avatar;
+
+    @Schema(description = "性别", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer sex;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/pay/admin/app/PayAppController.java

+package org.dromara.mall.controller.pay.admin.app;
+
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import cn.hutool.core.collection.CollUtil;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import lombok.extern.slf4j.Slf4j;
+import org.dromara.common.core.domain.R;
+import org.dromara.common.mall.enums.CommonStatusEnum;
+import org.dromara.common.mybatis.core.page.PageResult;
+import org.dromara.mall.controller.pay.admin.app.vo.*;
+import org.dromara.mall.convert.pay.PayAppConvert;
+import org.dromara.mall.domain.pay.PayAppDO;
+import org.dromara.mall.domain.pay.PayChannelDO;
+import org.dromara.mall.service.pay.PayAppService;
+import org.dromara.mall.service.pay.PayChannelService;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+import static org.dromara.common.mall.util.collection.CollectionUtils.convertList;
+
+
+@Slf4j
+@Tag(name = "管理后台 - 支付应用信息")
+@RestController
+@RequestMapping("/admin/pay/app")
+@Validated
+public class PayAppController {
+
+    @Resource
+    private PayAppService appService;
+    @Resource
+    private PayChannelService channelService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建支付应用信息")
+    @SaCheckPermission("pay:app:create")
+    public R<Long> createApp(@Valid @RequestBody PayAppCreateReqVO createReqVO) {
+        return R.ok(appService.createApp(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新支付应用信息")
+    @SaCheckPermission("pay:app:update")
+    public R<Boolean> updateApp(@Valid @RequestBody PayAppUpdateReqVO updateReqVO) {
+        appService.updateApp(updateReqVO);
+        return R.ok(true);
+    }
+
+    @PutMapping("/update-status")
+    @Operation(summary = "更新支付应用状态")
+    @SaCheckPermission("pay:app:update")
+    public R<Boolean> updateAppStatus(@Valid @RequestBody PayAppUpdateStatusReqVO updateReqVO) {
+        appService.updateAppStatus(updateReqVO.getId(), updateReqVO.getStatus());
+        return R.ok(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除支付应用信息")
+    @Parameter(name = "id", description = "编号", required = true)
+    @SaCheckPermission("pay:app:delete")
+    public R<Boolean> deleteApp(@RequestParam("id") Long id) {
+        appService.deleteApp(id);
+        return R.ok(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得支付应用信息")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @SaCheckPermission("pay:app:query")
+    public R<PayAppRespVO> getApp(@RequestParam("id") Long id) {
+        PayAppDO app = appService.getApp(id);
+        return R.ok(PayAppConvert.INSTANCE.convert(app));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得支付应用信息分页")
+    @SaCheckPermission("pay:app:query")
+    public R<PageResult<PayAppPageItemRespVO>> getAppPage(@Valid PayAppPageReqVO pageVO) {
+        // 得到应用分页列表
+        PageResult<PayAppDO> pageResult = appService.getAppPage(pageVO);
+        if (CollUtil.isEmpty(pageResult.getList())) {
+            return R.ok(PageResult.empty());
+        }
+
+        // 得到所有的应用编号，查出所有的渠道，并移除未启用的渠道
+        List<PayChannelDO> channels = channelService.getChannelListByAppIds(
+                convertList(pageResult.getList(), PayAppDO::getId));
+        channels.removeIf(channel -> !CommonStatusEnum.ENABLE.getStatus().equals(channel.getStatus()));
+
+        // 拼接后返回
+        return R.ok(PayAppConvert.INSTANCE.convertPage(pageResult, channels));
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得应用列表")
+    @SaCheckPermission("pay:merchant:query")
+    public R<List<PayAppRespVO>> getAppList() {
+        List<PayAppDO> appListDO = appService.getAppList();
+        return R.ok(PayAppConvert.INSTANCE.convertList(appListDO));
+    }
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/pay/admin/app/vo/PayAppBaseVO.java

+package org.dromara.mall.controller.pay.admin.app.vo;
+
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import org.dromara.common.mall.enums.CommonStatusEnum;
+import org.dromara.common.mall.validation.InEnum;
+import org.hibernate.validator.constraints.URL;
+
+/**
+* 支付应用信息 Base VO，提供给添加、修改、详细的子 VO 使用
+* 如果子 VO 存在差异的字段，请不要添加到这里，影响 Swagger 文档生成
+*/
+@Data
+public class PayAppBaseVO {
+
+    @Schema(description = "应用标识", requiredMode = Schema.RequiredMode.REQUIRED, example = "yudao")
+    @NotEmpty(message = "应用标识不能为空")
+    private String appKey;
+
+    @Schema(description = "应用名", requiredMode = Schema.RequiredMode.REQUIRED, example = "小豆")
+    @NotNull(message = "应用名不能为空")
+    private String name;
+
+    @Schema(description = "开启状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    @NotNull(message = "开启状态不能为空")
+    @InEnum(CommonStatusEnum.class)
+    private Integer status;
+
+    @Schema(description = "备注", example = "我是一个测试应用")
+    private String remark;
+
+    @Schema(description = "支付结果的回调地址", requiredMode = Schema.RequiredMode.REQUIRED, example = "http://127.0.0.1:48080/pay-callback")
+    @NotNull(message = "支付结果的回调地址不能为空")
+    @URL(message = "支付结果的回调地址必须为 URL 格式")
+    private String orderNotifyUrl;
+
+    @Schema(description = "退款结果的回调地址", requiredMode = Schema.RequiredMode.REQUIRED, example = "http://127.0.0.1:48080/refund-callback")
+    @NotNull(message = "退款结果的回调地址不能为空")
+    @URL(message = "退款结果的回调地址必须为 URL 格式")
+    private String refundNotifyUrl;
+
+    @Schema(description = "转账结果的回调地址", example = "http://127.0.0.1:48080/transfer-callback")
+    @URL(message = "转账结果的回调地址必须为 URL 格式")
+    private String transferNotifyUrl;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/pay/admin/app/vo/PayAppCreateReqVO.java

+package org.dromara.mall.controller.pay.admin.app.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - 支付应用信息创建 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class PayAppCreateReqVO extends PayAppBaseVO {
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/pay/admin/app/vo/PayAppPageItemRespVO.java

+package org.dromara.mall.controller.pay.admin.app.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+import java.util.Set;
+
+@Schema(description = "管理后台 - 支付应用信息分页查询 Response VO,相比于支付信息，还会多出应用渠道的开关信息")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class PayAppPageItemRespVO extends PayAppBaseVO {
+
+    @Schema(description = "应用编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+    @Schema(description = "已配置的支付渠道编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "[alipay_pc, alipay_wap]")
+    private Set<String> channelCodes;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/pay/admin/app/vo/PayAppPageReqVO.java

+package org.dromara.mall.controller.pay.admin.app.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+import org.dromara.common.mybatis.core.page.PageParam;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+import static org.dromara.common.mall.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+
+@Schema(description = "管理后台 - 支付应用信息分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class PayAppPageReqVO extends PageParam {
+
+    @Schema(description = "应用名", example = "小豆")
+    private String name;
+
+    @Schema(description = "应用标识", example = "yudao")
+    private String appKey;
+
+    @Schema(description = "开启状态", example = "0")
+    private Integer status;
+
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    @Schema(description = "创建时间")
+    private LocalDateTime[] createTime;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/pay/admin/app/vo/PayAppRespVO.java

+package org.dromara.mall.controller.pay.admin.app.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 支付应用信息 Response VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class PayAppRespVO extends PayAppBaseVO {
+
+    @Schema(description = "应用编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "应用标识", requiredMode = Schema.RequiredMode.REQUIRED, example = "yudao")
+    private String appKey;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}

ruoyi-modules/ruoyi-mall/src/main/java/org/dromara/mall/controller/pay/admin/app/vo/PayAppUpdateReqVO.java

+package org.dromara.mall.controller.pay.admin.app.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - 支付应用信息更新 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class PayAppUpdateReqVO extends PayAppBaseVO {
+
+    @Schema(description = "应用编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "应用编号不能为空")
+    private Long id;
+
+}