fix(tenant): 限制一级代理下级沿用分成比例

新增 handleWithdrawRefund 逻辑，当状态为 REJECTED/CANCELED/FAILED 时自动返还冻结金额至可提现余额并生成对应流水。

CLAUDE.md

@@ -67,6 +67,7 @@ The project uses a **modular monolith** architecture with the following key modu
   - `yolo-spring-boot-starter-biz-*`: Business-specific components (tenant, data permission, IP)
 - **yolo-module-system**: System management module (users, roles, permissions, dictionaries)
 - **yolo-module-infra**: Infrastructure module (jobs, file storage, code generator, monitoring)
+- **keyboard-server**: Business module for keyboard-specific features (custom controllers, services, DAL)
 - **yolo-server**: Main application container (empty shell that aggregates modules)
 
 ### Layered Architecture
@@ -104,30 +105,17 @@ enums/          # Module-specific enums
 - Connection: `jdbc:postgresql://localhost:5432/keyborad_db`
 - Default credentials: root/123asd
 
-### Database Scripts
-SQL scripts are located in `sql/` directory with support for multiple databases:
-- `sql/postgresql/` - PostgreSQL scripts
-- `sql/mysql/` - MySQL scripts
-- `sql/oracle/`, `sql/sqlserver/`, `sql/dm/`, `sql/kingbase/`, `sql/opengauss/` - Other DB support
-
-### Database Conversion
-Use `sql/tools/convertor.py` to convert MySQL scripts to other databases:
-```bash
-cd sql/tools
-python3 convertor.py postgres > output.sql
-```
-
 ### Quick Database Setup with Docker
 ```bash
-cd sql/tools
+cd script/docker
-docker compose up -d postgres
+docker compose up -d
 ```
 
 ## Configuration
 
 ### Application Profiles
 - `application.yaml` - Base configuration
-- `application-local.yaml` - Local development (port 48080)
+- `application-local.yaml` - Local development (port 48081)
 - `application-dev.yaml` - Development environment
 
 ### Key Configuration Properties
@@ -174,15 +162,15 @@ Configured via `spring.datasource.dynamic.datasource`:
 
 ## API Documentation
 
-- **Swagger UI**: http://localhost:48080/swagger-ui
+- **Swagger UI**: http://localhost:48081/swagger-ui
-- **Knife4j UI**: http://localhost:48080/doc.html (enhanced Swagger UI)
+- **Knife4j UI**: http://localhost:48081/doc.html (enhanced Swagger UI)
-- **OpenAPI JSON**: http://localhost:48080/v3/api-docs
+- **OpenAPI JSON**: http://localhost:48081/v3/api-docs
 
 ## Monitoring & Admin
 
-- **Spring Boot Admin**: http://localhost:48080/admin
+- **Spring Boot Admin**: http://localhost:48081/admin
-- **Actuator**: http://localhost:48080/actuator
+- **Actuator**: http://localhost:48081/actuator
-- **Druid Monitor**: http://localhost:48080/druid (database connection pool)
+- **Druid Monitor**: http://localhost:48081/druid (database connection pool)
 
 ## Common Issues
 
@@ -193,7 +181,7 @@ If you encounter startup issues, refer to: https://doc.iocoder.cn/quick-start/
 Ensure PostgreSQL is running and credentials in `application-local.yaml` are correct.
 
 ### Port Conflicts
-Default port is 48080. Change via `server.port` in configuration files.
+Default port is 48081. Change via `server.port` in configuration files.
 
 ## Dependencies & Versions
 

keyboard-server/pom.xml

@@ -52,5 +52,11 @@
             <version>2025.11-SNAPSHOT</version>
             <scope>compile</scope>
         </dependency>
+        <dependency>
+            <groupId>com.yolo</groupId>
+            <artifactId>yolo-module-system</artifactId>
+            <version>2025.11-SNAPSHOT</version>
+            <scope>compile</scope>
+        </dependency>
     </dependencies>
 </project>

keyboard-server/src/main/java/com/yolo/keyboard/api/invitecode/UserInviteCodeApiImpl.java

@@ -0,0 +1,55 @@
+package com.yolo.keyboard.api.invitecode;
+
+import cn.hutool.core.util.RandomUtil;
+import com.yolo.keyboard.dal.dataobject.userinvitecodes.KeyboardUserInviteCodesDO;
+import com.yolo.keyboard.dal.mysql.userinvitecodes.KeyboardUserInviteCodesMapper;
+import com.yolo.keyboard.module.system.api.invitecode.UserInviteCodeApi;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+
+import java.time.LocalDateTime;
+
+/**
+ * 用户邀请码 API 实现类
+ *
+ * @author ziin
+ */
+@Service
+public class UserInviteCodeApiImpl implements UserInviteCodeApi {
+
+    @Resource
+    private KeyboardUserInviteCodesMapper userInviteCodesMapper;
+
+    @Override
+    public String createInviteCodeForAgent(Long userId, Long tenantId) {
+        String inviteCode = generateUniqueInviteCode();
+        KeyboardUserInviteCodesDO inviteCodeDO = KeyboardUserInviteCodesDO.builder()
+                .code(inviteCode)
+                .ownerSystemUserId(userId)
+                .ownerTenantId(tenantId)
+                .status((short) 1)
+                .createdAt(LocalDateTime.now())
+                .usedCount(0)
+                .inviteType("AGENT")
+                .build();
+        userInviteCodesMapper.insert(inviteCodeDO);
+        return inviteCode;
+    }
+
+    /**
+     * 生成唯一的6位邀请码（字母和数字混合）
+     */
+    private String generateUniqueInviteCode() {
+        String code;
+        int maxAttempts = 100;
+        int attempt = 0;
+        do {
+            code = RandomUtil.randomString("ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789", 6);
+            attempt++;
+            if (attempt >= maxAttempts) {
+                throw new RuntimeException("无法生成唯一的邀请码，请稍后重试");
+            }
+        } while (userInviteCodesMapper.selectOne(KeyboardUserInviteCodesDO::getCode, code) != null);
+        return code;
+    }
+}

keyboard-server/src/main/java/com/yolo/keyboard/api/tenantbalance/TenantBalanceApiImpl.java

