feat(userthemes): 新增用户主题管理功能

新增用户主题完整CRUD模块，含控制器、DO、Mapper、Service及VO定义，并补充错误码。

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
 

yolo-module-system/src/main/java/com/yolo/keyboard/module/system/controller/admin/tenant/vo/tenant/TenantPageReqVO.java

@@ -7,6 +7,7 @@ import lombok.EqualsAndHashCode;
 import lombok.ToString;
 import org.springframework.format.annotation.DateTimeFormat;
 
+import java.math.BigDecimal;
 import java.time.LocalDateTime;
 
 import static com.yolo.keyboard.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
@@ -33,4 +34,35 @@ public class TenantPageReqVO extends PageParam {
     @Schema(description = "创建时间")
     private LocalDateTime[] createTime;
 
+
+    /**
+     * 上级租户 Id
+     */
+    @Schema(description = "上级租户编号")
+    private Long parentId;
+
+    /**
+     * 备注
+     */
+    @Schema(description = "备注")
+    private String remark;
+
+
+    /**
+     * 租户类型
+     */
+    @Schema(description = "租户类型")
+    private String tenantType;
+
+    /**
+     * 代理级别
+     */
+    @Schema(description = "代理级别")
+    private Integer tenantLevel;
+
+    /**
+     * 分润比例
+     */
+    @Schema(description = "分润比例")
+    private BigDecimal profitShareRatio;
 }

yolo-module-system/src/main/java/com/yolo/keyboard/module/system/controller/admin/tenant/vo/tenant/TenantRespVO.java

@@ -8,6 +8,7 @@ import com.yolo.keyboard.module.system.enums.DictTypeConstants;
 import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;
 
+import java.math.BigDecimal;
 import java.time.LocalDateTime;
 import java.util.List;
 
@@ -53,4 +54,32 @@ public class TenantRespVO {
     @ExcelProperty("创建时间")
     private LocalDateTime createTime;
 
+
+    /**
+     * 上级租户 Id
+     */
+    @Schema(description = "上级租户编号")
+    private Long parentId;
+
+    /**
+     * 备注
+     */
+    @Schema(description = "备注")
+    private String remark;
+
+
+    /**
+     * 租户类型
+     */
+    @Schema(description = "租户类型")
+    private String tenantType;
+
+    /**
+     * 代理级别
+     */
+    @Schema(description = "代理级别")
+    private Integer tenantLevel;
+
+    @Schema(description = "分润比例")
+    private BigDecimal profitShareRatio;
 }

yolo-module-system/src/main/java/com/yolo/keyboard/module/system/controller/admin/tenant/vo/tenant/TenantSaveReqVO.java

@@ -10,6 +10,7 @@ import jakarta.validation.constraints.Size;
 import lombok.Data;
 import org.hibernate.validator.constraints.Length;
 
+import java.math.BigDecimal;
 import java.time.LocalDateTime;
 import java.util.List;
 
@@ -68,4 +69,32 @@ public class TenantSaveReqVO {
                 || (ObjectUtil.isAllNotEmpty(username, password)); // 新增时，必须都传递 username、password
     }
 
+
+    /**
+     * 上级租户 Id
+     */
+    @Schema(description = "上级租户编号")
+    private Long parentId;
+
+    /**
+     * 备注
+     */
+    @Schema(description = "备注")
+    private String remark;
+
+
+    /**
+     * 租户类型
+     */
+    @Schema(description = "租户类型")
+    private String tenantType;
+
+    /**
+     * 代理级别
+     */
+    @Schema(description = "代理级别")
+    private Integer tenantLevel;
+
+    @Schema(description = "分润比例")
+    private BigDecimal profitShareRatio;
 }

yolo-module-system/src/main/java/com/yolo/keyboard/module/system/dal/dataobject/tenant/TenantDO.java

@@ -8,8 +8,10 @@ import com.yolo.keyboard.module.system.dal.dataobject.user.AdminUserDO;
 import com.baomidou.mybatisplus.annotation.KeySequence;
 import com.baomidou.mybatisplus.annotation.TableField;
 import com.baomidou.mybatisplus.annotation.TableName;
+import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.*;
 
+import java.math.BigDecimal;
 import java.time.LocalDateTime;
 import java.util.List;
 
@@ -86,4 +88,27 @@ public class TenantDO extends BaseDO {
      */
     private Integer accountCount;
 
+    /**
+     * 上级租户 Id
+     */
+    private Long parentId;
+
+    /**
+     * 备注
+     */
+
+    private String remark;
+
+
+    /**
+     * 租户类型
+     */
+    private String tenantType;
+
+    /**
+     * 代理级别
+     */
+    private Integer tenantLevel;
+
+    private BigDecimal profitShareRatio;
 }