@@ -0,0 +1,44 @@
+package com.yolo.keyboard.api.tenantbalance;
+
+import com.yolo.keyboard.dal.dataobject.tenantbalance.TenantBalanceDO;
+import com.yolo.keyboard.dal.mysql.tenantbalance.TenantBalanceMapper;
+import com.yolo.keyboard.module.system.api.tenantbalance.TenantBalanceApi;
+import jakarta.annotation.Resource;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import java.math.BigDecimal;
+
+/**
+ * 租户余额 API 实现类
+ *
+ * @author ziin
+ */
+@Service
+@Slf4j
+public class TenantBalanceApiImpl implements TenantBalanceApi {
+
+    @Resource
+    private TenantBalanceMapper tenantBalanceMapper;
+
+    @Override
+    public void initTenantBalance(Long tenantId) {
+        // 检查是否已存在
+        TenantBalanceDO existingBalance = tenantBalanceMapper.selectById(tenantId);
+        if (existingBalance != null) {
+            log.info("[initTenantBalance] 租户 {} 钱包已存在，跳过初始化", tenantId);
+            return;
+        }
+
+        // 初始化租户钱包
+        TenantBalanceDO balance = new TenantBalanceDO();
+        balance.setId(tenantId);
+        balance.setBalance(BigDecimal.ZERO);
+        balance.setWithdrawableBalance(BigDecimal.ZERO);
+        balance.setFrozenAmt(BigDecimal.ZERO);
+        balance.setVersion(0);
+        tenantBalanceMapper.insert(balance);
+
+        log.info("[initTenantBalance] 租户 {} 钱包初始化成功", tenantId);
+    }
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/i18nmessage/KeyboardI18nMessageController.java

@@ -0,0 +1,104 @@
+package com.yolo.keyboard.controller.admin.i18nmessage;
+
+import org.springframework.web.bind.annotation.*;
+import jakarta.annotation.Resource;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.security.access.prepost.PreAuthorize;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Operation;
+
+import jakarta.validation.constraints.*;
+import jakarta.validation.*;
+import jakarta.servlet.http.*;
+import java.util.*;
+import java.io.IOException;
+
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.CommonResult;
+import com.yolo.keyboard.framework.common.util.object.BeanUtils;
+import static com.yolo.keyboard.framework.common.pojo.CommonResult.success;
+
+import com.yolo.keyboard.framework.excel.core.util.ExcelUtils;
+
+import com.yolo.keyboard.framework.apilog.core.annotation.ApiAccessLog;
+import static com.yolo.keyboard.framework.apilog.core.enums.OperateTypeEnum.*;
+
+import com.yolo.keyboard.controller.admin.i18nmessage.vo.*;
+import com.yolo.keyboard.dal.dataobject.i18nmessage.KeyboardI18nMessageDO;
+import com.yolo.keyboard.service.i18nmessage.KeyboardI18nMessageService;
+
+@Tag(name = "管理后台 - 国际化错误提醒配置")
+@RestController
+@RequestMapping("/keyboard/I18n-message")
+@Validated
+public class KeyboardI18nMessageController {
+
+    @Resource
+    private KeyboardI18nMessageService i18nMessageService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建国际化错误提醒配置")
+    @PreAuthorize("@ss.hasPermission('keyboard:I18n-message:create')")
+    public CommonResult<Long> createI18nMessage(@Valid @RequestBody KeyboardI18nMessageSaveReqVO createReqVO) {
+        return success(i18nMessageService.createI18nMessage(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新国际化错误提醒配置")
+    @PreAuthorize("@ss.hasPermission('keyboard:I18n-message:update')")
+    public CommonResult<Boolean> updateI18nMessage(@Valid @RequestBody KeyboardI18nMessageSaveReqVO updateReqVO) {
+        i18nMessageService.updateI18nMessage(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除国际化错误提醒配置")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('keyboard:I18n-message:delete')")
+    public CommonResult<Boolean> deleteI18nMessage(@RequestParam("id") Long id) {
+        i18nMessageService.deleteI18nMessage(id);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete-list")
+    @Parameter(name = "ids", description = "编号", required = true)
+    @Operation(summary = "批量删除国际化错误提醒配置")
+                @PreAuthorize("@ss.hasPermission('keyboard:I18n-message:delete')")
+    public CommonResult<Boolean> deleteI18nMessageList(@RequestParam("ids") List<Long> ids) {
+        i18nMessageService.deleteI18nMessageListByIds(ids);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得国际化错误提醒配置")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('keyboard:I18n-message:query')")
+    public CommonResult<KeyboardI18nMessageRespVO> getI18nMessage(@RequestParam("id") Long id) {
+        KeyboardI18nMessageDO i18nMessage = i18nMessageService.getI18nMessage(id);
+        return success(BeanUtils.toBean(i18nMessage, KeyboardI18nMessageRespVO.class));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得国际化错误提醒配置分页")
+    @PreAuthorize("@ss.hasPermission('keyboard:I18n-message:query')")
+    public CommonResult<PageResult<KeyboardI18nMessageRespVO>> getI18nMessagePage(@Valid KeyboardI18nMessagePageReqVO pageReqVO) {
+        PageResult<KeyboardI18nMessageDO> pageResult = i18nMessageService.getI18nMessagePage(pageReqVO);
+        return success(BeanUtils.toBean(pageResult, KeyboardI18nMessageRespVO.class));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出国际化错误提醒配置 Excel")
+    @PreAuthorize("@ss.hasPermission('keyboard:I18n-message:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportI18nMessageExcel(@Valid KeyboardI18nMessagePageReqVO pageReqVO,
+              HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<KeyboardI18nMessageDO> list = i18nMessageService.getI18nMessagePage(pageReqVO).getList();
+        // 导出 Excel
+        ExcelUtils.write(response, "国际化错误提醒配置.xls", "数据", KeyboardI18nMessageRespVO.class,
+                        BeanUtils.toBean(list, KeyboardI18nMessageRespVO.class));
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/i18nmessage/vo/KeyboardI18nMessagePageReqVO.java

@@ -0,0 +1,21 @@
+package com.yolo.keyboard.controller.admin.i18nmessage.vo;
+
+import lombok.*;
+import java.util.*;
+import io.swagger.v3.oas.annotations.media.Schema;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+
+@Schema(description = "管理后台 - 国际化错误提醒配置分页 Request VO")
+@Data
+public class KeyboardI18nMessagePageReqVO extends PageParam {
+
+    @Schema(description = "错误代码")
+    private String code;
+
+    @Schema(description = "地区")
+    private String locale;
+
+    @Schema(description = "错误提醒")
+    private String message;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/i18nmessage/vo/KeyboardI18nMessageRespVO.java

@@ -0,0 +1,29 @@
+package com.yolo.keyboard.controller.admin.i18nmessage.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+import java.util.*;
+import cn.idev.excel.annotation.*;
+
+@Schema(description = "管理后台 - 国际化错误提醒配置 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class KeyboardI18nMessageRespVO {
+
+    @Schema(description = "主键 id", requiredMode = Schema.RequiredMode.REQUIRED, example = "18823")
+    @ExcelProperty("主键 id")
+    private Long id;
+
+    @Schema(description = "错误代码", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("错误代码")
+    private String code;
+
+    @Schema(description = "地区", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("地区")
+    private String locale;
+
+    @Schema(description = "错误提醒", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("错误提醒")
+    private String message;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/i18nmessage/vo/KeyboardI18nMessageSaveReqVO.java

@@ -0,0 +1,27 @@
+package com.yolo.keyboard.controller.admin.i18nmessage.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+import java.util.*;
+import jakarta.validation.constraints.*;
+
+@Schema(description = "管理后台 - 国际化错误提醒配置新增/修改 Request VO")
+@Data
+public class KeyboardI18nMessageSaveReqVO {
+
+    @Schema(description = "主键 id", requiredMode = Schema.RequiredMode.REQUIRED, example = "18823")
+    private Long id;
+
+    @Schema(description = "错误代码", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "错误代码不能为空")
+    private String code;
+
+    @Schema(description = "地区", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "地区不能为空")
+    private String locale;
+
+    @Schema(description = "错误提醒", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "错误提醒不能为空")
+    private String message;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/productitems/KeyboardProductItemsController.java

@@ -0,0 +1,104 @@
+package com.yolo.keyboard.controller.admin.productitems;
+
+import org.springframework.web.bind.annotation.*;
+import jakarta.annotation.Resource;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.security.access.prepost.PreAuthorize;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Operation;
+
+import jakarta.validation.constraints.*;
+import jakarta.validation.*;
+import jakarta.servlet.http.*;
+import java.util.*;
+import java.io.IOException;
+
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.CommonResult;
+import com.yolo.keyboard.framework.common.util.object.BeanUtils;
+import static com.yolo.keyboard.framework.common.pojo.CommonResult.success;
+
+import com.yolo.keyboard.framework.excel.core.util.ExcelUtils;
+
+import com.yolo.keyboard.framework.apilog.core.annotation.ApiAccessLog;
+import static com.yolo.keyboard.framework.apilog.core.enums.OperateTypeEnum.*;
+
+import com.yolo.keyboard.controller.admin.productitems.vo.*;
+import com.yolo.keyboard.dal.dataobject.productitems.KeyboardProductItemsDO;
+import com.yolo.keyboard.service.productitems.KeyboardProductItemsService;
+
+@Tag(name = "管理后台 - 内购商品")
+@RestController
+@RequestMapping("/keyboard/product-items")
+@Validated
+public class KeyboardProductItemsController {
+
+    @Resource
+    private KeyboardProductItemsService productItemsService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建内购商品")
+    @PreAuthorize("@ss.hasPermission('keyboard:product-items:create')")
+    public CommonResult<Long> createProductItems(@Valid @RequestBody KeyboardProductItemsSaveReqVO createReqVO) {
+        return success(productItemsService.createProductItems(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新内购商品")
+    @PreAuthorize("@ss.hasPermission('keyboard:product-items:update')")
+    public CommonResult<Boolean> updateProductItems(@Valid @RequestBody KeyboardProductItemsSaveReqVO updateReqVO) {
+        productItemsService.updateProductItems(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除内购商品")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('keyboard:product-items:delete')")
+    public CommonResult<Boolean> deleteProductItems(@RequestParam("id") Long id) {
+        productItemsService.deleteProductItems(id);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete-list")
+    @Parameter(name = "ids", description = "编号", required = true)
+    @Operation(summary = "批量删除内购商品")
+                @PreAuthorize("@ss.hasPermission('keyboard:product-items:delete')")
+    public CommonResult<Boolean> deleteProductItemsList(@RequestParam("ids") List<Long> ids) {
+        productItemsService.deleteProductItemsListByIds(ids);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得内购商品")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('keyboard:product-items:query')")
+    public CommonResult<KeyboardProductItemsRespVO> getProductItems(@RequestParam("id") Long id) {
+        KeyboardProductItemsDO productItems = productItemsService.getProductItems(id);
+        return success(BeanUtils.toBean(productItems, KeyboardProductItemsRespVO.class));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得内购商品分页")
+    @PreAuthorize("@ss.hasPermission('keyboard:product-items:query')")
+    public CommonResult<PageResult<KeyboardProductItemsRespVO>> getProductItemsPage(@Valid KeyboardProductItemsPageReqVO pageReqVO) {
+        PageResult<KeyboardProductItemsDO> pageResult = productItemsService.getProductItemsPage(pageReqVO);
+        return success(BeanUtils.toBean(pageResult, KeyboardProductItemsRespVO.class));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出内购商品 Excel")
+    @PreAuthorize("@ss.hasPermission('keyboard:product-items:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportProductItemsExcel(@Valid KeyboardProductItemsPageReqVO pageReqVO,
+              HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<KeyboardProductItemsDO> list = productItemsService.getProductItemsPage(pageReqVO).getList();
+        // 导出 Excel
+        ExcelUtils.write(response, "内购商品.xls", "数据", KeyboardProductItemsRespVO.class,
+                        BeanUtils.toBean(list, KeyboardProductItemsRespVO.class));
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/productitems/vo/KeyboardProductItemsPageReqVO.java

@@ -0,0 +1,53 @@
+package com.yolo.keyboard.controller.admin.productitems.vo;
+
+import lombok.*;
+import java.util.*;
+import io.swagger.v3.oas.annotations.media.Schema;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import java.math.BigDecimal;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+import static com.yolo.keyboard.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - 内购商品分页 Request VO")
+@Data
+public class KeyboardProductItemsPageReqVO extends PageParam {
+
+    @Schema(description = "产品标识符，唯一标识每个产品（如 com.loveKey.nyx.2month）", example = "15153")
+    private String productId;
+
+    @Schema(description = "产品类型，区分订阅（subscription）和内购（in-app-purchase）", example = "1")
+    private String type;
+
+    @Schema(description = "产品名称（如 100, 2）", example = "芋艿")
+    private String name;
+
+    @Schema(description = "产品单位（如 金币，个月）")
+    private String unit;
+
+    @Schema(description = "订阅时长的数值部分（如 2）")
+    private Integer durationValue;
+
+    @Schema(description = "订阅时长的单位部分（如 月，天）")
+    private String durationUnit;
+
+    @Schema(description = "产品价格", example = "25376")
+    private BigDecimal price;
+
+    @Schema(description = "产品的货币单位，如美元（$）")
+    private String currency;
+
+    @Schema(description = "产品的描述，提供更多细节信息", example = "你说的对")
+    private String description;
+
+    @Schema(description = "产品项的创建时间，默认当前时间")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "产品项的最后更新时间，更新时自动设置为当前时间")
+    private LocalDateTime updatedAt;
+
+    @Schema(description = "订阅时长的具体天数")
+    private Integer durationDays;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/productitems/vo/KeyboardProductItemsRespVO.java

@@ -0,0 +1,68 @@
+package com.yolo.keyboard.controller.admin.productitems.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+import java.util.*;
+import java.math.BigDecimal;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+import cn.idev.excel.annotation.*;
+
+@Schema(description = "管理后台 - 内购商品 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class KeyboardProductItemsRespVO {
+
+    @Schema(description = "主键，自增，唯一标识每个产品项", requiredMode = Schema.RequiredMode.REQUIRED, example = "7855")
+    @ExcelProperty("主键，自增，唯一标识每个产品项")
+    private Long id;
+
+    @Schema(description = "产品标识符，唯一标识每个产品（如 com.loveKey.nyx.2month）", requiredMode = Schema.RequiredMode.REQUIRED, example = "15153")
+    @ExcelProperty("产品标识符，唯一标识每个产品（如 com.loveKey.nyx.2month）")
+    private String productId;
+
+    @Schema(description = "产品类型，区分订阅（subscription）和内购（in-app-purchase）", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @ExcelProperty("产品类型，区分订阅（subscription）和内购（in-app-purchase）")
+    private String type;
+
+    @Schema(description = "产品名称（如 100, 2）", requiredMode = Schema.RequiredMode.REQUIRED, example = "芋艿")
+    @ExcelProperty("产品名称（如 100, 2）")
+    private String name;
+
+    @Schema(description = "产品单位（如 金币，个月）")
+    @ExcelProperty("产品单位（如 金币，个月）")
+    private String unit;
+
+    @Schema(description = "订阅时长的数值部分（如 2）")
+    @ExcelProperty("订阅时长的数值部分（如 2）")
+    private Integer durationValue;
+
+    @Schema(description = "订阅时长的单位部分（如 月，天）")
+    @ExcelProperty("订阅时长的单位部分（如 月，天）")
+    private String durationUnit;
+
+    @Schema(description = "产品价格", requiredMode = Schema.RequiredMode.REQUIRED, example = "25376")
+    @ExcelProperty("产品价格")
+    private BigDecimal price;
+
+    @Schema(description = "产品的货币单位，如美元（$）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("产品的货币单位，如美元（$）")
+    private String currency;
+
+    @Schema(description = "产品的描述，提供更多细节信息", example = "你说的对")
+    @ExcelProperty("产品的描述，提供更多细节信息")
+    private String description;
+
+    @Schema(description = "产品项的创建时间，默认当前时间")
+    @ExcelProperty("产品项的创建时间，默认当前时间")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "产品项的最后更新时间，更新时自动设置为当前时间")
+    @ExcelProperty("产品项的最后更新时间，更新时自动设置为当前时间")
+    private LocalDateTime updatedAt;
+
+    @Schema(description = "订阅时长的具体天数", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("订阅时长的具体天数")
+    private Integer durationDays;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/productitems/vo/KeyboardProductItemsSaveReqVO.java

@@ -0,0 +1,60 @@
+package com.yolo.keyboard.controller.admin.productitems.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+import java.util.*;
+import jakarta.validation.constraints.*;
+import java.math.BigDecimal;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 内购商品新增/修改 Request VO")
+@Data
+public class KeyboardProductItemsSaveReqVO {
+
+    @Schema(description = "主键，自增，唯一标识每个产品项", requiredMode = Schema.RequiredMode.REQUIRED, example = "7855")
+    private Long id;
+
+    @Schema(description = "产品标识符，唯一标识每个产品（如 com.loveKey.nyx.2month）", requiredMode = Schema.RequiredMode.REQUIRED, example = "15153")
+    @NotEmpty(message = "产品标识符，唯一标识每个产品（如 com.loveKey.nyx.2month）不能为空")
+    private String productId;
+
+    @Schema(description = "产品类型，区分订阅（subscription）和内购（in-app-purchase）", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotEmpty(message = "产品类型，区分订阅（subscription）和内购（in-app-purchase）不能为空")
+    private String type;
+
+    @Schema(description = "产品名称（如 100, 2）", requiredMode = Schema.RequiredMode.REQUIRED, example = "芋艿")
+    @NotEmpty(message = "产品名称（如 100, 2）不能为空")
+    private String name;
+
+    @Schema(description = "产品单位（如 金币，个月）")
+    private String unit;
+
+    @Schema(description = "订阅时长的数值部分（如 2）")
+    private Integer durationValue;
+
+    @Schema(description = "订阅时长的单位部分（如 月，天）")
+    private String durationUnit;
+
+    @Schema(description = "产品价格", requiredMode = Schema.RequiredMode.REQUIRED, example = "25376")
+    @NotNull(message = "产品价格不能为空")
+    private BigDecimal price;
+
+    @Schema(description = "产品的货币单位，如美元（$）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "产品的货币单位，如美元（$）不能为空")
+    private String currency;
+
+    @Schema(description = "产品的描述，提供更多细节信息", example = "你说的对")
+    private String description;
+
+    @Schema(description = "产品项的创建时间，默认当前时间")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "产品项的最后更新时间，更新时自动设置为当前时间")
+    private LocalDateTime updatedAt;
+
+    @Schema(description = "订阅时长的具体天数", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "订阅时长的具体天数不能为空")
+    private Integer durationDays;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tag/KeyboardTagController.java

@@ -0,0 +1,104 @@
+package com.yolo.keyboard.controller.admin.tag;
+
+import org.springframework.web.bind.annotation.*;
+import jakarta.annotation.Resource;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.security.access.prepost.PreAuthorize;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Operation;
+
+import jakarta.validation.constraints.*;
+import jakarta.validation.*;
+import jakarta.servlet.http.*;
+import java.util.*;
+import java.io.IOException;
+
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.CommonResult;
+import com.yolo.keyboard.framework.common.util.object.BeanUtils;
+import static com.yolo.keyboard.framework.common.pojo.CommonResult.success;
+
+import com.yolo.keyboard.framework.excel.core.util.ExcelUtils;
+
+import com.yolo.keyboard.framework.apilog.core.annotation.ApiAccessLog;
+import static com.yolo.keyboard.framework.apilog.core.enums.OperateTypeEnum.*;
+
+import com.yolo.keyboard.controller.admin.tag.vo.*;
+import com.yolo.keyboard.dal.dataobject.tag.KeyboardTagDO;
+import com.yolo.keyboard.service.tag.KeyboardTagService;
+
+@Tag(name = "管理后台 - 人设标签")
+@RestController
+@RequestMapping("/keyboard/tag")
+@Validated
+public class KeyboardTagController {
+
+    @Resource
+    private KeyboardTagService tagService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建人设标签")
+    @PreAuthorize("@ss.hasPermission('keyboard:tag:create')")
+    public CommonResult<Integer> createTag(@Valid @RequestBody KeyboardTagSaveReqVO createReqVO) {
+        return success(tagService.createTag(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新人设标签")
+    @PreAuthorize("@ss.hasPermission('keyboard:tag:update')")
+    public CommonResult<Boolean> updateTag(@Valid @RequestBody KeyboardTagSaveReqVO updateReqVO) {
+        tagService.updateTag(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除人设标签")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('keyboard:tag:delete')")
+    public CommonResult<Boolean> deleteTag(@RequestParam("id") Integer id) {
+        tagService.deleteTag(id);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete-list")
+    @Parameter(name = "ids", description = "编号", required = true)
+    @Operation(summary = "批量删除人设标签")
+                @PreAuthorize("@ss.hasPermission('keyboard:tag:delete')")
+    public CommonResult<Boolean> deleteTagList(@RequestParam("ids") List<Integer> ids) {
+        tagService.deleteTagListByIds(ids);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得人设标签")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('keyboard:tag:query')")
+    public CommonResult<KeyboardTagRespVO> getTag(@RequestParam("id") Integer id) {
+        KeyboardTagDO tag = tagService.getTag(id);
+        return success(BeanUtils.toBean(tag, KeyboardTagRespVO.class));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得人设标签分页")
+    @PreAuthorize("@ss.hasPermission('keyboard:tag:query')")
+    public CommonResult<PageResult<KeyboardTagRespVO>> getTagPage(@Valid KeyboardTagPageReqVO pageReqVO) {
+        PageResult<KeyboardTagDO> pageResult = tagService.getTagPage(pageReqVO);
+        return success(BeanUtils.toBean(pageResult, KeyboardTagRespVO.class));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出人设标签 Excel")
+    @PreAuthorize("@ss.hasPermission('keyboard:tag:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportTagExcel(@Valid KeyboardTagPageReqVO pageReqVO,
+              HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<KeyboardTagDO> list = tagService.getTagPage(pageReqVO).getList();
+        // 导出 Excel
+        ExcelUtils.write(response, "人设标签.xls", "数据", KeyboardTagRespVO.class,
+                        BeanUtils.toBean(list, KeyboardTagRespVO.class));
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tag/vo/KeyboardTagPageReqVO.java

@@ -0,0 +1,25 @@
+package com.yolo.keyboard.controller.admin.tag.vo;
+
+import lombok.*;
+import java.util.*;
+import io.swagger.v3.oas.annotations.media.Schema;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+import static com.yolo.keyboard.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - 人设标签分页 Request VO")
+@Data
+public class KeyboardTagPageReqVO extends PageParam {
+
+    @Schema(description = "标签名", example = "王五")
+    private String tagName;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "更新时间")
+    private LocalDateTime updatedAt;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tag/vo/KeyboardTagRespVO.java

@@ -0,0 +1,31 @@
+package com.yolo.keyboard.controller.admin.tag.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+import java.util.*;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+import cn.idev.excel.annotation.*;
+
+@Schema(description = "管理后台 - 人设标签 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class KeyboardTagRespVO {
+
+    @Schema(description = "主键 Id", requiredMode = Schema.RequiredMode.REQUIRED, example = "20413")
+    @ExcelProperty("主键 Id")
+    private Integer id;
+
+    @Schema(description = "标签名", example = "王五")
+    @ExcelProperty("标签名")
+    private String tagName;
+
+    @Schema(description = "创建时间")
+    @ExcelProperty("创建时间")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "更新时间")
+    @ExcelProperty("更新时间")
+    private LocalDateTime updatedAt;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tag/vo/KeyboardTagSaveReqVO.java

@@ -0,0 +1,26 @@
+package com.yolo.keyboard.controller.admin.tag.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+import java.util.*;
+import jakarta.validation.constraints.*;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 人设标签新增/修改 Request VO")
+@Data
+public class KeyboardTagSaveReqVO {
+
+    @Schema(description = "主键 Id", requiredMode = Schema.RequiredMode.REQUIRED, example = "20413")
+    private Integer id;
+
+    @Schema(description = "标签名", example = "王五")
+    private String tagName;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "更新时间")
+    private LocalDateTime updatedAt;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tenantbalance/TenantBalanceController.java

@@ -0,0 +1,191 @@
+package com.yolo.keyboard.controller.admin.tenantbalance;
+
+import com.yolo.keyboard.dal.dataobject.tenantbalancetransaction.TenantBalanceTransactionDO;
+import org.springframework.web.bind.annotation.*;
+import jakarta.annotation.Resource;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.security.access.prepost.PreAuthorize;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Operation;
+
+import jakarta.validation.constraints.*;
+import jakarta.validation.*;
+import jakarta.servlet.http.*;
+import java.util.*;
+import java.io.IOException;
+
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.CommonResult;
+import com.yolo.keyboard.framework.common.util.object.BeanUtils;
+import static com.yolo.keyboard.framework.common.pojo.CommonResult.success;
+
+import com.yolo.keyboard.framework.excel.core.util.ExcelUtils;
+
+import com.yolo.keyboard.framework.apilog.core.annotation.ApiAccessLog;
+import static com.yolo.keyboard.framework.apilog.core.enums.OperateTypeEnum.*;
+
+import com.yolo.keyboard.controller.admin.tenantbalance.vo.*;
+import com.yolo.keyboard.dal.dataobject.tenantbalance.TenantBalanceDO;
+import com.yolo.keyboard.service.tenantbalance.TenantBalanceService;
+
+@Tag(name = "管理后台 - 租户余额")
+@RestController
+@RequestMapping("/keyboard/tenant-balance")
+@Validated
+public class TenantBalanceController {
+
+    @Resource
+    private TenantBalanceService tenantBalanceService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建租户余额")
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-balance:create')")
+    public CommonResult<Long> createTenantBalance(@Valid @RequestBody TenantBalanceSaveReqVO createReqVO) {
+        return success(tenantBalanceService.createTenantBalance(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新租户余额")
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-balance:update')")
+    public CommonResult<Boolean> updateTenantBalance(@Valid @RequestBody TenantBalanceSaveReqVO updateReqVO) {
+        tenantBalanceService.updateTenantBalance(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除租户余额")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-balance:delete')")
+    public CommonResult<Boolean> deleteTenantBalance(@RequestParam("id") Long id) {
+        tenantBalanceService.deleteTenantBalance(id);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete-list")
+    @Parameter(name = "ids", description = "编号", required = true)
+    @Operation(summary = "批量删除租户余额")
+                @PreAuthorize("@ss.hasPermission('keyboard:tenant-balance:delete')")
+    public CommonResult<Boolean> deleteTenantBalanceList(@RequestParam("ids") List<Long> ids) {
+        tenantBalanceService.deleteTenantBalanceListByIds(ids);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得租户余额")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-balance:query')")
+    public CommonResult<TenantBalanceRespVO> getTenantBalance(@RequestParam("id") Long id) {
+        TenantBalanceDO tenantBalance = tenantBalanceService.getTenantBalance(id);
+        return success(BeanUtils.toBean(tenantBalance, TenantBalanceRespVO.class));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得租户余额分页")
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-balance:query')")
+    public CommonResult<PageResult<TenantBalanceRespVO>> getTenantBalancePage(@Valid TenantBalancePageReqVO pageReqVO) {
+        PageResult<TenantBalanceDO> pageResult = tenantBalanceService.getTenantBalancePage(pageReqVO);
+        return success(BeanUtils.toBean(pageResult, TenantBalanceRespVO.class));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出租户余额 Excel")
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-balance:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportTenantBalanceExcel(@Valid TenantBalancePageReqVO pageReqVO,
+              HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<TenantBalanceDO> list = tenantBalanceService.getTenantBalancePage(pageReqVO).getList();
+        // 导出 Excel
+        ExcelUtils.write(response, "租户余额.xls", "数据", TenantBalanceRespVO.class,
+                        BeanUtils.toBean(list, TenantBalanceRespVO.class));
+    }
+
+    @PostMapping("/addAmount")
+    @Operation(summary = "添加租户余额")
+    @PreAuthorize("@ss.hasPermission('system:tenant-balance:add')")
+    public CommonResult<Boolean>  addTenantBalance(@Valid @RequestBody TenantBalanceAddReqVO addReqVO) {
+        tenantBalanceService.addTenantBalance(addReqVO);
+        return success(true);
+    }
+
+    @GetMapping("/get-self-amount")
+    @Operation(summary = "获得自己的余额")
+    @PreAuthorize("@ss.hasPermission('system:tenant-balance:self-amount')")
+    public CommonResult<TenantBalanceRespVO> getTenantBalance() {
+        TenantBalanceDO tenantBalance = tenantBalanceService.getSelfBalance();
+        return success(BeanUtils.toBean(tenantBalance, TenantBalanceRespVO.class));
+    }
+
+    @GetMapping("/get-self-subordinate-amount-page")
+    @Operation(summary = "获得自己下级余额的分页")
+    @PreAuthorize("@ss.hasPermission('system:tenant-balance:self-subordinate')")
+    public CommonResult<PageResult<TenantBalanceRespVO>> getSelfSubordinate(@Valid TenantBalancePageReqVO pageReqVO) {
+        PageResult<TenantBalanceRespVO> tenantBalancePage = tenantBalanceService.getSelfSubordinateTenantBalancePage(pageReqVO);
+        return success(BeanUtils.toBean(tenantBalancePage, TenantBalanceRespVO.class));
+    }
+
+    @PostMapping("/withdraw")
+    @Operation(summary = "租户提现")
+    @PreAuthorize("@ss.hasPermission('system:tenant-balance:withdraw')")
+    public CommonResult<Boolean> withdraw(@Valid @RequestBody TenantBalanceWithdrawReqVO withdrawReqVO) {
+        tenantBalanceService.withdraw(withdrawReqVO);
+        return success(true);
+    }
+
+
+    // ==================== 子表（租户积分记录） ====================
+
+    @GetMapping("/tenant-balance-transaction/page")
+    @Operation(summary = "获得租户积分记录分页")
+    @Parameter(name = "tenantId", description = "租户 Id")
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-balance:query')")
+    public CommonResult<PageResult<TenantBalanceTransactionRespVO>> getTenantBalanceTransactionPage(PageParam pageReqVO,
+                                                                                                @RequestParam("tenantId") Long tenantId) {
+        PageResult<TenantBalanceTransactionDO> pageResult = tenantBalanceService.getTenantBalanceTransactionPage(pageReqVO, tenantId);
+        return success(BeanUtils.toBean(pageResult, TenantBalanceTransactionRespVO.class));
+    }
+
+    @PostMapping("/tenant-balance-transaction/create")
+    @Operation(summary = "创建租户积分记录")
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-balance:create')")
+    public CommonResult<Long> createTenantBalanceTransaction(@Valid @RequestBody TenantBalanceTransactionDO tenantBalanceTransaction) {
+        return success(tenantBalanceService.createTenantBalanceTransaction(tenantBalanceTransaction));
+    }
+
+    @PutMapping("/tenant-balance-transaction/update")
+    @Operation(summary = "更新租户积分记录")
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-balance:update')")
+    public CommonResult<Boolean> updateTenantBalanceTransaction(@Valid @RequestBody TenantBalanceTransactionDO tenantBalanceTransaction) {
+        tenantBalanceService.updateTenantBalanceTransaction(tenantBalanceTransaction);
+        return success(true);
+    }
+
+    @DeleteMapping("/tenant-balance-transaction/delete")
+    @Parameter(name = "id", description = "编号", required = true)
+    @Operation(summary = "删除租户积分记录")
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-balance:delete')")
+    public CommonResult<Boolean> deleteTenantBalanceTransaction(@RequestParam("id") Long id) {
+        tenantBalanceService.deleteTenantBalanceTransaction(id);
+        return success(true);
+    }
+
+    @DeleteMapping("/tenant-balance-transaction/delete-list")
+    @Parameter(name = "ids", description = "编号", required = true)
+    @Operation(summary = "批量删除租户积分记录")
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-balance:delete')")
+    public CommonResult<Boolean> deleteTenantBalanceTransactionList(@RequestParam("ids") List<Long> ids) {
+        tenantBalanceService.deleteTenantBalanceTransactionListByIds(ids);
+        return success(true);
+    }
+
+    @GetMapping("/tenant-balance-transaction/get")
+    @Operation(summary = "获得租户积分记录")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-balance:query')")
+    public CommonResult<TenantBalanceTransactionRespVO> getTenantBalanceTransaction(@RequestParam("id") Long id) {
+        TenantBalanceTransactionDO transaction = tenantBalanceService.getTenantBalanceTransaction(id);
+        return success(BeanUtils.toBean(transaction, TenantBalanceTransactionRespVO.class));
+    }
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tenantbalance/vo/TenantBalanceAddReqVO.java

@@ -0,0 +1,24 @@
+package com.yolo.keyboard.controller.admin.tenantbalance.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+
+/*
+ * @author: ziin
+ * @date: 2025/11/19 21:05
+ */
+@Schema(description = "管理后台 - 租户余额添加VO")
+@Data
+public class TenantBalanceAddReqVO {
+    @Schema(description = "租户 Id", requiredMode = Schema.RequiredMode.REQUIRED, example = "19954")
+    private Long id;
+
+    @Schema(description = "增加的余额", requiredMode = Schema.RequiredMode.REQUIRED, example = "1000000")
+    private BigDecimal amount;
+
+    @Schema(description = "备注", example = "备注")
+    private String remark;
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tenantbalance/vo/TenantBalancePageReqVO.java

@@ -0,0 +1,33 @@
+package com.yolo.keyboard.controller.admin.tenantbalance.vo;
+
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.util.*;
+import io.swagger.v3.oas.annotations.media.Schema;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+import static com.yolo.keyboard.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - 租户余额分页 Request VO")
+@Data
+public class TenantBalancePageReqVO extends PageParam {
+
+    @Schema(description = "当前积分余额")
+    private BigDecimal balance;
+
+    @Schema(description = "乐观锁版本号")
+    private Integer version;
+
+    @Schema(description = "更新时间")
+    private LocalDateTime updatedAt;
+
+
+    @Schema(description = "冻结金额")
+    private BigDecimal frozenAmt;
+
+    @Schema(description = "可提现金额")
+    private BigDecimal withdrawableBalance;
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tenantbalance/vo/TenantBalanceRespVO.java

@@ -0,0 +1,38 @@
+package com.yolo.keyboard.controller.admin.tenantbalance.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.util.*;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+import cn.idev.excel.annotation.*;
+
+@Schema(description = "管理后台 - 租户余额 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class TenantBalanceRespVO {
+
+    @Schema(description = "租户 Id", requiredMode = Schema.RequiredMode.REQUIRED, example = "13447")
+    @ExcelProperty("租户 Id")
+    private Long id;
+
+    @Schema(description = "当前积分余额", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("当前积分余额")
+    private BigDecimal balance;
+
+    @Schema(description = "乐观锁版本号", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("乐观锁版本号")
+    private Integer version;
+
+    @Schema(description = "更新时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("更新时间")
+    private LocalDateTime updatedAt;
+
+    @Schema(description = "冻结金额")
+    private BigDecimal frozenAmt;
+
+    @Schema(description = "可提现金额")
+    private BigDecimal withdrawableBalance;
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tenantbalance/vo/TenantBalanceSaveReqVO.java

@@ -0,0 +1,36 @@
+package com.yolo.keyboard.controller.admin.tenantbalance.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.util.*;
+import jakarta.validation.constraints.*;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 租户余额新增/修改 Request VO")
+@Data
+public class TenantBalanceSaveReqVO {
+
+    @Schema(description = "租户 Id", requiredMode = Schema.RequiredMode.REQUIRED, example = "13447")
+    private Long id;
+
+    @Schema(description = "当前积分余额", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "当前积分余额不能为空")
+    private BigDecimal balance;
+
+    @Schema(description = "乐观锁版本号", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "乐观锁版本号不能为空")
+    private Integer version;
+
+    @Schema(description = "更新时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "更新时间不能为空")
+    private LocalDateTime updatedAt;
+
+    @Schema(description = "冻结金额")
+    private BigDecimal frozenAmt;
+
+    @Schema(description = "可提现金额")
+    private BigDecimal withdrawableBalance;
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tenantbalance/vo/TenantBalanceTransactionRespVO.java

@@ -0,0 +1,52 @@
+package com.yolo.keyboard.controller.admin.tenantbalance.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 租户积分记录 Response VO")
+@Data
+public class TenantBalanceTransactionRespVO {
+
+    @Schema(description = "主键", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "本次变动点数，正加负减", requiredMode = Schema.RequiredMode.REQUIRED, example = "100.00")
+    private BigDecimal points;
+
+    @Schema(description = "变动后余额快照", example = "1000.00")
+    private BigDecimal balance;
+
+    @Schema(description = "变动后冻结金额快照", example = "200.00")
+    private BigDecimal frozenAmt;
+
+    @Schema(description = "变动后可提现余额快照", example = "800.00")
+    private BigDecimal withdrawableBalance;
+
+    @Schema(description = "变动类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "RECHARGE")
+    private String type;
+
+    @Schema(description = "变动描述", example = "余额充值")
+    private String description;
+
+    @Schema(description = "订单Id/业务单号", example = "ORD123456")
+    private String orderId;
+
+    @Schema(description = "业务流水号", example = "BIZ123456")
+    private String bizNo;
+
+    @Schema(description = "操作人Id", example = "1")
+    private Long operatorId;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "备注", example = "管理员充值")
+    private String remark;
+
+    @Schema(description = "租户Id", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long tenantId;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tenantbalance/vo/TenantBalanceWithdrawReqVO.java

@@ -0,0 +1,50 @@
+package com.yolo.keyboard.controller.admin.tenantbalance.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.DecimalMin;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+/**
+ * 管理后台 - 租户余额提现 Request VO
+ */
+@Schema(description = "管理后台 - 租户余额提现 Request VO")
+@Data
+public class TenantBalanceWithdrawReqVO {
+
+    @Schema(description = "提现金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "1000")
+    @NotNull(message = "提现金额不能为空")
+    @DecimalMin(value = "0.01", message = "提现金额必须大于0")
+    private BigDecimal amount;
+
+    @Schema(description = "打款渠道：BANK/ALIPAY/WECHAT", requiredMode = Schema.RequiredMode.REQUIRED, example = "BANK")
+    @NotEmpty(message = "打款渠道不能为空")
+    private String payChannel;
+
+    @Schema(description = "收款方类型：PERSON（个人）/COMPANY（企业）", requiredMode = Schema.RequiredMode.REQUIRED, example = "PERSON")
+    @NotEmpty(message = "收款方类型不能为空")
+    private String payeeType;
+
+    @Schema(description = "收款人姓名或公司名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "张三")
+    @NotEmpty(message = "收款人姓名不能为空")
+    private String payeeName;
+
+    @Schema(description = "收款账号（银行卡/支付宝等）", requiredMode = Schema.RequiredMode.REQUIRED, example = "6222021234567890123")
+    @NotEmpty(message = "收款账号不能为空")
+    private String payeeAccount;
+
+    @Schema(description = "收款银行名称（银行渠道必填）", example = "中国工商银行")
+    private String payeeBankName;
+
+    @Schema(description = "银行编码", example = "ICBC")
+    private String payeeBankCode;
+
+    @Schema(description = "银行支行名称", example = "北京分行朝阳支行")
+    private String payeeBankBranch;
+
+    @Schema(description = "备注", example = "提现备注")
+    private String remark;
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tenantcommission/KeyboardTenantCommissionController.java

@@ -0,0 +1,106 @@
+package com.yolo.keyboard.controller.admin.tenantcommission;
+
+import org.springframework.web.bind.annotation.*;
+import jakarta.annotation.Resource;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.security.access.prepost.PreAuthorize;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Operation;
+
+import jakarta.validation.constraints.*;
+import jakarta.validation.*;
+import jakarta.servlet.http.*;
+import java.util.*;
+import java.io.IOException;
+
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.CommonResult;
+import com.yolo.keyboard.framework.common.util.object.BeanUtils;
+import static com.yolo.keyboard.framework.common.pojo.CommonResult.success;
+
+import com.yolo.keyboard.framework.excel.core.util.ExcelUtils;
+
+import com.yolo.keyboard.framework.apilog.core.annotation.ApiAccessLog;
+import static com.yolo.keyboard.framework.apilog.core.enums.OperateTypeEnum.*;
+
+import com.yolo.keyboard.controller.admin.tenantcommission.vo.*;
+import com.yolo.keyboard.dal.dataobject.tenantcommission.KeyboardTenantCommissionDO;
+import com.yolo.keyboard.service.tenantcommission.KeyboardTenantCommissionService;
+
+@Tag(name = "管理后台 - 租户内购分成记录")
+@RestController
+@RequestMapping("/keyboard/tenant-commission")
+@Validated
+public class KeyboardTenantCommissionController {
+
+    @Resource
+    private KeyboardTenantCommissionService tenantCommissionService;
+
+
+    @PostMapping("/create")
+    @Operation(summary = "创建租户内购分成记录")
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-commission:create')")
+    public CommonResult<Long> createTenantCommission(@Valid @RequestBody KeyboardTenantCommissionSaveReqVO createReqVO) {
+        
+        return success(tenantCommissionService.createTenantCommission(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新租户内购分成记录")
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-commission:update')")
+    public CommonResult<Boolean> updateTenantCommission(@Valid @RequestBody KeyboardTenantCommissionSaveReqVO updateReqVO) {
+        tenantCommissionService.updateTenantCommission(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除租户内购分成记录")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-commission:delete')")
+    public CommonResult<Boolean> deleteTenantCommission(@RequestParam("id") Long id) {
+        tenantCommissionService.deleteTenantCommission(id);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete-list")
+    @Parameter(name = "ids", description = "编号", required = true)
+    @Operation(summary = "批量删除租户内购分成记录")
+                @PreAuthorize("@ss.hasPermission('keyboard:tenant-commission:delete')")
+    public CommonResult<Boolean> deleteTenantCommissionList(@RequestParam("ids") List<Long> ids) {
+        tenantCommissionService.deleteTenantCommissionListByIds(ids);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得租户内购分成记录")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-commission:query')")
+    public CommonResult<KeyboardTenantCommissionRespVO> getTenantCommission(@RequestParam("id") Long id) {
+        KeyboardTenantCommissionDO tenantCommission = tenantCommissionService.getTenantCommission(id);
+        return success(BeanUtils.toBean(tenantCommission, KeyboardTenantCommissionRespVO.class));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得租户内购分成记录分页")
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-commission:query')")
+    public CommonResult<PageResult<KeyboardTenantCommissionRespVO>> getTenantCommissionPage(@Valid KeyboardTenantCommissionPageReqVO pageReqVO) {
+        PageResult<KeyboardTenantCommissionDO> pageResult = tenantCommissionService.getTenantCommissionPage(pageReqVO);
+        return success(BeanUtils.toBean(pageResult, KeyboardTenantCommissionRespVO.class));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出租户内购分成记录 Excel")
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-commission:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportTenantCommissionExcel(@Valid KeyboardTenantCommissionPageReqVO pageReqVO,
+              HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<KeyboardTenantCommissionDO> list = tenantCommissionService.getTenantCommissionPage(pageReqVO).getList();
+        // 导出 Excel
+        ExcelUtils.write(response, "租户内购分成记录.xls", "数据", KeyboardTenantCommissionRespVO.class,
+                        BeanUtils.toBean(list, KeyboardTenantCommissionRespVO.class));
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tenantcommission/vo/KeyboardTenantCommissionPageReqVO.java

@@ -0,0 +1,63 @@
+package com.yolo.keyboard.controller.admin.tenantcommission.vo;
+
+import lombok.*;
+import java.util.*;
+import io.swagger.v3.oas.annotations.media.Schema;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import java.math.BigDecimal;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+import static com.yolo.keyboard.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - 租户内购分成记录分页 Request VO")
+@Data
+public class KeyboardTenantCommissionPageReqVO extends PageParam {
+
+    @Schema(description = "租户ID", example = "1", hidden = true)
+    private Long tenantId;
+
+    @Schema(description = "内购记录ID", example = "20900")
+    private Integer purchaseRecordId;
+
+    @Schema(description = "内购交易ID", example = "30383")
+    private String transactionId;
+
+    @Schema(description = "被邀请用户ID（购买用户）", example = "2447")
+    private Integer inviteeUserId;
+
+    @Schema(description = "邀请人用户ID", example = "1012")
+    private Long inviterUserId;
+
+    @Schema(description = "内购金额")
+    private BigDecimal purchaseAmount;
+
+    @Schema(description = "分成比例")
+    private BigDecimal commissionRate;
+
+    @Schema(description = "分成金额")
+    private BigDecimal commissionAmount;
+
+    @Schema(description = "状态：PENDING-待结算，SETTLED-已结算，REFUNDED-已退款", example = "2")
+    private String status;
+
+    @Schema(description = "内购时间")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] purchaseTime;
+
+    @Schema(description = "结算时间")
+    private LocalDateTime settledAt;
+
+    @Schema(description = "关联的余额交易记录ID", example = "29131")
+    private Long balanceTransactionId;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "更新时间")
+    private LocalDateTime updatedAt;
+
+    @Schema(description = "备注", example = "随便")
+    private String remark;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tenantcommission/vo/KeyboardTenantCommissionRespVO.java

@@ -0,0 +1,76 @@
+package com.yolo.keyboard.controller.admin.tenantcommission.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+import java.util.*;
+import java.math.BigDecimal;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+import cn.idev.excel.annotation.*;
+
+@Schema(description = "管理后台 - 租户内购分成记录 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class KeyboardTenantCommissionRespVO {
+
+    @Schema(description = "主键", requiredMode = Schema.RequiredMode.REQUIRED, example = "3144")
+    @ExcelProperty("主键")
+    private Long id;
+
+    @Schema(description = "内购记录ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "20900")
+    @ExcelProperty("内购记录ID")
+    private Integer purchaseRecordId;
+
+    @Schema(description = "内购交易ID", example = "30383")
+    @ExcelProperty("内购交易ID")
+    private String transactionId;
+
+    @Schema(description = "被邀请用户ID（购买用户）", example = "2447")
+    @ExcelProperty("被邀请用户ID（购买用户）")
+    private Integer inviteeUserId;
+
+    @Schema(description = "邀请人用户ID", example = "1012")
+    @ExcelProperty("邀请人用户ID")
+    private Long inviterUserId;
+
+    @Schema(description = "内购金额")
+    @ExcelProperty("内购金额")
+    private BigDecimal purchaseAmount;
+
+    @Schema(description = "分成比例")
+    @ExcelProperty("分成比例")
+    private BigDecimal commissionRate;
+
+    @Schema(description = "分成金额")
+    @ExcelProperty("分成金额")
+    private BigDecimal commissionAmount;
+
+    @Schema(description = "状态：PENDING-待结算，SETTLED-已结算，REFUNDED-已退款", example = "2")
+    @ExcelProperty("状态：PENDING-待结算，SETTLED-已结算，REFUNDED-已退款")
+    private String status;
+
+    @Schema(description = "内购时间")
+    @ExcelProperty("内购时间")
+    private LocalDateTime purchaseTime;
+
+    @Schema(description = "结算时间")
+    @ExcelProperty("结算时间")
+    private LocalDateTime settledAt;
+
+    @Schema(description = "关联的余额交易记录ID", example = "29131")
+    @ExcelProperty("关联的余额交易记录ID")
+    private Long balanceTransactionId;
+
+    @Schema(description = "创建时间")
+    @ExcelProperty("创建时间")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "更新时间")
+    @ExcelProperty("更新时间")
+    private LocalDateTime updatedAt;
+
+    @Schema(description = "备注", example = "随便")
+    @ExcelProperty("备注")
+    private String remark;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tenantcommission/vo/KeyboardTenantCommissionSaveReqVO.java

@@ -0,0 +1,61 @@
+package com.yolo.keyboard.controller.admin.tenantcommission.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+import java.util.*;
+import jakarta.validation.constraints.*;
+import java.math.BigDecimal;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 租户内购分成记录新增/修改 Request VO")
+@Data
+public class KeyboardTenantCommissionSaveReqVO {
+
+    @Schema(description = "主键", requiredMode = Schema.RequiredMode.REQUIRED, example = "3144")
+    private Long id;
+
+    @Schema(description = "内购记录ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "20900")
+    @NotNull(message = "内购记录ID不能为空")
+    private Integer purchaseRecordId;
+
+    @Schema(description = "内购交易ID", example = "30383")
+    private String transactionId;
+
+    @Schema(description = "被邀请用户ID（购买用户）", example = "2447")
+    private Integer inviteeUserId;
+
+    @Schema(description = "邀请人用户ID", example = "1012")
+    private Long inviterUserId;
+
+    @Schema(description = "内购金额")
+    private BigDecimal purchaseAmount;
+
+    @Schema(description = "分成比例")
+    private BigDecimal commissionRate;
+
+    @Schema(description = "分成金额")
+    private BigDecimal commissionAmount;
+
+    @Schema(description = "状态：PENDING-待结算，SETTLED-已结算，REFUNDED-已退款", example = "2")
+    private String status;
+
+    @Schema(description = "内购时间")
+    private LocalDateTime purchaseTime;
+
+    @Schema(description = "结算时间")
+    private LocalDateTime settledAt;
+
+    @Schema(description = "关联的余额交易记录ID", example = "29131")
+    private Long balanceTransactionId;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "更新时间")
+    private LocalDateTime updatedAt;
+
+    @Schema(description = "备注", example = "随便")
+    private String remark;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tenantwithdraworder/KeyboardTenantWithdrawOrderController.java

@@ -0,0 +1,103 @@
+package com.yolo.keyboard.controller.admin.tenantwithdraworder;
+
+import org.springframework.web.bind.annotation.*;
+import jakarta.annotation.Resource;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.security.access.prepost.PreAuthorize;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Operation;
+
+import jakarta.validation.constraints.*;
+import jakarta.validation.*;
+import jakarta.servlet.http.*;
+import java.util.*;
+import java.io.IOException;
+
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.CommonResult;
+import com.yolo.keyboard.framework.common.util.object.BeanUtils;
+import static com.yolo.keyboard.framework.common.pojo.CommonResult.success;
+
+import com.yolo.keyboard.framework.excel.core.util.ExcelUtils;
+
+import com.yolo.keyboard.framework.apilog.core.annotation.ApiAccessLog;
+import static com.yolo.keyboard.framework.apilog.core.enums.OperateTypeEnum.*;
+
+import com.yolo.keyboard.controller.admin.tenantwithdraworder.vo.*;
+import com.yolo.keyboard.dal.dataobject.tenantwithdraworder.KeyboardTenantWithdrawOrderDO;
+import com.yolo.keyboard.service.tenantwithdraworder.KeyboardTenantWithdrawOrderService;
+
+@Tag(name = "管理后台 - 租户提现订单表（申请-审核-打款-完成/失败）")
+@RestController
+@RequestMapping("/keyboard/tenant-withdraw-order")
+@Validated
+public class KeyboardTenantWithdrawOrderController {
+
+    @Resource
+    private KeyboardTenantWithdrawOrderService tenantWithdrawOrderService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建租户提现订单表（申请-审核-打款-完成/失败）")
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-withdraw-order:create')")
+    public CommonResult<Long> createTenantWithdrawOrder(@Valid @RequestBody KeyboardTenantWithdrawOrderSaveReqVO createReqVO) {
+        return success(tenantWithdrawOrderService.createTenantWithdrawOrder(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新租户提现订单表（申请-审核-打款-完成/失败）")
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-withdraw-order:update')")
+    public CommonResult<Boolean> updateTenantWithdrawOrder(@Valid @RequestBody KeyboardTenantWithdrawOrderSaveReqVO updateReqVO) {
+        tenantWithdrawOrderService.updateTenantWithdrawOrder(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除租户提现订单表（申请-审核-打款-完成/失败）")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-withdraw-order:delete')")
+    public CommonResult<Boolean> deleteTenantWithdrawOrder(@RequestParam("id") Long id) {
+        tenantWithdrawOrderService.deleteTenantWithdrawOrder(id);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete-list")
+    @Parameter(name = "ids", description = "编号", required = true)
+    @Operation(summary = "批量删除租户提现订单表（申请-审核-打款-完成/失败）")
+                @PreAuthorize("@ss.hasPermission('keyboard:tenant-withdraw-order:delete')")
+    public CommonResult<Boolean> deleteTenantWithdrawOrderList(@RequestParam("ids") List<Long> ids) {
+        tenantWithdrawOrderService.deleteTenantWithdrawOrderListByIds(ids);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得租户提现订单表（申请-审核-打款-完成/失败）")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-withdraw-order:query')")
+    public CommonResult<KeyboardTenantWithdrawOrderRespVO> getTenantWithdrawOrder(@RequestParam("id") Long id) {
+        KeyboardTenantWithdrawOrderDO tenantWithdrawOrder = tenantWithdrawOrderService.getTenantWithdrawOrder(id);
+        return success(BeanUtils.toBean(tenantWithdrawOrder, KeyboardTenantWithdrawOrderRespVO.class));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得租户提现订单表（申请-审核-打款-完成/失败）分页")
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-withdraw-order:query')")
+    public CommonResult<PageResult<KeyboardTenantWithdrawOrderRespVO>> getTenantWithdrawOrderPage(@Valid KeyboardTenantWithdrawOrderPageReqVO pageReqVO) {
+        PageResult<KeyboardTenantWithdrawOrderRespVO> pageResult = tenantWithdrawOrderService.getTenantWithdrawOrderPage(pageReqVO);
+        return success(pageResult);
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出租户提现订单表（申请-审核-打款-完成/失败） Excel")
+    @PreAuthorize("@ss.hasPermission('keyboard:tenant-withdraw-order:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportTenantWithdrawOrderExcel(@Valid KeyboardTenantWithdrawOrderPageReqVO pageReqVO,
+              HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<KeyboardTenantWithdrawOrderRespVO> list = tenantWithdrawOrderService.getTenantWithdrawOrderPage(pageReqVO).getList();
+        // 导出 Excel
+        ExcelUtils.write(response, "租户提现订单表（申请-审核-打款-完成/失败）.xls", "数据", KeyboardTenantWithdrawOrderRespVO.class, list);
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tenantwithdraworder/vo/KeyboardTenantWithdrawOrderPageReqVO.java

@@ -0,0 +1,117 @@
+package com.yolo.keyboard.controller.admin.tenantwithdraworder.vo;
+
+import lombok.*;
+import java.util.*;
+import io.swagger.v3.oas.annotations.media.Schema;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+import static com.yolo.keyboard.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - 租户提现订单表（申请-审核-打款-完成/失败）分页 Request VO")
+@Data
+public class KeyboardTenantWithdrawOrderPageReqVO extends PageParam {
+
+    @Schema(description = "提现单号（业务唯一）")
+    private String withdrawNo;
+
+    @Schema(description = "业务幂等号（防重复提交）")
+    private String bizNo;
+
+    @Schema(description = "币种（默认 CNY）")
+    private String currency;
+
+    @Schema(description = "提现申请金额（单位：分）")
+    private Long amount;
+
+    @Schema(description = "手续费金额（单位：分）")
+    private Long feeAmount;
+
+    @Schema(description = "实际到账金额（单位：分 = amount - fee_amount）")
+    private Long actualAmount;
+
+    @Schema(description = "打款渠道：BANK/ALIPAY/WECHAT/PAYPAL 等")
+    private String payChannel;
+
+    @Schema(description = "收款方类型：PERSON（个人）/COMPANY（企业）", example = "1")
+    private String payeeType;
+
+    @Schema(description = "收款人姓名或公司名称（快照）", example = "张三")
+    private String payeeName;
+
+    @Schema(description = "收款账号（银行卡/支付宝等，建议加密或脱敏）", example = "5425")
+    private String payeeAccount;
+
+    @Schema(description = "收款银行名称", example = "芋艿")
+    private String payeeBankName;
+
+    @Schema(description = "银行编码（可选）")
+    private String payeeBankCode;
+
+    @Schema(description = "银行支行名称（可选）")
+    private String payeeBankBranch;
+
+    @Schema(description = "提现状态：APPLIED/APPROVED/REJECTED/PAYING/PAID/FAILED/CANCELED", example = "1")
+    private String status;
+
+    @Schema(description = "审核状态：PENDING/PASSED/REJECTED", example = "1")
+    private String auditStatus;
+
+    @Schema(description = "拒绝原因或打款失败原因", example = "不香")
+    private String reason;
+
+    @Schema(description = "提现申请时间")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] applyTime;
+
+    @Schema(description = "审核完成时间")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] auditTime;
+
+    @Schema(description = "发起打款时间（请求第三方）")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] payTime;
+
+    @Schema(description = "打款成功时间（第三方确认）")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] paidTime;
+
+    @Schema(description = "业务终态时间（成功/失败/取消）")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] finishTime;
+
+    @Schema(description = "打款批次号（内部使用）")
+    private String payerBatchNo;
+
+    @Schema(description = "第三方打款交易号/流水号（对账用）")
+    private String channelTradeNo;
+
+    @Schema(description = "第三方返回的原始报文（用于排查）")
+    private Object channelRaw;
+
+    @Schema(description = "关联余额流水ID（冻结/扣减/返还）", example = "30641")
+    private Long balanceTxnId;
+
+    @Schema(description = "乐观锁版本号")
+    private Integer version;
+
+    @Schema(description = "提现申请人ID", example = "6858")
+    private Long creatorId;
+
+    @Schema(description = "审核人ID", example = "15039")
+    private Long auditorId;
+
+    @Schema(description = "打款操作人ID", example = "8850")
+    private Long payerId;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "更新时间")
+    private LocalDateTime updatedAt;
+
+    @Schema(description = "租户ID列表（用于下级租户过滤）", hidden = true)
+    private List<Long> tenantIds;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tenantwithdraworder/vo/KeyboardTenantWithdrawOrderRespVO.java

@@ -0,0 +1,153 @@
+package com.yolo.keyboard.controller.admin.tenantwithdraworder.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.util.*;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+import cn.idev.excel.annotation.*;
+
+@Schema(description = "管理后台 - 租户提现订单表（申请-审核-打款-完成/失败） Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class KeyboardTenantWithdrawOrderRespVO {
+
+    @Schema(description = "主键", requiredMode = Schema.RequiredMode.REQUIRED, example = "20442")
+    @ExcelProperty("主键")
+    private Long id;
+
+    @Schema(description = "提现单号（业务唯一）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("提现单号（业务唯一）")
+    private String withdrawNo;
+
+    @Schema(description = "业务幂等号（防重复提交）")
+    @ExcelProperty("业务幂等号（防重复提交）")
+    private String bizNo;
+
+    @Schema(description = "币种（默认 CNY）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("币种（默认 CNY）")
+    private String currency;
+
+    @Schema(description = "提现申请金额（单位：元）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("提现申请金额（单位：元）")
+    private BigDecimal amount;
+
+    @Schema(description = "手续费金额（单位：元）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("手续费金额（单位：元）")
+    private BigDecimal feeAmount;
+
+    @Schema(description = "实际到账金额（单位：元 = amount - fee_amount）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("实际到账金额（单位：元 = amount - fee_amount）")
+    private BigDecimal actualAmount;
+
+    @Schema(description = "打款渠道：BANK/ALIPAY/WECHAT/PAYPAL 等", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("打款渠道：BANK/ALIPAY/WECHAT/PAYPAL 等")
+    private String payChannel;
+
+    @Schema(description = "收款方类型：PERSON（个人）/COMPANY（企业）", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @ExcelProperty("收款方类型：PERSON（个人）/COMPANY（企业）")
+    private String payeeType;
+
+    @Schema(description = "收款人姓名或公司名称（快照）", example = "张三")
+    @ExcelProperty("收款人姓名或公司名称（快照）")
+    private String payeeName;
+
+    @Schema(description = "收款账号（银行卡/支付宝等，建议加密或脱敏）", example = "5425")
+    @ExcelProperty("收款账号（银行卡/支付宝等，建议加密或脱敏）")
+    private String payeeAccount;
+
+    @Schema(description = "收款银行名称", example = "芋艿")
+    @ExcelProperty("收款银行名称")
+    private String payeeBankName;
+
+    @Schema(description = "银行编码（可选）")
+    @ExcelProperty("银行编码（可选）")
+    private String payeeBankCode;
+
+    @Schema(description = "银行支行名称（可选）")
+    @ExcelProperty("银行支行名称（可选）")
+    private String payeeBankBranch;
+
+    @Schema(description = "提现状态：APPLIED/APPROVED/REJECTED/PAYING/PAID/FAILED/CANCELED", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @ExcelProperty("提现状态：APPLIED/APPROVED/REJECTED/PAYING/PAID/FAILED/CANCELED")
+    private String status;
+
+    @Schema(description = "审核状态：PENDING/PASSED/REJECTED", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @ExcelProperty("审核状态：PENDING/PASSED/REJECTED")
+    private String auditStatus;
+
+    @Schema(description = "拒绝原因或打款失败原因", example = "不香")
+    @ExcelProperty("拒绝原因或打款失败原因")
+    private String reason;
+
+    @Schema(description = "提现申请时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("提现申请时间")
+    private LocalDateTime applyTime;
+
+    @Schema(description = "审核完成时间")
+    @ExcelProperty("审核完成时间")
+    private LocalDateTime auditTime;
+
+    @Schema(description = "发起打款时间（请求第三方）")
+    @ExcelProperty("发起打款时间（请求第三方）")
+    private LocalDateTime payTime;
+
+    @Schema(description = "打款成功时间（第三方确认）")
+    @ExcelProperty("打款成功时间（第三方确认）")
+    private LocalDateTime paidTime;
+
+    @Schema(description = "业务终态时间（成功/失败/取消）")
+    @ExcelProperty("业务终态时间（成功/失败/取消）")
+    private LocalDateTime finishTime;
+
+    @Schema(description = "打款批次号（内部使用）")
+    @ExcelProperty("打款批次号（内部使用）")
+    private String payerBatchNo;
+
+    @Schema(description = "第三方打款交易号/流水号（对账用）")
+    @ExcelProperty("第三方打款交易号/流水号（对账用）")
+    private String channelTradeNo;
+
+    @Schema(description = "第三方返回的原始报文（用于排查）")
+    @ExcelProperty("第三方返回的原始报文（用于排查）")
+    private Object channelRaw;
+
+    @Schema(description = "关联余额流水ID（冻结/扣减/返还）", example = "30641")
+    @ExcelProperty("关联余额流水ID（冻结/扣减/返还）")
+    private Long balanceTxnId;
+
+    @Schema(description = "乐观锁版本号", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("乐观锁版本号")
+    private Integer version;
+
+    @Schema(description = "提现申请人ID", example = "6858")
+    @ExcelProperty("提现申请人ID")
+    private Long creatorId;
+
+    @Schema(description = "审核人ID", example = "15039")
+    @ExcelProperty("审核人ID")
+    private Long auditorId;
+
+    @Schema(description = "打款操作人ID", example = "8850")
+    @ExcelProperty("打款操作人ID")
+    private Long payerId;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("创建时间")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "更新时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("更新时间")
+    private LocalDateTime updatedAt;
+
+    @Schema(description = "租户编号", example = "1")
+    @ExcelProperty("租户编号")
+    private Long tenantId;
+
+    @Schema(description = "租户名称", example = "芋道源码")
+    @ExcelProperty("租户名称")
+    private String tenantName;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/tenantwithdraworder/vo/KeyboardTenantWithdrawOrderSaveReqVO.java

@@ -0,0 +1,125 @@
+package com.yolo.keyboard.controller.admin.tenantwithdraworder.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.util.*;
+import jakarta.validation.constraints.*;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 租户提现订单表（申请-审核-打款-完成/失败）新增/修改 Request VO")
+@Data
+public class KeyboardTenantWithdrawOrderSaveReqVO {
+
+    @Schema(description = "主键", requiredMode = Schema.RequiredMode.REQUIRED, example = "20442")
+    private Long id;
+
+    @Schema(description = "提现单号（业务唯一）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "提现单号（业务唯一）不能为空")
+    private String withdrawNo;
+
+    @Schema(description = "业务幂等号（防重复提交）")
+    private String bizNo;
+
+    @Schema(description = "币种（默认 CNY）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "币种（默认 CNY）不能为空")
+    private String currency;
+
+    @Schema(description = "提现申请金额（单位：元）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "提现申请金额不能为空")
+    private BigDecimal amount;
+
+    @Schema(description = "手续费金额（单位：元）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "手续费金额不能为空")
+    private BigDecimal feeAmount;
+
+    @Schema(description = "实际到账金额（单位：元 = amount - fee_amount）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "实际到账金额不能为空")
+    private BigDecimal actualAmount;
+
+    @Schema(description = "打款渠道：BANK/ALIPAY/WECHAT/PAYPAL 等", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "打款渠道：BANK/ALIPAY/WECHAT/PAYPAL 等不能为空")
+    private String payChannel;
+
+    @Schema(description = "收款方类型：PERSON（个人）/COMPANY（企业）", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotEmpty(message = "收款方类型：PERSON（个人）/COMPANY（企业）不能为空")
+    private String payeeType;
+
+    @Schema(description = "收款人姓名或公司名称（快照）", example = "张三")
+    private String payeeName;
+
+    @Schema(description = "收款账号（银行卡/支付宝等，建议加密或脱敏）", example = "5425")
+    private String payeeAccount;
+
+    @Schema(description = "收款银行名称", example = "芋艿")
+    private String payeeBankName;
+
+    @Schema(description = "银行编码（可选）")
+    private String payeeBankCode;
+
+    @Schema(description = "银行支行名称（可选）")
+    private String payeeBankBranch;
+
+    @Schema(description = "提现状态：APPLIED/APPROVED/REJECTED/PAYING/PAID/FAILED/CANCELED", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotEmpty(message = "提现状态：APPLIED/APPROVED/REJECTED/PAYING/PAID/FAILED/CANCELED不能为空")
+    private String status;
+
+    @Schema(description = "审核状态：PENDING/PASSED/REJECTED", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotEmpty(message = "审核状态：PENDING/PASSED/REJECTED不能为空")
+    private String auditStatus;
+
+    @Schema(description = "拒绝原因或打款失败原因", example = "不香")
+    private String reason;
+
+    @Schema(description = "提现申请时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "提现申请时间不能为空")
+    private LocalDateTime applyTime;
+
+    @Schema(description = "审核完成时间")
+    private LocalDateTime auditTime;
+
+    @Schema(description = "发起打款时间（请求第三方）")
+    private LocalDateTime payTime;
+
+    @Schema(description = "打款成功时间（第三方确认）")
+    private LocalDateTime paidTime;
+
+    @Schema(description = "业务终态时间（成功/失败/取消）")
+    private LocalDateTime finishTime;
+
+    @Schema(description = "打款批次号（内部使用）")
+    private String payerBatchNo;
+
+    @Schema(description = "第三方打款交易号/流水号（对账用）")
+    private String channelTradeNo;
+
+    @Schema(description = "第三方返回的原始报文（用于排查）")
+    private Object channelRaw;
+
+    @Schema(description = "关联余额流水ID（冻结/扣减/返还）", example = "30641")
+    private Long balanceTxnId;
+
+    @Schema(description = "乐观锁版本号", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "乐观锁版本号不能为空")
+    private Integer version;
+
+    @Schema(description = "提现申请人ID", example = "6858")
+    private Long creatorId;
+
+    @Schema(description = "审核人ID", example = "15039")
+    private Long auditorId;
+
+    @Schema(description = "打款操作人ID", example = "8850")
+    private Long payerId;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "创建时间不能为空")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "更新时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "更新时间不能为空")
+    private LocalDateTime updatedAt;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/usercalllog/KeyboardUserCallLogController.java

@@ -0,0 +1,104 @@
+package com.yolo.keyboard.controller.admin.usercalllog;
+
+import org.springframework.web.bind.annotation.*;
+import jakarta.annotation.Resource;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.security.access.prepost.PreAuthorize;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Operation;
+
+import jakarta.validation.constraints.*;
+import jakarta.validation.*;
+import jakarta.servlet.http.*;
+import java.util.*;
+import java.io.IOException;
+
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.CommonResult;
+import com.yolo.keyboard.framework.common.util.object.BeanUtils;
+import static com.yolo.keyboard.framework.common.pojo.CommonResult.success;
+
+import com.yolo.keyboard.framework.excel.core.util.ExcelUtils;
+
+import com.yolo.keyboard.framework.apilog.core.annotation.ApiAccessLog;
+import static com.yolo.keyboard.framework.apilog.core.enums.OperateTypeEnum.*;
+
+import com.yolo.keyboard.controller.admin.usercalllog.vo.*;
+import com.yolo.keyboard.dal.dataobject.usercalllog.KeyboardUserCallLogDO;
+import com.yolo.keyboard.service.usercalllog.KeyboardUserCallLogService;
+
+@Tag(name = "管理后台 - 用户每次调用日志（用于记录token、模型、耗时、成功率等）")
+@RestController
+@RequestMapping("/keyboard/user-call-log")
+@Validated
+public class KeyboardUserCallLogController {
+
+    @Resource
+    private KeyboardUserCallLogService userCallLogService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建用户每次调用日志（用于记录token、模型、耗时、成功率等）")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-call-log:create')")
+    public CommonResult<Long> createUserCallLog(@Valid @RequestBody KeyboardUserCallLogSaveReqVO createReqVO) {
+        return success(userCallLogService.createUserCallLog(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新用户每次调用日志（用于记录token、模型、耗时、成功率等）")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-call-log:update')")
+    public CommonResult<Boolean> updateUserCallLog(@Valid @RequestBody KeyboardUserCallLogSaveReqVO updateReqVO) {
+        userCallLogService.updateUserCallLog(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除用户每次调用日志（用于记录token、模型、耗时、成功率等）")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('keyboard:user-call-log:delete')")
+    public CommonResult<Boolean> deleteUserCallLog(@RequestParam("id") Long id) {
+        userCallLogService.deleteUserCallLog(id);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete-list")
+    @Parameter(name = "ids", description = "编号", required = true)
+    @Operation(summary = "批量删除用户每次调用日志（用于记录token、模型、耗时、成功率等）")
+                @PreAuthorize("@ss.hasPermission('keyboard:user-call-log:delete')")
+    public CommonResult<Boolean> deleteUserCallLogList(@RequestParam("ids") List<Long> ids) {
+        userCallLogService.deleteUserCallLogListByIds(ids);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得用户每次调用日志（用于记录token、模型、耗时、成功率等）")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-call-log:query')")
+    public CommonResult<KeyboardUserCallLogRespVO> getUserCallLog(@RequestParam("id") Long id) {
+        KeyboardUserCallLogDO userCallLog = userCallLogService.getUserCallLog(id);
+        return success(BeanUtils.toBean(userCallLog, KeyboardUserCallLogRespVO.class));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得用户每次调用日志（用于记录token、模型、耗时、成功率等）分页")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-call-log:query')")
+    public CommonResult<PageResult<KeyboardUserCallLogRespVO>> getUserCallLogPage(@Valid KeyboardUserCallLogPageReqVO pageReqVO) {
+        PageResult<KeyboardUserCallLogDO> pageResult = userCallLogService.getUserCallLogPage(pageReqVO);
+        return success(BeanUtils.toBean(pageResult, KeyboardUserCallLogRespVO.class));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出用户每次调用日志（用于记录token、模型、耗时、成功率等） Excel")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-call-log:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportUserCallLogExcel(@Valid KeyboardUserCallLogPageReqVO pageReqVO,
+              HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<KeyboardUserCallLogDO> list = userCallLogService.getUserCallLogPage(pageReqVO).getList();
+        // 导出 Excel
+        ExcelUtils.write(response, "用户每次调用日志（用于记录token、模型、耗时、成功率等）.xls", "数据", KeyboardUserCallLogRespVO.class,
+                        BeanUtils.toBean(list, KeyboardUserCallLogRespVO.class));
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/usercalllog/vo/KeyboardUserCallLogPageReqVO.java

@@ -0,0 +1,52 @@
+package com.yolo.keyboard.controller.admin.usercalllog.vo;
+
+import lombok.*;
+import java.util.*;
+import io.swagger.v3.oas.annotations.media.Schema;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+import static com.yolo.keyboard.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - 用户每次调用日志（用于记录token、模型、耗时、成功率等）分页 Request VO")
+@Data
+public class KeyboardUserCallLogPageReqVO extends PageParam {
+
+    @Schema(description = "用户ID", example = "22552")
+    private Long userId;
+
+    @Schema(description = "幂等请求ID，避免重试导致重复记录", example = "12645")
+    private String requestId;
+
+    @Schema(description = "调用功能来源")
+    private String feature;
+
+    @Schema(description = "调用的模型名称")
+    private String model;
+
+    @Schema(description = "输入token数")
+    private Integer inputTokens;
+
+    @Schema(description = "输出token数")
+    private Integer outputTokens;
+
+    @Schema(description = "总token数（input+output）")
+    private Integer totalTokens;
+
+    @Schema(description = "调用是否成功")
+    private Boolean success;
+
+    @Schema(description = "调用耗时（毫秒）")
+    private Integer latencyMs;
+
+    @Schema(description = "失败错误码（可空）")
+    private String errorCode;
+
+    @Schema(description = "调用记录创建时间")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "生成 id", example = "2813")
+    private String genId;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/usercalllog/vo/KeyboardUserCallLogRespVO.java

@@ -0,0 +1,67 @@
+package com.yolo.keyboard.controller.admin.usercalllog.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+import java.util.*;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+import cn.idev.excel.annotation.*;
+
+@Schema(description = "管理后台 - 用户每次调用日志（用于记录token、模型、耗时、成功率等） Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class KeyboardUserCallLogRespVO {
+
+    @Schema(description = "主键 id", requiredMode = Schema.RequiredMode.REQUIRED, example = "32537")
+    @ExcelProperty("主键 id")
+    private Long id;
+
+    @Schema(description = "用户ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "22552")
+    @ExcelProperty("用户ID")
+    private Long userId;
+
+    @Schema(description = "幂等请求ID，避免重试导致重复记录", requiredMode = Schema.RequiredMode.REQUIRED, example = "12645")
+    @ExcelProperty("幂等请求ID，避免重试导致重复记录")
+    private String requestId;
+
+    @Schema(description = "调用功能来源", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("调用功能来源")
+    private String feature;
+
+    @Schema(description = "调用的模型名称")
+    @ExcelProperty("调用的模型名称")
+    private String model;
+
+    @Schema(description = "输入token数", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("输入token数")
+    private Integer inputTokens;
+
+    @Schema(description = "输出token数", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("输出token数")
+    private Integer outputTokens;
+
+    @Schema(description = "总token数（input+output）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("总token数（input+output）")
+    private Integer totalTokens;
+
+    @Schema(description = "调用是否成功", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("调用是否成功")
+    private Boolean success;
+
+    @Schema(description = "调用耗时（毫秒）")
+    @ExcelProperty("调用耗时（毫秒）")
+    private Integer latencyMs;
+
+    @Schema(description = "失败错误码（可空）")
+    @ExcelProperty("失败错误码（可空）")
+    private String errorCode;
+
+    @Schema(description = "调用记录创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("调用记录创建时间")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "生成 id", example = "2813")
+    @ExcelProperty("生成 id")
+    private String genId;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/usercalllog/vo/KeyboardUserCallLogSaveReqVO.java

@@ -0,0 +1,61 @@
+package com.yolo.keyboard.controller.admin.usercalllog.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+import java.util.*;
+import jakarta.validation.constraints.*;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 用户每次调用日志（用于记录token、模型、耗时、成功率等）新增/修改 Request VO")
+@Data
+public class KeyboardUserCallLogSaveReqVO {
+
+    @Schema(description = "主键 id", requiredMode = Schema.RequiredMode.REQUIRED, example = "32537")
+    private Long id;
+
+    @Schema(description = "用户ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "22552")
+    @NotNull(message = "用户ID不能为空")
+    private Long userId;
+
+    @Schema(description = "幂等请求ID，避免重试导致重复记录", requiredMode = Schema.RequiredMode.REQUIRED, example = "12645")
+    @NotEmpty(message = "幂等请求ID，避免重试导致重复记录不能为空")
+    private String requestId;
+
+    @Schema(description = "调用功能来源", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "调用功能来源不能为空")
+    private String feature;
+
+    @Schema(description = "调用的模型名称")
+    private String model;
+
+    @Schema(description = "输入token数", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "输入token数不能为空")
+    private Integer inputTokens;
+
+    @Schema(description = "输出token数", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "输出token数不能为空")
+    private Integer outputTokens;
+
+    @Schema(description = "总token数（input+output）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "总token数（input+output）不能为空")
+    private Integer totalTokens;
+
+    @Schema(description = "调用是否成功", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "调用是否成功不能为空")
+    private Boolean success;
+
+    @Schema(description = "调用耗时（毫秒）")
+    private Integer latencyMs;
+
+    @Schema(description = "失败错误码（可空）")
+    private String errorCode;
+
+    @Schema(description = "调用记录创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "调用记录创建时间不能为空")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "生成 id", example = "2813")
+    private String genId;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/usercharacter/KeyboardUserCharacterController.java

@@ -0,0 +1,104 @@
+package com.yolo.keyboard.controller.admin.usercharacter;
+
+import org.springframework.web.bind.annotation.*;
+import jakarta.annotation.Resource;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.security.access.prepost.PreAuthorize;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Operation;
+
+import jakarta.validation.constraints.*;
+import jakarta.validation.*;
+import jakarta.servlet.http.*;
+import java.util.*;
+import java.io.IOException;
+
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.CommonResult;
+import com.yolo.keyboard.framework.common.util.object.BeanUtils;
+import static com.yolo.keyboard.framework.common.pojo.CommonResult.success;
+
+import com.yolo.keyboard.framework.excel.core.util.ExcelUtils;
+
+import com.yolo.keyboard.framework.apilog.core.annotation.ApiAccessLog;
+import static com.yolo.keyboard.framework.apilog.core.enums.OperateTypeEnum.*;
+
+import com.yolo.keyboard.controller.admin.usercharacter.vo.*;
+import com.yolo.keyboard.dal.dataobject.usercharacter.KeyboardUserCharacterDO;
+import com.yolo.keyboard.service.usercharacter.KeyboardUserCharacterService;
+
+@Tag(name = "管理后台 - 用户人设管理")
+@RestController
+@RequestMapping("/keyboard/user-character")
+@Validated
+public class KeyboardUserCharacterController {
+
+    @Resource
+    private KeyboardUserCharacterService userCharacterService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建用户人设管理")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-character:create')")
+    public CommonResult<Long> createUserCharacter(@Valid @RequestBody KeyboardUserCharacterSaveReqVO createReqVO) {
+        return success(userCharacterService.createUserCharacter(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新用户人设管理")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-character:update')")
+    public CommonResult<Boolean> updateUserCharacter(@Valid @RequestBody KeyboardUserCharacterSaveReqVO updateReqVO) {
+        userCharacterService.updateUserCharacter(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除用户人设管理")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('keyboard:user-character:delete')")
+    public CommonResult<Boolean> deleteUserCharacter(@RequestParam("id") Long id) {
+        userCharacterService.deleteUserCharacter(id);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete-list")
+    @Parameter(name = "ids", description = "编号", required = true)
+    @Operation(summary = "批量删除用户人设管理")
+                @PreAuthorize("@ss.hasPermission('keyboard:user-character:delete')")
+    public CommonResult<Boolean> deleteUserCharacterList(@RequestParam("ids") List<Long> ids) {
+        userCharacterService.deleteUserCharacterListByIds(ids);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得用户人设管理")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-character:query')")
+    public CommonResult<KeyboardUserCharacterRespVO> getUserCharacter(@RequestParam("id") Long id) {
+        KeyboardUserCharacterDO userCharacter = userCharacterService.getUserCharacter(id);
+        return success(BeanUtils.toBean(userCharacter, KeyboardUserCharacterRespVO.class));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得用户人设管理分页")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-character:query')")
+    public CommonResult<PageResult<KeyboardUserCharacterRespVO>> getUserCharacterPage(@Valid KeyboardUserCharacterPageReqVO pageReqVO) {
+        PageResult<KeyboardUserCharacterDO> pageResult = userCharacterService.getUserCharacterPage(pageReqVO);
+        return success(BeanUtils.toBean(pageResult, KeyboardUserCharacterRespVO.class));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出用户人设管理 Excel")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-character:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportUserCharacterExcel(@Valid KeyboardUserCharacterPageReqVO pageReqVO,
+              HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<KeyboardUserCharacterDO> list = userCharacterService.getUserCharacterPage(pageReqVO).getList();
+        // 导出 Excel
+        ExcelUtils.write(response, "用户人设管理.xls", "数据", KeyboardUserCharacterRespVO.class,
+                        BeanUtils.toBean(list, KeyboardUserCharacterRespVO.class));
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/usercharacter/vo/KeyboardUserCharacterPageReqVO.java

@@ -0,0 +1,31 @@
+package com.yolo.keyboard.controller.admin.usercharacter.vo;
+
+import lombok.*;
+import java.util.*;
+import io.swagger.v3.oas.annotations.media.Schema;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+import static com.yolo.keyboard.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - 用户人设管理分页 Request VO")
+@Data
+public class KeyboardUserCharacterPageReqVO extends PageParam {
+
+    @Schema(description = "键盘人设 id", example = "7333")
+    private Long characterId;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "更新时间")
+    private LocalDateTime updatedAt;
+
+    @Schema(description = "用户 Id", example = "31348")
+    private Long userId;
+
+    @Schema(description = "emoji 标签")
+    private String emoji;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/usercharacter/vo/KeyboardUserCharacterRespVO.java

@@ -0,0 +1,39 @@
+package com.yolo.keyboard.controller.admin.usercharacter.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+import java.util.*;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+import cn.idev.excel.annotation.*;
+
+@Schema(description = "管理后台 - 用户人设管理 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class KeyboardUserCharacterRespVO {
+
+    @Schema(description = "主键 Id", requiredMode = Schema.RequiredMode.REQUIRED, example = "32344")
+    @ExcelProperty("主键 Id")
+    private Long id;
+
+    @Schema(description = "键盘人设 id", example = "7333")
+    @ExcelProperty("键盘人设 id")
+    private Long characterId;
+
+    @Schema(description = "创建时间")
+    @ExcelProperty("创建时间")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "更新时间")
+    @ExcelProperty("更新时间")
+    private LocalDateTime updatedAt;
+
+    @Schema(description = "用户 Id", example = "31348")
+    @ExcelProperty("用户 Id")
+    private Long userId;
+
+    @Schema(description = "emoji 标签")
+    @ExcelProperty("emoji 标签")
+    private String emoji;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/usercharacter/vo/KeyboardUserCharacterSaveReqVO.java

@@ -0,0 +1,32 @@
+package com.yolo.keyboard.controller.admin.usercharacter.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+import java.util.*;
+import jakarta.validation.constraints.*;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 用户人设管理新增/修改 Request VO")
+@Data
+public class KeyboardUserCharacterSaveReqVO {
+
+    @Schema(description = "主键 Id", requiredMode = Schema.RequiredMode.REQUIRED, example = "32344")
+    private Long id;
+
+    @Schema(description = "键盘人设 id", example = "7333")
+    private Long characterId;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "更新时间")
+    private LocalDateTime updatedAt;
+
+    @Schema(description = "用户 Id", example = "31348")
+    private Long userId;
+
+    @Schema(description = "emoji 标签")
+    private String emoji;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userinvitecodes/KeyboardUserInviteCodesController.java

@@ -0,0 +1,104 @@
+package com.yolo.keyboard.controller.admin.userinvitecodes;
+
+import org.springframework.web.bind.annotation.*;
+import jakarta.annotation.Resource;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.security.access.prepost.PreAuthorize;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Operation;
+
+import jakarta.validation.constraints.*;
+import jakarta.validation.*;
+import jakarta.servlet.http.*;
+import java.util.*;
+import java.io.IOException;
+
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.CommonResult;
+import com.yolo.keyboard.framework.common.util.object.BeanUtils;
+import static com.yolo.keyboard.framework.common.pojo.CommonResult.success;
+
+import com.yolo.keyboard.framework.excel.core.util.ExcelUtils;
+
+import com.yolo.keyboard.framework.apilog.core.annotation.ApiAccessLog;
+import static com.yolo.keyboard.framework.apilog.core.enums.OperateTypeEnum.*;
+
+import com.yolo.keyboard.controller.admin.userinvitecodes.vo.*;
+import com.yolo.keyboard.dal.dataobject.userinvitecodes.KeyboardUserInviteCodesDO;
+import com.yolo.keyboard.service.userinvitecodes.KeyboardUserInviteCodesService;
+
+@Tag(name = "管理后台 - 用户生成的邀请码表，用于邀请新用户注册/安装并建立邀请关系")
+@RestController
+@RequestMapping("/keyboard/user-invite-codes")
+@Validated
+public class KeyboardUserInviteCodesController {
+
+    @Resource
+    private KeyboardUserInviteCodesService userInviteCodesService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建用户生成的邀请码表，用于邀请新用户注册/安装并建立邀请关系")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-invite-codes:create')")
+    public CommonResult<Long> createUserInviteCodes(@Valid @RequestBody KeyboardUserInviteCodesSaveReqVO createReqVO) {
+        return success(userInviteCodesService.createUserInviteCodes(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新用户生成的邀请码表，用于邀请新用户注册/安装并建立邀请关系")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-invite-codes:update')")
+    public CommonResult<Boolean> updateUserInviteCodes(@Valid @RequestBody KeyboardUserInviteCodesSaveReqVO updateReqVO) {
+        userInviteCodesService.updateUserInviteCodes(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除用户生成的邀请码表，用于邀请新用户注册/安装并建立邀请关系")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('keyboard:user-invite-codes:delete')")
+    public CommonResult<Boolean> deleteUserInviteCodes(@RequestParam("id") Long id) {
+        userInviteCodesService.deleteUserInviteCodes(id);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete-list")
+    @Parameter(name = "ids", description = "编号", required = true)
+    @Operation(summary = "批量删除用户生成的邀请码表，用于邀请新用户注册/安装并建立邀请关系")
+                @PreAuthorize("@ss.hasPermission('keyboard:user-invite-codes:delete')")
+    public CommonResult<Boolean> deleteUserInviteCodesList(@RequestParam("ids") List<Long> ids) {
+        userInviteCodesService.deleteUserInviteCodesListByIds(ids);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得用户生成的邀请码表，用于邀请新用户注册/安装并建立邀请关系")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-invite-codes:query')")
+    public CommonResult<KeyboardUserInviteCodesRespVO> getUserInviteCodes(@RequestParam("id") Long id) {
+        KeyboardUserInviteCodesDO userInviteCodes = userInviteCodesService.getUserInviteCodes(id);
+        return success(BeanUtils.toBean(userInviteCodes, KeyboardUserInviteCodesRespVO.class));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得用户生成的邀请码表，用于邀请新用户注册/安装并建立邀请关系分页")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-invite-codes:query')")
+    public CommonResult<PageResult<KeyboardUserInviteCodesRespVO>> getUserInviteCodesPage(@Valid KeyboardUserInviteCodesPageReqVO pageReqVO) {
+        PageResult<KeyboardUserInviteCodesDO> pageResult = userInviteCodesService.getUserInviteCodesPage(pageReqVO);
+        return success(BeanUtils.toBean(pageResult, KeyboardUserInviteCodesRespVO.class));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出用户生成的邀请码表，用于邀请新用户注册/安装并建立邀请关系 Excel")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-invite-codes:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportUserInviteCodesExcel(@Valid KeyboardUserInviteCodesPageReqVO pageReqVO,
+              HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<KeyboardUserInviteCodesDO> list = userInviteCodesService.getUserInviteCodesPage(pageReqVO).getList();
+        // 导出 Excel
+        ExcelUtils.write(response, "用户生成的邀请码表，用于邀请新用户注册/安装并建立邀请关系.xls", "数据", KeyboardUserInviteCodesRespVO.class,
+                        BeanUtils.toBean(list, KeyboardUserInviteCodesRespVO.class));
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userinvitecodes/vo/KeyboardUserInviteCodesPageReqVO.java

@@ -0,0 +1,46 @@
+package com.yolo.keyboard.controller.admin.userinvitecodes.vo;
+
+import lombok.*;
+import java.util.*;
+import io.swagger.v3.oas.annotations.media.Schema;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+import static com.yolo.keyboard.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - 用户生成的邀请码表，用于邀请新用户注册/安装并建立邀请关系分页 Request VO")
+@Data
+public class KeyboardUserInviteCodesPageReqVO extends PageParam {
+
+    @Schema(description = "邀请码字符串，对外展示，唯一")
+    private String code;
+
+    @Schema(description = "邀请码所属用户ID（邀请人）", example = "14170")
+    private Long ownerUserId;
+
+    @Schema(description = "邀请码状态：1=启用，0=停用", example = "2")
+    private Short status;
+
+    @Schema(description = "邀请码创建时间")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "邀请码过期时间，NULL表示永久有效")
+    private LocalDateTime expiresAt;
+
+    @Schema(description = "邀请码最大可使用次数，NULL表示不限次数")
+    private Integer maxUses;
+
+    @Schema(description = "邀请码已使用次数", example = "25037")
+    private Integer usedCount;
+
+    @Schema(description = "邀请码所属租户", example = "17355")
+    private Long ownerTenantId;
+
+    @Schema(description = "邀请码所属系统用户", example = "772")
+    private Long ownerSystemUserId;
+
+    @Schema(description = "邀请码类型", example = "1")
+    private String inviteType;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userinvitecodes/vo/KeyboardUserInviteCodesRespVO.java

@@ -0,0 +1,59 @@
+package com.yolo.keyboard.controller.admin.userinvitecodes.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+import java.util.*;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+import cn.idev.excel.annotation.*;
+
+@Schema(description = "管理后台 - 用户生成的邀请码表，用于邀请新用户注册/安装并建立邀请关系 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class KeyboardUserInviteCodesRespVO {
+
+    @Schema(description = "邀请码主键ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "3053")
+    @ExcelProperty("邀请码主键ID")
+    private Long id;
+
+    @Schema(description = "邀请码字符串，对外展示，唯一", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("邀请码字符串，对外展示，唯一")
+    private String code;
+
+    @Schema(description = "邀请码所属用户ID（邀请人）", requiredMode = Schema.RequiredMode.REQUIRED, example = "14170")
+    @ExcelProperty("邀请码所属用户ID（邀请人）")
+    private Long ownerUserId;
+
+    @Schema(description = "邀请码状态：1=启用，0=停用", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    @ExcelProperty("邀请码状态：1=启用，0=停用")
+    private Short status;
+
+    @Schema(description = "邀请码创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("邀请码创建时间")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "邀请码过期时间，NULL表示永久有效")
+    @ExcelProperty("邀请码过期时间，NULL表示永久有效")
+    private LocalDateTime expiresAt;
+
+    @Schema(description = "邀请码最大可使用次数，NULL表示不限次数")
+    @ExcelProperty("邀请码最大可使用次数，NULL表示不限次数")
+    private Integer maxUses;
+
+    @Schema(description = "邀请码已使用次数", requiredMode = Schema.RequiredMode.REQUIRED, example = "25037")
+    @ExcelProperty("邀请码已使用次数")
+    private Integer usedCount;
+    
+    @Schema(description = "邀请码所属租户", example = "17355")
+    @ExcelProperty("邀请码所属租户")
+    private Long ownerTenantId;
+
+    @Schema(description = "邀请码所属系统用户ID（邀请人）", example = "772")
+    @ExcelProperty("邀请码所属系统用户")
+    private Long ownerSystemUserId;
+
+    @Schema(description = "邀请码类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @ExcelProperty("邀请码类型")
+    private String inviteType;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userinvitecodes/vo/KeyboardUserInviteCodesSaveReqVO.java

@@ -0,0 +1,53 @@
+package com.yolo.keyboard.controller.admin.userinvitecodes.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+import java.util.*;
+import jakarta.validation.constraints.*;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 用户生成的邀请码表，用于邀请新用户注册/安装并建立邀请关系新增/修改 Request VO")
+@Data
+public class KeyboardUserInviteCodesSaveReqVO {
+
+    @Schema(description = "邀请码主键ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "3053")
+    private Long id;
+
+    @Schema(description = "邀请码字符串，对外展示，唯一", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "邀请码字符串，对外展示，唯一不能为空")
+    private String code;
+
+    @Schema(description = "邀请码所属用户ID（邀请人）", requiredMode = Schema.RequiredMode.REQUIRED, example = "14170")
+    @NotNull(message = "邀请码所属用户ID（邀请人）不能为空")
+    private Long ownerUserId;
+
+    @Schema(description = "邀请码状态：1=启用，0=停用", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    @NotNull(message = "邀请码状态：1=启用，0=停用不能为空")
+    private Short status;
+
+    @Schema(description = "邀请码创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "邀请码创建时间不能为空")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "邀请码过期时间，NULL表示永久有效")
+    private LocalDateTime expiresAt;
+
+    @Schema(description = "邀请码最大可使用次数，NULL表示不限次数")
+    private Integer maxUses;
+
+    @Schema(description = "邀请码已使用次数", requiredMode = Schema.RequiredMode.REQUIRED, example = "25037")
+    @NotNull(message = "邀请码已使用次数不能为空")
+    private Integer usedCount;
+
+    @Schema(description = "邀请码所属租户", example = "17355")
+    private Long ownerTenantId;
+
+    @Schema(description = "邀请码所属系统用户", example = "772")
+    private Long ownerSystemUserId;
+
+    @Schema(description = "邀请码类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotEmpty(message = "邀请码类型不能为空")
+    private String inviteType;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userinvites/KeyboardUserInvitesController.java

@@ -0,0 +1,104 @@
+package com.yolo.keyboard.controller.admin.userinvites;
+
+import org.springframework.web.bind.annotation.*;
+import jakarta.annotation.Resource;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.security.access.prepost.PreAuthorize;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Operation;
+
+import jakarta.validation.constraints.*;
+import jakarta.validation.*;
+import jakarta.servlet.http.*;
+import java.util.*;
+import java.io.IOException;
+
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.CommonResult;
+import com.yolo.keyboard.framework.common.util.object.BeanUtils;
+import static com.yolo.keyboard.framework.common.pojo.CommonResult.success;
+
+import com.yolo.keyboard.framework.excel.core.util.ExcelUtils;
+
+import com.yolo.keyboard.framework.apilog.core.annotation.ApiAccessLog;
+import static com.yolo.keyboard.framework.apilog.core.enums.OperateTypeEnum.*;
+
+import com.yolo.keyboard.controller.admin.userinvites.vo.*;
+import com.yolo.keyboard.dal.dataobject.userinvites.KeyboardUserInvitesDO;
+import com.yolo.keyboard.service.userinvites.KeyboardUserInvitesService;
+
+@Tag(name = "管理后台 - 用户邀请关系绑定台账表，记录新用户最终归属的邀请人")
+@RestController
+@RequestMapping("/keyboard/user-invites")
+@Validated
+public class KeyboardUserInvitesController {
+
+    @Resource
+    private KeyboardUserInvitesService userInvitesService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建用户邀请关系绑定台账表，记录新用户最终归属的邀请人")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-invites:create')")
+    public CommonResult<Long> createUserInvites(@Valid @RequestBody KeyboardUserInvitesSaveReqVO createReqVO) {
+        return success(userInvitesService.createUserInvites(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新用户邀请关系绑定台账表，记录新用户最终归属的邀请人")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-invites:update')")
+    public CommonResult<Boolean> updateUserInvites(@Valid @RequestBody KeyboardUserInvitesSaveReqVO updateReqVO) {
+        userInvitesService.updateUserInvites(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除用户邀请关系绑定台账表，记录新用户最终归属的邀请人")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('keyboard:user-invites:delete')")
+    public CommonResult<Boolean> deleteUserInvites(@RequestParam("id") Long id) {
+        userInvitesService.deleteUserInvites(id);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete-list")
+    @Parameter(name = "ids", description = "编号", required = true)
+    @Operation(summary = "批量删除用户邀请关系绑定台账表，记录新用户最终归属的邀请人")
+                @PreAuthorize("@ss.hasPermission('keyboard:user-invites:delete')")
+    public CommonResult<Boolean> deleteUserInvitesList(@RequestParam("ids") List<Long> ids) {
+        userInvitesService.deleteUserInvitesListByIds(ids);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得用户邀请关系绑定台账表，记录新用户最终归属的邀请人")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-invites:query')")
+    public CommonResult<KeyboardUserInvitesRespVO> getUserInvites(@RequestParam("id") Long id) {
+        KeyboardUserInvitesDO userInvites = userInvitesService.getUserInvites(id);
+        return success(BeanUtils.toBean(userInvites, KeyboardUserInvitesRespVO.class));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得用户邀请关系绑定台账表，记录新用户最终归属的邀请人分页")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-invites:query')")
+    public CommonResult<PageResult<KeyboardUserInvitesRespVO>> getUserInvitesPage(@Valid KeyboardUserInvitesPageReqVO pageReqVO) {
+        PageResult<KeyboardUserInvitesDO> pageResult = userInvitesService.getUserInvitesPage(pageReqVO);
+        return success(BeanUtils.toBean(pageResult, KeyboardUserInvitesRespVO.class));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出用户邀请关系绑定台账表，记录新用户最终归属的邀请人 Excel")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-invites:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportUserInvitesExcel(@Valid KeyboardUserInvitesPageReqVO pageReqVO,
+              HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<KeyboardUserInvitesDO> list = userInvitesService.getUserInvitesPage(pageReqVO).getList();
+        // 导出 Excel
+        ExcelUtils.write(response, "用户邀请关系绑定台账表，记录新用户最终归属的邀请人.xls", "数据", KeyboardUserInvitesRespVO.class,
+                        BeanUtils.toBean(list, KeyboardUserInvitesRespVO.class));
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userinvites/vo/KeyboardUserInvitesPageReqVO.java

@@ -0,0 +1,55 @@
+package com.yolo.keyboard.controller.admin.userinvites.vo;
+
+import lombok.*;
+import java.util.*;
+import io.swagger.v3.oas.annotations.media.Schema;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+import static com.yolo.keyboard.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - 用户邀请关系绑定台账表，记录新用户最终归属的邀请人分页 Request VO")
+@Data
+public class KeyboardUserInvitesPageReqVO extends PageParam {
+
+    @Schema(description = "邀请人用户ID", example = "11992")
+    private Long inviterUserId;
+
+    @Schema(description = "被邀请人用户ID（新注册用户）", example = "28499")
+    private Long inviteeUserId;
+
+    @Schema(description = "使用的邀请码ID", example = "30340")
+    private Long inviteCodeId;
+
+    @Schema(description = "绑定时关联的点击Token（通过邀请链接自动绑定时使用）")
+    private String clickToken;
+
+    @Schema(description = "绑定方式：1=手动填写邀请码，2=邀请链接自动绑定，3=其他方式", example = "2")
+    private Short bindType;
+
+    @Schema(description = "邀请关系绑定完成时间")
+    private LocalDateTime boundAt;
+
+    @Schema(description = "绑定 iP")
+    private String bindIp;
+
+    @Schema(description = "userAgent")
+    private String bindUserAgent;
+
+    @Schema(description = "邀请码类型快照：USER=普通用户邀请，AGENT=代理邀请", example = "2")
+    private String inviteType;
+
+    @Schema(description = "收益结算归属租户ID（代理结算用，绑定时固化）", example = "25223")
+    private Long profitTenantId;
+
+    @Schema(description = "收益归因员工ID（用于区分租户员工/渠道，绑定时固化）", example = "31236")
+    private Long profitEmployeeId;
+
+    @Schema(description = "邀请人所属租户ID快照（便于审计/对账，可选）", example = "17028")
+    private Long inviterTenantId;
+
+    @Schema(description = "邀请码字符串快照（便于排查，可选）")
+    private String inviteCode;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userinvites/vo/KeyboardUserInvitesRespVO.java

@@ -0,0 +1,71 @@
+package com.yolo.keyboard.controller.admin.userinvites.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+import java.util.*;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+import cn.idev.excel.annotation.*;
+
+@Schema(description = "管理后台 - 用户邀请关系绑定台账表，记录新用户最终归属的邀请人 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class KeyboardUserInvitesRespVO {
+
+    @Schema(description = "邀请绑定记录主键ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "7254")
+    @ExcelProperty("邀请绑定记录主键ID")
+    private Long id;
+
+    @Schema(description = "邀请人用户ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "11992")
+    @ExcelProperty("邀请人用户ID")
+    private Long inviterUserId;
+
+    @Schema(description = "被邀请人用户ID（新注册用户）", requiredMode = Schema.RequiredMode.REQUIRED, example = "28499")
+    @ExcelProperty("被邀请人用户ID（新注册用户）")
+    private Long inviteeUserId;
+
+    @Schema(description = "使用的邀请码ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "30340")
+    @ExcelProperty("使用的邀请码ID")
+    private Long inviteCodeId;
+
+    @Schema(description = "绑定时关联的点击Token（通过邀请链接自动绑定时使用）")
+    @ExcelProperty("绑定时关联的点击Token（通过邀请链接自动绑定时使用）")
+    private String clickToken;
+
+    @Schema(description = "绑定方式：1=手动填写邀请码，2=邀请链接自动绑定，3=其他方式", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    @ExcelProperty("绑定方式：1=手动填写邀请码，2=邀请链接自动绑定，3=其他方式")
+    private Short bindType;
+
+    @Schema(description = "邀请关系绑定完成时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("邀请关系绑定完成时间")
+    private LocalDateTime boundAt;
+
+    @Schema(description = "绑定 iP")
+    @ExcelProperty("绑定 iP")
+    private String bindIp;
+
+    @Schema(description = "userAgent")
+    @ExcelProperty("userAgent")
+    private String bindUserAgent;
+
+    @Schema(description = "邀请码类型快照：USER=普通用户邀请，AGENT=代理邀请", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    @ExcelProperty("邀请码类型快照：USER=普通用户邀请，AGENT=代理邀请")
+    private String inviteType;
+
+    @Schema(description = "收益结算归属租户ID（代理结算用，绑定时固化）", example = "25223")
+    @ExcelProperty("收益结算归属租户ID（代理结算用，绑定时固化）")
+    private Long profitTenantId;
+
+    @Schema(description = "收益归因员工ID（用于区分租户员工/渠道，绑定时固化）", example = "31236")
+    @ExcelProperty("收益归因员工ID（用于区分租户员工/渠道，绑定时固化）")
+    private Long profitEmployeeId;
+
+    @Schema(description = "邀请人所属租户ID快照（便于审计/对账，可选）", example = "17028")
+    @ExcelProperty("邀请人所属租户ID快照（便于审计/对账，可选）")
+    private Long inviterTenantId;
+
+    @Schema(description = "邀请码字符串快照（便于排查，可选）")
+    @ExcelProperty("邀请码字符串快照（便于排查，可选）")
+    private String inviteCode;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userinvites/vo/KeyboardUserInvitesSaveReqVO.java

@@ -0,0 +1,62 @@
+package com.yolo.keyboard.controller.admin.userinvites.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+import java.util.*;
+import jakarta.validation.constraints.*;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 用户邀请关系绑定台账表，记录新用户最终归属的邀请人新增/修改 Request VO")
+@Data
+public class KeyboardUserInvitesSaveReqVO {
+
+    @Schema(description = "邀请绑定记录主键ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "7254")
+    private Long id;
+
+    @Schema(description = "邀请人用户ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "11992")
+    @NotNull(message = "邀请人用户ID不能为空")
+    private Long inviterUserId;
+
+    @Schema(description = "被邀请人用户ID（新注册用户）", requiredMode = Schema.RequiredMode.REQUIRED, example = "28499")
+    @NotNull(message = "被邀请人用户ID（新注册用户）不能为空")
+    private Long inviteeUserId;
+
+    @Schema(description = "使用的邀请码ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "30340")
+    @NotNull(message = "使用的邀请码ID不能为空")
+    private Long inviteCodeId;
+
+    @Schema(description = "绑定时关联的点击Token（通过邀请链接自动绑定时使用）")
+    private String clickToken;
+
+    @Schema(description = "绑定方式：1=手动填写邀请码，2=邀请链接自动绑定，3=其他方式", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    @NotNull(message = "绑定方式：1=手动填写邀请码，2=邀请链接自动绑定，3=其他方式不能为空")
+    private Short bindType;
+
+    @Schema(description = "邀请关系绑定完成时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "邀请关系绑定完成时间不能为空")
+    private LocalDateTime boundAt;
+
+    @Schema(description = "绑定 iP")
+    private String bindIp;
+
+    @Schema(description = "userAgent")
+    private String bindUserAgent;
+
+    @Schema(description = "邀请码类型快照：USER=普通用户邀请，AGENT=代理邀请", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    @NotEmpty(message = "邀请码类型快照：USER=普通用户邀请，AGENT=代理邀请不能为空")
+    private String inviteType;
+
+    @Schema(description = "收益结算归属租户ID（代理结算用，绑定时固化）", example = "25223")
+    private Long profitTenantId;
+
+    @Schema(description = "收益归因员工ID（用于区分租户员工/渠道，绑定时固化）", example = "31236")
+    private Long profitEmployeeId;
+
+    @Schema(description = "邀请人所属租户ID快照（便于审计/对账，可选）", example = "17028")
+    private Long inviterTenantId;
+
+    @Schema(description = "邀请码字符串快照（便于排查，可选）")
+    private String inviteCode;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userpurchaserecords/KeyboardUserPurchaseRecordsController.java

@@ -0,0 +1,104 @@
+package com.yolo.keyboard.controller.admin.userpurchaserecords;
+
+import org.springframework.web.bind.annotation.*;
+import jakarta.annotation.Resource;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.security.access.prepost.PreAuthorize;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Operation;
+
+import jakarta.validation.constraints.*;
+import jakarta.validation.*;
+import jakarta.servlet.http.*;
+import java.util.*;
+import java.io.IOException;
+
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.CommonResult;
+import com.yolo.keyboard.framework.common.util.object.BeanUtils;
+import static com.yolo.keyboard.framework.common.pojo.CommonResult.success;
+
+import com.yolo.keyboard.framework.excel.core.util.ExcelUtils;
+
+import com.yolo.keyboard.framework.apilog.core.annotation.ApiAccessLog;
+import static com.yolo.keyboard.framework.apilog.core.enums.OperateTypeEnum.*;
+
+import com.yolo.keyboard.controller.admin.userpurchaserecords.vo.*;
+import com.yolo.keyboard.dal.dataobject.userpurchaserecords.KeyboardUserPurchaseRecordsDO;
+import com.yolo.keyboard.service.userpurchaserecords.KeyboardUserPurchaseRecordsService;
+
+@Tag(name = "管理后台 - 用户内购记录")
+@RestController
+@RequestMapping("/keyboard/user-purchase-records")
+@Validated
+public class KeyboardUserPurchaseRecordsController {
+
+    @Resource
+    private KeyboardUserPurchaseRecordsService userPurchaseRecordsService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建用户内购记录")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-purchase-records:create')")
+    public CommonResult<Integer> createUserPurchaseRecords(@Valid @RequestBody KeyboardUserPurchaseRecordsSaveReqVO createReqVO) {
+        return success(userPurchaseRecordsService.createUserPurchaseRecords(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新用户内购记录")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-purchase-records:update')")
+    public CommonResult<Boolean> updateUserPurchaseRecords(@Valid @RequestBody KeyboardUserPurchaseRecordsSaveReqVO updateReqVO) {
+        userPurchaseRecordsService.updateUserPurchaseRecords(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除用户内购记录")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('keyboard:user-purchase-records:delete')")
+    public CommonResult<Boolean> deleteUserPurchaseRecords(@RequestParam("id") Integer id) {
+        userPurchaseRecordsService.deleteUserPurchaseRecords(id);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete-list")
+    @Parameter(name = "ids", description = "编号", required = true)
+    @Operation(summary = "批量删除用户内购记录")
+                @PreAuthorize("@ss.hasPermission('keyboard:user-purchase-records:delete')")
+    public CommonResult<Boolean> deleteUserPurchaseRecordsList(@RequestParam("ids") List<Integer> ids) {
+        userPurchaseRecordsService.deleteUserPurchaseRecordsListByIds(ids);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得用户内购记录")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-purchase-records:query')")
+    public CommonResult<KeyboardUserPurchaseRecordsRespVO> getUserPurchaseRecords(@RequestParam("id") Integer id) {
+        KeyboardUserPurchaseRecordsDO userPurchaseRecords = userPurchaseRecordsService.getUserPurchaseRecords(id);
+        return success(BeanUtils.toBean(userPurchaseRecords, KeyboardUserPurchaseRecordsRespVO.class));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得用户内购记录分页")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-purchase-records:query')")
+    public CommonResult<PageResult<KeyboardUserPurchaseRecordsRespVO>> getUserPurchaseRecordsPage(@Valid KeyboardUserPurchaseRecordsPageReqVO pageReqVO) {
+        PageResult<KeyboardUserPurchaseRecordsDO> pageResult = userPurchaseRecordsService.getUserPurchaseRecordsPage(pageReqVO);
+        return success(BeanUtils.toBean(pageResult, KeyboardUserPurchaseRecordsRespVO.class));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出用户内购记录 Excel")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-purchase-records:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportUserPurchaseRecordsExcel(@Valid KeyboardUserPurchaseRecordsPageReqVO pageReqVO,
+              HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<KeyboardUserPurchaseRecordsDO> list = userPurchaseRecordsService.getUserPurchaseRecordsPage(pageReqVO).getList();
+        // 导出 Excel
+        ExcelUtils.write(response, "用户内购记录.xls", "数据", KeyboardUserPurchaseRecordsRespVO.class,
+                        BeanUtils.toBean(list, KeyboardUserPurchaseRecordsRespVO.class));
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userpurchaserecords/vo/KeyboardUserPurchaseRecordsPageReqVO.java

@@ -0,0 +1,65 @@
+package com.yolo.keyboard.controller.admin.userpurchaserecords.vo;
+
+import lombok.*;
+import java.util.*;
+import io.swagger.v3.oas.annotations.media.Schema;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import java.math.BigDecimal;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+import static com.yolo.keyboard.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - 用户内购记录分页 Request VO")
+@Data
+public class KeyboardUserPurchaseRecordsPageReqVO extends PageParam {
+
+    @Schema(description = "用户 ID，关联到用户表，表示是哪位用户购买了产品", example = "21782")
+    private Integer userId;
+
+    @Schema(description = "购买的产品 ID，关联到产品表", example = "10744")
+    private String productId;
+
+    @Schema(description = "购买数量（如内购的金币数量，订阅的时长）")
+    private Integer purchaseQuantity;
+
+    @Schema(description = "实际支付价格", example = "17601")
+    private BigDecimal price;
+
+    @Schema(description = "货币类型（如美元 $）")
+    private String currency;
+
+    @Schema(description = "购买时间")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] purchaseTime;
+
+    @Schema(description = "购买类型（如内购，订阅）", example = "1")
+    private String purchaseType;
+
+    @Schema(description = "购买状态（如已支付，待支付，退款）", example = "2")
+    private String status;
+
+    @Schema(description = "支付方式（如信用卡，支付宝等）")
+    private String paymentMethod;
+
+    @Schema(description = "唯一的交易 ID，用于标识该购买操作", example = "14496")
+    private String transactionId;
+
+    @Schema(description = "苹果的原始交易 ID", example = "3666")
+    private String originalTransactionId;
+
+    @Schema(description = "购买的产品 ID 列表（JSON 格式或数组）")
+    private Object productIds;
+
+    @Schema(description = "苹果返回的购买时间")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] purchaseDate;
+
+    @Schema(description = "苹果返回的过期时间（如果有）")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] expiresDate;
+
+    @Schema(description = "苹果的环境（如 Sandbox 或 Production）")
+    private String environment;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userpurchaserecords/vo/KeyboardUserPurchaseRecordsRespVO.java

@@ -0,0 +1,80 @@
+package com.yolo.keyboard.controller.admin.userpurchaserecords.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+import java.util.*;
+import java.math.BigDecimal;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+import cn.idev.excel.annotation.*;
+
+@Schema(description = "管理后台 - 用户内购记录 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class KeyboardUserPurchaseRecordsRespVO {
+
+    @Schema(description = "主键，自增，唯一标识每条购买记录", requiredMode = Schema.RequiredMode.REQUIRED, example = "1239")
+    @ExcelProperty("主键，自增，唯一标识每条购买记录")
+    private Integer id;
+
+    @Schema(description = "用户 ID，关联到用户表，表示是哪位用户购买了产品", requiredMode = Schema.RequiredMode.REQUIRED, example = "21782")
+    @ExcelProperty("用户 ID，关联到用户表，表示是哪位用户购买了产品")
+    private Integer userId;
+
+    @Schema(description = "购买的产品 ID，关联到产品表", requiredMode = Schema.RequiredMode.REQUIRED, example = "10744")
+    @ExcelProperty("购买的产品 ID，关联到产品表")
+    private String productId;
+
+    @Schema(description = "购买数量（如内购的金币数量，订阅的时长）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("购买数量（如内购的金币数量，订阅的时长）")
+    private Integer purchaseQuantity;
+
+    @Schema(description = "实际支付价格", requiredMode = Schema.RequiredMode.REQUIRED, example = "17601")
+    @ExcelProperty("实际支付价格")
+    private BigDecimal price;
+
+    @Schema(description = "货币类型（如美元 $）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("货币类型（如美元 $）")
+    private String currency;
+
+    @Schema(description = "购买时间")
+    @ExcelProperty("购买时间")
+    private LocalDateTime purchaseTime;
+
+    @Schema(description = "购买类型（如内购，订阅）", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @ExcelProperty("购买类型（如内购，订阅）")
+    private String purchaseType;
+
+    @Schema(description = "购买状态（如已支付，待支付，退款）", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    @ExcelProperty("购买状态（如已支付，待支付，退款）")
+    private String status;
+
+    @Schema(description = "支付方式（如信用卡，支付宝等）")
+    @ExcelProperty("支付方式（如信用卡，支付宝等）")
+    private String paymentMethod;
+
+    @Schema(description = "唯一的交易 ID，用于标识该购买操作", requiredMode = Schema.RequiredMode.REQUIRED, example = "14496")
+    @ExcelProperty("唯一的交易 ID，用于标识该购买操作")
+    private String transactionId;
+
+    @Schema(description = "苹果的原始交易 ID", example = "3666")
+    @ExcelProperty("苹果的原始交易 ID")
+    private String originalTransactionId;
+
+    @Schema(description = "购买的产品 ID 列表（JSON 格式或数组）")
+    @ExcelProperty("购买的产品 ID 列表（JSON 格式或数组）")
+    private Object productIds;
+
+    @Schema(description = "苹果返回的购买时间")
+    @ExcelProperty("苹果返回的购买时间")
+    private LocalDateTime purchaseDate;
+
+    @Schema(description = "苹果返回的过期时间（如果有）")
+    @ExcelProperty("苹果返回的过期时间（如果有）")
+    private LocalDateTime expiresDate;
+
+    @Schema(description = "苹果的环境（如 Sandbox 或 Production）")
+    @ExcelProperty("苹果的环境（如 Sandbox 或 Production）")
+    private String environment;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userpurchaserecords/vo/KeyboardUserPurchaseRecordsSaveReqVO.java

@@ -0,0 +1,71 @@
+package com.yolo.keyboard.controller.admin.userpurchaserecords.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+import java.util.*;
+import jakarta.validation.constraints.*;
+import java.math.BigDecimal;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 用户内购记录新增/修改 Request VO")
+@Data
+public class KeyboardUserPurchaseRecordsSaveReqVO {
+
+    @Schema(description = "主键，自增，唯一标识每条购买记录", requiredMode = Schema.RequiredMode.REQUIRED, example = "1239")
+    private Integer id;
+
+    @Schema(description = "用户 ID，关联到用户表，表示是哪位用户购买了产品", requiredMode = Schema.RequiredMode.REQUIRED, example = "21782")
+    @NotNull(message = "用户 ID，关联到用户表，表示是哪位用户购买了产品不能为空")
+    private Integer userId;
+
+    @Schema(description = "购买的产品 ID，关联到产品表", requiredMode = Schema.RequiredMode.REQUIRED, example = "10744")
+    @NotEmpty(message = "购买的产品 ID，关联到产品表不能为空")
+    private String productId;
+
+    @Schema(description = "购买数量（如内购的金币数量，订阅的时长）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "购买数量（如内购的金币数量，订阅的时长）不能为空")
+    private Integer purchaseQuantity;
+
+    @Schema(description = "实际支付价格", requiredMode = Schema.RequiredMode.REQUIRED, example = "17601")
+    @NotNull(message = "实际支付价格不能为空")
+    private BigDecimal price;
+
+    @Schema(description = "货币类型（如美元 $）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "货币类型（如美元 $）不能为空")
+    private String currency;
+
+    @Schema(description = "购买时间")
+    private LocalDateTime purchaseTime;
+
+    @Schema(description = "购买类型（如内购，订阅）", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotEmpty(message = "购买类型（如内购，订阅）不能为空")
+    private String purchaseType;
+
+    @Schema(description = "购买状态（如已支付，待支付，退款）", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    @NotEmpty(message = "购买状态（如已支付，待支付，退款）不能为空")
+    private String status;
+
+    @Schema(description = "支付方式（如信用卡，支付宝等）")
+    private String paymentMethod;
+
+    @Schema(description = "唯一的交易 ID，用于标识该购买操作", requiredMode = Schema.RequiredMode.REQUIRED, example = "14496")
+    @NotEmpty(message = "唯一的交易 ID，用于标识该购买操作不能为空")
+    private String transactionId;
+
+    @Schema(description = "苹果的原始交易 ID", example = "3666")
+    private String originalTransactionId;
+
+    @Schema(description = "购买的产品 ID 列表（JSON 格式或数组）")
+    private Object productIds;
+
+    @Schema(description = "苹果返回的购买时间")
+    private LocalDateTime purchaseDate;
+
+    @Schema(description = "苹果返回的过期时间（如果有）")
+    private LocalDateTime expiresDate;
+
+    @Schema(description = "苹果的环境（如 Sandbox 或 Production）")
+    private String environment;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userquotatotal/KeyboardUserQuotaTotalController.java

@@ -0,0 +1,104 @@
+package com.yolo.keyboard.controller.admin.userquotatotal;
+
+import org.springframework.web.bind.annotation.*;
+import jakarta.annotation.Resource;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.security.access.prepost.PreAuthorize;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Operation;
+
+import jakarta.validation.constraints.*;
+import jakarta.validation.*;
+import jakarta.servlet.http.*;
+import java.util.*;
+import java.io.IOException;
+
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.CommonResult;
+import com.yolo.keyboard.framework.common.util.object.BeanUtils;
+import static com.yolo.keyboard.framework.common.pojo.CommonResult.success;
+
+import com.yolo.keyboard.framework.excel.core.util.ExcelUtils;
+
+import com.yolo.keyboard.framework.apilog.core.annotation.ApiAccessLog;
+import static com.yolo.keyboard.framework.apilog.core.enums.OperateTypeEnum.*;
+
+import com.yolo.keyboard.controller.admin.userquotatotal.vo.*;
+import com.yolo.keyboard.dal.dataobject.userquotatotal.KeyboardUserQuotaTotalDO;
+import com.yolo.keyboard.service.userquotatotal.KeyboardUserQuotaTotalService;
+
+@Tag(name = "管理后台 - 用户免费功能永久总次数额度表（所有功能共用）")
+@RestController
+@RequestMapping("/keyboard/user-quota-total")
+@Validated
+public class KeyboardUserQuotaTotalController {
+
+    @Resource
+    private KeyboardUserQuotaTotalService userQuotaTotalService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建用户免费功能永久总次数额度表（所有功能共用）")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-quota-total:create')")
+    public CommonResult<Long> createUserQuotaTotal(@Valid @RequestBody KeyboardUserQuotaTotalSaveReqVO createReqVO) {
+        return success(userQuotaTotalService.createUserQuotaTotal(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新用户免费功能永久总次数额度表（所有功能共用）")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-quota-total:update')")
+    public CommonResult<Boolean> updateUserQuotaTotal(@Valid @RequestBody KeyboardUserQuotaTotalSaveReqVO updateReqVO) {
+        userQuotaTotalService.updateUserQuotaTotal(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除用户免费功能永久总次数额度表（所有功能共用）")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('keyboard:user-quota-total:delete')")
+    public CommonResult<Boolean> deleteUserQuotaTotal(@RequestParam("id") Long id) {
+        userQuotaTotalService.deleteUserQuotaTotal(id);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete-list")
+    @Parameter(name = "ids", description = "编号", required = true)
+    @Operation(summary = "批量删除用户免费功能永久总次数额度表（所有功能共用）")
+                @PreAuthorize("@ss.hasPermission('keyboard:user-quota-total:delete')")
+    public CommonResult<Boolean> deleteUserQuotaTotalList(@RequestParam("ids") List<Long> ids) {
+        userQuotaTotalService.deleteUserQuotaTotalListByIds(ids);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得用户免费功能永久总次数额度表（所有功能共用）")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-quota-total:query')")
+    public CommonResult<KeyboardUserQuotaTotalRespVO> getUserQuotaTotal(@RequestParam("id") Long id) {
+        KeyboardUserQuotaTotalDO userQuotaTotal = userQuotaTotalService.getUserQuotaTotal(id);
+        return success(BeanUtils.toBean(userQuotaTotal, KeyboardUserQuotaTotalRespVO.class));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得用户免费功能永久总次数额度表（所有功能共用）分页")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-quota-total:query')")
+    public CommonResult<PageResult<KeyboardUserQuotaTotalRespVO>> getUserQuotaTotalPage(@Valid KeyboardUserQuotaTotalPageReqVO pageReqVO) {
+        PageResult<KeyboardUserQuotaTotalDO> pageResult = userQuotaTotalService.getUserQuotaTotalPage(pageReqVO);
+        return success(BeanUtils.toBean(pageResult, KeyboardUserQuotaTotalRespVO.class));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出用户免费功能永久总次数额度表（所有功能共用） Excel")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-quota-total:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportUserQuotaTotalExcel(@Valid KeyboardUserQuotaTotalPageReqVO pageReqVO,
+              HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<KeyboardUserQuotaTotalDO> list = userQuotaTotalService.getUserQuotaTotalPage(pageReqVO).getList();
+        // 导出 Excel
+        ExcelUtils.write(response, "用户免费功能永久总次数额度表（所有功能共用）.xls", "数据", KeyboardUserQuotaTotalRespVO.class,
+                        BeanUtils.toBean(list, KeyboardUserQuotaTotalRespVO.class));
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userquotatotal/vo/KeyboardUserQuotaTotalPageReqVO.java

@@ -0,0 +1,31 @@
+package com.yolo.keyboard.controller.admin.userquotatotal.vo;
+
+import lombok.*;
+import java.util.*;
+import io.swagger.v3.oas.annotations.media.Schema;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+import static com.yolo.keyboard.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - 用户免费功能永久总次数额度表（所有功能共用）分页 Request VO")
+@Data
+public class KeyboardUserQuotaTotalPageReqVO extends PageParam {
+
+    @Schema(description = "免费体验的永久总次数上限（可通过运营活动增加）")
+    private Integer totalQuota;
+
+    @Schema(description = "已消耗的免费次数")
+    private Integer usedQuota;
+
+    @Schema(description = "乐观锁版本号（并发控制预留字段）")
+    private Integer version;
+
+    @Schema(description = "首次创建额度记录的时间（通常为注册时间）")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "最近一次额度发生变化的时间（消耗或赠送）")
+    private LocalDateTime updatedAt;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userquotatotal/vo/KeyboardUserQuotaTotalRespVO.java

@@ -0,0 +1,39 @@
+package com.yolo.keyboard.controller.admin.userquotatotal.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+import java.util.*;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+import cn.idev.excel.annotation.*;
+
+@Schema(description = "管理后台 - 用户免费功能永久总次数额度表（所有功能共用） Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class KeyboardUserQuotaTotalRespVO {
+
+    @Schema(description = "用户唯一ID，对应系统用户", requiredMode = Schema.RequiredMode.REQUIRED, example = "19113")
+    @ExcelProperty("用户唯一ID，对应系统用户")
+    private Long userId;
+
+    @Schema(description = "免费体验的永久总次数上限（可通过运营活动增加）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("免费体验的永久总次数上限（可通过运营活动增加）")
+    private Integer totalQuota;
+
+    @Schema(description = "已消耗的免费次数", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("已消耗的免费次数")
+    private Integer usedQuota;
+
+    @Schema(description = "乐观锁版本号（并发控制预留字段）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("乐观锁版本号（并发控制预留字段）")
+    private Integer version;
+
+    @Schema(description = "首次创建额度记录的时间（通常为注册时间）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("首次创建额度记录的时间（通常为注册时间）")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "最近一次额度发生变化的时间（消耗或赠送）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("最近一次额度发生变化的时间（消耗或赠送）")
+    private LocalDateTime updatedAt;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userquotatotal/vo/KeyboardUserQuotaTotalSaveReqVO.java

@@ -0,0 +1,37 @@
+package com.yolo.keyboard.controller.admin.userquotatotal.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+import java.util.*;
+import jakarta.validation.constraints.*;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 用户免费功能永久总次数额度表（所有功能共用）新增/修改 Request VO")
+@Data
+public class KeyboardUserQuotaTotalSaveReqVO {
+
+    @Schema(description = "用户唯一ID，对应系统用户", requiredMode = Schema.RequiredMode.REQUIRED, example = "19113")
+    private Long userId;
+
+    @Schema(description = "免费体验的永久总次数上限（可通过运营活动增加）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "免费体验的永久总次数上限（可通过运营活动增加）不能为空")
+    private Integer totalQuota;
+
+    @Schema(description = "已消耗的免费次数", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "已消耗的免费次数不能为空")
+    private Integer usedQuota;
+
+    @Schema(description = "乐观锁版本号（并发控制预留字段）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "乐观锁版本号（并发控制预留字段）不能为空")
+    private Integer version;
+
+    @Schema(description = "首次创建额度记录的时间（通常为注册时间）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "首次创建额度记录的时间（通常为注册时间）不能为空")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "最近一次额度发生变化的时间（消耗或赠送）", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "最近一次额度发生变化的时间（消耗或赠送）不能为空")
+    private LocalDateTime updatedAt;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userthemes/KeyboardUserThemesController.java

@@ -0,0 +1,104 @@
+package com.yolo.keyboard.controller.admin.userthemes;
+
+import org.springframework.web.bind.annotation.*;
+import jakarta.annotation.Resource;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.security.access.prepost.PreAuthorize;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Operation;
+
+import jakarta.validation.constraints.*;
+import jakarta.validation.*;
+import jakarta.servlet.http.*;
+import java.util.*;
+import java.io.IOException;
+
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.CommonResult;
+import com.yolo.keyboard.framework.common.util.object.BeanUtils;
+import static com.yolo.keyboard.framework.common.pojo.CommonResult.success;
+
+import com.yolo.keyboard.framework.excel.core.util.ExcelUtils;
+
+import com.yolo.keyboard.framework.apilog.core.annotation.ApiAccessLog;
+import static com.yolo.keyboard.framework.apilog.core.enums.OperateTypeEnum.*;
+
+import com.yolo.keyboard.controller.admin.userthemes.vo.*;
+import com.yolo.keyboard.dal.dataobject.userthemes.KeyboardUserThemesDO;
+import com.yolo.keyboard.service.userthemes.KeyboardUserThemesService;
+
+@Tag(name = "管理后台 - 用户主题")
+@RestController
+@RequestMapping("/keyboard/user-themes")
+@Validated
+public class KeyboardUserThemesController {
+
+    @Resource
+    private KeyboardUserThemesService userThemesService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建用户主题")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-themes:create')")
+    public CommonResult<Long> createUserThemes(@Valid @RequestBody KeyboardUserThemesSaveReqVO createReqVO) {
+        return success(userThemesService.createUserThemes(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新用户主题")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-themes:update')")
+    public CommonResult<Boolean> updateUserThemes(@Valid @RequestBody KeyboardUserThemesSaveReqVO updateReqVO) {
+        userThemesService.updateUserThemes(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除用户主题")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('keyboard:user-themes:delete')")
+    public CommonResult<Boolean> deleteUserThemes(@RequestParam("id") Long id) {
+        userThemesService.deleteUserThemes(id);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete-list")
+    @Parameter(name = "ids", description = "编号", required = true)
+    @Operation(summary = "批量删除用户主题")
+                @PreAuthorize("@ss.hasPermission('keyboard:user-themes:delete')")
+    public CommonResult<Boolean> deleteUserThemesList(@RequestParam("ids") List<Long> ids) {
+        userThemesService.deleteUserThemesListByIds(ids);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得用户主题")
+    @Parameter(name = "id", description = "编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-themes:query')")
+    public CommonResult<KeyboardUserThemesRespVO> getUserThemes(@RequestParam("id") Long id) {
+        KeyboardUserThemesDO userThemes = userThemesService.getUserThemes(id);
+        return success(BeanUtils.toBean(userThemes, KeyboardUserThemesRespVO.class));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得用户主题分页")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-themes:query')")
+    public CommonResult<PageResult<KeyboardUserThemesRespVO>> getUserThemesPage(@Valid KeyboardUserThemesPageReqVO pageReqVO) {
+        PageResult<KeyboardUserThemesDO> pageResult = userThemesService.getUserThemesPage(pageReqVO);
+        return success(BeanUtils.toBean(pageResult, KeyboardUserThemesRespVO.class));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出用户主题 Excel")
+    @PreAuthorize("@ss.hasPermission('keyboard:user-themes:export')")
+    @ApiAccessLog(operateType = EXPORT)
+    public void exportUserThemesExcel(@Valid KeyboardUserThemesPageReqVO pageReqVO,
+              HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<KeyboardUserThemesDO> list = userThemesService.getUserThemesPage(pageReqVO).getList();
+        // 导出 Excel
+        ExcelUtils.write(response, "用户主题.xls", "数据", KeyboardUserThemesRespVO.class,
+                        BeanUtils.toBean(list, KeyboardUserThemesRespVO.class));
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userthemes/vo/KeyboardUserThemesPageReqVO.java

@@ -0,0 +1,31 @@
+package com.yolo.keyboard.controller.admin.userthemes.vo;
+
+import lombok.*;
+import java.util.*;
+import io.swagger.v3.oas.annotations.media.Schema;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+import static com.yolo.keyboard.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - 用户主题分页 Request VO")
+@Data
+public class KeyboardUserThemesPageReqVO extends PageParam {
+
+    @Schema(description = "主题主键", example = "21647")
+    private Long themeId;
+
+    @Schema(description = "用户 Id", example = "9884")
+    private Long userId;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "是否从显示移除")
+    private Boolean viewDeleted;
+
+    @Schema(description = "更新时间")
+    private Boolean updatedAt;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userthemes/vo/KeyboardUserThemesRespVO.java

@@ -0,0 +1,39 @@
+package com.yolo.keyboard.controller.admin.userthemes.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+import java.util.*;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+import cn.idev.excel.annotation.*;
+
+@Schema(description = "管理后台 - 用户主题 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class KeyboardUserThemesRespVO {
+
+    @Schema(description = "主键 id", requiredMode = Schema.RequiredMode.REQUIRED, example = "746")
+    @ExcelProperty("主键 id")
+    private Long id;
+
+    @Schema(description = "主题主键", example = "21647")
+    @ExcelProperty("主题主键")
+    private Long themeId;
+
+    @Schema(description = "用户 Id", example = "9884")
+    @ExcelProperty("用户 Id")
+    private Long userId;
+
+    @Schema(description = "创建时间")
+    @ExcelProperty("创建时间")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "是否从显示移除")
+    @ExcelProperty("是否从显示移除")
+    private Boolean viewDeleted;
+
+    @Schema(description = "更新时间")
+    @ExcelProperty("更新时间")
+    private Boolean updatedAt;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/controller/admin/userthemes/vo/KeyboardUserThemesSaveReqVO.java

@@ -0,0 +1,32 @@
+package com.yolo.keyboard.controller.admin.userthemes.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.*;
+import java.util.*;
+import jakarta.validation.constraints.*;
+import org.springframework.format.annotation.DateTimeFormat;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - 用户主题新增/修改 Request VO")
+@Data
+public class KeyboardUserThemesSaveReqVO {
+
+    @Schema(description = "主键 id", requiredMode = Schema.RequiredMode.REQUIRED, example = "746")
+    private Long id;
+
+    @Schema(description = "主题主键", example = "21647")
+    private Long themeId;
+
+    @Schema(description = "用户 Id", example = "9884")
+    private Long userId;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createdAt;
+
+    @Schema(description = "是否从显示移除")
+    private Boolean viewDeleted;
+
+    @Schema(description = "更新时间")
+    private Boolean updatedAt;
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/dataobject/i18nmessage/KeyboardI18nMessageDO.java

@@ -0,0 +1,43 @@
+package com.yolo.keyboard.dal.dataobject.i18nmessage;
+
+import com.yolo.keyboard.framework.tenant.core.aop.TenantIgnore;
+import lombok.*;
+import java.util.*;
+import com.baomidou.mybatisplus.annotation.*;
+import com.yolo.keyboard.framework.mybatis.core.dataobject.BaseDO;
+
+/**
+ * 国际化错误提醒配置 DO
+ *
+ * @author ziin
+ */
+@TableName("keyboard_i18n_message")
+@KeySequence("keyboard_i18n_message_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@TenantIgnore
+public class KeyboardI18nMessageDO {
+
+    /**
+     * 主键 id
+     */
+    @TableId
+    private Long id;
+    /**
+     * 错误代码
+     */
+    private String code;
+    /**
+     * 地区
+     */
+    private String locale;
+    /**
+     * 错误提醒
+     */
+    private String message;
+
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/dataobject/productitems/KeyboardProductItemsDO.java

@@ -0,0 +1,82 @@
+package com.yolo.keyboard.dal.dataobject.productitems;
+
+import com.yolo.keyboard.framework.tenant.core.aop.TenantIgnore;
+import lombok.*;
+import java.util.*;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.time.LocalDateTime;
+import com.baomidou.mybatisplus.annotation.*;
+import com.yolo.keyboard.framework.mybatis.core.dataobject.BaseDO;
+
+/**
+ * 内购商品 DO
+ *
+ * @author ziin
+ */
+@TableName("keyboard_product_items")
+@KeySequence("keyboard_product_items_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@TenantIgnore
+public class KeyboardProductItemsDO{
+
+    /**
+     * 主键，自增，唯一标识每个产品项
+     */
+    @TableId
+    private Long id;
+    /**
+     * 产品标识符，唯一标识每个产品（如 com.loveKey.nyx.2month）
+     */
+    private String productId;
+    /**
+     * 产品类型，区分订阅（subscription）和内购（in-app-purchase）
+     */
+    private String type;
+    /**
+     * 产品名称（如 100, 2）
+     */
+    private String name;
+    /**
+     * 产品单位（如 金币，个月）
+     */
+    private String unit;
+    /**
+     * 订阅时长的数值部分（如 2）
+     */
+    private Integer durationValue;
+    /**
+     * 订阅时长的单位部分（如 月，天）
+     */
+    private String durationUnit;
+    /**
+     * 产品价格
+     */
+    private BigDecimal price;
+    /**
+     * 产品的货币单位，如美元（$）
+     */
+    private String currency;
+    /**
+     * 产品的描述，提供更多细节信息
+     */
+    private String description;
+    /**
+     * 产品项的创建时间，默认当前时间
+     */
+    private LocalDateTime createdAt;
+    /**
+     * 产品项的最后更新时间，更新时自动设置为当前时间
+     */
+    private LocalDateTime updatedAt;
+    /**
+     * 订阅时长的具体天数
+     */
+    private Integer durationDays;
+
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/dataobject/tag/KeyboardTagDO.java

@@ -0,0 +1,45 @@
+package com.yolo.keyboard.dal.dataobject.tag;
+
+import com.yolo.keyboard.framework.tenant.core.aop.TenantIgnore;
+import lombok.*;
+import java.util.*;
+import java.time.LocalDateTime;
+import java.time.LocalDateTime;
+import com.baomidou.mybatisplus.annotation.*;
+import com.yolo.keyboard.framework.mybatis.core.dataobject.BaseDO;
+
+/**
+ * 人设标签 DO
+ *
+ * @author ziin
+ */
+@TableName("keyboard_tag")
+@KeySequence("keyboard_tag_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@TenantIgnore
+public class KeyboardTagDO{
+
+    /**
+     * 主键 Id
+     */
+    @TableId
+    private Integer id;
+    /**
+     * 标签名
+     */
+    private String tagName;
+    /**
+     * 创建时间
+     */
+    private LocalDateTime createdAt;
+    /**
+     * 更新时间
+     */
+    private LocalDateTime updatedAt;
+
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/dataobject/tenantbalance/TenantBalanceDO.java

@@ -0,0 +1,53 @@
+package com.yolo.keyboard.dal.dataobject.tenantbalance;
+
+import com.yolo.keyboard.framework.tenant.core.aop.TenantIgnore;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.util.*;
+import java.time.LocalDateTime;
+import com.baomidou.mybatisplus.annotation.*;
+import com.yolo.keyboard.framework.mybatis.core.dataobject.BaseDO;
+
+/**
+ * 租户余额 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("system_tenant_balance")
+//@KeySequence("system_tenant_balance_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@TenantIgnore
+public class TenantBalanceDO extends BaseDO {
+
+    /**
+     * 租户 Id
+     */
+    @TableId
+    private Long id;
+    /**
+     * 当前积分余额
+     */
+    private BigDecimal balance;
+    /**
+     * 乐观锁版本号
+     */
+    @Version
+    private Integer version;
+    /**
+     * 更新时间
+     */
+    private LocalDateTime updatedAt;
+
+    /**
+     * 冻结金额
+     */
+    private BigDecimal frozenAmt;
+
+    private BigDecimal withdrawableBalance;
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/dataobject/tenantbalancetransaction/TenantBalanceTransactionDO.java

@@ -0,0 +1,74 @@
+package com.yolo.keyboard.dal.dataobject.tenantbalancetransaction;
+
+import com.yolo.keyboard.framework.tenant.core.aop.TenantIgnore;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.util.*;
+import java.time.LocalDateTime;
+import com.baomidou.mybatisplus.annotation.*;
+import com.yolo.keyboard.framework.mybatis.core.dataobject.BaseDO;
+
+/**
+ * 租户积分记录 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("system_tenant_balance_transaction")
+@KeySequence("system_tenant_balance_transaction_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@TenantIgnore
+public class TenantBalanceTransactionDO {
+
+    /**
+     * 主键
+     */
+    @TableId
+    private Long id;
+    /**
+     * 本次变动点数，正加负减
+     */
+    private BigDecimal points;
+    /**
+     * 变动后余额快照（冗余）
+     */
+    private BigDecimal balance;
+    /**
+     * 变动类型，如 TRANSFER_IN, WITHDRAW，REFUND_COMMISSION ，RECHARGE_COMMISSION
+     */
+    private String type;
+    /**
+     * 变动描述
+     */
+    private String description;
+    /**
+     * 订单 Id/业务单号
+     */
+    private String orderId;
+    /**
+     * 业务流水号（转账、订单等唯一标识）
+     */
+    private String bizNo;
+    /**
+     * 操作人 Id
+     */
+    private Long operatorId;
+    /**
+     * 创建时间
+     */
+    private LocalDateTime createdAt;
+    /**
+     * 备注
+     */
+    private String remark;
+
+    private Long tenantId;
+
+    private BigDecimal frozenAmt;
+
+    private BigDecimal withdrawableBalance;
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/dataobject/tenantcommission/KeyboardTenantCommissionDO.java

@@ -0,0 +1,117 @@
+package com.yolo.keyboard.dal.dataobject.tenantcommission;
+
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.yolo.keyboard.framework.tenant.core.aop.TenantIgnore;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+/**
+ * 租户分成记录 DO
+ * 记录每笔内购订单的分成计算结果
+ *
+ * @author ziin
+ */
+@TableName("keyboard_tenant_commission")
+@KeySequence("keyboard_tenant_commission_seq")
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@TenantIgnore
+public class KeyboardTenantCommissionDO {
+
+    /**
+     * 主键
+     */
+    @TableId
+    private Long id;
+
+    /**
+     * 内购记录ID
+     */
+    private Integer purchaseRecordId;
+
+    /**
+     * 内购交易ID（唯一标识）
+     */
+    private String transactionId;
+
+    /**
+     * 被邀请用户ID（购买用户）
+     */
+    private Integer inviteeUserId;
+
+    /**
+     * 邀请人用户ID
+     */
+    private Long inviterUserId;
+
+    /**
+     * 收益归属租户ID
+     */
+    private Long tenantId;
+
+    /**
+     * 内购金额
+     */
+    private BigDecimal purchaseAmount;
+
+    /**
+     * 分成比例
+     */
+    private BigDecimal commissionRate;
+
+    /**
+     * 分成金额
+     */
+    private BigDecimal commissionAmount;
+
+    /**
+     * 状态：PENDING-待结算，SETTLED-已结算，REFUNDED-已退款
+     */
+    private String status;
+
+    /**
+     * 内购时间
+     */
+    private LocalDateTime purchaseTime;
+
+    /**
+     * 结算时间
+     */
+    private LocalDateTime settledAt;
+
+    /**
+     * 关联的余额交易记录ID
+     */
+    private Long balanceTransactionId;
+
+    /**
+     * 创建时间
+     */
+    private LocalDateTime createdAt;
+
+    /**
+     * 更新时间
+     */
+    private LocalDateTime updatedAt;
+
+    /**
+     * 可提现时间（结算时间 + 30天）
+     */
+    private LocalDateTime withdrawableAt;
+
+    /**
+     * 是否已处理转可提现：false-未处理，true-已处理
+     */
+    private Boolean withdrawableProcessed;
+
+    /**
+     * 备注
+     */
+    private String remark;
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/dataobject/tenantwithdraworder/KeyboardTenantWithdrawOrderDO.java

@@ -0,0 +1,165 @@
+package com.yolo.keyboard.dal.dataobject.tenantwithdraworder;
+
+import com.yolo.keyboard.framework.tenant.core.aop.TenantIgnore;
+import lombok.*;
+
+import java.math.BigDecimal;
+import java.util.*;
+import java.time.LocalDateTime;
+import java.time.LocalDateTime;
+import java.time.LocalDateTime;
+import java.time.LocalDateTime;
+import java.time.LocalDateTime;
+import java.time.LocalDateTime;
+import java.time.LocalDateTime;
+import com.baomidou.mybatisplus.annotation.*;
+import com.yolo.keyboard.framework.mybatis.core.dataobject.BaseDO;
+
+/**
+ * 租户提现订单表（申请-审核-打款-完成/失败） DO
+ *
+ * @author ziin
+ */
+@TableName("system_tenant_withdraw_order")
+@KeySequence("system_tenant_withdraw_order_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@TenantIgnore
+public class KeyboardTenantWithdrawOrderDO {
+
+    /**
+     * 主键
+     */
+    @TableId
+    private Long id;
+    /**
+     * 提现单号（业务唯一）
+     */
+    private String withdrawNo;
+    /**
+     * 业务幂等号（防重复提交）
+     */
+    private String bizNo;
+    /**
+     * 币种（默认 CNY）
+     */
+    private String currency;
+    /**
+     * 提现申请金额（单位：元）
+     */
+    private BigDecimal amount;
+    /**
+     * 手续费金额（单位：元）
+     */
+    private BigDecimal feeAmount;
+    /**
+     * 实际到账金额（单位：元 = amount - fee_amount）
+     */
+    private BigDecimal actualAmount;
+    /**
+     * 打款渠道：BANK/ALIPAY/WECHAT/PAYPAL 等
+     */
+    private String payChannel;
+    /**
+     * 收款方类型：PERSON（个人）/COMPANY（企业）
+     */
+    private String payeeType;
+    /**
+     * 收款人姓名或公司名称（快照）
+     */
+    private String payeeName;
+    /**
+     * 收款账号（银行卡/支付宝等，建议加密或脱敏）
+     */
+    private String payeeAccount;
+    /**
+     * 收款银行名称
+     */
+    private String payeeBankName;
+    /**
+     * 银行编码（可选）
+     */
+    private String payeeBankCode;
+    /**
+     * 银行支行名称（可选）
+     */
+    private String payeeBankBranch;
+    /**
+     * 提现状态：APPLIED/APPROVED/REJECTED/PAYING/PAID/FAILED/CANCELED
+     */
+    private String status;
+    /**
+     * 审核状态：PENDING/PASSED/REJECTED
+     */
+    private String auditStatus;
+    /**
+     * 拒绝原因或打款失败原因
+     */
+    private String reason;
+    /**
+     * 提现申请时间
+     */
+    private LocalDateTime applyTime;
+    /**
+     * 审核完成时间
+     */
+    private LocalDateTime auditTime;
+    /**
+     * 发起打款时间（请求第三方）
+     */
+    private LocalDateTime payTime;
+    /**
+     * 打款成功时间（第三方确认）
+     */
+    private LocalDateTime paidTime;
+    /**
+     * 业务终态时间（成功/失败/取消）
+     */
+    private LocalDateTime finishTime;
+    /**
+     * 打款批次号（内部使用）
+     */
+    private String payerBatchNo;
+    /**
+     * 第三方打款交易号/流水号（对账用）
+     */
+    private String channelTradeNo;
+    /**
+     * 第三方返回的原始报文（用于排查）
+     */
+    private Object channelRaw;
+    /**
+     * 关联余额流水ID（冻结/扣减/返还）
+     */
+    private Long balanceTxnId;
+    /**
+     * 乐观锁版本号
+     */
+    @Version
+    private Integer version;
+    /**
+     * 提现申请人ID
+     */
+    private Long creatorId;
+    /**
+     * 审核人ID
+     */
+    private Long auditorId;
+    /**
+     * 打款操作人ID
+     */
+    private Long payerId;
+    /**
+     * 创建时间
+     */
+    private LocalDateTime createdAt;
+    /**
+     * 更新时间
+     */
+    private LocalDateTime updatedAt;
+
+    private Long tenantId;
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/dataobject/themes/KeyboardThemesDO.java

@@ -7,6 +7,7 @@ import java.math.BigDecimal;
 import java.time.LocalDateTime;
 import java.time.LocalDateTime;
 import com.baomidou.mybatisplus.annotation.*;
+import com.yolo.keyboard.framework.mybatis.core.type.JsonbTypeHandler;
 import com.yolo.keyboard.framework.mybatis.core.dataobject.BaseDO;
 
 /**
@@ -14,7 +15,7 @@ import com.yolo.keyboard.framework.mybatis.core.dataobject.BaseDO;
  *
  * @author ziin
  */
-@TableName("keyboard_themes")
+@TableName(value = "keyboard_themes", autoResultMap = true)
 @KeySequence("keyboard_themes_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
 @Data
 @ToString(callSuper = true)
@@ -40,6 +41,7 @@ public class KeyboardThemesDO  {
     /**
      * 主题标签
      */
+    @TableField(typeHandler = JsonbTypeHandler.class)
     private Object themeTag;
     /**
      * 主题下载次数

keyboard-server/src/main/java/com/yolo/keyboard/dal/dataobject/usercalllog/KeyboardUserCallLogDO.java

@@ -0,0 +1,80 @@
+package com.yolo.keyboard.dal.dataobject.usercalllog;
+
+import com.yolo.keyboard.framework.tenant.core.aop.TenantIgnore;
+import lombok.*;
+import java.util.*;
+import java.time.LocalDateTime;
+import com.baomidou.mybatisplus.annotation.*;
+import com.yolo.keyboard.framework.mybatis.core.dataobject.BaseDO;
+
+/**
+ * 用户每次调用日志（用于记录token、模型、耗时、成功率等） DO
+ *
+ * @author Ziin
+ */
+@TableName("keyboard_user_call_log")
+@KeySequence("keyboard_user_call_log_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@TenantIgnore
+public class KeyboardUserCallLogDO{
+
+    /**
+     * 主键 id
+     */
+    @TableId
+    private Long id;
+    /**
+     * 用户ID
+     */
+    private Long userId;
+    /**
+     * 幂等请求ID，避免重试导致重复记录
+     */
+    private String requestId;
+    /**
+     * 调用功能来源
+     */
+    private String feature;
+    /**
+     * 调用的模型名称
+     */
+    private String model;
+    /**
+     * 输入token数
+     */
+    private Integer inputTokens;
+    /**
+     * 输出token数
+     */
+    private Integer outputTokens;
+    /**
+     * 总token数（input+output）
+     */
+    private Integer totalTokens;
+    /**
+     * 调用是否成功
+     */
+    private Boolean success;
+    /**
+     * 调用耗时（毫秒）
+     */
+    private Integer latencyMs;
+    /**
+     * 失败错误码（可空）
+     */
+    private String errorCode;
+    /**
+     * 调用记录创建时间
+     */
+    private LocalDateTime createdAt;
+    /**
+     * 生成 id
+     */
+    private String genId;
+
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/dataobject/usercharacter/KeyboardUserCharacterDO.java

@@ -0,0 +1,53 @@
+package com.yolo.keyboard.dal.dataobject.usercharacter;
+
+import com.yolo.keyboard.framework.tenant.core.aop.TenantIgnore;
+import lombok.*;
+import java.util.*;
+import java.time.LocalDateTime;
+import java.time.LocalDateTime;
+import com.baomidou.mybatisplus.annotation.*;
+import com.yolo.keyboard.framework.mybatis.core.dataobject.BaseDO;
+
+/**
+ * 用户人设管理 DO
+ *
+ * @author ziin
+ */
+@TableName("keyboard_user_character")
+@KeySequence("keyboard_user_character_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@TenantIgnore
+public class KeyboardUserCharacterDO{
+
+    /**
+     * 主键 Id
+     */
+    @TableId
+    private Long id;
+    /**
+     * 键盘人设 id
+     */
+    private Long characterId;
+    /**
+     * 创建时间
+     */
+    private LocalDateTime createdAt;
+    /**
+     * 更新时间
+     */
+    private LocalDateTime updatedAt;
+    /**
+     * 用户 Id
+     */
+    private Long userId;
+    /**
+     * emoji 标签
+     */
+    private String emoji;
+
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/dataobject/userinvitecodes/KeyboardUserInviteCodesDO.java

@@ -0,0 +1,73 @@
+package com.yolo.keyboard.dal.dataobject.userinvitecodes;
+
+import com.yolo.keyboard.framework.tenant.core.aop.TenantIgnore;
+import lombok.*;
+import java.util.*;
+import java.time.LocalDateTime;
+import java.time.LocalDateTime;
+import com.baomidou.mybatisplus.annotation.*;
+import com.yolo.keyboard.framework.mybatis.core.dataobject.BaseDO;
+
+/**
+ * 用户生成的邀请码表，用于邀请新用户注册/安装并建立邀请关系 DO
+ *
+ * @author ziin
+ */
+@TableName("keyboard_user_invite_codes")
+@KeySequence("invite_codes_id_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@TenantIgnore
+public class KeyboardUserInviteCodesDO {
+
+    /**
+     * 邀请码主键ID
+     */
+    @TableId
+    private Long id;
+    /**
+     * 邀请码字符串，对外展示，唯一
+     */
+    private String code;
+    /**
+     * 邀请码所属用户ID（邀请人）
+     */
+    private Long ownerUserId;
+    /**
+     * 邀请码状态：1=启用，0=停用
+     */
+    private Short status;
+    /**
+     * 邀请码创建时间
+     */
+    private LocalDateTime createdAt;
+    /**
+     * 邀请码过期时间，NULL表示永久有效
+     */
+    private LocalDateTime expiresAt;
+    /**
+     * 邀请码最大可使用次数，NULL表示不限次数
+     */
+    private Integer maxUses;
+    /**
+     * 邀请码已使用次数
+     */
+    private Integer usedCount;
+    /**
+     * 邀请码所属租户
+     */
+    private Long ownerTenantId;
+    /**
+     * 邀请码所属系统用户
+     */
+    private Long ownerSystemUserId;
+    /**
+     * 邀请码类型
+     */
+    private String inviteType;
+
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/dataobject/userinvites/KeyboardUserInvitesDO.java

@@ -0,0 +1,84 @@
+package com.yolo.keyboard.dal.dataobject.userinvites;
+
+import com.yolo.keyboard.framework.tenant.core.aop.TenantIgnore;
+import lombok.*;
+import java.util.*;
+import java.time.LocalDateTime;
+import com.baomidou.mybatisplus.annotation.*;
+import com.yolo.keyboard.framework.mybatis.core.dataobject.BaseDO;
+
+/**
+ * 用户邀请关系绑定台账表，记录新用户最终归属的邀请人 DO
+ *
+ * @author ziin
+ */
+@TableName("keyboard_user_invites")
+@KeySequence("keyboard_user_invites_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@TenantIgnore
+public class KeyboardUserInvitesDO {
+
+    /**
+     * 邀请绑定记录主键ID
+     */
+    @TableId
+    private Long id;
+    /**
+     * 邀请人用户ID
+     */
+    private Long inviterUserId;
+    /**
+     * 被邀请人用户ID（新注册用户）
+     */
+    private Long inviteeUserId;
+    /**
+     * 使用的邀请码ID
+     */
+    private Long inviteCodeId;
+    /**
+     * 绑定时关联的点击Token（通过邀请链接自动绑定时使用）
+     */
+    private String clickToken;
+    /**
+     * 绑定方式：1=手动填写邀请码，2=邀请链接自动绑定，3=其他方式
+     */
+    private Short bindType;
+    /**
+     * 邀请关系绑定完成时间
+     */
+    private LocalDateTime boundAt;
+    /**
+     * 绑定 iP
+     */
+    private String bindIp;
+    /**
+     * userAgent
+     */
+    private String bindUserAgent;
+    /**
+     * 邀请码类型快照：USER=普通用户邀请，AGENT=代理邀请
+     */
+    private String inviteType;
+    /**
+     * 收益结算归属租户ID（代理结算用，绑定时固化）
+     */
+    private Long profitTenantId;
+    /**
+     * 收益归因员工ID（用于区分租户员工/渠道，绑定时固化）
+     */
+    private Long profitEmployeeId;
+    /**
+     * 邀请人所属租户ID快照（便于审计/对账，可选）
+     */
+    private Long inviterTenantId;
+    /**
+     * 邀请码字符串快照（便于排查，可选）
+     */
+    private String inviteCode;
+
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/dataobject/userpurchaserecords/KeyboardUserPurchaseRecordsDO.java

@@ -0,0 +1,95 @@
+package com.yolo.keyboard.dal.dataobject.userpurchaserecords;
+
+import com.yolo.keyboard.framework.tenant.core.aop.TenantIgnore;
+import lombok.*;
+import java.util.*;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.time.LocalDateTime;
+import java.time.LocalDateTime;
+import com.baomidou.mybatisplus.annotation.*;
+import com.yolo.keyboard.framework.mybatis.core.dataobject.BaseDO;
+
+/**
+ * 用户内购记录 DO
+ *
+ * @author ziin
+ */
+@TableName("keyboard_user_purchase_records")
+@KeySequence("keyboard_user_purchase_records_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@TenantIgnore
+public class KeyboardUserPurchaseRecordsDO{
+
+    /**
+     * 主键，自增，唯一标识每条购买记录
+     */
+    @TableId
+    private Integer id;
+    /**
+     * 用户 ID，关联到用户表，表示是哪位用户购买了产品
+     */
+    private Integer userId;
+    /**
+     * 购买的产品 ID，关联到产品表
+     */
+    private String productId;
+    /**
+     * 购买数量（如内购的金币数量，订阅的时长）
+     */
+    private Integer purchaseQuantity;
+    /**
+     * 实际支付价格
+     */
+    private BigDecimal price;
+    /**
+     * 货币类型（如美元 $）
+     */
+    private String currency;
+    /**
+     * 购买时间
+     */
+    private LocalDateTime purchaseTime;
+    /**
+     * 购买类型（如内购，订阅）
+     */
+    private String purchaseType;
+    /**
+     * 购买状态（如已支付，待支付，退款）
+     */
+    private String status;
+    /**
+     * 支付方式（如信用卡，支付宝等）
+     */
+    private String paymentMethod;
+    /**
+     * 唯一的交易 ID，用于标识该购买操作
+     */
+    private String transactionId;
+    /**
+     * 苹果的原始交易 ID
+     */
+    private String originalTransactionId;
+    /**
+     * 购买的产品 ID 列表（JSON 格式或数组）
+     */
+    private Object productIds;
+    /**
+     * 苹果返回的购买时间
+     */
+    private LocalDateTime purchaseDate;
+    /**
+     * 苹果返回的过期时间（如果有）
+     */
+    private LocalDateTime expiresDate;
+    /**
+     * 苹果的环境（如 Sandbox 或 Production）
+     */
+    private String environment;
+
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/dataobject/userquotatotal/KeyboardUserQuotaTotalDO.java

@@ -0,0 +1,53 @@
+package com.yolo.keyboard.dal.dataobject.userquotatotal;
+
+import com.yolo.keyboard.framework.tenant.core.aop.TenantIgnore;
+import lombok.*;
+import java.util.*;
+import java.time.LocalDateTime;
+import java.time.LocalDateTime;
+import com.baomidou.mybatisplus.annotation.*;
+import com.yolo.keyboard.framework.mybatis.core.dataobject.BaseDO;
+
+/**
+ * 用户免费功能永久总次数额度表（所有功能共用） DO
+ *
+ * @author 芋道源码
+ */
+@TableName("keyboard_user_quota_total")
+@KeySequence("keyboard_user_quota_total_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@TenantIgnore
+public class KeyboardUserQuotaTotalDO{
+
+    /**
+     * 用户唯一ID，对应系统用户
+     */
+    @TableId
+    private Long userId;
+    /**
+     * 免费体验的永久总次数上限（可通过运营活动增加）
+     */
+    private Integer totalQuota;
+    /**
+     * 已消耗的免费次数
+     */
+    private Integer usedQuota;
+    /**
+     * 乐观锁版本号（并发控制预留字段）
+     */
+    private Integer version;
+    /**
+     * 首次创建额度记录的时间（通常为注册时间）
+     */
+    private LocalDateTime createdAt;
+    /**
+     * 最近一次额度发生变化的时间（消耗或赠送）
+     */
+    private LocalDateTime updatedAt;
+
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/dataobject/userthemes/KeyboardUserThemesDO.java

@@ -0,0 +1,52 @@
+package com.yolo.keyboard.dal.dataobject.userthemes;
+
+import com.yolo.keyboard.framework.tenant.core.aop.TenantIgnore;
+import lombok.*;
+import java.util.*;
+import java.time.LocalDateTime;
+import com.baomidou.mybatisplus.annotation.*;
+import com.yolo.keyboard.framework.mybatis.core.dataobject.BaseDO;
+
+/**
+ * 用户主题 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("keyboard_user_themes")
+@KeySequence("keyboard_user_themes_seq") // 用于 Oracle、PostgreSQL、Kingbase、DB2、H2 数据库的主键自增。如果是 MySQL 等数据库，可不写。
+@Data
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@TenantIgnore
+public class KeyboardUserThemesDO{
+
+    /**
+     * 主键 id
+     */
+    @TableId
+    private Long id;
+    /**
+     * 主题主键
+     */
+    private Long themeId;
+    /**
+     * 用户 Id
+     */
+    private Long userId;
+    /**
+     * 创建时间
+     */
+    private LocalDateTime createdAt;
+    /**
+     * 是否从显示移除
+     */
+    private Boolean viewDeleted;
+    /**
+     * 更新时间
+     */
+    private Boolean updatedAt;
+
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/mysql/i18nmessage/KeyboardI18nMessageMapper.java

@@ -0,0 +1,28 @@
+package com.yolo.keyboard.dal.mysql.i18nmessage;
+
+import java.util.*;
+
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.mybatis.core.query.LambdaQueryWrapperX;
+import com.yolo.keyboard.framework.mybatis.core.mapper.BaseMapperX;
+import com.yolo.keyboard.dal.dataobject.i18nmessage.KeyboardI18nMessageDO;
+import org.apache.ibatis.annotations.Mapper;
+import com.yolo.keyboard.controller.admin.i18nmessage.vo.*;
+
+/**
+ * 国际化错误提醒配置 Mapper
+ *
+ * @author ziin
+ */
+@Mapper
+public interface KeyboardI18nMessageMapper extends BaseMapperX<KeyboardI18nMessageDO> {
+
+    default PageResult<KeyboardI18nMessageDO> selectPage(KeyboardI18nMessagePageReqVO reqVO) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<KeyboardI18nMessageDO>()
+                .eqIfPresent(KeyboardI18nMessageDO::getCode, reqVO.getCode())
+                .eqIfPresent(KeyboardI18nMessageDO::getLocale, reqVO.getLocale())
+                .eqIfPresent(KeyboardI18nMessageDO::getMessage, reqVO.getMessage())
+                .orderByDesc(KeyboardI18nMessageDO::getId));
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/mysql/productitems/KeyboardProductItemsMapper.java

@@ -0,0 +1,37 @@
+package com.yolo.keyboard.dal.mysql.productitems;
+
+import java.util.*;
+
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.mybatis.core.query.LambdaQueryWrapperX;
+import com.yolo.keyboard.framework.mybatis.core.mapper.BaseMapperX;
+import com.yolo.keyboard.dal.dataobject.productitems.KeyboardProductItemsDO;
+import org.apache.ibatis.annotations.Mapper;
+import com.yolo.keyboard.controller.admin.productitems.vo.*;
+
+/**
+ * 内购商品 Mapper
+ *
+ * @author ziin
+ */
+@Mapper
+public interface KeyboardProductItemsMapper extends BaseMapperX<KeyboardProductItemsDO> {
+
+    default PageResult<KeyboardProductItemsDO> selectPage(KeyboardProductItemsPageReqVO reqVO) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<KeyboardProductItemsDO>()
+                .eqIfPresent(KeyboardProductItemsDO::getProductId, reqVO.getProductId())
+                .eqIfPresent(KeyboardProductItemsDO::getType, reqVO.getType())
+                .likeIfPresent(KeyboardProductItemsDO::getName, reqVO.getName())
+                .eqIfPresent(KeyboardProductItemsDO::getUnit, reqVO.getUnit())
+                .eqIfPresent(KeyboardProductItemsDO::getDurationValue, reqVO.getDurationValue())
+                .eqIfPresent(KeyboardProductItemsDO::getDurationUnit, reqVO.getDurationUnit())
+                .eqIfPresent(KeyboardProductItemsDO::getPrice, reqVO.getPrice())
+                .eqIfPresent(KeyboardProductItemsDO::getCurrency, reqVO.getCurrency())
+                .eqIfPresent(KeyboardProductItemsDO::getDescription, reqVO.getDescription())
+                .eqIfPresent(KeyboardProductItemsDO::getCreatedAt, reqVO.getCreatedAt())
+                .eqIfPresent(KeyboardProductItemsDO::getUpdatedAt, reqVO.getUpdatedAt())
+                .eqIfPresent(KeyboardProductItemsDO::getDurationDays, reqVO.getDurationDays())
+                .orderByDesc(KeyboardProductItemsDO::getId));
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/mysql/tag/KeyboardTagMapper.java

@@ -0,0 +1,28 @@
+package com.yolo.keyboard.dal.mysql.tag;
+
+import java.util.*;
+
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.mybatis.core.query.LambdaQueryWrapperX;
+import com.yolo.keyboard.framework.mybatis.core.mapper.BaseMapperX;
+import com.yolo.keyboard.dal.dataobject.tag.KeyboardTagDO;
+import org.apache.ibatis.annotations.Mapper;
+import com.yolo.keyboard.controller.admin.tag.vo.*;
+
+/**
+ * 人设标签 Mapper
+ *
+ * @author ziin
+ */
+@Mapper
+public interface KeyboardTagMapper extends BaseMapperX<KeyboardTagDO> {
+
+    default PageResult<KeyboardTagDO> selectPage(KeyboardTagPageReqVO reqVO) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<KeyboardTagDO>()
+                .likeIfPresent(KeyboardTagDO::getTagName, reqVO.getTagName())
+                .eqIfPresent(KeyboardTagDO::getCreatedAt, reqVO.getCreatedAt())
+                .eqIfPresent(KeyboardTagDO::getUpdatedAt, reqVO.getUpdatedAt())
+                .orderByDesc(KeyboardTagDO::getId));
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/mysql/tenantbalance/TenantBalanceMapper.java

@@ -0,0 +1,28 @@
+package com.yolo.keyboard.dal.mysql.tenantbalance;
+
+import java.util.*;
+
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.mybatis.core.query.LambdaQueryWrapperX;
+import com.yolo.keyboard.framework.mybatis.core.mapper.BaseMapperX;
+import com.yolo.keyboard.dal.dataobject.tenantbalance.TenantBalanceDO;
+import org.apache.ibatis.annotations.Mapper;
+import com.yolo.keyboard.controller.admin.tenantbalance.vo.*;
+
+/**
+ * 租户余额 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface TenantBalanceMapper extends BaseMapperX<TenantBalanceDO> {
+
+    default PageResult<TenantBalanceDO> selectPage(TenantBalancePageReqVO reqVO) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<TenantBalanceDO>()
+                .eqIfPresent(TenantBalanceDO::getBalance, reqVO.getBalance())
+                .eqIfPresent(TenantBalanceDO::getVersion, reqVO.getVersion())
+                .eqIfPresent(TenantBalanceDO::getUpdatedAt, reqVO.getUpdatedAt())
+                .orderByDesc(TenantBalanceDO::getId));
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/mysql/tenantbalancetransaction/TenantBalanceTransactionMapper.java

@@ -0,0 +1,33 @@
+package com.yolo.keyboard.dal.mysql.tenantbalancetransaction;
+
+import com.yolo.keyboard.dal.dataobject.tenantbalancetransaction.TenantBalanceTransactionDO;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.mybatis.core.mapper.BaseMapperX;
+import com.yolo.keyboard.framework.mybatis.core.query.LambdaQueryWrapperX;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+/**
+ * 租户积分记录 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface TenantBalanceTransactionMapper extends BaseMapperX<TenantBalanceTransactionDO> {
+
+    default PageResult<TenantBalanceTransactionDO> selectPage(PageParam reqVO, Long tenantId) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<TenantBalanceTransactionDO>()
+                .eq(TenantBalanceTransactionDO::getTenantId, tenantId)
+                .orderByDesc(TenantBalanceTransactionDO::getId));
+    }
+
+    default int deleteByTenantId(Long tenantId) {
+        return delete(TenantBalanceTransactionDO::getTenantId, tenantId);
+    }
+
+    default int deleteByTenantIds(List<Long> tenantIds) {
+        return deleteBatch(TenantBalanceTransactionDO::getTenantId, tenantIds);
+    }
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/mysql/tenantcommission/KeyboardTenantCommissionMapper.java

@@ -0,0 +1,61 @@
+package com.yolo.keyboard.dal.mysql.tenantcommission;
+
+import com.yolo.keyboard.controller.admin.tenantcommission.vo.KeyboardTenantCommissionPageReqVO;
+import com.yolo.keyboard.dal.dataobject.tenantcommission.KeyboardTenantCommissionDO;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.mybatis.core.mapper.BaseMapperX;
+import com.yolo.keyboard.framework.mybatis.core.query.LambdaQueryWrapperX;
+import org.apache.ibatis.annotations.Mapper;
+
+/**
+ * 租户分成记录 Mapper
+ *
+ * @author ziin
+ */
+@Mapper
+public interface KeyboardTenantCommissionMapper extends BaseMapperX<KeyboardTenantCommissionDO> {
+
+    /**
+     * 根据交易ID查询分成记录
+     */
+    default KeyboardTenantCommissionDO selectByTransactionId(String transactionId) {
+        return selectOne(KeyboardTenantCommissionDO::getTransactionId, transactionId);
+    }
+
+    /**
+     * 根据内购记录ID查询分成记录
+     */
+    default KeyboardTenantCommissionDO selectByPurchaseRecordId(Integer purchaseRecordId) {
+        return selectOne(KeyboardTenantCommissionDO::getPurchaseRecordId, purchaseRecordId);
+    }
+
+    /**
+     * 根据内购记录ID和租户ID查询分成记录
+     * 用于检查某个租户是否已经对某条内购记录计算过分成
+     */
+    default KeyboardTenantCommissionDO selectByPurchaseRecordIdAndTenantId(Integer purchaseRecordId, Long tenantId) {
+        return selectOne(new LambdaQueryWrapperX<KeyboardTenantCommissionDO>()
+                .eq(KeyboardTenantCommissionDO::getPurchaseRecordId, purchaseRecordId)
+                .eq(KeyboardTenantCommissionDO::getTenantId, tenantId));
+    }
+
+    default PageResult<KeyboardTenantCommissionDO> selectPage(KeyboardTenantCommissionPageReqVO reqVO) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<KeyboardTenantCommissionDO>()
+                .eqIfPresent(KeyboardTenantCommissionDO::getTenantId, reqVO.getTenantId())
+                .eqIfPresent(KeyboardTenantCommissionDO::getPurchaseRecordId, reqVO.getPurchaseRecordId())
+                .eqIfPresent(KeyboardTenantCommissionDO::getTransactionId, reqVO.getTransactionId())
+                .eqIfPresent(KeyboardTenantCommissionDO::getInviteeUserId, reqVO.getInviteeUserId())
+                .eqIfPresent(KeyboardTenantCommissionDO::getInviterUserId, reqVO.getInviterUserId())
+                .eqIfPresent(KeyboardTenantCommissionDO::getPurchaseAmount, reqVO.getPurchaseAmount())
+                .eqIfPresent(KeyboardTenantCommissionDO::getCommissionRate, reqVO.getCommissionRate())
+                .eqIfPresent(KeyboardTenantCommissionDO::getCommissionAmount, reqVO.getCommissionAmount())
+                .eqIfPresent(KeyboardTenantCommissionDO::getStatus, reqVO.getStatus())
+                .betweenIfPresent(KeyboardTenantCommissionDO::getPurchaseTime, reqVO.getPurchaseTime())
+                .eqIfPresent(KeyboardTenantCommissionDO::getSettledAt, reqVO.getSettledAt())
+                .eqIfPresent(KeyboardTenantCommissionDO::getBalanceTransactionId, reqVO.getBalanceTransactionId())
+                .eqIfPresent(KeyboardTenantCommissionDO::getCreatedAt, reqVO.getCreatedAt())
+                .eqIfPresent(KeyboardTenantCommissionDO::getUpdatedAt, reqVO.getUpdatedAt())
+                .eqIfPresent(KeyboardTenantCommissionDO::getRemark, reqVO.getRemark())
+                .orderByDesc(KeyboardTenantCommissionDO::getId));
+    }
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/mysql/tenantwithdraworder/KeyboardTenantWithdrawOrderMapper.java

@@ -0,0 +1,57 @@
+package com.yolo.keyboard.dal.mysql.tenantwithdraworder;
+
+import java.util.*;
+
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.mybatis.core.query.LambdaQueryWrapperX;
+import com.yolo.keyboard.framework.mybatis.core.mapper.BaseMapperX;
+import com.yolo.keyboard.dal.dataobject.tenantwithdraworder.KeyboardTenantWithdrawOrderDO;
+import org.apache.ibatis.annotations.Mapper;
+import com.yolo.keyboard.controller.admin.tenantwithdraworder.vo.*;
+
+/**
+ * 租户提现订单表（申请-审核-打款-完成/失败） Mapper
+ *
+ * @author ziin
+ */
+@Mapper
+public interface KeyboardTenantWithdrawOrderMapper extends BaseMapperX<KeyboardTenantWithdrawOrderDO> {
+
+    default PageResult<KeyboardTenantWithdrawOrderDO> selectPage(KeyboardTenantWithdrawOrderPageReqVO reqVO) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<KeyboardTenantWithdrawOrderDO>()
+                .inIfPresent(KeyboardTenantWithdrawOrderDO::getTenantId, reqVO.getTenantIds())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getWithdrawNo, reqVO.getWithdrawNo())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getBizNo, reqVO.getBizNo())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getCurrency, reqVO.getCurrency())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getAmount, reqVO.getAmount())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getFeeAmount, reqVO.getFeeAmount())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getActualAmount, reqVO.getActualAmount())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getPayChannel, reqVO.getPayChannel())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getPayeeType, reqVO.getPayeeType())
+                .likeIfPresent(KeyboardTenantWithdrawOrderDO::getPayeeName, reqVO.getPayeeName())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getPayeeAccount, reqVO.getPayeeAccount())
+                .likeIfPresent(KeyboardTenantWithdrawOrderDO::getPayeeBankName, reqVO.getPayeeBankName())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getPayeeBankCode, reqVO.getPayeeBankCode())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getPayeeBankBranch, reqVO.getPayeeBankBranch())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getStatus, reqVO.getStatus())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getAuditStatus, reqVO.getAuditStatus())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getReason, reqVO.getReason())
+                .betweenIfPresent(KeyboardTenantWithdrawOrderDO::getApplyTime, reqVO.getApplyTime())
+                .betweenIfPresent(KeyboardTenantWithdrawOrderDO::getAuditTime, reqVO.getAuditTime())
+                .betweenIfPresent(KeyboardTenantWithdrawOrderDO::getPayTime, reqVO.getPayTime())
+                .betweenIfPresent(KeyboardTenantWithdrawOrderDO::getPaidTime, reqVO.getPaidTime())
+                .betweenIfPresent(KeyboardTenantWithdrawOrderDO::getFinishTime, reqVO.getFinishTime())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getPayerBatchNo, reqVO.getPayerBatchNo())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getChannelTradeNo, reqVO.getChannelTradeNo())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getChannelRaw, reqVO.getChannelRaw())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getBalanceTxnId, reqVO.getBalanceTxnId())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getVersion, reqVO.getVersion())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getCreatorId, reqVO.getCreatorId())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getAuditorId, reqVO.getAuditorId())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getPayerId, reqVO.getPayerId())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getCreatedAt, reqVO.getCreatedAt())
+                .eqIfPresent(KeyboardTenantWithdrawOrderDO::getUpdatedAt, reqVO.getUpdatedAt())
+                .orderByDesc(KeyboardTenantWithdrawOrderDO::getId));
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/mysql/usercalllog/KeyboardUserCallLogMapper.java

@@ -0,0 +1,37 @@
+package com.yolo.keyboard.dal.mysql.usercalllog;
+
+import java.util.*;
+
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.mybatis.core.query.LambdaQueryWrapperX;
+import com.yolo.keyboard.framework.mybatis.core.mapper.BaseMapperX;
+import com.yolo.keyboard.dal.dataobject.usercalllog.KeyboardUserCallLogDO;
+import org.apache.ibatis.annotations.Mapper;
+import com.yolo.keyboard.controller.admin.usercalllog.vo.*;
+
+/**
+ * 用户每次调用日志（用于记录token、模型、耗时、成功率等） Mapper
+ *
+ * @author Ziin
+ */
+@Mapper
+public interface KeyboardUserCallLogMapper extends BaseMapperX<KeyboardUserCallLogDO> {
+
+    default PageResult<KeyboardUserCallLogDO> selectPage(KeyboardUserCallLogPageReqVO reqVO) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<KeyboardUserCallLogDO>()
+                .eqIfPresent(KeyboardUserCallLogDO::getUserId, reqVO.getUserId())
+                .eqIfPresent(KeyboardUserCallLogDO::getRequestId, reqVO.getRequestId())
+                .eqIfPresent(KeyboardUserCallLogDO::getFeature, reqVO.getFeature())
+                .eqIfPresent(KeyboardUserCallLogDO::getModel, reqVO.getModel())
+                .eqIfPresent(KeyboardUserCallLogDO::getInputTokens, reqVO.getInputTokens())
+                .eqIfPresent(KeyboardUserCallLogDO::getOutputTokens, reqVO.getOutputTokens())
+                .eqIfPresent(KeyboardUserCallLogDO::getTotalTokens, reqVO.getTotalTokens())
+                .eqIfPresent(KeyboardUserCallLogDO::getSuccess, reqVO.getSuccess())
+                .eqIfPresent(KeyboardUserCallLogDO::getLatencyMs, reqVO.getLatencyMs())
+                .eqIfPresent(KeyboardUserCallLogDO::getErrorCode, reqVO.getErrorCode())
+                .eqIfPresent(KeyboardUserCallLogDO::getCreatedAt, reqVO.getCreatedAt())
+                .eqIfPresent(KeyboardUserCallLogDO::getGenId, reqVO.getGenId())
+                .orderByDesc(KeyboardUserCallLogDO::getId));
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/mysql/usercharacter/KeyboardUserCharacterMapper.java

@@ -0,0 +1,30 @@
+package com.yolo.keyboard.dal.mysql.usercharacter;
+
+import java.util.*;
+
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.mybatis.core.query.LambdaQueryWrapperX;
+import com.yolo.keyboard.framework.mybatis.core.mapper.BaseMapperX;
+import com.yolo.keyboard.dal.dataobject.usercharacter.KeyboardUserCharacterDO;
+import org.apache.ibatis.annotations.Mapper;
+import com.yolo.keyboard.controller.admin.usercharacter.vo.*;
+
+/**
+ * 用户人设管理 Mapper
+ *
+ * @author ziin
+ */
+@Mapper
+public interface KeyboardUserCharacterMapper extends BaseMapperX<KeyboardUserCharacterDO> {
+
+    default PageResult<KeyboardUserCharacterDO> selectPage(KeyboardUserCharacterPageReqVO reqVO) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<KeyboardUserCharacterDO>()
+                .eqIfPresent(KeyboardUserCharacterDO::getCharacterId, reqVO.getCharacterId())
+                .eqIfPresent(KeyboardUserCharacterDO::getCreatedAt, reqVO.getCreatedAt())
+                .eqIfPresent(KeyboardUserCharacterDO::getUpdatedAt, reqVO.getUpdatedAt())
+                .eqIfPresent(KeyboardUserCharacterDO::getUserId, reqVO.getUserId())
+                .eqIfPresent(KeyboardUserCharacterDO::getEmoji, reqVO.getEmoji())
+                .orderByDesc(KeyboardUserCharacterDO::getId));
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/mysql/userinvitecodes/KeyboardUserInviteCodesMapper.java

@@ -0,0 +1,35 @@
+package com.yolo.keyboard.dal.mysql.userinvitecodes;
+
+import java.util.*;
+
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.mybatis.core.query.LambdaQueryWrapperX;
+import com.yolo.keyboard.framework.mybatis.core.mapper.BaseMapperX;
+import com.yolo.keyboard.dal.dataobject.userinvitecodes.KeyboardUserInviteCodesDO;
+import org.apache.ibatis.annotations.Mapper;
+import com.yolo.keyboard.controller.admin.userinvitecodes.vo.*;
+
+/**
+ * 用户生成的邀请码表，用于邀请新用户注册/安装并建立邀请关系 Mapper
+ *
+ * @author ziin
+ */
+@Mapper
+public interface KeyboardUserInviteCodesMapper extends BaseMapperX<KeyboardUserInviteCodesDO> {
+
+    default PageResult<KeyboardUserInviteCodesDO> selectPage(KeyboardUserInviteCodesPageReqVO reqVO) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<KeyboardUserInviteCodesDO>()
+                .eqIfPresent(KeyboardUserInviteCodesDO::getCode, reqVO.getCode())
+                .eqIfPresent(KeyboardUserInviteCodesDO::getOwnerUserId, reqVO.getOwnerUserId())
+                .eqIfPresent(KeyboardUserInviteCodesDO::getStatus, reqVO.getStatus())
+                .eqIfPresent(KeyboardUserInviteCodesDO::getCreatedAt, reqVO.getCreatedAt())
+                .eqIfPresent(KeyboardUserInviteCodesDO::getExpiresAt, reqVO.getExpiresAt())
+                .eqIfPresent(KeyboardUserInviteCodesDO::getMaxUses, reqVO.getMaxUses())
+                .eqIfPresent(KeyboardUserInviteCodesDO::getUsedCount, reqVO.getUsedCount())
+                .eqIfPresent(KeyboardUserInviteCodesDO::getOwnerTenantId, reqVO.getOwnerTenantId())
+                .eqIfPresent(KeyboardUserInviteCodesDO::getOwnerSystemUserId, reqVO.getOwnerSystemUserId())
+                .eqIfPresent(KeyboardUserInviteCodesDO::getInviteType, reqVO.getInviteType())
+                .orderByDesc(KeyboardUserInviteCodesDO::getId));
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/mysql/userinvites/KeyboardUserInvitesMapper.java

@@ -0,0 +1,38 @@
+package com.yolo.keyboard.dal.mysql.userinvites;
+
+import java.util.*;
+
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.mybatis.core.query.LambdaQueryWrapperX;
+import com.yolo.keyboard.framework.mybatis.core.mapper.BaseMapperX;
+import com.yolo.keyboard.dal.dataobject.userinvites.KeyboardUserInvitesDO;
+import org.apache.ibatis.annotations.Mapper;
+import com.yolo.keyboard.controller.admin.userinvites.vo.*;
+
+/**
+ * 用户邀请关系绑定台账表，记录新用户最终归属的邀请人 Mapper
+ *
+ * @author ziin
+ */
+@Mapper
+public interface KeyboardUserInvitesMapper extends BaseMapperX<KeyboardUserInvitesDO> {
+
+    default PageResult<KeyboardUserInvitesDO> selectPage(KeyboardUserInvitesPageReqVO reqVO) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<KeyboardUserInvitesDO>()
+                .eqIfPresent(KeyboardUserInvitesDO::getInviterUserId, reqVO.getInviterUserId())
+                .eqIfPresent(KeyboardUserInvitesDO::getInviteeUserId, reqVO.getInviteeUserId())
+                .eqIfPresent(KeyboardUserInvitesDO::getInviteCodeId, reqVO.getInviteCodeId())
+                .eqIfPresent(KeyboardUserInvitesDO::getClickToken, reqVO.getClickToken())
+                .eqIfPresent(KeyboardUserInvitesDO::getBindType, reqVO.getBindType())
+                .eqIfPresent(KeyboardUserInvitesDO::getBoundAt, reqVO.getBoundAt())
+                .eqIfPresent(KeyboardUserInvitesDO::getBindIp, reqVO.getBindIp())
+                .eqIfPresent(KeyboardUserInvitesDO::getBindUserAgent, reqVO.getBindUserAgent())
+                .eqIfPresent(KeyboardUserInvitesDO::getInviteType, reqVO.getInviteType())
+                .eqIfPresent(KeyboardUserInvitesDO::getProfitTenantId, reqVO.getProfitTenantId())
+                .eqIfPresent(KeyboardUserInvitesDO::getProfitEmployeeId, reqVO.getProfitEmployeeId())
+                .eqIfPresent(KeyboardUserInvitesDO::getInviterTenantId, reqVO.getInviterTenantId())
+                .eqIfPresent(KeyboardUserInvitesDO::getInviteCode, reqVO.getInviteCode())
+                .orderByDesc(KeyboardUserInvitesDO::getId));
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/mysql/userpurchaserecords/KeyboardUserPurchaseRecordsMapper.java

@@ -0,0 +1,40 @@
+package com.yolo.keyboard.dal.mysql.userpurchaserecords;
+
+import java.util.*;
+
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.mybatis.core.query.LambdaQueryWrapperX;
+import com.yolo.keyboard.framework.mybatis.core.mapper.BaseMapperX;
+import com.yolo.keyboard.dal.dataobject.userpurchaserecords.KeyboardUserPurchaseRecordsDO;
+import org.apache.ibatis.annotations.Mapper;
+import com.yolo.keyboard.controller.admin.userpurchaserecords.vo.*;
+
+/**
+ * 用户内购记录 Mapper
+ *
+ * @author ziin
+ */
+@Mapper
+public interface KeyboardUserPurchaseRecordsMapper extends BaseMapperX<KeyboardUserPurchaseRecordsDO> {
+
+    default PageResult<KeyboardUserPurchaseRecordsDO> selectPage(KeyboardUserPurchaseRecordsPageReqVO reqVO) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<KeyboardUserPurchaseRecordsDO>()
+                .eqIfPresent(KeyboardUserPurchaseRecordsDO::getUserId, reqVO.getUserId())
+                .eqIfPresent(KeyboardUserPurchaseRecordsDO::getProductId, reqVO.getProductId())
+                .eqIfPresent(KeyboardUserPurchaseRecordsDO::getPurchaseQuantity, reqVO.getPurchaseQuantity())
+                .eqIfPresent(KeyboardUserPurchaseRecordsDO::getPrice, reqVO.getPrice())
+                .eqIfPresent(KeyboardUserPurchaseRecordsDO::getCurrency, reqVO.getCurrency())
+                .betweenIfPresent(KeyboardUserPurchaseRecordsDO::getPurchaseTime, reqVO.getPurchaseTime())
+                .eqIfPresent(KeyboardUserPurchaseRecordsDO::getPurchaseType, reqVO.getPurchaseType())
+                .eqIfPresent(KeyboardUserPurchaseRecordsDO::getStatus, reqVO.getStatus())
+                .eqIfPresent(KeyboardUserPurchaseRecordsDO::getPaymentMethod, reqVO.getPaymentMethod())
+                .eqIfPresent(KeyboardUserPurchaseRecordsDO::getTransactionId, reqVO.getTransactionId())
+                .eqIfPresent(KeyboardUserPurchaseRecordsDO::getOriginalTransactionId, reqVO.getOriginalTransactionId())
+                .eqIfPresent(KeyboardUserPurchaseRecordsDO::getProductIds, reqVO.getProductIds())
+                .betweenIfPresent(KeyboardUserPurchaseRecordsDO::getPurchaseDate, reqVO.getPurchaseDate())
+                .betweenIfPresent(KeyboardUserPurchaseRecordsDO::getExpiresDate, reqVO.getExpiresDate())
+                .eqIfPresent(KeyboardUserPurchaseRecordsDO::getEnvironment, reqVO.getEnvironment())
+                .orderByDesc(KeyboardUserPurchaseRecordsDO::getId));
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/mysql/userquotatotal/KeyboardUserQuotaTotalMapper.java

@@ -0,0 +1,30 @@
+package com.yolo.keyboard.dal.mysql.userquotatotal;
+
+import java.util.*;
+
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.mybatis.core.query.LambdaQueryWrapperX;
+import com.yolo.keyboard.framework.mybatis.core.mapper.BaseMapperX;
+import com.yolo.keyboard.dal.dataobject.userquotatotal.KeyboardUserQuotaTotalDO;
+import org.apache.ibatis.annotations.Mapper;
+import com.yolo.keyboard.controller.admin.userquotatotal.vo.*;
+
+/**
+ * 用户免费功能永久总次数额度表（所有功能共用） Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface KeyboardUserQuotaTotalMapper extends BaseMapperX<KeyboardUserQuotaTotalDO> {
+
+    default PageResult<KeyboardUserQuotaTotalDO> selectPage(KeyboardUserQuotaTotalPageReqVO reqVO) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<KeyboardUserQuotaTotalDO>()
+                .eqIfPresent(KeyboardUserQuotaTotalDO::getTotalQuota, reqVO.getTotalQuota())
+                .eqIfPresent(KeyboardUserQuotaTotalDO::getUsedQuota, reqVO.getUsedQuota())
+                .eqIfPresent(KeyboardUserQuotaTotalDO::getVersion, reqVO.getVersion())
+                .eqIfPresent(KeyboardUserQuotaTotalDO::getCreatedAt, reqVO.getCreatedAt())
+                .eqIfPresent(KeyboardUserQuotaTotalDO::getUpdatedAt, reqVO.getUpdatedAt())
+                .orderByDesc(KeyboardUserQuotaTotalDO::getUserId));
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/dal/mysql/userthemes/KeyboardUserThemesMapper.java

@@ -0,0 +1,30 @@
+package com.yolo.keyboard.dal.mysql.userthemes;
+
+import java.util.*;
+
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.mybatis.core.query.LambdaQueryWrapperX;
+import com.yolo.keyboard.framework.mybatis.core.mapper.BaseMapperX;
+import com.yolo.keyboard.dal.dataobject.userthemes.KeyboardUserThemesDO;
+import org.apache.ibatis.annotations.Mapper;
+import com.yolo.keyboard.controller.admin.userthemes.vo.*;
+
+/**
+ * 用户主题 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface KeyboardUserThemesMapper extends BaseMapperX<KeyboardUserThemesDO> {
+
+    default PageResult<KeyboardUserThemesDO> selectPage(KeyboardUserThemesPageReqVO reqVO) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<KeyboardUserThemesDO>()
+                .eqIfPresent(KeyboardUserThemesDO::getThemeId, reqVO.getThemeId())
+                .eqIfPresent(KeyboardUserThemesDO::getUserId, reqVO.getUserId())
+                .eqIfPresent(KeyboardUserThemesDO::getCreatedAt, reqVO.getCreatedAt())
+                .eqIfPresent(KeyboardUserThemesDO::getViewDeleted, reqVO.getViewDeleted())
+                .eqIfPresent(KeyboardUserThemesDO::getUpdatedAt, reqVO.getUpdatedAt())
+                .orderByDesc(KeyboardUserThemesDO::getId));
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/job/CommissionWithdrawableJob.java

@@ -0,0 +1,134 @@
+package com.yolo.keyboard.job;
+
+import cn.hutool.core.collection.CollUtil;
+import com.yolo.keyboard.dal.dataobject.tenantbalance.TenantBalanceDO;
+import com.yolo.keyboard.dal.dataobject.tenantbalancetransaction.TenantBalanceTransactionDO;
+import com.yolo.keyboard.dal.dataobject.tenantcommission.KeyboardTenantCommissionDO;
+import com.yolo.keyboard.dal.mysql.tenantbalance.TenantBalanceMapper;
+import com.yolo.keyboard.dal.mysql.tenantbalancetransaction.TenantBalanceTransactionMapper;
+import com.yolo.keyboard.dal.mysql.tenantcommission.KeyboardTenantCommissionMapper;
+import com.yolo.keyboard.framework.mybatis.core.query.LambdaQueryWrapperX;
+import com.yolo.keyboard.framework.quartz.core.handler.JobHandler;
+import com.yolo.keyboard.framework.tenant.core.aop.TenantIgnore;
+import com.yolo.keyboard.utils.BizNoGenerator;
+import jakarta.annotation.Resource;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+/**
+ * 分成可提现转换定时任务
+ * 每小时执行一次，将满30天的分成金额转为可提现余额
+ *
+ * @author ziin
+ */
+@Component
+@Slf4j
+public class CommissionWithdrawableJob implements JobHandler {
+
+    @Resource
+    private KeyboardTenantCommissionMapper commissionMapper;
+
+    @Resource
+    private TenantBalanceMapper tenantBalanceMapper;
+
+    @Resource
+    private TenantBalanceTransactionMapper balanceTransactionMapper;
+
+    private static final String WITHDRAWABLE_TYPE = "WITHDRAWABLE";
+
+    @Override
+    @TenantIgnore
+    @Transactional(rollbackFor = Exception.class)
+    public String execute(String param) {
+        log.info("[CommissionWithdrawableJob] 开始执行分成可提现转换任务");
+
+        LocalDateTime now = LocalDateTime.now();
+
+        // 1. 查询已到可提现时间且未处理的分成记录
+        List<KeyboardTenantCommissionDO> commissions = commissionMapper.selectList(
+                new LambdaQueryWrapperX<KeyboardTenantCommissionDO>()
+                        .le(KeyboardTenantCommissionDO::getWithdrawableAt, now)
+                        .eq(KeyboardTenantCommissionDO::getWithdrawableProcessed, false)
+                        .eq(KeyboardTenantCommissionDO::getStatus, "SETTLED")
+        );
+
+        if (CollUtil.isEmpty(commissions)) {
+            log.info("[CommissionWithdrawableJob] 没有需要处理的分成记录");
+            return "没有需要处理的分成记录";
+        }
+
+        // 2. 按租户分组汇总金额
+        Map<Long, List<KeyboardTenantCommissionDO>> tenantCommissionsMap = commissions.stream()
+                .collect(Collectors.groupingBy(KeyboardTenantCommissionDO::getTenantId));
+
+        int tenantCount = 0;
+        int commissionCount = 0;
+        BigDecimal totalAmount = BigDecimal.ZERO;
+
+        // 3. 逐个租户处理
+        for (Map.Entry<Long, List<KeyboardTenantCommissionDO>> entry : tenantCommissionsMap.entrySet()) {
+            Long tenantId = entry.getKey();
+            List<KeyboardTenantCommissionDO> tenantCommissions = entry.getValue();
+
+            // 计算该租户的总可提现金额
+            BigDecimal tenantTotalAmount = tenantCommissions.stream()
+                    .map(KeyboardTenantCommissionDO::getCommissionAmount)
+                    .reduce(BigDecimal.ZERO, BigDecimal::add);
+
+            // 更新租户可提现余额
+            TenantBalanceDO balance = tenantBalanceMapper.selectById(tenantId);
+            if (balance == null) {
+                log.warn("[CommissionWithdrawableJob] 租户 {} 余额记录不存在，跳过", tenantId);
+                continue;
+            }
+
+            BigDecimal currentWithdrawable = balance.getWithdrawableBalance() != null
+                    ? balance.getWithdrawableBalance() : BigDecimal.ZERO;
+            BigDecimal newWithdrawable = currentWithdrawable.add(tenantTotalAmount);
+            balance.setWithdrawableBalance(newWithdrawable);
+            tenantBalanceMapper.updateById(balance);
+
+            // 创建余额交易记录
+            String bizNo = BizNoGenerator.generate("WDB");
+            TenantBalanceTransactionDO transaction = TenantBalanceTransactionDO.builder()
+                    .bizNo(bizNo)
+                    .points(tenantTotalAmount)
+                    .balance(balance.getBalance())
+                    .frozenAmt(balance.getFrozenAmt() != null ? balance.getFrozenAmt() : BigDecimal.ZERO)
+                    .withdrawableBalance(newWithdrawable)
+                    .tenantId(tenantId)
+                    .type(WITHDRAWABLE_TYPE)
+                    .description("分成转可提现")
+                    .createdAt(now)
+                    .remark("共 " + tenantCommissions.size() + " 笔分成转为可提现")
+                    .build();
+            balanceTransactionMapper.insert(transaction);
+
+            // 标记分成记录为已处理
+            for (KeyboardTenantCommissionDO commission : tenantCommissions) {
+                commission.setWithdrawableProcessed(true);
+                commission.setUpdatedAt(now);
+                commissionMapper.updateById(commission);
+            }
+
+            tenantCount++;
+            commissionCount += tenantCommissions.size();
+            totalAmount = totalAmount.add(tenantTotalAmount);
+
+            log.info("[CommissionWithdrawableJob] 处理租户 {}，分成 {} 笔，金额 {}",
+                    tenantId, tenantCommissions.size(), tenantTotalAmount);
+        }
+
+        String result = String.format("处理租户 %d 个，分成记录 %d 条，总金额 %s",
+                tenantCount, commissionCount, totalAmount.toPlainString());
+        log.info("[CommissionWithdrawableJob] 任务执行完成: {}", result);
+        return result;
+    }
+}

keyboard-server/src/main/java/com/yolo/keyboard/job/TenantCommissionCalculateJob.java

@@ -0,0 +1,308 @@
+package com.yolo.keyboard.job;
+
+import cn.hutool.core.collection.CollUtil;
+import com.yolo.keyboard.dal.dataobject.tenantbalance.TenantBalanceDO;
+import com.yolo.keyboard.dal.dataobject.tenantbalancetransaction.TenantBalanceTransactionDO;
+import com.yolo.keyboard.dal.dataobject.tenantcommission.KeyboardTenantCommissionDO;
+import com.yolo.keyboard.dal.dataobject.userinvites.KeyboardUserInvitesDO;
+import com.yolo.keyboard.dal.dataobject.userpurchaserecords.KeyboardUserPurchaseRecordsDO;
+import com.yolo.keyboard.dal.mysql.tenantbalance.TenantBalanceMapper;
+import com.yolo.keyboard.dal.mysql.tenantbalancetransaction.TenantBalanceTransactionMapper;
+import com.yolo.keyboard.dal.mysql.tenantcommission.KeyboardTenantCommissionMapper;
+import com.yolo.keyboard.dal.mysql.userinvites.KeyboardUserInvitesMapper;
+import com.yolo.keyboard.dal.mysql.userpurchaserecords.KeyboardUserPurchaseRecordsMapper;
+import com.yolo.keyboard.framework.mybatis.core.query.LambdaQueryWrapperX;
+import com.yolo.keyboard.framework.quartz.core.handler.JobHandler;
+import com.yolo.keyboard.framework.tenant.core.aop.TenantIgnore;
+import com.yolo.keyboard.module.system.dal.dataobject.tenant.TenantDO;
+import com.yolo.keyboard.module.system.dal.mysql.tenant.TenantMapper;
+import com.yolo.keyboard.utils.BizNoGenerator;
+import jakarta.annotation.Resource;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.math.BigDecimal;
+import java.math.RoundingMode;
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * 租户分成计算定时任务
+ * 每小时执行一次，计算邀请用户的内购分成
+ * 支持一级代理和二级代理的分成计算
+ *
+ * @author ziin
+ */
+@Component
+@Slf4j
+public class TenantCommissionCalculateJob implements JobHandler {
+
+    @Resource
+    private KeyboardUserPurchaseRecordsMapper purchaseRecordsMapper;
+
+    @Resource
+    private KeyboardUserInvitesMapper userInvitesMapper;
+
+    @Resource
+    private KeyboardTenantCommissionMapper commissionMapper;
+
+    @Resource
+    private TenantMapper tenantMapper;
+
+    @Resource
+    private TenantBalanceMapper tenantBalanceMapper;
+
+    @Resource
+    private TenantBalanceTransactionMapper balanceTransactionMapper;
+
+    private static final String COMMISSION_TYPE = "COMMISSION";
+    private static final String STATUS_PAID = "PAID";
+    private static final String INVITE_TYPE_AGENT = "AGENT";
+
+    @Override
+    @TenantIgnore
+    @Transactional(rollbackFor = Exception.class)
+    public String execute(String param) {
+        log.info("[TenantCommissionCalculateJob] 开始执行分成计算任务");
+
+        // 1. 查询最近一小时内已支付的内购记录
+        LocalDateTime endTime = LocalDateTime.now();
+        LocalDateTime startTime = endTime.minusHours(1);
+
+        List<KeyboardUserPurchaseRecordsDO> purchaseRecords = purchaseRecordsMapper.selectList(
+                new LambdaQueryWrapperX<KeyboardUserPurchaseRecordsDO>()
+                        .eq(KeyboardUserPurchaseRecordsDO::getStatus, STATUS_PAID)
+                        .between(KeyboardUserPurchaseRecordsDO::getPurchaseTime, startTime, endTime)
+        );
+
+        if (CollUtil.isEmpty(purchaseRecords)) {
+            log.info("[TenantCommissionCalculateJob] 最近一小时内没有已支付的内购记录");
+            return "没有需要处理的内购记录";
+        }
+
+        int processedCount = 0;
+        int commissionCount = 0;
+        BigDecimal totalCommission = BigDecimal.ZERO;
+
+        // 2. 遍历内购记录，检查是否有邀请关系
+        for (KeyboardUserPurchaseRecordsDO record : purchaseRecords) {
+            // 检查是否已经计算过分成
+            if (commissionMapper.selectByPurchaseRecordId(record.getId()) != null) {
+                log.debug("[TenantCommissionCalculateJob] 内购记录 {} 已计算过分成，跳过", record.getId());
+                continue;
+            }
+
+            processedCount++;
+
+            // 查询该用户的邀请关系
+            KeyboardUserInvitesDO invite = userInvitesMapper.selectOne(
+                    KeyboardUserInvitesDO::getInviteeUserId, record.getUserId().longValue()
+            );
+
+            if (invite == null) {
+                log.debug("[TenantCommissionCalculateJob] 用户 {} 没有邀请关系，跳过", record.getUserId());
+                continue;
+            }
+
+            // 只处理代理邀请类型
+            if (!INVITE_TYPE_AGENT.equals(invite.getInviteType())) {
+                log.debug("[TenantCommissionCalculateJob] 用户 {} 的邀请类型不是代理，跳过", record.getUserId());
+                continue;
+            }
+
+            // 获取收益归属租户（邀请人所属租户）
+            Long inviterTenantId = invite.getProfitTenantId();
+            if (inviterTenantId == null) {
+                inviterTenantId = invite.getInviterTenantId();
+            }
+            if (inviterTenantId == null) {
+                log.warn("[TenantCommissionCalculateJob] 用户 {} 的邀请关系没有关联租户，跳过", record.getUserId());
+                continue;
+            }
+
+            // 获取邀请人租户信息
+            TenantDO inviterTenant = tenantMapper.selectById(inviterTenantId);
+            if (inviterTenant == null) {
+                log.warn("[TenantCommissionCalculateJob] 租户 {} 不存在，跳过", inviterTenantId);
+                continue;
+            }
+
+            // 获取内购金额
+            BigDecimal purchaseAmount = record.getPrice();
+            if (purchaseAmount == null || purchaseAmount.compareTo(BigDecimal.ZERO) <= 0) {
+                log.debug("[TenantCommissionCalculateJob] 内购记录 {} 金额无效，跳过", record.getId());
+                continue;
+            }
+
+            LocalDateTime now = LocalDateTime.now();
+            LocalDateTime withdrawableAt = now.plusDays(30);
+
+            // 判断是否是二级代理（有上级租户）
+            if (inviterTenant.getParentId() != null) {
+                // 二级代理场景：需要给一级代理和二级代理都分成
+                TenantDO parentTenant = tenantMapper.selectById(inviterTenant.getParentId());
+                if (parentTenant == null) {
+                    log.warn("[TenantCommissionCalculateJob] 上级租户 {} 不存在，跳过", inviterTenant.getParentId());
+                    continue;
+                }
+
+                // 使用一级代理的分成比例计算总分成
+                BigDecimal totalCommissionRate = parentTenant.getProfitShareRatio();
+                if (totalCommissionRate == null || totalCommissionRate.compareTo(BigDecimal.ZERO) <= 0) {
+                    log.debug("[TenantCommissionCalculateJob] 一级代理租户 {} 没有设置分成比例，跳过", parentTenant.getId());
+                    continue;
+                }
+
+                BigDecimal totalCommissionAmount = purchaseAmount.multiply(totalCommissionRate)
+                        .setScale(2, RoundingMode.HALF_UP);
+
+                // 获取二级代理的返点比例
+                BigDecimal rebateRatio = inviterTenant.getUpstreamRebateRatio();
+                if (rebateRatio == null || rebateRatio.compareTo(BigDecimal.ZERO) <= 0) {
+                    // 如果没有设置返点比例，全部归一级代理
+                    log.debug("[TenantCommissionCalculateJob] 二级代理租户 {} 没有设置返点比例，全部归一级代理", inviterTenantId);
+                    int count = createCommissionRecord(record, invite, parentTenant.getId(), purchaseAmount,
+                            totalCommissionRate, totalCommissionAmount, now, withdrawableAt,
+                            "一级代理分成（二级代理无返点）");
+                    commissionCount += count;
+                    totalCommission = totalCommission.add(totalCommissionAmount);
+                } else {
+                    // 计算二级代理分成
+                    BigDecimal secondLevelAmount = totalCommissionAmount.multiply(rebateRatio)
+                            .setScale(2, RoundingMode.HALF_UP);
+                    // 计算一级代理分成
+                    BigDecimal firstLevelAmount = totalCommissionAmount.subtract(secondLevelAmount);
+
+                    // 为二级代理创建分成记录
+                    if (secondLevelAmount.compareTo(BigDecimal.ZERO) > 0) {
+                        int count = createCommissionRecord(record, invite, inviterTenantId, purchaseAmount,
+                                rebateRatio, secondLevelAmount, now, withdrawableAt,
+                                "二级代理分成");
+                        commissionCount += count;
+                        totalCommission = totalCommission.add(secondLevelAmount);
+                        log.info("[TenantCommissionCalculateJob] 内购记录 {}, 二级代理 {}, 分成金额 {}",
+                                record.getId(), inviterTenantId, secondLevelAmount);
+                    }
+
+                    // 为一级代理创建分成记录
+                    if (firstLevelAmount.compareTo(BigDecimal.ZERO) > 0) {
+                        BigDecimal firstLevelRate = BigDecimal.ONE.subtract(rebateRatio);
+                        int count = createCommissionRecord(record, invite, parentTenant.getId(), purchaseAmount,
+                                firstLevelRate, firstLevelAmount, now, withdrawableAt,
+                                "一级代理分成（扣除二级返点）");
+                        commissionCount += count;
+                        totalCommission = totalCommission.add(firstLevelAmount);
+                        log.info("[TenantCommissionCalculateJob] 内购记录 {}, 一级代理 {}, 分成金额 {}",
+                                record.getId(), parentTenant.getId(), firstLevelAmount);
+                    }
+                }
+            } else {
+                // 一级代理场景：全部分成归一级代理
+                BigDecimal commissionRate = inviterTenant.getProfitShareRatio();
+                if (commissionRate == null || commissionRate.compareTo(BigDecimal.ZERO) <= 0) {
+                    log.debug("[TenantCommissionCalculateJob] 租户 {} 没有设置分成比例，跳过", inviterTenantId);
+                    continue;
+                }
+
+                BigDecimal commissionAmount = purchaseAmount.multiply(commissionRate)
+                        .setScale(2, RoundingMode.HALF_UP);
+
+                int count = createCommissionRecord(record, invite, inviterTenantId, purchaseAmount,
+                        commissionRate, commissionAmount, now, withdrawableAt,
+                        "一级代理分成");
+                commissionCount += count;
+                totalCommission = totalCommission.add(commissionAmount);
+
+                log.info("[TenantCommissionCalculateJob] 内购记录 {}, 一级代理 {}, 分成金额 {}",
+                        record.getId(), inviterTenantId, commissionAmount);
+            }
+        }
+
+        String result = String.format("处理内购记录 %d 条，生成分成 %d 条，总分成金额 %s",
+                processedCount, commissionCount, totalCommission.toPlainString());
+        log.info("[TenantCommissionCalculateJob] 任务执行完成: {}", result);
+        return result;
+    }
+
+    /**
+     * 创建分成记录并更新租户余额
+     *
+     * @return 创建的分成记录数量
+     */
+    private int createCommissionRecord(KeyboardUserPurchaseRecordsDO record,
+                                       KeyboardUserInvitesDO invite,
+                                       Long tenantId,
+                                       BigDecimal purchaseAmount,
+                                       BigDecimal commissionRate,
+                                       BigDecimal commissionAmount,
+                                       LocalDateTime now,
+                                       LocalDateTime withdrawableAt,
+                                       String remark) {
+        // 0. 检查该租户是否已对该内购记录计算过分成（防止重复计算）
+        KeyboardTenantCommissionDO existingCommission = commissionMapper.selectByPurchaseRecordIdAndTenantId(record.getId(), tenantId);
+        if (existingCommission != null) {
+            log.debug("[TenantCommissionCalculateJob] 租户 {} 已对内购记录 {} 计算过分成，跳过", tenantId, record.getId());
+            return 0;
+        }
+
+        // 1. 创建分成记录
+        KeyboardTenantCommissionDO commission = KeyboardTenantCommissionDO.builder()
+                .purchaseRecordId(record.getId())
+                .transactionId(record.getTransactionId())
+                .inviteeUserId(record.getUserId())
+                .inviterUserId(invite.getProfitEmployeeId())
+                .tenantId(tenantId)
+                .purchaseAmount(purchaseAmount)
+                .commissionRate(commissionRate)
+                .commissionAmount(commissionAmount)
+                .status("SETTLED")
+                .purchaseTime(record.getPurchaseTime())
+                .settledAt(now)
+                .withdrawableAt(withdrawableAt)
+                .withdrawableProcessed(false)
+                .createdAt(now)
+                .updatedAt(now)
+                .remark(remark)
+                .build();
+
+        // 2. 更新租户余额（分成金额先计入总余额，30天后才可提现）
+        TenantBalanceDO balance = tenantBalanceMapper.selectById(tenantId);
+        if (balance == null) {
+            balance = new TenantBalanceDO();
+            balance.setId(tenantId);
+            balance.setBalance(commissionAmount);
+            balance.setWithdrawableBalance(BigDecimal.ZERO);
+            balance.setFrozenAmt(BigDecimal.ZERO);
+            balance.setVersion(0);
+            tenantBalanceMapper.insert(balance);
+        } else {
+            BigDecimal newBalance = balance.getBalance().add(commissionAmount);
+            balance.setBalance(newBalance);
+            tenantBalanceMapper.updateById(balance);
+        }
+
+        // 3. 创建余额交易记录
+        String bizNo = BizNoGenerator.generate("COMM");
+        TenantBalanceTransactionDO transaction = TenantBalanceTransactionDO.builder()
+                .bizNo(bizNo)
+                .points(commissionAmount)
+                .balance(balance.getBalance())
+                .frozenAmt(balance.getFrozenAmt() != null ? balance.getFrozenAmt() : BigDecimal.ZERO)
+                .withdrawableBalance(balance.getWithdrawableBalance() != null ? balance.getWithdrawableBalance() : BigDecimal.ZERO)
+                .tenantId(tenantId)
+                .type(COMMISSION_TYPE)
+                .description("邀请用户内购分成")
+                .orderId(record.getTransactionId())
+                .createdAt(now)
+                .remark("内购记录ID: " + record.getId() + ", 被邀请用户: " + record.getUserId() + ", " + remark)
+                .build();
+        balanceTransactionMapper.insert(transaction);
+
+        // 4. 更新分成记录的关联交易ID并保存
+        commission.setBalanceTransactionId(transaction.getId());
+        commissionMapper.insert(commission);
+
+        return 1;
+    }
+}

keyboard-server/src/main/java/com/yolo/keyboard/service/i18nmessage/KeyboardI18nMessageService.java

@@ -0,0 +1,62 @@
+package com.yolo.keyboard.service.i18nmessage;
+
+import java.util.*;
+import jakarta.validation.*;
+import com.yolo.keyboard.controller.admin.i18nmessage.vo.*;
+import com.yolo.keyboard.dal.dataobject.i18nmessage.KeyboardI18nMessageDO;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+
+/**
+ * 国际化错误提醒配置 Service 接口
+ *
+ * @author ziin
+ */
+public interface KeyboardI18nMessageService {
+
+    /**
+     * 创建国际化错误提醒配置
+     *
+     * @param createReqVO 创建信息
+     * @return 编号
+     */
+    Long createI18nMessage(@Valid KeyboardI18nMessageSaveReqVO createReqVO);
+
+    /**
+     * 更新国际化错误提醒配置
+     *
+     * @param updateReqVO 更新信息
+     */
+    void updateI18nMessage(@Valid KeyboardI18nMessageSaveReqVO updateReqVO);
+
+    /**
+     * 删除国际化错误提醒配置
+     *
+     * @param id 编号
+     */
+    void deleteI18nMessage(Long id);
+
+    /**
+    * 批量删除国际化错误提醒配置
+    *
+    * @param ids 编号
+    */
+    void deleteI18nMessageListByIds(List<Long> ids);
+
+    /**
+     * 获得国际化错误提醒配置
+     *
+     * @param id 编号
+     * @return 国际化错误提醒配置
+     */
+    KeyboardI18nMessageDO getI18nMessage(Long id);
+
+    /**
+     * 获得国际化错误提醒配置分页
+     *
+     * @param pageReqVO 分页查询
+     * @return 国际化错误提醒配置分页
+     */
+    PageResult<KeyboardI18nMessageDO> getI18nMessagePage(KeyboardI18nMessagePageReqVO pageReqVO);
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/service/i18nmessage/KeyboardI18nMessageServiceImpl.java

@@ -0,0 +1,85 @@
+package com.yolo.keyboard.service.i18nmessage;
+
+import cn.hutool.core.collection.CollUtil;
+import org.springframework.stereotype.Service;
+import jakarta.annotation.Resource;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.*;
+import com.yolo.keyboard.controller.admin.i18nmessage.vo.*;
+import com.yolo.keyboard.dal.dataobject.i18nmessage.KeyboardI18nMessageDO;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import com.yolo.keyboard.framework.common.util.object.BeanUtils;
+
+import com.yolo.keyboard.dal.mysql.i18nmessage.KeyboardI18nMessageMapper;
+
+import static com.yolo.keyboard.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static com.yolo.keyboard.framework.common.util.collection.CollectionUtils.convertList;
+import static com.yolo.keyboard.framework.common.util.collection.CollectionUtils.diffList;
+import static com.yolo.keyboard.module.infra.enums.ErrorCodeConstants.I18N_MESSAGE_NOT_EXISTS;
+
+/**
+ * 国际化错误提醒配置 Service 实现类
+ *
+ * @author ziin
+ */
+@Service
+@Validated
+public class KeyboardI18nMessageServiceImpl implements KeyboardI18nMessageService {
+
+    @Resource
+    private KeyboardI18nMessageMapper i18nMessageMapper;
+
+    @Override
+    public Long createI18nMessage(KeyboardI18nMessageSaveReqVO createReqVO) {
+        // 插入
+        KeyboardI18nMessageDO i18nMessage = BeanUtils.toBean(createReqVO, KeyboardI18nMessageDO.class);
+        i18nMessageMapper.insert(i18nMessage);
+
+        // 返回
+        return i18nMessage.getId();
+    }
+
+    @Override
+    public void updateI18nMessage(KeyboardI18nMessageSaveReqVO updateReqVO) {
+        // 校验存在
+        validateI18nMessageExists(updateReqVO.getId());
+        // 更新
+        KeyboardI18nMessageDO updateObj = BeanUtils.toBean(updateReqVO, KeyboardI18nMessageDO.class);
+        i18nMessageMapper.updateById(updateObj);
+    }
+
+    @Override
+    public void deleteI18nMessage(Long id) {
+        // 校验存在
+        validateI18nMessageExists(id);
+        // 删除
+        i18nMessageMapper.deleteById(id);
+    }
+
+    @Override
+        public void deleteI18nMessageListByIds(List<Long> ids) {
+        // 删除
+        i18nMessageMapper.deleteByIds(ids);
+        }
+
+
+    private void validateI18nMessageExists(Long id) {
+        if (i18nMessageMapper.selectById(id) == null) {
+            throw exception(I18N_MESSAGE_NOT_EXISTS);
+        }
+    }
+
+    @Override
+    public KeyboardI18nMessageDO getI18nMessage(Long id) {
+        return i18nMessageMapper.selectById(id);
+    }
+
+    @Override
+    public PageResult<KeyboardI18nMessageDO> getI18nMessagePage(KeyboardI18nMessagePageReqVO pageReqVO) {
+        return i18nMessageMapper.selectPage(pageReqVO);
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/service/productitems/KeyboardProductItemsService.java

@@ -0,0 +1,62 @@
+package com.yolo.keyboard.service.productitems;
+
+import java.util.*;
+import jakarta.validation.*;
+import com.yolo.keyboard.controller.admin.productitems.vo.*;
+import com.yolo.keyboard.dal.dataobject.productitems.KeyboardProductItemsDO;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+
+/**
+ * 内购商品 Service 接口
+ *
+ * @author ziin
+ */
+public interface KeyboardProductItemsService {
+
+    /**
+     * 创建内购商品
+     *
+     * @param createReqVO 创建信息
+     * @return 编号
+     */
+    Long createProductItems(@Valid KeyboardProductItemsSaveReqVO createReqVO);
+
+    /**
+     * 更新内购商品
+     *
+     * @param updateReqVO 更新信息
+     */
+    void updateProductItems(@Valid KeyboardProductItemsSaveReqVO updateReqVO);
+
+    /**
+     * 删除内购商品
+     *
+     * @param id 编号
+     */
+    void deleteProductItems(Long id);
+
+    /**
+    * 批量删除内购商品
+    *
+    * @param ids 编号
+    */
+    void deleteProductItemsListByIds(List<Long> ids);
+
+    /**
+     * 获得内购商品
+     *
+     * @param id 编号
+     * @return 内购商品
+     */
+    KeyboardProductItemsDO getProductItems(Long id);
+
+    /**
+     * 获得内购商品分页
+     *
+     * @param pageReqVO 分页查询
+     * @return 内购商品分页
+     */
+    PageResult<KeyboardProductItemsDO> getProductItemsPage(KeyboardProductItemsPageReqVO pageReqVO);
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/service/productitems/KeyboardProductItemsServiceImpl.java

@@ -0,0 +1,85 @@
+package com.yolo.keyboard.service.productitems;
+
+import cn.hutool.core.collection.CollUtil;
+import org.springframework.stereotype.Service;
+import jakarta.annotation.Resource;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.*;
+import com.yolo.keyboard.controller.admin.productitems.vo.*;
+import com.yolo.keyboard.dal.dataobject.productitems.KeyboardProductItemsDO;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import com.yolo.keyboard.framework.common.util.object.BeanUtils;
+
+import com.yolo.keyboard.dal.mysql.productitems.KeyboardProductItemsMapper;
+
+import static com.yolo.keyboard.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static com.yolo.keyboard.framework.common.util.collection.CollectionUtils.convertList;
+import static com.yolo.keyboard.framework.common.util.collection.CollectionUtils.diffList;
+import static com.yolo.keyboard.module.infra.enums.ErrorCodeConstants.PRODUCT_ITEMS_NOT_EXISTS;
+
+/**
+ * 内购商品 Service 实现类
+ *
+ * @author ziin
+ */
+@Service
+@Validated
+public class KeyboardProductItemsServiceImpl implements KeyboardProductItemsService {
+
+    @Resource
+    private KeyboardProductItemsMapper productItemsMapper;
+
+    @Override
+    public Long createProductItems(KeyboardProductItemsSaveReqVO createReqVO) {
+        // 插入
+        KeyboardProductItemsDO productItems = BeanUtils.toBean(createReqVO, KeyboardProductItemsDO.class);
+        productItemsMapper.insert(productItems);
+
+        // 返回
+        return productItems.getId();
+    }
+
+    @Override
+    public void updateProductItems(KeyboardProductItemsSaveReqVO updateReqVO) {
+        // 校验存在
+        validateProductItemsExists(updateReqVO.getId());
+        // 更新
+        KeyboardProductItemsDO updateObj = BeanUtils.toBean(updateReqVO, KeyboardProductItemsDO.class);
+        productItemsMapper.updateById(updateObj);
+    }
+
+    @Override
+    public void deleteProductItems(Long id) {
+        // 校验存在
+        validateProductItemsExists(id);
+        // 删除
+        productItemsMapper.deleteById(id);
+    }
+
+    @Override
+        public void deleteProductItemsListByIds(List<Long> ids) {
+        // 删除
+        productItemsMapper.deleteByIds(ids);
+        }
+
+
+    private void validateProductItemsExists(Long id) {
+        if (productItemsMapper.selectById(id) == null) {
+            throw exception(PRODUCT_ITEMS_NOT_EXISTS);
+        }
+    }
+
+    @Override
+    public KeyboardProductItemsDO getProductItems(Long id) {
+        return productItemsMapper.selectById(id);
+    }
+
+    @Override
+    public PageResult<KeyboardProductItemsDO> getProductItemsPage(KeyboardProductItemsPageReqVO pageReqVO) {
+        return productItemsMapper.selectPage(pageReqVO);
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/service/tag/KeyboardTagService.java

@@ -0,0 +1,62 @@
+package com.yolo.keyboard.service.tag;
+
+import java.util.*;
+import jakarta.validation.*;
+import com.yolo.keyboard.controller.admin.tag.vo.*;
+import com.yolo.keyboard.dal.dataobject.tag.KeyboardTagDO;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+
+/**
+ * 人设标签 Service 接口
+ *
+ * @author ziin
+ */
+public interface KeyboardTagService {
+
+    /**
+     * 创建人设标签
+     *
+     * @param createReqVO 创建信息
+     * @return 编号
+     */
+    Integer createTag(@Valid KeyboardTagSaveReqVO createReqVO);
+
+    /**
+     * 更新人设标签
+     *
+     * @param updateReqVO 更新信息
+     */
+    void updateTag(@Valid KeyboardTagSaveReqVO updateReqVO);
+
+    /**
+     * 删除人设标签
+     *
+     * @param id 编号
+     */
+    void deleteTag(Integer id);
+
+    /**
+    * 批量删除人设标签
+    *
+    * @param ids 编号
+    */
+    void deleteTagListByIds(List<Integer> ids);
+
+    /**
+     * 获得人设标签
+     *
+     * @param id 编号
+     * @return 人设标签
+     */
+    KeyboardTagDO getTag(Integer id);
+
+    /**
+     * 获得人设标签分页
+     *
+     * @param pageReqVO 分页查询
+     * @return 人设标签分页
+     */
+    PageResult<KeyboardTagDO> getTagPage(KeyboardTagPageReqVO pageReqVO);
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/service/tag/KeyboardTagServiceImpl.java

@@ -0,0 +1,85 @@
+package com.yolo.keyboard.service.tag;
+
+import cn.hutool.core.collection.CollUtil;
+import org.springframework.stereotype.Service;
+import jakarta.annotation.Resource;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.*;
+import com.yolo.keyboard.controller.admin.tag.vo.*;
+import com.yolo.keyboard.dal.dataobject.tag.KeyboardTagDO;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import com.yolo.keyboard.framework.common.util.object.BeanUtils;
+
+import com.yolo.keyboard.dal.mysql.tag.KeyboardTagMapper;
+
+import static com.yolo.keyboard.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static com.yolo.keyboard.framework.common.util.collection.CollectionUtils.convertList;
+import static com.yolo.keyboard.framework.common.util.collection.CollectionUtils.diffList;
+import static com.yolo.keyboard.module.infra.enums.ErrorCodeConstants.TAG_NOT_EXISTS;
+
+/**
+ * 人设标签 Service 实现类
+ *
+ * @author ziin
+ */
+@Service
+@Validated
+public class KeyboardTagServiceImpl implements KeyboardTagService {
+
+    @Resource
+    private KeyboardTagMapper tagMapper;
+
+    @Override
+    public Integer createTag(KeyboardTagSaveReqVO createReqVO) {
+        // 插入
+        KeyboardTagDO tag = BeanUtils.toBean(createReqVO, KeyboardTagDO.class);
+        tagMapper.insert(tag);
+
+        // 返回
+        return tag.getId();
+    }
+
+    @Override
+    public void updateTag(KeyboardTagSaveReqVO updateReqVO) {
+        // 校验存在
+        validateTagExists(updateReqVO.getId());
+        // 更新
+        KeyboardTagDO updateObj = BeanUtils.toBean(updateReqVO, KeyboardTagDO.class);
+        tagMapper.updateById(updateObj);
+    }
+
+    @Override
+    public void deleteTag(Integer id) {
+        // 校验存在
+        validateTagExists(id);
+        // 删除
+        tagMapper.deleteById(id);
+    }
+
+    @Override
+        public void deleteTagListByIds(List<Integer> ids) {
+        // 删除
+        tagMapper.deleteByIds(ids);
+        }
+
+
+    private void validateTagExists(Integer id) {
+        if (tagMapper.selectById(id) == null) {
+            throw exception(TAG_NOT_EXISTS);
+        }
+    }
+
+    @Override
+    public KeyboardTagDO getTag(Integer id) {
+        return tagMapper.selectById(id);
+    }
+
+    @Override
+    public PageResult<KeyboardTagDO> getTagPage(KeyboardTagPageReqVO pageReqVO) {
+        return tagMapper.selectPage(pageReqVO);
+    }
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/service/tenantbalance/TenantBalanceService.java

@@ -0,0 +1,139 @@
+package com.yolo.keyboard.service.tenantbalance;
+
+import java.util.*;
+
+import com.yolo.keyboard.dal.dataobject.tenantbalancetransaction.TenantBalanceTransactionDO;
+import jakarta.validation.*;
+import com.yolo.keyboard.controller.admin.tenantbalance.vo.*;
+import com.yolo.keyboard.dal.dataobject.tenantbalance.TenantBalanceDO;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+
+/**
+ * 租户余额 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface TenantBalanceService {
+
+    /**
+     * 创建租户余额
+     *
+     * @param createReqVO 创建信息
+     * @return 编号
+     */
+    Long createTenantBalance(@Valid TenantBalanceSaveReqVO createReqVO);
+
+    /**
+     * 更新租户余额
+     *
+     * @param updateReqVO 更新信息
+     */
+    void updateTenantBalance(@Valid TenantBalanceSaveReqVO updateReqVO);
+
+    /**
+     * 删除租户余额
+     *
+     * @param id 编号
+     */
+    void deleteTenantBalance(Long id);
+
+    /**
+    * 批量删除租户余额
+    *
+    * @param ids 编号
+    */
+    void deleteTenantBalanceListByIds(List<Long> ids);
+
+    /**
+     * 获得租户余额
+     *
+     * @param id 编号
+     * @return 租户余额
+     */
+    TenantBalanceDO getTenantBalance(Long id);
+
+    /**
+     * 获得租户余额分页
+     *
+     * @param pageReqVO 分页查询
+     * @return 租户余额分页
+     */
+    PageResult<TenantBalanceDO> getTenantBalancePage(TenantBalancePageReqVO pageReqVO);
+
+    /**
+     * 添加租户余额
+     *
+     * @param addReqVO 添加信息
+     */
+    void addTenantBalance(@Valid TenantBalanceAddReqVO addReqVO);
+
+    /**
+     * 获得自己的余额
+     *
+     * @return 租户余额
+     */
+    TenantBalanceDO getSelfBalance();
+
+    /**
+     * 获得自己下级余额的分页
+     *
+     * @param pageReqVO 分页查询
+     * @return 租户余额分页
+     */
+    PageResult<TenantBalanceRespVO> getSelfSubordinateTenantBalancePage(TenantBalancePageReqVO pageReqVO);
+
+    /**
+     * 获得租户积分记录分页
+     *
+     * @param pageReqVO 分页查询
+     * @param tenantId 租户 Id
+     * @return 租户积分记录分页
+     */
+    PageResult<TenantBalanceTransactionDO> getTenantBalanceTransactionPage(PageParam pageReqVO, Long tenantId);
+
+    /**
+     * 创建租户积分记录
+     *
+     * @param tenantBalanceTransaction 创建信息
+     * @return 编号
+     */
+    Long createTenantBalanceTransaction(@Valid TenantBalanceTransactionDO tenantBalanceTransaction);
+
+    /**
+     * 更新租户积分记录
+     *
+     * @param tenantBalanceTransaction 更新信息
+     */
+    void updateTenantBalanceTransaction(@Valid TenantBalanceTransactionDO tenantBalanceTransaction);
+
+    /**
+     * 删除租户积分记录
+     *
+     * @param id 编号
+     */
+    void deleteTenantBalanceTransaction(Long id);
+
+    /**
+     * 批量删除租户积分记录
+     *
+     * @param ids 编号
+     */
+    void deleteTenantBalanceTransactionListByIds(List<Long> ids);
+
+    /**
+     * 获得租户积分记录
+     *
+     * @param id 编号
+     * @return 租户积分记录
+     */
+    TenantBalanceTransactionDO getTenantBalanceTransaction(Long id);
+
+    /**
+     * 租户提现
+     *
+     * @param withdrawReqVO 提现信息
+     */
+    void withdraw(@Valid TenantBalanceWithdrawReqVO withdrawReqVO);
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/service/tenantbalance/TenantBalanceServiceImpl.java

@@ -0,0 +1,375 @@
+package com.yolo.keyboard.service.tenantbalance;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.json.JSONUtil;
+import com.yolo.keyboard.dal.dataobject.tenantbalancetransaction.TenantBalanceTransactionDO;
+import com.yolo.keyboard.dal.dataobject.tenantwithdraworder.KeyboardTenantWithdrawOrderDO;
+import com.yolo.keyboard.dal.mysql.tenantbalancetransaction.TenantBalanceTransactionMapper;
+import com.yolo.keyboard.dal.mysql.tenantwithdraworder.KeyboardTenantWithdrawOrderMapper;
+import com.yolo.keyboard.framework.common.util.collection.CollectionUtils;
+import com.yolo.keyboard.framework.mybatis.core.query.LambdaQueryWrapperX;
+import com.yolo.keyboard.framework.tenant.core.context.TenantContextHolder;
+import com.yolo.keyboard.module.infra.api.config.ConfigApi;
+import com.yolo.keyboard.module.system.api.notify.NotifyMessageSendApi;
+import com.yolo.keyboard.module.system.api.notify.dto.NotifySendSingleToUserReqDTO;
+import com.yolo.keyboard.utils.BizNoGenerator;
+import org.springframework.stereotype.Service;
+import jakarta.annotation.Resource;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.*;
+import com.yolo.keyboard.controller.admin.tenantbalance.vo.*;
+import com.yolo.keyboard.dal.dataobject.tenantbalance.TenantBalanceDO;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import com.yolo.keyboard.framework.common.util.object.BeanUtils;
+
+import com.yolo.keyboard.dal.mysql.tenantbalance.TenantBalanceMapper;
+import com.yolo.keyboard.module.system.dal.dataobject.tenant.TenantDO;
+import com.yolo.keyboard.module.system.dal.mysql.tenant.TenantMapper;
+
+import static com.yolo.keyboard.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static com.yolo.keyboard.framework.common.util.collection.CollectionUtils.convertList;
+import static com.yolo.keyboard.framework.common.util.collection.CollectionUtils.diffList;
+import static com.yolo.keyboard.module.infra.enums.ErrorCodeConstants.*;
+
+/**
+ * 租户余额 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class TenantBalanceServiceImpl implements TenantBalanceService {
+
+    @Resource
+    private TenantBalanceMapper tenantBalanceMapper;
+
+    @Resource
+    private TenantBalanceTransactionMapper tenantBalanceTransactionMapper;
+
+    @Resource
+    private TenantMapper tenantMapper;
+
+    @Resource
+    private ConfigApi configApi;
+
+    @Resource
+    private KeyboardTenantWithdrawOrderMapper tenantWithdrawOrderMapper;
+
+    @Resource
+    private NotifyMessageSendApi notifyMessageSendApi;
+
+    private static final String WITHDRAW_DAYS_CONFIG_KEY = "WITHDRAW-DAYS";
+    private static final String WITHDRAW_NOTIFY_TEMPLATE_CODE = "tx-001";
+
+    @Override
+    public Long createTenantBalance(TenantBalanceSaveReqVO createReqVO) {
+        // 插入
+        TenantBalanceDO tenantBalance = BeanUtils.toBean(createReqVO, TenantBalanceDO.class);
+        tenantBalanceMapper.insert(tenantBalance);
+
+        // 返回
+        return tenantBalance.getId();
+    }
+
+    @Override
+    public void updateTenantBalance(TenantBalanceSaveReqVO updateReqVO) {
+        // 校验存在
+        validateTenantBalanceExists(updateReqVO.getId());
+        // 更新
+        TenantBalanceDO updateObj = BeanUtils.toBean(updateReqVO, TenantBalanceDO.class);
+        tenantBalanceMapper.updateById(updateObj);
+    }
+
+    @Override
+    public void deleteTenantBalance(Long id) {
+        // 校验存在
+        validateTenantBalanceExists(id);
+        // 删除
+        tenantBalanceMapper.deleteById(id);
+    }
+
+    @Override
+        public void deleteTenantBalanceListByIds(List<Long> ids) {
+        // 删除
+        tenantBalanceMapper.deleteByIds(ids);
+        }
+
+
+    private void validateTenantBalanceExists(Long id) {
+        if (tenantBalanceMapper.selectById(id) == null) {
+            throw exception(TENANT_BALANCE_NOT_EXISTS);
+        }
+    }
+
+    @Override
+    public TenantBalanceDO getTenantBalance(Long id) {
+        return tenantBalanceMapper.selectById(id);
+    }
+
+    @Override
+    public PageResult<TenantBalanceDO> getTenantBalancePage(TenantBalancePageReqVO pageReqVO) {
+        return tenantBalanceMapper.selectPage(pageReqVO);
+    }
+
+    @Override
+    @Transactional
+    public void addTenantBalance(TenantBalanceAddReqVO addReqVO) {
+        // 1. 根据ID查询租户余额记录，校验是否存在
+        TenantBalanceDO balance = tenantBalanceMapper.selectById(addReqVO.getId());
+        if (balance == null) {
+            throw exception(TENANT_BALANCE_NOT_EXISTS);
+        }
+
+        // 2. 计算新的余额（当前余额 + 充值金额）
+        BigDecimal newBalance = balance.getBalance().add(new BigDecimal(String.valueOf(addReqVO.getAmount())));
+        // 3. 更新租户余额（使用乐观锁）
+        balance.setBalance(newBalance);
+        int updateCount = tenantBalanceMapper.updateById(balance);
+        if (updateCount == 0) {
+            throw exception(TENANT_BALANCE_NOT_EXISTS);
+        }
+
+        // 4. 创建余额交易记录
+        TenantBalanceTransactionDO transaction = TenantBalanceTransactionDO.builder()
+                .bizNo(BizNoGenerator.generate("RECHARGE")) // 生成充值业务编号
+                .points(new BigDecimal(String.valueOf(addReqVO.getAmount()))) // 充值金额
+                .balance(newBalance) // 充值后余额
+                .frozenAmt(balance.getFrozenAmt() != null ? balance.getFrozenAmt() : BigDecimal.ZERO) // 当前冻结金额
+                .withdrawableBalance(balance.getWithdrawableBalance() != null ? balance.getWithdrawableBalance() : BigDecimal.ZERO) // 当前可提现金额
+                .tenantId(addReqVO.getId())
+                .type("RECHARGE") // 交易类型：充值
+                .description("余额充值") // 交易描述
+                .remark(addReqVO.getRemark()) // 备注信息
+                .operatorId(TenantContextHolder.getTenantId()) // 操作人ID（当前租户ID）
+                .build();
+        // 5. 插入交易记录到数据库
+        tenantBalanceTransactionMapper.insert(transaction);
+    }
+
+    @Override
+    public TenantBalanceDO getSelfBalance() {
+        Long tenantId = TenantContextHolder.getRequiredTenantId();
+        return tenantBalanceMapper.selectById(tenantId);
+    }
+
+    @Override
+    public PageResult<TenantBalanceRespVO> getSelfSubordinateTenantBalancePage(TenantBalancePageReqVO pageReqVO) {
+        // 1. 获取当前租户ID
+        Long currentTenantId = TenantContextHolder.getRequiredTenantId();
+        
+        // 2. 查询当前租户的下级租户列表
+        List<TenantDO> subordinateTenants = tenantMapper.selectList(TenantDO::getParentId, currentTenantId);
+        
+        // 3. 提取下级租户的ID列表
+        List<Long> tenantIds = CollectionUtils.convertList(subordinateTenants, TenantDO::getId);
+        
+        // 4. 如果没有下级租户，则直接返回空的分页结果
+        if (CollUtil.isEmpty(tenantIds)) {
+            return PageResult.empty();
+        }
+        
+        // 5. 根据下级租户ID列表查询对应的余额信息，并进行分页
+        PageResult<TenantBalanceDO> pageResult = tenantBalanceMapper.selectPage(pageReqVO,
+            new LambdaQueryWrapperX<TenantBalanceDO>().in(TenantBalanceDO::getId, tenantIds));
+            
+        // 6. 将查询结果转换为响应VO并返回
+        return BeanUtils.toBean(pageResult, TenantBalanceRespVO.class);
+    }
+
+    @Override
+    public PageResult<TenantBalanceTransactionDO> getTenantBalanceTransactionPage(PageParam pageReqVO, Long tenantId) {
+        return tenantBalanceTransactionMapper.selectPage(pageReqVO, tenantId);
+    }
+
+    @Override
+    public Long createTenantBalanceTransaction(TenantBalanceTransactionDO tenantBalanceTransaction) {
+        tenantBalanceTransactionMapper.insert(tenantBalanceTransaction);
+        return tenantBalanceTransaction.getId();
+    }
+
+    @Override
+    public void updateTenantBalanceTransaction(TenantBalanceTransactionDO tenantBalanceTransaction) {
+        // 校验存在
+        validateTenantBalanceTransactionExists(tenantBalanceTransaction.getId());
+        // 更新
+        tenantBalanceTransactionMapper.updateById(tenantBalanceTransaction);
+    }
+
+    @Override
+    public void deleteTenantBalanceTransaction(Long id) {
+        // 删除
+        tenantBalanceTransactionMapper.deleteById(id);
+    }
+
+    @Override
+    public void deleteTenantBalanceTransactionListByIds(List<Long> ids) {
+        // 删除
+        tenantBalanceTransactionMapper.deleteByIds(ids);
+    }
+
+    @Override
+    public TenantBalanceTransactionDO getTenantBalanceTransaction(Long id) {
+        return tenantBalanceTransactionMapper.selectById(id);
+    }
+
+    private void validateTenantBalanceTransactionExists(Long id) {
+        if (tenantBalanceTransactionMapper.selectById(id) == null) {
+            throw exception(TENANT_BALANCE_TRANSACTION_NOT_EXISTS);
+        }
+    }
+
+    private void deleteTenantBalanceTransactionByTenantId(Long tenantId) {
+        tenantBalanceTransactionMapper.deleteByTenantId(tenantId);
+    }
+
+    private void deleteTenantBalanceTransactionByTenantIds(List<Long> tenantIds) {
+        tenantBalanceTransactionMapper.deleteByTenantIds(tenantIds);
+    }
+
+    @Override
+    @Transactional
+    public void withdraw(TenantBalanceWithdrawReqVO withdrawReqVO) {
+        // 1. 校验是否在提现日期范围内
+        validateWithdrawDate();
+
+        // 2. 获取当前租户的余额记录
+        Long tenantId = TenantContextHolder.getRequiredTenantId();
+        TenantBalanceDO balance = tenantBalanceMapper.selectById(tenantId);
+        if (balance == null) {
+            throw exception(TENANT_BALANCE_NOT_EXISTS);
+        }
+
+        // 3. 校验可提现金额是否充足
+        BigDecimal withdrawAmount = withdrawReqVO.getAmount();
+        BigDecimal withdrawableBalance = balance.getWithdrawableBalance() != null ? balance.getWithdrawableBalance() : BigDecimal.ZERO;
+        if (withdrawableBalance.compareTo(withdrawAmount) < 0) {
+            throw exception(TENANT_BALANCE_WITHDRAW_INSUFFICIENT);
+        }
+
+        // 4. 从可提现金额中扣减并增加冻结金额
+        BigDecimal frozenAmt = balance.getFrozenAmt() != null ? balance.getFrozenAmt() : BigDecimal.ZERO;
+        BigDecimal newWithdrawableBalance = withdrawableBalance.subtract(withdrawAmount);
+        BigDecimal newFrozenAmt = frozenAmt.add(withdrawAmount);
+        balance.setWithdrawableBalance(newWithdrawableBalance);
+        balance.setFrozenAmt(newFrozenAmt);
+        int updateCount = tenantBalanceMapper.updateById(balance);
+        if (updateCount == 0) {
+            throw exception(TENANT_BALANCE_NOT_EXISTS);
+        }
+
+        // 5. 生成提现单号
+        String withdrawNo = BizNoGenerator.generate("WD");
+        String bizNo = BizNoGenerator.generate("BIZ");
+
+        // 6. 创建冻结交易记录
+        TenantBalanceTransactionDO transaction = TenantBalanceTransactionDO.builder()
+                .bizNo(bizNo)
+                .points(withdrawAmount.negate()) // 冻结金额（负数表示冻结扣减）
+                .balance(balance.getBalance()) // 当前总余额
+                .frozenAmt(newFrozenAmt) // 冻结后的冻结金额
+                .withdrawableBalance(newWithdrawableBalance) // 扣减后的可提现余额
+                .tenantId(tenantId)
+                .type("FREEZE")
+                .description("提现冻结")
+                .remark(withdrawReqVO.getRemark())
+                .operatorId(tenantId)
+                .build();
+        tenantBalanceTransactionMapper.insert(transaction);
+
+        // 7. 创建提现申请订单
+        LocalDateTime now = LocalDateTime.now();
+        KeyboardTenantWithdrawOrderDO withdrawOrder = KeyboardTenantWithdrawOrderDO.builder()
+                .withdrawNo(withdrawNo)
+                .bizNo(bizNo)
+                .tenantId(tenantId)
+                .currency("CNY")
+                .amount(withdrawAmount) // 直接存储 BigDecimal
+                .feeAmount(BigDecimal.ZERO) // 手续费暂时为0
+                .actualAmount(withdrawAmount) // 实际到账金额
+                // 收款信息
+                .payChannel(withdrawReqVO.getPayChannel())
+                .payeeType(withdrawReqVO.getPayeeType())
+                .payeeName(withdrawReqVO.getPayeeName())
+                .payeeAccount(withdrawReqVO.getPayeeAccount())
+                .payeeBankName(withdrawReqVO.getPayeeBankName())
+                .payeeBankCode(withdrawReqVO.getPayeeBankCode())
+                .payeeBankBranch(withdrawReqVO.getPayeeBankBranch())
+                // 状态
+                .status("APPLIED") // 申请中
+                .auditStatus("PENDING") // 待审核
+                .applyTime(now)
+                .balanceTxnId(transaction.getId()) // 关联冻结交易记录
+                .creatorId(tenantId)
+                .createdAt(now)
+                .updatedAt(now)
+                .build();
+        tenantWithdrawOrderMapper.insert(withdrawOrder);
+
+        // 8. 发送站内信通知
+        sendWithdrawNotify(tenantId, withdrawAmount);
+    }
+
+    /**
+     * 发送提现站内信通知
+     *
+     * @param tenantId       租户ID
+     * @param withdrawAmount 提现金额
+     */
+    private void sendWithdrawNotify(Long tenantId, BigDecimal withdrawAmount) {
+        // 获取租户信息，找到联系人用户ID
+        TenantDO tenant = tenantMapper.selectById(tenantId);
+        if (tenant == null || tenant.getContactUserId() == null) {
+            return;
+        }
+
+        // 构建站内信请求
+        NotifySendSingleToUserReqDTO reqDTO = new NotifySendSingleToUserReqDTO();
+        reqDTO.setUserId(tenant.getContactUserId());
+        reqDTO.setTemplateCode(WITHDRAW_NOTIFY_TEMPLATE_CODE);
+        reqDTO.setTemplateParams(Map.of("amount", withdrawAmount.toPlainString()));
+
+        // 发送站内信
+        notifyMessageSendApi.sendSingleMessageToAdmin(reqDTO);
+    }
+
+    /**
+     * 校验是否在提现日期范围内
+     * 配置格式：{"start": 25, "days": 6}
+     * 表示每月从第 start 天开始，连续 days 天可以提现（不允许跨月）
+     */
+    private void validateWithdrawDate() {
+        // 获取提现日期配置
+        String configValue = configApi.getConfigValueByKey(WITHDRAW_DAYS_CONFIG_KEY);
+        if (configValue == null || configValue.isEmpty()) {
+            throw exception(TENANT_BALANCE_WITHDRAW_CONFIG_NOT_EXISTS);
+        }
+
+        // 解析配置
+        cn.hutool.json.JSONObject config = JSONUtil.parseObj(configValue);
+        int startDay = config.getInt("start");
+        int days = config.getInt("days");
+
+        // 获取当前日期
+        LocalDate today = LocalDate.now();
+        int currentDay = today.getDayOfMonth();
+        int lastDayOfMonth = today.lengthOfMonth();
+
+        // 计算提现日期范围（不允许跨月，endDay 最大为当月最后一天）
+        int endDay = Math.min(startDay + days - 1, lastDayOfMonth);
+
+        // 判断当前日期是否在 [startDay, endDay] 范围内
+        boolean isInRange = currentDay >= startDay && currentDay <= endDay;
+
+        if (!isInRange) {
+            throw exception(TENANT_BALANCE_WITHDRAW_NOT_IN_DATE);
+        }
+    }
+
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/service/tenantcommission/KeyboardTenantCommissionService.java

@@ -0,0 +1,69 @@
+package com.yolo.keyboard.service.tenantcommission;
+
+import java.util.*;
+import jakarta.validation.*;
+import com.yolo.keyboard.controller.admin.tenantcommission.vo.*;
+import com.yolo.keyboard.dal.dataobject.tenantcommission.KeyboardTenantCommissionDO;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+
+/**
+ * 租户内购分成记录 Service 接口
+ *
+ * @author ziin
+ */
+public interface KeyboardTenantCommissionService {
+
+    /**
+     * 创建租户内购分成记录
+     *
+     * @param createReqVO 创建信息
+     * @return 编号
+     */
+    Long createTenantCommission(@Valid KeyboardTenantCommissionSaveReqVO createReqVO);
+
+    /**
+     * 更新租户内购分成记录
+     *
+     * @param updateReqVO 更新信息
+     */
+    void updateTenantCommission(@Valid KeyboardTenantCommissionSaveReqVO updateReqVO);
+
+    /**
+     * 删除租户内购分成记录
+     *
+     * @param id 编号
+     */
+    void deleteTenantCommission(Long id);
+
+    /**
+    * 批量删除租户内购分成记录
+    *
+    * @param ids 编号
+    */
+    void deleteTenantCommissionListByIds(List<Long> ids);
+
+    /**
+     * 获得租户内购分成记录
+     *
+     * @param id 编号
+     * @return 租户内购分成记录
+     */
+    KeyboardTenantCommissionDO getTenantCommission(Long id);
+
+    /**
+     * 获得租户内购分成记录分页
+     *
+     * @param pageReqVO 分页查询
+     * @return 租户内购分成记录分页
+     */
+    PageResult<KeyboardTenantCommissionDO> getTenantCommissionPage(KeyboardTenantCommissionPageReqVO pageReqVO);
+
+    /**
+     * 获得当前登录租户的分成记录分页
+     *
+     * @param pageReqVO 分页查询
+     * @return 租户内购分成记录分页
+     */
+
+}

keyboard-server/src/main/java/com/yolo/keyboard/service/tenantcommission/KeyboardTenantCommissionServiceImpl.java

@@ -0,0 +1,99 @@
+package com.yolo.keyboard.service.tenantcommission;
+
+import cn.hutool.core.collection.CollUtil;
+import org.springframework.stereotype.Service;
+import jakarta.annotation.Resource;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.*;
+import com.yolo.keyboard.controller.admin.tenantcommission.vo.*;
+import com.yolo.keyboard.dal.dataobject.tenantcommission.KeyboardTenantCommissionDO;
+import com.yolo.keyboard.framework.common.pojo.PageResult;
+import com.yolo.keyboard.framework.common.pojo.PageParam;
+import com.yolo.keyboard.framework.common.util.object.BeanUtils;
+
+import com.yolo.keyboard.dal.mysql.tenantcommission.KeyboardTenantCommissionMapper;
+import com.yolo.keyboard.framework.tenant.core.context.TenantContextHolder;
+import com.yolo.keyboard.module.system.dal.dataobject.tenant.TenantDO;
+import com.yolo.keyboard.module.system.dal.mysql.tenant.TenantMapper;
+
+import static com.yolo.keyboard.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static com.yolo.keyboard.framework.common.util.collection.CollectionUtils.convertList;
+import static com.yolo.keyboard.framework.common.util.collection.CollectionUtils.diffList;import static com.yolo.keyboard.module.infra.enums.ErrorCodeConstants.TENANT_COMMISSION_NOT_EXISTS;
+
+/**
+ * 租户内购分成记录 Service 实现类
+ *
+ * @author ziin
+ */
+@Service
+@Validated
+public class KeyboardTenantCommissionServiceImpl implements KeyboardTenantCommissionService {
+
+    @Resource
+    private KeyboardTenantCommissionMapper tenantCommissionMapper;
+
+    @Resource
+    private TenantMapper tenantMapper;
+
+    @Override
+    public Long createTenantCommission(KeyboardTenantCommissionSaveReqVO createReqVO) {
+        // 插入
+        KeyboardTenantCommissionDO tenantCommission = BeanUtils.toBean(createReqVO, KeyboardTenantCommissionDO.class);
+        tenantCommissionMapper.insert(tenantCommission);
+
+        // 返回
+        return tenantCommission.getId();
+    }
+
+    @Override
+    public void updateTenantCommission(KeyboardTenantCommissionSaveReqVO updateReqVO) {
+        // 校验存在
+        validateTenantCommissionExists(updateReqVO.getId());
+        // 更新
+        KeyboardTenantCommissionDO updateObj = BeanUtils.toBean(updateReqVO, KeyboardTenantCommissionDO.class);
+        tenantCommissionMapper.updateById(updateObj);
+    }
+
+    @Override
+    public void deleteTenantCommission(Long id) {
+        // 校验存在
+        validateTenantCommissionExists(id);
+        // 删除
+        tenantCommissionMapper.deleteById(id);
+    }
+
+    @Override
+        public void deleteTenantCommissionListByIds(List<Long> ids) {
+        // 删除
+        tenantCommissionMapper.deleteByIds(ids);
+        }
+
+
+    private void validateTenantCommissionExists(Long id) {
+        if (tenantCommissionMapper.selectById(id) == null) {
+            throw exception(TENANT_COMMISSION_NOT_EXISTS);
+        }
+    }
+
+    @Override
+    public KeyboardTenantCommissionDO getTenantCommission(Long id) {
+        return tenantCommissionMapper.selectById(id);
+    }
+
+    @Override
+    public PageResult<KeyboardTenantCommissionDO> getTenantCommissionPage(KeyboardTenantCommissionPageReqVO pageReqVO) {
+        // 如果当前租户的 tenantLevel 不等于 0，只能查询属于自己的数据
+        Long currentTenantId = TenantContextHolder.getTenantId();
+        if (currentTenantId != null) {
+            TenantDO currentTenant = tenantMapper.selectById(currentTenantId);
+            if (currentTenant != null && currentTenant.getTenantLevel() != null
+                    && currentTenant.getTenantLevel() != 0) {
+                pageReqVO.setTenantId(currentTenantId);
+            }
+        }
+        return tenantCommissionMapper.selectPage(pageReqVO);
+    }
+
+}