refactor all

src/main/java/com/imyeyu/api/annotation/CaptchaValid.java

@@ -1,22 +0,0 @@
-package com.imyeyu.api.annotation;
-
-import com.imyeyu.api.bean.CaptchaFrom;
-
-import java.lang.annotation.ElementType;
-import java.lang.annotation.Retention;
-import java.lang.annotation.RetentionPolicy;
-import java.lang.annotation.Target;
-
-/**
- * 图形验证码校验注解
- *
- * @author 夜雨
- * @since 2023-07-15 10:09
- */
-@Target(ElementType.METHOD)
-@Retention(RetentionPolicy.RUNTIME)
-public @interface CaptchaValid {
-
-	/** @return 验证码来源 */
-	CaptchaFrom value();
-}

src/main/java/com/imyeyu/api/annotation/CaptchaValidInterceptor.java

@@ -1,20 +1,13 @@
 package com.imyeyu.api.annotation;
 
-import lombok.extern.slf4j.Slf4j;
-import com.imyeyu.api.bean.CaptchaFrom;
 import com.imyeyu.api.util.CaptchaManager;
-import com.imyeyu.spring.bean.CaptchaData;
-import org.aspectj.lang.JoinPoint;
+import com.imyeyu.spring.annotation.CaptchaValidAbstractInterceptor;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
 import org.aspectj.lang.annotation.Aspect;
-import org.aspectj.lang.annotation.Before;
-import org.aspectj.lang.annotation.Pointcut;
-import org.aspectj.lang.reflect.MethodSignature;
-import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.stereotype.Component;
 
-import java.lang.reflect.Method;
-
 /**
  * 图形验证码校验注解处理器
  *
@@ -24,47 +17,19 @@ import java.lang.reflect.Method;
 @Slf4j
 @Aspect
 @Component
-public class CaptchaValidInterceptor {
+@RequiredArgsConstructor
+public class CaptchaValidInterceptor extends CaptchaValidAbstractInterceptor {
 
 	@Value("${spring.profiles.active}")
 	private String env;
 
-	@Autowired
-	private CaptchaManager captchaManager;
+	private final CaptchaManager captchaManager;
 
-	/** 注入注解 */
-	@Pointcut("@annotation(com.imyeyu.api.annotation.CaptchaValid)")
-	public void captchaPointCut() {
-	}
-
-	/**
-	 * 执行前
-	 *
-	 * @param joinPoint 切入点
-	 */
-	@Before("captchaPointCut()")
-	public void doBefore(JoinPoint joinPoint) {
-		try {
-			if (env.startsWith("dev")) {
-				// 开发环境不校验
-				return;
-			}
-			if (joinPoint.getSignature() instanceof MethodSignature ms) {
-				Method method = joinPoint.getTarget().getClass().getMethod(ms.getName(), ms.getParameterTypes());
-				CaptchaValid annotation = method.getAnnotation(CaptchaValid.class);
-				CaptchaFrom from = annotation.value();
-
-				Object[] args = joinPoint.getArgs();
-				for (int i = 0; i < args.length; i++) {
-					if (args[i] instanceof CaptchaData<?> captchaData) {
-						// 校验请求参数的验证码
-						captchaManager.test(captchaData.getCaptcha(), from.toString());
-						break;
-					}
-				}
-			}
-		} catch (NoSuchMethodException e) {
-			throw new RuntimeException("TODO CaptchaValidInterceptor error");
+	@Override
+	protected void verify(String captchaId, String captcha) {
+		if (!env.equals("prod")) {
+			return;
 		}
+		captchaManager.verify(captchaId, captcha);
 	}
 }

src/main/java/com/imyeyu/api/annotation/EnableSetting.java

@@ -1,7 +1,5 @@
 package com.imyeyu.api.annotation;
 
-import com.imyeyu.api.modules.common.bean.SettingKey;
-
 import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
@@ -17,8 +15,20 @@ import java.lang.annotation.Target;
 @Retention(RetentionPolicy.RUNTIME)
 public @interface EnableSetting {
 
-	/** @return 配置键 */
-	SettingKey value();
+	/**
+	 *
+	 *
+	 * @author 夜雨
+	 * @since 2026-04-27 14:45
+	 */
+	enum Logic {
+
+		AND,
+
+		OR
+	}
+
+	Logic logic() default Logic.AND;
 
 	/** @return 未启用配置时响应消息语言映射键 */
 	String message() default "service.offline";

src/main/java/com/imyeyu/api/annotation/EnableSettingInterceptor.java

@@ -1,17 +1,20 @@
 package com.imyeyu.api.annotation;
 
+import com.imyeyu.api.modules.common.service.SettingService;
 import jakarta.servlet.http.HttpServletRequest;
 import jakarta.servlet.http.HttpServletResponse;
 import lombok.RequiredArgsConstructor;
-import com.imyeyu.java.bean.timi.TimiCode;
-import com.imyeyu.java.bean.timi.TimiException;
-import com.imyeyu.api.modules.common.service.SettingService;
 import org.springframework.context.annotation.Lazy;
 import org.springframework.lang.NonNull;
 import org.springframework.stereotype.Component;
 import org.springframework.web.method.HandlerMethod;
 import org.springframework.web.servlet.HandlerInterceptor;
 
+import java.lang.reflect.InvocationTargetException;
+import java.lang.reflect.Method;
+import java.util.ArrayList;
+import java.util.List;
+
 /**
  * 启用配置注解处理器
  *
@@ -24,16 +27,28 @@ public class EnableSettingInterceptor implements HandlerInterceptor {
 
 	private final SettingService service;
 
-	public boolean preHandle(@NonNull HttpServletRequest req, @NonNull HttpServletResponse resp, @NonNull Object handler) {
+	public boolean preHandle(@NonNull HttpServletRequest req, @NonNull HttpServletResponse resp, @NonNull Object handler) throws InvocationTargetException, IllegalAccessException {
 		if (handler instanceof HandlerMethod handlerMethod) {
 			EnableSetting annotation = handlerMethod.getMethodAnnotation(EnableSetting.class);
 			if (annotation == null) {
 				return true;
 			}
-			if (service.is(annotation.value())) {
-				return true;
+			EnableSetting.Logic logic = annotation.logic();
+			List<Boolean> valueList = new ArrayList<>();
+			for (Method method : annotation.getClass().getMethods()) {
+				if (method.getName().equals("message")) {
+					continue;
+				}
+				Enum<?>[] enums = (Enum<?>[]) method.invoke(annotation);
+				for (Enum<?> anEnum : enums) {
+					valueList.add(service.getSystem(anEnum).isTrue());
+				}
+			}
+			if (logic == EnableSetting.Logic.AND) {
+				return valueList.stream().allMatch(Boolean::booleanValue);
+			} else {
+				return valueList.stream().anyMatch(Boolean::booleanValue);
 			}
-			throw new TimiException(TimiCode.ERROR_SERVICE_OFF, annotation.message());
 		}
 		return true;
 	}

src/main/java/com/imyeyu/api/annotation/MultilingualField.java

@@ -0,0 +1,31 @@
+package com.imyeyu.api.annotation;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * 标记需要在响应阶段自动回填的多语言字段
+ *
+ * @author 夜雨
+ * @since 2026-07-17 00:00
+ */
+@Target({ElementType.FIELD})
+@Retention(RetentionPolicy.RUNTIME)
+public @interface MultilingualField {
+
+	/**
+	 * 多语言 ID 来源字段名
+	 *
+	 * @return 来源字段名
+	 */
+	String value();
+
+	/**
+	 * 模板参数来源字段名
+	 *
+	 * @return 同类中的 Map 字段名
+	 */
+	String argMap() default "";
+}

src/main/java/com/imyeyu/api/annotation/RequestRateLimitInterceptor.java

@@ -23,19 +23,21 @@ import org.springframework.stereotype.Component;
 @Component
 public class RequestRateLimitInterceptor extends RequestRateLimitAbstractInterceptor {
 
+	private static final String KEY_PREFIX = "REQUEST:RATE_LIMIT:";
+
 	@Autowired
 	@Qualifier("redisRateLimit")
-	private Redis<String, Integer> redisRequestRateLimit;
+	private Redis<String, Integer> redis;
 
 	@Override
 	public boolean beforeRun(HttpServletRequest req, HttpServletResponse resp, String id, int cycle, int limit) {
 		// 键
-		String key = "TimiServerAPI." + TimiSpring.getRequestIP() + "." + id;
-		if (redisRequestRateLimit.has(key)) {
-			Integer count = redisRequestRateLimit.get(key);
+		String key = getKey(id);
+		if (redis.has(key)) {
+			Integer count = redis.get(key);
 			if (count != null) {
 				if (count < limit) {
-					redisRequestRateLimit.setAndKeepTTL(key, ++count);
+					redis.setAndKeepTTL(key, ++count);
 				} else {
 					log.warn("请求频率过高：[" + key + "].C" + count + "L" + limit);
 					throw new TimiException(TimiCode.REQUEST_BAD).msgKey("request_rate_limit");
@@ -43,7 +45,11 @@ public class RequestRateLimitInterceptor extends RequestRateLimitAbstractInterce
 			}
 			return true;
 		}
-		redisRequestRateLimit.set(key, 0, Time.S * cycle);
+		redis.set(key, 0, Time.S * cycle);
 		return true;
 	}
+
+	private String getKey(String id) {
+		return "%sTIMISERVERAPI:%s:%s".formatted(KEY_PREFIX, TimiSpring.getRequestIP(), id);
+	}
 }

src/main/java/com/imyeyu/api/annotation/RequireCorePermission.java

@@ -0,0 +1,29 @@
+package com.imyeyu.api.annotation;
+
+import com.imyeyu.api.bean.PermissionMatchMode;
+import com.imyeyu.api.bean.CorePermissionCode;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+///
+/// 要求 CORE 模块权限
+///
+/// @author Codex
+/// @since 2026-07-26
+@Target({ElementType.METHOD, ElementType.TYPE})
+@Retention(RetentionPolicy.RUNTIME)
+public @interface RequireCorePermission {
+
+	/// 所需权限
+	///
+	/// @return 权限列表
+	CorePermissionCode[] value();
+
+	/// 匹配模式
+	///
+	/// @return 匹配模式
+	PermissionMatchMode mode() default PermissionMatchMode.ALL;
+}

src/main/java/com/imyeyu/api/annotation/RequireCorePermissionInterceptor.java

@@ -0,0 +1,46 @@
+package com.imyeyu.api.annotation;
+
+import com.imyeyu.api.bean.PermissionMatchMode;
+import com.imyeyu.api.bean.CorePermissionCode;
+import com.imyeyu.api.bean.ModuleCode;
+import com.imyeyu.api.modules.user.service.PermissionChecker;
+import com.imyeyu.java.TimiJava;
+import jakarta.servlet.http.HttpServletRequest;
+import jakarta.servlet.http.HttpServletResponse;
+import org.springframework.lang.NonNull;
+import org.springframework.stereotype.Component;
+import org.springframework.web.method.HandlerMethod;
+import org.springframework.web.servlet.HandlerInterceptor;
+
+///
+/// CORE 权限注解处理器
+///
+/// @author Codex
+/// @since 2026-07-27
+@Component
+public class RequireCorePermissionInterceptor implements HandlerInterceptor {
+
+	private final PermissionChecker permissionChecker;
+
+	public RequireCorePermissionInterceptor(PermissionChecker permissionChecker) {
+		this.permissionChecker = permissionChecker;
+	}
+
+	@Override
+	public boolean preHandle(@NonNull HttpServletRequest req, @NonNull HttpServletResponse resp, @NonNull Object handler) {
+		if (!(handler instanceof HandlerMethod handlerMethod)) {
+			return true;
+		}
+		RequireCorePermission annotation = handlerMethod.getMethodAnnotation(RequireCorePermission.class);
+		if (annotation == null || TimiJava.isEmpty(annotation.value())) {
+			return true;
+		}
+		String[] permissionCodeList = java.util.Arrays.stream(annotation.value()).map(CorePermissionCode::getValue).toArray(String[]::new);
+		if (annotation.mode() == PermissionMatchMode.ANY) {
+			permissionChecker.checkAny(ModuleCode.CORE, permissionCodeList);
+		} else {
+			permissionChecker.checkAll(ModuleCode.CORE, permissionCodeList);
+		}
+		return true;
+	}
+}

src/main/java/com/imyeyu/api/annotation/RequireCoreRole.java

@@ -0,0 +1,29 @@
+package com.imyeyu.api.annotation;
+
+import com.imyeyu.api.bean.RoleMatchMode;
+import com.imyeyu.api.bean.CoreRoleCode;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+///
+/// 要求 CORE 模块角色
+///
+/// @author Codex
+/// @since 2026-07-26
+@Target({ElementType.METHOD, ElementType.TYPE})
+@Retention(RetentionPolicy.RUNTIME)
+public @interface RequireCoreRole {
+
+	/// 所需角色
+	///
+	/// @return 角色列表
+	CoreRoleCode[] value();
+
+	/// 匹配模式
+	///
+	/// @return 匹配模式
+	RoleMatchMode mode() default RoleMatchMode.ALL;
+}

src/main/java/com/imyeyu/api/annotation/RequireCoreRoleInterceptor.java

@@ -0,0 +1,46 @@
+package com.imyeyu.api.annotation;
+
+import com.imyeyu.api.bean.ModuleCode;
+import com.imyeyu.api.bean.RoleMatchMode;
+import com.imyeyu.api.bean.CoreRoleCode;
+import com.imyeyu.api.modules.user.service.RoleChecker;
+import com.imyeyu.java.TimiJava;
+import jakarta.servlet.http.HttpServletRequest;
+import jakarta.servlet.http.HttpServletResponse;
+import org.springframework.lang.NonNull;
+import org.springframework.stereotype.Component;
+import org.springframework.web.method.HandlerMethod;
+import org.springframework.web.servlet.HandlerInterceptor;
+
+///
+/// CORE 角色注解处理器
+///
+/// @author Codex
+/// @since 2026-07-27
+@Component
+public class RequireCoreRoleInterceptor implements HandlerInterceptor {
+
+	private final RoleChecker roleChecker;
+
+	public RequireCoreRoleInterceptor(RoleChecker roleChecker) {
+		this.roleChecker = roleChecker;
+	}
+
+	@Override
+	public boolean preHandle(@NonNull HttpServletRequest req, @NonNull HttpServletResponse resp, @NonNull Object handler) {
+		if (!(handler instanceof HandlerMethod handlerMethod)) {
+			return true;
+		}
+		RequireCoreRole annotation = handlerMethod.getMethodAnnotation(RequireCoreRole.class);
+		if (annotation == null || TimiJava.isEmpty(annotation.value())) {
+			return true;
+		}
+		String[] roleCodeList = java.util.Arrays.stream(annotation.value()).map(CoreRoleCode::name).toArray(String[]::new);
+		if (annotation.mode() == RoleMatchMode.ANY) {
+			roleChecker.checkAny(ModuleCode.CORE, roleCodeList);
+		} else {
+			roleChecker.checkAll(ModuleCode.CORE, roleCodeList);
+		}
+		return true;
+	}
+}

src/main/java/com/imyeyu/api/annotation/RequiredTokenInterceptor.java

@@ -1,39 +0,0 @@
-package com.imyeyu.api.annotation;
-
-import jakarta.servlet.http.HttpServletRequest;
-import jakarta.servlet.http.HttpServletResponse;
-import lombok.extern.slf4j.Slf4j;
-import com.imyeyu.java.bean.timi.TimiCode;
-import com.imyeyu.java.bean.timi.TimiException;
-import com.imyeyu.api.modules.blog.util.UserToken;
-import com.imyeyu.spring.TimiSpring;
-import com.imyeyu.spring.annotation.RequiredToken;
-import com.imyeyu.spring.annotation.RequiredTokenAbstractInterceptor;
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.stereotype.Component;
-
-/**
- * 令牌验证注解处理器
- *
- * @author 夜雨
- * @since 2021-08-16 18:07
- */
-@Slf4j
-@Component
-public class RequiredTokenInterceptor extends RequiredTokenAbstractInterceptor<RequiredToken> {
-
-	@Autowired
-	private UserToken userToken;
-
-	public RequiredTokenInterceptor() {
-		super(RequiredToken.class);
-	}
-
-	@Override
-	protected boolean beforeRun(HttpServletRequest req, HttpServletResponse resp) {
-		if (userToken.isInvalid(TimiSpring.getToken())) {
-			throw new TimiException(TimiCode.ARG_MISS).msgKey("token.illegal");
-		}
-		return true;
-	}
-}

src/main/java/com/imyeyu/api/bean/CaptchaFrom.java

@@ -1,34 +0,0 @@
-package com.imyeyu.api.bean;
-
-/**
- * 验证码来源
- *
- * @author 夜雨
- * @since 2023-07-16 10:12
- */
-public enum CaptchaFrom {
-
-	/** 注册 */
-	REGISTER,
-
-	/** 登录 */
-	LOGIN,
-
-	/** 忘记密码 */
-	RESET_PASSWORD,
-
-	/** 评论 */
-	COMMENT,
-
-	/** 评论回复 */
-	COMMENT_REPLY,
-
-	/** Git 反馈 */
-	GIT_ISSUE,
-
-	/** Git 合并请求 */
-	GIT_MERGE,
-
-	/** 歌词修正申请 */
-	LYRIC_CORRECT
-}

src/main/java/com/imyeyu/api/bean/CorePermissionCode.java

@@ -0,0 +1,80 @@
+package com.imyeyu.api.bean;
+
+import com.imyeyu.api.modules.user.bean.BuiltinPermissionCode;
+import lombok.AllArgsConstructor;
+
+///
+/// CORE 模块权限枚举
+///
+/// @author Codex
+/// @since 2026-07-26
+@AllArgsConstructor
+public enum CorePermissionCode implements BuiltinPermissionCode {
+
+	PERMISSION_CREATE("PERMISSION:CREATE", "权限创建", false, true),
+	PERMISSION_READ("PERMISSION:READ", "权限读取", false, true),
+	PERMISSION_UPDATE("PERMISSION:UPDATE", "权限修改", false, true),
+	PERMISSION_DELETE("PERMISSION:DELETE", "权限删除", false, true),
+
+	ROLE_CREATE("ROLE:CREATE", "角色创建", false, true),
+	ROLE_READ("ROLE:READ", "角色读取", false, true),
+	ROLE_UPDATE("ROLE:UPDATE", "角色修改", false, true),
+	ROLE_DELETE("ROLE:DELETE", "角色删除", false, true),
+
+	ROLE_PERMISSION_CREATE("ROLE_PERMISSION:CREATE", "角色权限创建", false, true),
+	ROLE_PERMISSION_READ("ROLE_PERMISSION:READ", "角色权限读取", false, true),
+	ROLE_PERMISSION_DELETE("ROLE_PERMISSION:DELETE", "角色权限删除", false, true),
+
+	ROLE_RELATION_CREATE("ROLE_RELATION:CREATE", "角色关联创建", false, true),
+	ROLE_RELATION_READ("ROLE_RELATION:READ", "角色关联读取", false, true),
+	ROLE_RELATION_DELETE("ROLE_RELATION:DELETE", "角色关联删除", false, true),
+
+	SETTING_CREATE("SETTING:CREATE", "设置创建", false, true),
+	SETTING_READ("SETTING:READ", "设置读取", false, true),
+	SETTING_UPDATE("SETTING:UPDATE", "设置修改", false, true),
+	SETTING_DELETE("SETTING:DELETE", "设置删除", false, true),
+
+	MULTILINGUAL_CREATE("MULTILINGUAL:CREATE", "多语言创建", false, true),
+	MULTILINGUAL_READ("MULTILINGUAL:READ", "多语言读取", false, true),
+	MULTILINGUAL_UPDATE("MULTILINGUAL:UPDATE", "多语言修改", false, true),
+	MULTILINGUAL_DELETE("MULTILINGUAL:DELETE", "多语言删除", false, true),
+
+	USER_CREATE("USER:CREATE", "用户创建", false, true),
+	USER_READ("USER:READ", "用户读取", false, true),
+	USER_UPDATE("USER:UPDATE", "用户修改", false, true),
+	USER_DELETE("USER:DELETE", "用户删除", false, true),
+
+	USER_ROLE_CREATE("USER_ROLE:CREATE", "用户角色创建", true, true),
+	USER_ROLE_READ("USER_ROLE:READ", "用户角色读取", true, true),
+	USER_ROLE_DELETE("USER_ROLE:DELETE", "用户角色删除", true, true);
+
+	final String value;
+	final String defaultName;
+	final boolean grantToSystem;
+	final boolean grantToAdmin;
+
+	@Override
+	public ModuleCode getModuleCode() {
+		return ModuleCode.CORE;
+	}
+
+	@Override
+	public String getValue() {
+		return value;
+	}
+
+	@Override
+	public String getDefaultName() {
+		return defaultName;
+	}
+
+	@Override
+	public boolean isGrantToSystem() {
+		return grantToSystem;
+	}
+
+	@Override
+	public boolean isGrantToAdmin() {
+		return grantToAdmin;
+	}
+}

src/main/java/com/imyeyu/api/bean/CoreRoleCode.java

@@ -0,0 +1,41 @@
+package com.imyeyu.api.bean;
+
+import com.imyeyu.api.modules.user.bean.BuiltinRoleCode;
+import lombok.AllArgsConstructor;
+
+///
+/// CORE 模块角色枚举
+///
+/// @author Codex
+/// @since 2026-07-26
+@AllArgsConstructor
+public enum CoreRoleCode implements BuiltinRoleCode {
+
+	SYSTEM("系统", true, null),
+
+	ADMIN("管理员", false, SYSTEM.name());
+
+	final String defaultName;
+	final boolean protectedRole;
+	final String parentCode;
+
+	@Override
+	public ModuleCode getModuleCode() {
+		return ModuleCode.CORE;
+	}
+
+	@Override
+	public String getDefaultName() {
+		return defaultName;
+	}
+
+	@Override
+	public boolean isProtected() {
+		return protectedRole;
+	}
+
+	@Override
+	public String getParentCode() {
+		return parentCode;
+	}
+}

src/main/java/com/imyeyu/api/bean/ModuleCode.java

@@ -0,0 +1,13 @@
+package com.imyeyu.api.bean;
+
+///
+/// 模块代码
+///
+/// @author Codex
+/// @since 2026-07-26
+public enum ModuleCode {
+
+	CORE,
+
+	GAO,
+}

src/main/java/com/imyeyu/api/bean/MultilingualHandler.java

@@ -1,26 +0,0 @@
-package com.imyeyu.api.bean;
-
-import java.lang.annotation.ElementType;
-import java.lang.annotation.Retention;
-import java.lang.annotation.RetentionPolicy;
-import java.lang.annotation.Target;
-
-/**
- * @author 夜雨
- * @since 2023-10-25 10:10
- */
-public interface MultilingualHandler {
-
-	/**
-	 *
-	 *
-	 * @author 夜雨
-	 * @since 2023-10-25 10:25
-	 */
-	@Target({ElementType.FIELD})
-	@Retention(RetentionPolicy.RUNTIME)
-	@interface MultilingualField {
-
-		String[] args() default {};
-	}
-}

src/main/java/com/imyeyu/api/bean/PermissionMatchMode.java

@@ -0,0 +1,16 @@
+package com.imyeyu.api.bean;
+
+/**
+ * 权限匹配模式
+ *
+ * @author 夜雨
+ * @since 2026-06-05 17:45
+ */
+public enum PermissionMatchMode {
+
+	/** 全部满足 */
+	ALL,
+
+	/** 满足任意一个 */
+	ANY,
+}

src/main/java/com/imyeyu/api/bean/RoleMatchMode.java

@@ -0,0 +1,16 @@
+package com.imyeyu.api.bean;
+
+/**
+ * 角色匹配模式
+ *
+ * @author 夜雨
+ * @since 2026-06-05 17:45
+ */
+public enum RoleMatchMode {
+
+	/** 全部满足 */
+	ALL,
+
+	/** 满足任意一个 */
+	ANY,
+}

src/main/java/com/imyeyu/api/config/BeanConfig.java

@@ -2,7 +2,11 @@ package com.imyeyu.api.config;
 
 import com.fasterxml.jackson.annotation.JsonInclude;
 import com.fasterxml.jackson.databind.DeserializationFeature;
+import com.fasterxml.jackson.databind.MapperFeature;
 import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.databind.PropertyNamingStrategies;
+import com.fasterxml.jackson.databind.PropertyNamingStrategy;
+import com.fasterxml.jackson.databind.json.JsonMapper;
 import com.imyeyu.utils.Time;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
@@ -17,11 +21,12 @@ public class BeanConfig {
 
 	@Bean
 	public ObjectMapper jackson() {
-		ObjectMapper mapper = new ObjectMapper();
-		mapper.setDateFormat(Time.dateTime);
-		mapper.disable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);
-		mapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);
-		return mapper;
+		return JsonMapper.builder()
+		                 .serializationInclusion(JsonInclude.Include.NON_NULL)
+		                 .defaultDateFormat(Time.dateTime)
+		                 .disable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES)
+		                 .enable(MapperFeature.USE_STD_BEAN_NAMING)
+		                 .build();
 	}
 
 	@Bean

src/main/java/com/imyeyu/api/config/RedisConfig.java

@@ -1,7 +1,6 @@
 package com.imyeyu.api.config;
 
 import com.fasterxml.jackson.databind.ObjectMapper;
-import com.imyeyu.api.modules.blog.entity.ArticleRanking;
 import com.imyeyu.api.modules.common.entity.Multilingual;
 import com.imyeyu.spring.bean.RedisConfigParams;
 import com.imyeyu.spring.config.AbstractRedisConfig;
@@ -11,8 +10,8 @@ import com.imyeyu.utils.Time;
 import io.lettuce.core.api.StatefulConnection;
 import lombok.Data;
 import lombok.EqualsAndHashCode;
-import lombok.RequiredArgsConstructor;
 import org.apache.commons.pool2.impl.GenericObjectPoolConfig;
+import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
 import org.springframework.boot.context.properties.ConfigurationProperties;
 import org.springframework.cache.interceptor.KeyGenerator;
@@ -36,11 +35,11 @@ import java.time.Duration;
 @Configuration
 @EqualsAndHashCode(callSuper = true)
 @EnableAutoConfiguration
-@RequiredArgsConstructor
 @ConfigurationProperties(prefix = "spring.redis")
 public class RedisConfig extends AbstractRedisConfig {
 
-	private final ObjectMapper jackson;
+	@Autowired
+	private ObjectMapper jackson;
 
 	// ---------- 连接配置 ----------
 
@@ -53,57 +52,8 @@ public class RedisConfig extends AbstractRedisConfig {
 	/** 密码 */
 	private String password;
 
-	/** 数据库 */
-	private Database database;
-
-	/**
-	 * 数据库
-	 *
-	 * @author 夜雨
-	 * @since 2023-08-21 16:25
-	 */
-	@Data
-	public static class Database {
-
-		/** 分布式锁 */
-		private int locker;
-
-		/** 多语言环境 */
-		private int language;
-
-		/** 多语言键环境 */
-		private int languageMap;
-
-		/** 文章排位 */
-		private int articleRanking;
-
-		/** 文章阅读记录 */
-		private int articleRead;
-
-		/** 用户登录令牌 */
-		private int userToken;
-
-		/** 用户经验值标记 */
-		private int userExpFlag;
-
-		/** 用户邮箱验证 */
-		private int userEmailVerify;
-
-		/** 用户重置密码验证 */
-		private int userResetPWVerify;
-
-		/** 访问频率控制 */
-		private int rateLimit;
-
-		/** 系统配置 */
-		private int setting;
-
-		/** Minecraft 登录 */
-		private int fmcPlayerToken;
-
-		/** 共享剪切板 */
-		private int clipboard;
-	}
+	/** Redis 逻辑库 */
+	private int database;
 
 	@Override
 	protected RedisConfigParams configParams() {
@@ -149,13 +99,13 @@ public class RedisConfig extends AbstractRedisConfig {
 	/** @return 分布式锁， ID: 尝试加锁次数 */
 	@Bean("redisLocker")
 	public Redis<String, Integer> getLockerRedisTemplate() {
-		return getRedis(database.locker, RedisSerializers.STRING, RedisSerializers.INTEGER);
+		return getRedis(database, RedisSerializers.STRING, RedisSerializers.INTEGER);
 	}
 
 	/** @return 多语言环境，ID: {@link Multilingual} */
 	@Bean("redisLanguage")
-	public Redis<Long, Multilingual> getLanguageRedisTemplate() {
-		return getRedis(database.language, RedisSerializers.LONG, new RedisSerializer<>() {
+	public Redis<String, Multilingual> getLanguageRedisTemplate() {
+		return getRedis(database, RedisSerializers.STRING, new RedisSerializer<>() {
 
 			public Multilingual deserialize(@Nullable byte[] bytes) {
 				if (bytes == null || bytes.length == 0) {
@@ -182,63 +132,74 @@ public class RedisConfig extends AbstractRedisConfig {
 		});
 	}
 
+	@Bean("redisCaptcha")
+	public Redis<String, String> getCaptchaRedisTemplate() {
+		return getRedis(database, RedisSerializers.STRING, RedisSerializers.STRING);
+	}
+
 	/** @return 文章访问记录，IP: [文章 ID] */
 	@Bean("redisLanguageMap")
 	public Redis<String, Long> getLanguageMapRedisTemplate() {
-		return getRedis(database.languageMap, RedisSerializers.STRING, RedisSerializers.LONG);
-	}
-
-	/** @return 文章访问统计，文章 ID: {@link ArticleRanking}(JSON) */
-	@Bean("redisArticleRanking")
-	public Redis<Long, ArticleRanking> getArticleRankingRedisTemplate() {
-		return getRedis(database.articleRanking, RedisSerializers.LONG, RedisSerializers.jacksonSerializer(jackson, ArticleRanking.class));
+		return getRedis(database, RedisSerializers.STRING, RedisSerializers.LONG);
 	}
 
 	/** @return 文章访问记录，IP: [文章 ID] */
 	@Bean("redisArticleRead")
 	public Redis<String, Long> getArticleReadRedisTemplate() {
-		return getRedis(database.articleRead, RedisSerializers.STRING, RedisSerializers.LONG);
+		return getRedis(database, RedisSerializers.STRING, RedisSerializers.LONG);
 	}
 
 	/** @return 用户登录经验标记，UID: NULL，暂时没有值，数据死亡时间为次日零时 */
 	@Bean("redisUserExpFlag")
 	public Redis<Long, String> getUserExpFlagRedisTemplate() {
-		return getRedis(database.userExpFlag, RedisSerializers.LONG, RedisSerializers.STRING);
+		return getRedis(database, RedisSerializers.LONG, RedisSerializers.STRING);
+	}
+
+	/** @return 用户登录令牌，令牌: 用户 ID */
+	@Bean("redisUserToken")
+	public Redis<String, String> getUserTokenRedisTemplate() {
+		return getRedis(database, RedisSerializers.STRING, RedisSerializers.STRING);
 	}
 
 	/** @return 用户邮箱验证密钥，密钥: UID */
 	@Bean("redisUserEmailVerify")
 	public Redis<String, Long> getUserEmailVerifyRedisTemplate() {
-		return getRedis(database.userEmailVerify, RedisSerializers.STRING, RedisSerializers.LONG);
+		return getRedis(database, RedisSerializers.STRING, RedisSerializers.LONG);
 	}
 
 	/** @return 用户重置密码密钥，密钥: UID */
 	@Bean("redisUserResetPWVerify")
 	public Redis<String, Long> getUserResetPWVerifyRedisTemplate() {
-		return getRedis(database.userResetPWVerify, RedisSerializers.STRING, RedisSerializers.LONG);
+		return getRedis(database, RedisSerializers.STRING, RedisSerializers.LONG);
+	}
+
+	/** @return 用户手机号验证码，手机号: 验证码 */
+	@Bean("redisUserPhoneVerify")
+	public Redis<String, String> getUserPhoneVerifyRedisTemplate() {
+		return getRedis(database, RedisSerializers.STRING, RedisSerializers.STRING);
 	}
 
 	/** @return 接口访问控制，IP#方法: 生命周期内访问次数 */
 	@Bean("redisRateLimit")
 	public Redis<String, Integer> getRateLimitRedisTemplate() {
-		return getRedis(database.rateLimit, RedisSerializers.STRING, RedisSerializers.INTEGER);
+		return getRedis(database, RedisSerializers.STRING, RedisSerializers.INTEGER);
 	}
 
 	/** @return 系统配置，Key 枚举: String 配置值 */
 	@Bean("redisSetting")
 	public Redis<String, String> getSettingRedisTemplate() {
-		return getRedis(database.setting, RedisSerializers.STRING, RedisSerializers.STRING);
+		return getRedis(database, RedisSerializers.STRING, RedisSerializers.STRING);
 	}
 
 	/** @return Minecraft 登录，令牌: 玩家 ID */
 	@Bean("redisMCPlayerToken")
 	public Redis<String, Long> getMCPlayerLoginRedisTemplate() {
-		return getRedis(database.fmcPlayerToken, RedisSerializers.STRING, RedisSerializers.LONG);
+		return getRedis(database, RedisSerializers.STRING, RedisSerializers.LONG);
 	}
 
 	/** @return 共享剪切板，会话 ID: 内容 */
 	@Bean("redisClipboard")
 	public Redis<String, String> getClipboardRedisTemplate() {
-		return getRedis(database.clipboard, RedisSerializers.STRING, RedisSerializers.STRING);
+		return getRedis(database, RedisSerializers.STRING, RedisSerializers.STRING);
 	}
 }

src/main/java/com/imyeyu/api/config/WebConfig.java

@@ -7,9 +7,11 @@ import com.fasterxml.jackson.databind.ObjectMapper;
 import com.fasterxml.jackson.databind.json.JsonMapper;
 import com.imyeyu.api.annotation.EnableSettingInterceptor;
 import com.imyeyu.api.annotation.RequestRateLimitInterceptor;
-import com.imyeyu.api.annotation.RequiredTokenInterceptor;
+import com.imyeyu.api.annotation.RequireCorePermissionInterceptor;
+import com.imyeyu.api.annotation.RequireCoreRoleInterceptor;
+import com.imyeyu.api.modules.gao.annotation.RequireGaoPermissionInterceptor;
+import com.imyeyu.api.modules.gao.annotation.RequireGaoRoleInterceptor;
 import com.imyeyu.api.modules.journal.util.JournalAPIInterceptor;
-import com.imyeyu.api.modules.minecraft.annotation.RequiredFMCServerTokenInterceptor;
 import com.imyeyu.api.modules.system.util.SystemAPIInterceptor;
 import com.imyeyu.spring.annotation.RequestBodyValueArgumentResolver;
 import com.imyeyu.utils.Time;
@@ -39,10 +41,12 @@ public class WebConfig implements WebMvcConfigurer {
 	private final ObjectMapper jackson;
 	private final SystemAPIInterceptor systemAPIInterceptor;
 	private final JournalAPIInterceptor journalAPIInterceptor;
-	private final RequiredTokenInterceptor requiredTokenInterceptor;
 	private final EnableSettingInterceptor enableSettingInterceptor;
+	private final RequireGaoRoleInterceptor requireGaoRoleInterceptor;
+	private final RequireCoreRoleInterceptor requireCoreRoleInterceptor;
 	private final RequestRateLimitInterceptor requestRateLimitInterceptor;
-	private final RequiredFMCServerTokenInterceptor requiredFMCServerTokenInterceptor;
+	private final RequireGaoPermissionInterceptor requireGaoPermissionInterceptor;
+	private final RequireCorePermissionInterceptor requireCorePermissionInterceptor;
 
 	/**
 	 * 过滤器
@@ -53,9 +57,11 @@ public class WebConfig implements WebMvcConfigurer {
 	public void addInterceptors(InterceptorRegistry registry) {
 		registry.addInterceptor(systemAPIInterceptor).addPathPatterns(SystemAPIInterceptor.PATH);
 		registry.addInterceptor(journalAPIInterceptor).addPathPatterns(JournalAPIInterceptor.PATH);
-		registry.addInterceptor(requiredFMCServerTokenInterceptor).addPathPatterns("/fmc/server/**");
-		registry.addInterceptor(requiredTokenInterceptor).addPathPatterns("/**");
 		registry.addInterceptor(enableSettingInterceptor).addPathPatterns("/**");
+		registry.addInterceptor(requireCoreRoleInterceptor).addPathPatterns("/**");
+		registry.addInterceptor(requireCorePermissionInterceptor).addPathPatterns("/**");
+		registry.addInterceptor(requireGaoRoleInterceptor).addPathPatterns("/**");
+		registry.addInterceptor(requireGaoPermissionInterceptor).addPathPatterns("/**");
 		registry.addInterceptor(requestRateLimitInterceptor).addPathPatterns("/**");
 	}
 

src/main/java/com/imyeyu/api/config/dbsource/ForeverMCDBConfig.java

@@ -30,7 +30,6 @@ public class ForeverMCDBConfig {
 	public static final String ROLLBACKER = "foreverMCTransactionManager";
 
 	@Bean(name = "foreverMCDataSource")
-	@Primary
 	@ConfigurationProperties(prefix = "spring.datasource.forevermc")
 	public DataSource getPrimaryDateSource() throws SQLException {
 		HikariDataSource dataSource = new HikariDataSource();
@@ -50,7 +49,6 @@ public class ForeverMCDBConfig {
 
 
 	@Bean(name = "foreverMCSqlSessionFactory")
-	@Primary
 	public SqlSessionFactory primarySqlSessionFactory(@Qualifier("foreverMCDataSource") DataSource datasource) throws Exception {
 		org.apache.ibatis.session.Configuration config = new org.apache.ibatis.session.Configuration();
 		config.setUseGeneratedKeys(true);
@@ -64,7 +62,6 @@ public class ForeverMCDBConfig {
 	}
 
 	@Bean("foreverMCSqlSessionTemplate")
-	@Primary
 	public SqlSessionTemplate primarySqlSessionTemplate(@Qualifier("foreverMCSqlSessionFactory") SqlSessionFactory sessionfactory) {
 		return new SqlSessionTemplate(sessionfactory);
 	}

src/main/java/com/imyeyu/api/config/dbsource/GiteaDBConfig.java

@@ -38,7 +38,6 @@ public class GiteaDBConfig {
 	public static final String ROLLBACKER = "giteaTransactionManager";
 
 	@Bean(name = "giteaDataSource")
-	@Primary
 	@ConfigurationProperties(prefix = "spring.datasource.gitea")
 	public DataSource dateSource() throws SQLException {
 		HikariDataSource dataSource = new HikariDataSource();
@@ -58,7 +57,6 @@ public class GiteaDBConfig {
 
 
 	@Bean(name = "giteaSqlSessionFactory")
-	@Primary
 	public SqlSessionFactory sessionFactory(@Qualifier("giteaDataSource") DataSource datasource) throws Exception {
 		org.apache.ibatis.session.Configuration config = new org.apache.ibatis.session.Configuration();
 		config.setUseGeneratedKeys(true);
@@ -69,7 +67,7 @@ public class GiteaDBConfig {
 		{
 			ResourcePatternResolver resourceResolver = new PathMatchingResourcePatternResolver();
 			List<String> mapperLocations = new ArrayList<>();
-			mapperLocations.add("classpath:mapper/gitea/**/*.xml");
+//			mapperLocations.add("classpath:mapper/gitea/**/*.xml");
 			for (String mapperLocation : mapperLocations) {
 				resources.addAll(List.of(resourceResolver.getResources(mapperLocation)));
 			}
@@ -92,7 +90,6 @@ public class GiteaDBConfig {
 
 
 	@Bean("giteaSqlSessionTemplate")
-	@Primary
 	public SqlSessionTemplate sessionTemplate(@Qualifier("giteaSqlSessionFactory") SqlSessionFactory sessionfactory) {
 		return new SqlSessionTemplate(sessionfactory);
 	}

src/main/java/com/imyeyu/api/config/dbsource/TimiServerDBConfig.java

@@ -8,6 +8,7 @@ import org.mybatis.spring.SqlSessionFactoryBean;
 import org.mybatis.spring.SqlSessionTemplate;
 import org.mybatis.spring.annotation.MapperScan;
 import org.springframework.beans.factory.annotation.Qualifier;
+import org.springframework.boot.autoconfigure.flyway.FlywayDataSource;
 import org.springframework.boot.context.properties.ConfigurationProperties;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
@@ -32,7 +33,9 @@ import java.util.List;
 @Configuration
 @MapperScan(basePackages = {
 		"com.imyeyu.api.modules.git.mapper",
+		"com.imyeyu.api.modules.gao.mapper",
 		"com.imyeyu.api.modules.bill.mapper",
+		"com.imyeyu.api.modules.user.mapper",
 		"com.imyeyu.api.modules.blog.mapper",
 		"com.imyeyu.api.modules.lyric.mapper",
 		"com.imyeyu.api.modules.mirror.mapper",
@@ -47,6 +50,7 @@ public class TimiServerDBConfig {
 
 	@Bean(name = "timiServerDataSource")
 	@Primary
+	@FlywayDataSource
 	@ConfigurationProperties(prefix = "spring.datasource.timiserver")
 	public DataSource getPrimaryDateSource() throws SQLException {
 		HikariDataSource dataSource = new HikariDataSource();
@@ -77,19 +81,16 @@ public class TimiServerDBConfig {
 		{
 			ResourcePatternResolver resourceResolver = new PathMatchingResourcePatternResolver();
 			List<String> mapperLocations = new ArrayList<>();
-			mapperLocations.add("classpath:mapper/git/**/*.xml");
-			mapperLocations.add("classpath:mapper/blog/**/*.xml");
-			mapperLocations.add("classpath:mapper/common/**/*.xml");
-			mapperLocations.add("classpath:mapper/system/**/*.xml");
-			mapperLocations.add("classpath:mapper/journal/**/*.xml");
-			mapperLocations.add("classpath:mapper/minecraft/**/*.xml");
+			mapperLocations.add("classpath:mapper/timi-server/**/*.xml");
 			for (String mapperLocation : mapperLocations) {
 				resources.addAll(List.of(resourceResolver.getResources(mapperLocation)));
 			}
 		}
 		String[] typeAliases = {
 				"com.imyeyu.api.modules.git.entity",
+				"com.imyeyu.api.modules.gao.entity",
 				"com.imyeyu.api.modules.bill.entity",
+				"com.imyeyu.api.modules.user.entity",
 				"com.imyeyu.api.modules.blog.entity",
 				"com.imyeyu.api.modules.lyric.entity",
 				"com.imyeyu.api.modules.mirror.entity",

src/main/java/com/imyeyu/api/modules/blog/controller/ArticleController.java

@@ -1,93 +0,0 @@
-package com.imyeyu.api.modules.blog.controller;
-
-import com.imyeyu.api.modules.blog.entity.Article;
-import com.imyeyu.api.modules.blog.entity.ArticleRanking;
-import com.imyeyu.api.modules.blog.service.ArticleService;
-import com.imyeyu.api.modules.blog.vo.article.ArticleView;
-import com.imyeyu.api.modules.blog.vo.article.KeywordPage;
-import com.imyeyu.spring.annotation.AOPLog;
-import com.imyeyu.spring.annotation.RequestRateLimit;
-import com.imyeyu.spring.bean.Page;
-import com.imyeyu.spring.bean.PageResult;
-import jakarta.validation.Valid;
-import jakarta.validation.constraints.Min;
-import jakarta.validation.constraints.NotNull;
-import lombok.RequiredArgsConstructor;
-import org.springframework.validation.annotation.Validated;
-import org.springframework.web.bind.annotation.PathVariable;
-import org.springframework.web.bind.annotation.RequestBody;
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RestController;
-
-import java.util.List;
-
-/**
- * 文章接口
- *
- * @author 夜雨
- * @since 2021-02-17 17:47
- */
-@Validated
-@RestController
-@RequiredArgsConstructor
-@RequestMapping("/article")
-public class ArticleController {
-
-	private final ArticleService service;
-
-	/**
-	 * 查看
-	 *
-	 * @param id 文章 ID
-	 * @return 文章
-	 */
-	@AOPLog
-	@RequestRateLimit
-	@RequestMapping("/{id}")
-	public ArticleView view(@Min(1) @NotNull @PathVariable Long id) {
-		return service.view(id);
-	}
-
-	/**
-	 * 喜欢文章
-	 *
-	 * @param id 文章 ID
-	 * @return 最新喜欢数量
-	 */
-	@AOPLog
-	@RequestRateLimit
-	@RequestMapping("/like/{id}")
-	public int like(@Min(1) @NotNull @PathVariable Long id) {
-		return service.like(id);
-	}
-
-	/**
-	 * 主列表
-	 *
-	 * @param page 页面参数
-	 * @return 文章列表
-	 */
-	@RequestRateLimit
-	@RequestMapping("/list")
-	public PageResult<Article> list(@Valid @RequestBody Page page) {
-		return service.page(page);
-	}
-
-	/**
-	 * 根据关键字获取列表
-	 *
-	 * @param page 关键字页面参数
-	 * @return 文章列表
-	 */
-	@RequestRateLimit
-	@RequestMapping("/list/search")
-	public PageResult<Article> listByKeyword(@Valid @RequestBody KeywordPage page) {
-		return service.pageByKeyword(page);
-	}
-
-	/** @return 每周访问排位 */
-	@RequestMapping("/list/ranking")
-	public List<ArticleRanking> ranking() {
-		return service.listRanking();
-	}
-}

src/main/java/com/imyeyu/api/modules/blog/controller/BlogController.java

@@ -1,32 +0,0 @@
-package com.imyeyu.api.modules.blog.controller;
-
-import lombok.RequiredArgsConstructor;
-import lombok.extern.slf4j.Slf4j;
-import com.imyeyu.api.modules.blog.entity.Friend;
-import com.imyeyu.api.modules.blog.service.FriendService;
-import org.springframework.web.bind.annotation.GetMapping;
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RestController;
-
-import java.util.List;
-
-/**
- * 主控
- *
- * @author 夜雨
- * @since 2023-02-04 10:28
- */
-@Slf4j
-@RestController
-@RequiredArgsConstructor
-@RequestMapping("/")
-public class BlogController {
-
-	private final FriendService friendService;
-
-	/** @return 所有友链列表 */
-	@GetMapping("/friend")
-	public List<Friend> friend() {
-		return friendService.listAll();
-	}
-}

src/main/java/com/imyeyu/api/modules/blog/entity/Article.java

@@ -1,92 +0,0 @@
-package com.imyeyu.api.modules.blog.entity;
-
-import com.fasterxml.jackson.databind.JsonNode;
-import com.imyeyu.api.modules.common.bean.CommentSupport;
-import com.imyeyu.spring.entity.Destroyable;
-import com.imyeyu.spring.entity.Entity;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-
-/**
- * 文章
- *
- * @author 夜雨
- * @since 2021-03-01 17:10
- */
-@Data
-@EqualsAndHashCode(callSuper = true)
-public class Article extends Entity implements CommentSupport, Destroyable {
-
-	/**
-	 * 文章渲染类型，对应前端模板
-	 *
-	 * @author 夜雨
-	 * @since 2021-07-04 09:23
-	 */
-	public enum Type {
-
-		/** 公版 */
-		PUBLIC,
-
-		/** 音乐 */
-		MUSIC,
-
-		/** 软件 */
-		SOFTWARE
-	}
-
-	/** 标题 */
-	protected String title;
-
-	/** 类型 */
-	protected Type type;
-
-	/** 摘要 */
-	protected String digest;
-
-	/** 数据 */
-	protected String data;
-
-	/** 扩展数据 */
-	protected JsonNode extendData;
-
-	/** 阅读数量 */
-	protected int reads;
-
-	/** 喜欢数量 */
-	protected int likes;
-
-	/** true 为显示评论 */
-	protected boolean showComment;
-
-	/** true 为可评论 */
-	protected boolean canComment;
-
-	/** true 为可排位 */
-	protected boolean canRanking;
-
-	/** true 为可通过列表查询 */
-	protected boolean canList;
-
-	/** @return true 为可评论 */
-	@Override
-	public boolean canComment() {
-		return canComment;
-	}
-
-	/** @return true 为不可评论 */
-	@Override
-	public boolean canNotComment() {
-		return !canComment;
-	}
-
-	/** @return true 为可排位 */
-	public boolean canRanking() {
-		return canRanking;
-	}
-
-	/** @return true 为不可排位 */
-	public boolean canNotRanking() {
-		return !canRanking;
-	}
-}

src/main/java/com/imyeyu/api/modules/blog/entity/ArticleRanking.java

@@ -1,35 +0,0 @@
-package com.imyeyu.api.modules.blog.entity;
-
-import com.imyeyu.spring.entity.Entity;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * 访问排行（每周）
- * 只记录访问次数、标题和最近访问，具体文章由 Redis key 记录
- *
- * @author 夜雨
- * @since 2021-03-01 17:10
- */
-@Data
-@NoArgsConstructor
-@EqualsAndHashCode(callSuper = true)
-public class ArticleRanking extends Entity {
-
-	private String title;
-	private Article.Type type;
-	private int count = 1;
-	private Long recentAt; // 最近访问
-
-	public ArticleRanking(Long id, String title, Article.Type type) {
-		setId(id);
-		this.title = title;
-		this.type = type;
-	}
-
-	/** 访问计数 + 1 */
-	public void read() {
-		count++;
-	}
-}

src/main/java/com/imyeyu/api/modules/blog/entity/CommentRemindQueue.java

@@ -1,36 +0,0 @@
-package com.imyeyu.api.modules.blog.entity;
-
-import com.imyeyu.api.modules.common.entity.CommentReply;
-import com.imyeyu.spring.annotation.table.AutoUUID;
-import com.imyeyu.spring.annotation.table.Id;
-import lombok.Data;
-import lombok.NoArgsConstructor;
-
-/**
- * 评论回复提醒队列，和 CommentReplyRecord 不一样，本队列在推送消息后就删除，而后者会持久保存
- *
- * <p>基本逻辑：
- * <pre>
- *     触发：用户回复一条评论
- *     条件：被回复者是注册用户 && 不是回复自己 && 邮箱已验证 && 接收回复提醒邮件
- *     事件：添加本对象到队列列表，等待邮件推送服务调度，邮件推送服务
- * </pre>
- * 会针对用户收集本队列消息组合成邮件再一并推送
- *
- * @author 夜雨
- * @since 2021-08-25 00:00
- */
-@Data
-@NoArgsConstructor
-public class CommentRemindQueue {
-
-	@Id
-	@AutoUUID
-	private String UUID;
-
-	private Long userId;
-
-	private Long replyId;
-
-	private CommentReply reply;
-}

src/main/java/com/imyeyu/api/modules/blog/entity/Friend.java

@@ -1,21 +0,0 @@
-package com.imyeyu.api.modules.blog.entity;
-
-import lombok.AllArgsConstructor;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-import com.imyeyu.spring.entity.Entity;
-
-/**
- * 夜雨 创建于 2021-07-15 15:59
- */
-@Data
-@NoArgsConstructor
-@AllArgsConstructor
-@EqualsAndHashCode(callSuper = true)
-public class Friend extends Entity {
-
-	private String icon;
-	private String name;
-	private String link;
-}

src/main/java/com/imyeyu/api/modules/blog/mapper/ArticleMapper.java

@@ -1,33 +0,0 @@
-package com.imyeyu.api.modules.blog.mapper;
-
-import com.imyeyu.api.modules.blog.entity.Article;
-import com.imyeyu.spring.bean.Page;
-import com.imyeyu.spring.mapper.BaseMapper;
-import org.apache.ibatis.annotations.Select;
-
-import java.util.List;
-
-/**
- * 文章
- *
- * @author 夜雨
- * @since 2021-02-23 21:34
- */
-public interface ArticleMapper extends BaseMapper<Article, Long> {
-
-	@Override
-	long countByPage(Page page);
-
-	@Override
-	List<Article> selectByPage(Page page);
-
-	long countByKeyword(String keyword);
-
-	List<Article> selectByKeyword(String keyword, Long offset, long limit);
-
-	@Select("UPDATE `article` SET `likes` = `likes` + 1 WHERE `id` = #{articleId}")
-	void like(Long articleId);
-
-	@Select("UPDATE `article` SET `reads` = `reads` + 1 WHERE `id` = #{articleId}")
-	void read(Long articleId);
-}

src/main/java/com/imyeyu/api/modules/blog/mapper/FriendMapper.java

@@ -1,20 +0,0 @@
-package com.imyeyu.api.modules.blog.mapper;
-
-
-import com.imyeyu.api.modules.blog.entity.Friend;
-import com.imyeyu.spring.mapper.BaseMapper;
-import org.apache.ibatis.annotations.Select;
-
-import java.util.List;
-
-/**
- * 友链
- *
- * @author 夜雨
- * @since 2021-07-15 16:11
- */
-public interface FriendMapper extends BaseMapper<Friend, Long> {
-
-	@Select("SELECT * FROM friend WHERE 1 = 1" + NOT_DELETE)
-	List<Friend> listAll();
-}

src/main/java/com/imyeyu/api/modules/blog/service/ArticleService.java

@@ -1,48 +0,0 @@
-package com.imyeyu.api.modules.blog.service;
-
-import com.imyeyu.java.bean.timi.TimiException;
-import com.imyeyu.api.modules.blog.entity.Article;
-import com.imyeyu.api.modules.blog.entity.ArticleRanking;
-import com.imyeyu.api.modules.blog.vo.article.ArticleView;
-import com.imyeyu.api.modules.blog.vo.article.KeywordPage;
-import com.imyeyu.spring.bean.PageResult;
-import com.imyeyu.spring.service.GettableService;
-import com.imyeyu.spring.service.PageableService;
-
-import java.util.List;
-
-/**
- * 文章服务
- *
- * @author 夜雨
- * @since 2021-02-23 21:33
- */
-public interface ArticleService extends GettableService<Article, Long>, PageableService<Article> {
-
-	/**
-	 * 获取文章，此方法触发阅读计数，包括触发每周热门排行统计，同一 IP 3 小时内访问多次的文章只计一次
-	 *
-	 * @param id 文章 ID
-	 * @throws TimiException 服务异常
-	 */
-	ArticleView view(long id);
-
-	PageResult<Article> pageByKeyword(KeywordPage page);
-
-	/**
-	 * 获取每周阅读排行
-	 *
-	 * @return 热门文章列表
-	 * @throws TimiException 服务异常
-	 */
-	List<ArticleRanking> listRanking();
-
-	/**
-	 * 喜欢文章
-	 *
-	 * @param articleId 文章 ID
-	 * @return 最新喜欢数量
-	 * @throws TimiException 服务异常
-	 */
-	int like(Long articleId);
-}

src/main/java/com/imyeyu/api/modules/blog/service/CommentRemindQueueService.java

@@ -1,41 +0,0 @@
-package com.imyeyu.api.modules.blog.service;
-
-import com.imyeyu.java.bean.timi.TimiException;
-import com.imyeyu.api.modules.blog.entity.CommentRemindQueue;
-import com.imyeyu.spring.service.CreatableService;
-
-import java.util.List;
-
-/**
- * 评论回复队列服务
- *
- * @author 夜雨
- * @since 2021-08-25 00:11
- */
-public interface CommentRemindQueueService extends CreatableService<CommentRemindQueue> {
-
-	/**
-	 * 根据用户 ID 获取
-	 *
-	 * @param userId 用户 ID
-	 * @return 回复提醒列表
-	 * @throws TimiException 服务异常
-	 */
-	List<CommentRemindQueue> listByUserId(Long userId);
-
-	/**
-	 * 根据用户 ID 移出队列
-	 *
-	 * @param uid 用户 ID
-	 * @throws TimiException 服务异常
-	 */
-	void destroyByUserId(Long uid);
-
-	/**
-	 * 根据回复 ID 移出队列
-	 *
-	 * @param rid 回复 ID
-	 * @throws TimiException 服务异常
-	 */
-	void destroyByReplyId(Long rid);
-}

src/main/java/com/imyeyu/api/modules/blog/service/FriendService.java

@@ -1,16 +0,0 @@
-package com.imyeyu.api.modules.blog.service;
-
-import com.imyeyu.api.modules.blog.entity.Friend;
-
-import java.util.List;
-
-/**
- * 友链服务
- *
- * @author 夜雨
- * @since 2021-07-15 16:04
- */
-public interface FriendService {
-
-	List<Friend> listAll();
-}

src/main/java/com/imyeyu/api/modules/blog/service/implement/ArticleServiceImplement.java

@@ -1,122 +0,0 @@
-package com.imyeyu.api.modules.blog.service.implement;
-
-import com.imyeyu.api.config.dbsource.TimiServerDBConfig;
-import com.imyeyu.api.modules.blog.entity.Article;
-import com.imyeyu.api.modules.blog.entity.ArticleRanking;
-import com.imyeyu.api.modules.blog.mapper.ArticleMapper;
-import com.imyeyu.api.modules.blog.service.ArticleService;
-import com.imyeyu.api.modules.blog.vo.article.ArticleView;
-import com.imyeyu.api.modules.blog.vo.article.KeywordPage;
-import com.imyeyu.api.modules.common.entity.Attachment;
-import com.imyeyu.api.modules.common.entity.Comment;
-import com.imyeyu.api.modules.common.entity.Tag;
-import com.imyeyu.api.modules.common.mapper.CommentMapper;
-import com.imyeyu.api.modules.common.service.AttachmentService;
-import com.imyeyu.api.modules.common.service.TagService;
-import com.imyeyu.java.bean.timi.TimiException;
-import com.imyeyu.spring.TimiSpring;
-import com.imyeyu.spring.bean.Page;
-import com.imyeyu.spring.bean.PageResult;
-import com.imyeyu.spring.mapper.BaseMapper;
-import com.imyeyu.spring.service.AbstractEntityService;
-import com.imyeyu.spring.util.Redis;
-import com.imyeyu.utils.Time;
-import lombok.RequiredArgsConstructor;
-import lombok.extern.slf4j.Slf4j;
-import org.springframework.beans.BeanUtils;
-import org.springframework.stereotype.Service;
-import org.springframework.transaction.annotation.Transactional;
-
-import java.util.Comparator;
-import java.util.List;
-
-/**
- * 文章服务实现
- * 
- * @author 夜雨
- * @since 2021-02-17 17:48
- */
-@Slf4j
-@Service
-@RequiredArgsConstructor
-public class ArticleServiceImplement extends AbstractEntityService<Article, Long> implements ArticleService {
-
-	private final TagService tagService;
-	private final AttachmentService attachmentService;
-
-	private final ArticleMapper mapper;
-	private final CommentMapper commentMapper;
-
-	private final Redis<String, Long> redisArticleRead;
-	private final Redis<Long, ArticleRanking> redisArticleRanking;
-
-	@Override
-	protected BaseMapper<Article, Long> mapper() {
-		return mapper;
-	}
-
-	@Override
-	public PageResult<Article> page(Page page) {
-		PageResult<Article> result = new PageResult<>();
-		result.setList(mapper.selectByPage(page));
-		result.setTotal(mapper.countByPage(page));
-		return result;
-	}
-
-	@Transactional(TimiServerDBConfig.ROLLBACKER)
-	@Override
-	public ArticleView view(long id) {
-		String ip = TimiSpring.getRequestIP();
-		Article article = get(id);
-		TimiException.required(article, "article.not_found");
-		// 计数
-		if (!redisArticleRead.contains(ip, article.getId())) {
-			// 3 小时内访问记录
-			redisArticleRead.add(ip, article.getId());
-			redisArticleRead.setExpire(ip, Time.H * 3);
-			mapper.read(article.getId());
-			// 每周访问计数
-			if (article.canRanking()) {
-				ArticleRanking ranking = redisArticleRanking.get(article.getId());
-				if (ranking == null) {
-					ranking = new ArticleRanking(article.getId(), article.getTitle(), article.getType());
-					ranking.setRecentAt(Time.now());
-					redisArticleRanking.set(article.getId(), ranking, Time.D * 7);
-				} else {
-					ranking.read();
-					ranking.setRecentAt(Time.now());
-					redisArticleRanking.setAndKeepTTL(article.getId(), ranking);
-				}
-			}
-		}
-
-		ArticleView view = new ArticleView();
-		BeanUtils.copyProperties(article, view);
-		view.setComments(commentMapper.countAll(Comment.BizType.ARTICLE, article.getId()));
-		view.setTagList(tagService.listByBizID(Tag.BizType.ARTICLE, String.valueOf(article.getId())));
-		view.setAttachmentList(attachmentService.listByBizId(Attachment.BizType.ARTICLE, article.getId()));
-		return view;
-	}
-
-	@Override
-	public PageResult<Article> pageByKeyword(KeywordPage page) {
-		PageResult<Article> result = new PageResult<>();
-		result.setList(mapper.selectByKeyword(page.getKeyword(), page.getOffset(), page.getLimit()));
-		result.setTotal(mapper.countByKeyword(page.getKeyword()));
-		return result;
-	}
-
-	@Override
-	public List<ArticleRanking> listRanking() {
-		List<ArticleRanking> list = redisArticleRanking.values();
-		list.sort(Comparator.comparing(ArticleRanking::getCount).reversed());
-		return list.subList(0, Math.min(10, list.size()));
-	}
-
-	@Transactional(TimiServerDBConfig.ROLLBACKER)
-	@Override
-	public int like(Long articleId) {
-		mapper.like(articleId);
-		return get(articleId).getLikes();
-	}
-}

src/main/java/com/imyeyu/api/modules/blog/service/implement/CommentRemindQueueServiceImplement.java

@@ -1,52 +0,0 @@
-package com.imyeyu.api.modules.blog.service.implement;
-
-import com.imyeyu.api.config.dbsource.TimiServerDBConfig;
-import com.imyeyu.api.modules.blog.entity.CommentRemindQueue;
-import com.imyeyu.api.modules.blog.service.CommentRemindQueueService;
-import com.imyeyu.api.modules.common.mapper.CommentRemindQueueMapper;
-import com.imyeyu.spring.mapper.BaseMapper;
-import com.imyeyu.spring.service.AbstractEntityService;
-import lombok.RequiredArgsConstructor;
-import org.springframework.stereotype.Service;
-import org.springframework.transaction.annotation.Transactional;
-
-import java.util.List;
-
-/**
- * 评论回复队列服务实现
- *
- * @author 夜雨
- * @since 2021-08-25 00:11
- */
-@Service
-@RequiredArgsConstructor
-public class CommentRemindQueueServiceImplement extends AbstractEntityService<CommentRemindQueue, String> implements CommentRemindQueueService {
-
-	private final CommentRemindQueueMapper mapper;
-
-	@Override
-	protected BaseMapper<CommentRemindQueue, String> mapper() {
-		return mapper;
-	}
-
-	@Override
-	public List<CommentRemindQueue> listByUserId(Long userId) {
-		return mapper.listByUserId(userId);
-	}
-
-	@Transactional(TimiServerDBConfig.ROLLBACKER)
-	@Override
-	public void destroyByUserId(Long userId) {
-		CommentRemindQueue example = new CommentRemindQueue();
-		example.setUserId(userId);
-		mapper.deleteAllByExample(example);
-	}
-
-	@Transactional(TimiServerDBConfig.ROLLBACKER)
-	@Override
-	public void destroyByReplyId(Long replyId) {
-		CommentRemindQueue example = new CommentRemindQueue();
-		example.setReplyId(replyId);
-		mapper.destroyAllByExample(example);
-	}
-}

src/main/java/com/imyeyu/api/modules/blog/service/implement/FriendServiceImplement.java

@@ -1,27 +0,0 @@
-package com.imyeyu.api.modules.blog.service.implement;
-
-import lombok.RequiredArgsConstructor;
-import com.imyeyu.api.modules.blog.entity.Friend;
-import com.imyeyu.api.modules.blog.mapper.FriendMapper;
-import com.imyeyu.api.modules.blog.service.FriendService;
-import org.springframework.stereotype.Service;
-
-import java.util.List;
-
-/**
- * 友链服务实现
- *
- * @author 夜雨
- * @since 2021-07-15 16:05
- */
-@Service
-@RequiredArgsConstructor
-public class FriendServiceImplement implements FriendService {
-
-	private final FriendMapper mapper;
-
-	@Override
-	public List<Friend> listAll() {
-		return mapper.listAll();
-	}
-}

src/main/java/com/imyeyu/api/modules/blog/util/UserToken.java

@@ -1,147 +0,0 @@
-package com.imyeyu.api.modules.blog.util;
-
-import com.imyeyu.java.TimiJava;
-import com.imyeyu.java.bean.timi.TimiException;
-import com.imyeyu.api.config.RedisConfig;
-import com.imyeyu.api.modules.common.bean.SettingKey;
-import com.imyeyu.api.modules.common.entity.User;
-import com.imyeyu.api.modules.common.service.SettingService;
-import com.imyeyu.api.modules.common.service.UserService;
-import com.imyeyu.spring.TimiSpring;
-import com.imyeyu.spring.util.Redis;
-import com.imyeyu.spring.util.RedisSerializers;
-import com.imyeyu.utils.Time;
-import jakarta.annotation.Nullable;
-import jakarta.annotation.PostConstruct;
-import jakarta.servlet.http.Cookie;
-import jakarta.validation.constraints.NotNull;
-import lombok.RequiredArgsConstructor;
-import org.springframework.context.annotation.Lazy;
-import org.springframework.stereotype.Component;
-
-import java.util.Objects;
-
-/**
- * Redis 令牌缓存
- *
- * <p>一级缓存 Session，二级缓存 Redis，有效期为 {@link SettingKey#TTL_USER_TOKEN} 天，每次触发
- * 二级缓存获取时会刷新这个时间，即指定天数内不再访问则视为登出
- *
- * @author 夜雨
- * @since 2023-07-17 16:58
- */
-@Component
-@RequiredArgsConstructor(onConstructor_ = {@Lazy})
-public class UserToken {
-
-	private final RedisConfig redisConfig;
-
-	private final UserService userService;
-	private final SettingService settingService;
-
-	private Redis<String, Long> redis;
-
-	@PostConstruct
-	private void postConstruct() {
-		redis = redisConfig.getRedis(redisConfig.getDatabase().getUserToken(), RedisSerializers.STRING, RedisSerializers.LONG);
-	}
-
-	public Long set(String token, Long userId) {
-		long ttl = Time.D * settingService.getAsInt(SettingKey.TTL_USER_TOKEN);
-		// 会话
-		TimiSpring.setSessionAttr(token, userId);
-		// 跨站 Cookie
-		Cookie cookie = Objects.requireNonNullElse(TimiSpring.getCookie("Token"), new Cookie("Token", token));
-		cookie.setDomain(settingService.getAsString(SettingKey.DOMAIN_ROOT));
-		cookie.setPath("/");
-		cookie.setSecure(true);
-		cookie.setMaxAge((int) (ttl / 1000));
-		TimiSpring.addCookie(cookie);
-		// Redis
-		redis.set(token, userId, ttl);
-		return Time.now() + ttl;
-	}
-
-	public Long getExpireAt(String token) {
-		return Time.now() + redis.getExpire(token);
-	}
-
-	/**
-	 * 获取令牌是否有效
-	 *
-	 * @param token 令牌
-	 * @return true 为有效
-	 */
-	public boolean isValid(String token) {
-		return getUserId(token) != null;
-	}
-
-	/**
-	 * 获取令牌是否无效（{@link #isValid(String)} 取反）
-	 *
-	 * @param token 令牌
-	 * @return true 为无效
-	 */
-	public boolean isInvalid(String token) {
-		return !isValid(token);
-	}
-
-	/**
-	 * 获取用户 ID
-	 * <p>一级缓存 Session，二级缓存 Redis，每次触发二级缓存获取时会刷新这个时间
-	 * <p>Session 存键为 token，值为 UserId，Redis 也相同
-	 *
-	 * @param token 令牌
-	 * @return 用户 ID
-	 * @throws TimiException 无效 token
-	 */
-	public @Nullable Long getRequiredUserId(String token) throws TimiException {
-		return TimiException.required(getUserId(token), "invalid token");
-	}
-
-	/**
-	 * 获取用户 ID
-	 * <p>一级缓存 Session，二级缓存 Redis，每次触发二级缓存获取时会刷新这个时间
-	 * <p>Session 存键为 token，值为 UserId，Redis 也相同
-	 * 
-	 * @param token 令牌
-	 * @return 用户 ID，token 无效时为 null
-	 */
-	public @Nullable Long getUserId(String token) {
-		if (TimiJava.isEmpty(token)) {
-			return null;
-		}
-		Long userId;
-		// Session
-		if (TimiSpring.getSessionAttr(token) instanceof Long sessionUserId) {
-			userId = sessionUserId;
-		} else {
-			// Redis
-			userId = redis.get(token);
-		}
-		if (TimiJava.isEmpty(userId)) {
-			return null;
-		}
-		// 刷新
-		set(token, userId);
-		return userId;
-	}
-
-	public @NotNull User getUser(String token) {
-		return userService.get(getRequiredUserId(token));
-	}
-
-	public void clear(String token) {
-		// 会话
-		TimiSpring.removeSessionAttr(token);
-		// 清除跨站 Cookie
-		Cookie cookie = new Cookie("Token", "DIED");
-		cookie.setDomain(settingService.getAsString(SettingKey.DOMAIN_ROOT));
-		cookie.setPath("/");
-		cookie.setSecure(true);
-		cookie.setMaxAge(0);
-		TimiSpring.addCookie(cookie);
-		// Redis
-		redis.destroy(token);
-	}
-}

src/main/java/com/imyeyu/api/modules/blog/vo/article/ArticleView.java

@@ -1,24 +0,0 @@
-package com.imyeyu.api.modules.blog.vo.article;
-
-import com.imyeyu.api.modules.blog.entity.Article;
-import com.imyeyu.api.modules.common.entity.Attachment;
-import com.imyeyu.api.modules.common.entity.Tag;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-
-import java.util.List;
-
-/**
- * @author 夜雨
- * @since 2023-08-07 17:19
- */
-@Data
-@EqualsAndHashCode(callSuper = true)
-public class ArticleView extends Article {
-
-	private long comments;
-
-	private List<Tag> tagList;
-
-	private List<Attachment> attachmentList;
-}

src/main/java/com/imyeyu/api/modules/blog/vo/article/ClassPage.java

@@ -1,16 +0,0 @@
-package com.imyeyu.api.modules.blog.vo.article;
-
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import com.imyeyu.spring.bean.Page;
-
-/**
- * @author 夜雨
- * @since 2023-07-14 17:52
- */
-@Data
-@EqualsAndHashCode(callSuper = true)
-public class ClassPage extends Page {
-
-	private long classId;
-}

src/main/java/com/imyeyu/api/modules/blog/vo/article/KeywordPage.java

@@ -1,18 +0,0 @@
-package com.imyeyu.api.modules.blog.vo.article;
-
-import jakarta.validation.constraints.NotBlank;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import com.imyeyu.spring.bean.Page;
-
-/**
- * @author 夜雨
- * @since 2023-07-14 17:53
- */
-@Data
-@EqualsAndHashCode(callSuper = true)
-public class KeywordPage extends Page {
-
-	@NotBlank(message = "article.keyword.empty")
-	private String keyword;
-}

src/main/java/com/imyeyu/api/modules/blog/vo/article/LabelPage.java

@@ -1,16 +0,0 @@
-package com.imyeyu.api.modules.blog.vo.article;
-
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import com.imyeyu.spring.bean.Page;
-
-/**
- * @author 夜雨
- * @since 2023-07-14 17:53
- */
-@Data
-@EqualsAndHashCode(callSuper = true)
-public class LabelPage extends Page {
-
-	private long labelId;
-}

src/main/java/com/imyeyu/api/modules/common/bean/CommentSupport.java

@@ -1,16 +0,0 @@
-package com.imyeyu.api.modules.common.bean;
-
-/**
- * 支持评论的实体
- *
- * @author 夜雨
- * @since 2023-10-10 11:39
- */
-public interface CommentSupport {
-
-	/** @return true 为可评论 */
-	boolean canComment();
-
-	/** @return true 为不可评论 */
-	boolean canNotComment();
-}

src/main/java/com/imyeyu/api/modules/common/bean/SettingKey.java

@@ -1,191 +0,0 @@
-package com.imyeyu.api.modules.common.bean;
-
-/**
- * 系统设置
- *
- * @author 夜雨
- * @since 2021-07-20 21:46
- */
-public enum SettingKey {
-
-	// ---------- 通用 ----------
-
-	RUN_ENV,
-
-	PUBLIC_RESOURCES,
-
-	/** 启用注册 */
-	ENABLE_REGISTER,
-
-	/** 启用登录 */
-	ENABLE_LOGIN,
-
-	/** 启用评论 */
-	ENABLE_COMMENT,
-
-	/** 启用测试 */
-	ENABLE_DEBUG,
-
-	/** 启用账号数据更新（User 和 UserProfile） */
-	ENABLE_USER_UPDATE,
-
-	/** 启用灰色滤镜 */
-	ENABLE_GRAY_FILTER,
-
-	TEMP_FILE_PATH,
-
-	// ---------- ICP 备案号 ----------
-
-	ICP_IMYEYU_COM,
-
-	// ---------- 域名 ----------
-
-	DOMAIN_ROOT,
-
-	DOMAIN_API,
-
-	DOMAIN_GIT,
-
-	DOMAIN_BLOG,
-
-	DOMAIN_SPACE,
-
-	DOMAIN_RESOURCE,
-
-	DOMAIN_DOWNLOAD,
-
-	DOMAIN_FOREVER_MC,
-
-	// ---------- ForeverMC ----------
-
-	/** 启用登录服务 */
-	FMC_PLAYER_LOGIN_ENABLE,
-
-	/** 最多绑定玩家数量 */
-	FMC_MAX_BIND,
-
-	/** 闪烁标语 */
-	FMC_SPLASHES,
-
-	/** 启动器背景 */
-	FMC_BG,
-
-	FMC_BGM,
-
-	FMC_BG_SWIPER,
-
-	/** JRE 列表 */
-	FMC_JRE,
-
-	/** 辅助登录模组 */
-	FMC_LOGIN_FABRIC,
-
-	/** 启用图片地图上传 */
-	FMC_ENABLE_IMAGE_MAP_UPLOAD,
-
-	/** 玩家登录令牌有效期（天） */
-	FMC_PLAYER_LOGIN_TOKEN_TTL,
-
-	/** 服务器与数据中心的通信令牌 */
-	FMC_SERVER_TOKEN,
-
-	// ---------- 生存时间 ----------
-
-	TTL_USER_TOKEN,
-
-	TTL_SETTING,
-
-	TTL_MULTILINGUAL,
-
-	// ---------- 多语言翻译 ----------
-
-	MULTILINGUAL_TRANSLATE_API,
-
-	MULTILINGUAL_TRANSLATE_APP_ID,
-
-	MULTILINGUAL_TRANSLATE_KEY,
-
-	// ---------- 账单 ----------
-
-	BILL_API_TOKEN,
-
-	// ---------- Git ----------
-
-	GIT_API,
-
-	GIT_ABOUT_ARTICLE,
-
-	GIT_REPO_PATH,
-
-	// ---------- 远程音乐 ----------
-
-	MUSIC_MAX_FRAME_LENGTH,
-
-	MUSIC_PLAYER_PORT,
-
-	MUSIC_PLAYER_IP,
-
-	MUSIC_CONTROLLER_PORT,
-
-	MUSIC_CONTROLLER_IP,
-
-	MUSIC_CONTROLLER_URI,
-
-	// ---------- 日记 ----------
-
-	JOURNAL_KEY,
-
-	JOURNAL_APP_ID,
-
-	JOURNAL_APP_SECRET,
-
-	JOURNAL_MEMO,
-
-	JOURNAL_OPEN_ID_WHITE_LIST,
-
-	// ---------- 临时文件 ----------
-
-	/** 临时文件最小缓存时间 */
-	TEMP_FILE_TTL_MIN,
-
-	/** 临时文件最长缓存时间 */
-	TEMP_FILE_TTL_MAX,
-
-	/** 临时文件默认缓存时间 */
-	TEMP_FILE_TTL_DEFAULT,
-
-	/** 已过期的临时文件保留时间 */
-	TEMP_FILE_RESIDUE_TIME,
-
-	/** 每个 IP 限制有效临时文件容量 */
-	TEMP_FILE_LIMIT,
-
-	// ---------- 系统 ----------
-
-	SYSTEM_FILE_BASE,
-
-	SYSTEM_FILE_TYPE,
-
-	SYSTEM_FILE_SYNC,
-
-	/** 文件过滤（通过密钥类型） */
-	SYSTEM_FILE_FILTER,
-
-	SYSTEM_STATUS_RATE,
-
-	SYSTEM_STATUS_LIMIT,
-
-	SYSTEM_STATUS_NETWORK_MAC,
-
-	SYSTEM_TERMINAL_TTL,
-
-	SYSTEM_TERMINAL_FILTERS,
-
-	/** 一般密钥 */
-	SYSTEM_API_KEY,
-
-	/** 超级密钥 */
-	SYSTEM_API_SUPER_KEY,
-
-	SYSTEM_REBOOT_COMMAND,
-}

src/main/java/com/imyeyu/api/modules/common/bean/SettingModule.java

@@ -0,0 +1,50 @@
+package com.imyeyu.api.modules.common.bean;
+
+import com.imyeyu.api.modules.common.entity.Setting;
+import com.imyeyu.java.bean.timi.TimiCode;
+import com.imyeyu.java.bean.timi.TimiException;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * 设置模块
+ *
+ * @author 夜雨
+ * @since 2026-04-24 00:59
+ */
+@Getter
+@AllArgsConstructor
+public enum SettingModule {
+
+	COMMON(Setting.Module.Common.class),
+
+	DOMAIN(Setting.Module.Domain.class),
+
+	FOREVER_MC(Setting.Module.ForeverMC.class),
+
+	MULTILINGUAL(Setting.Module.Multilingual.class),
+
+	GITEA(Setting.Module.Gitea.class),
+
+	MUSIC(Setting.Module.Music.class),
+
+	JOURNAL(Setting.Module.Journal.class),
+
+	TEMP_FILE(Setting.Module.TempFile.class),
+
+	SYSTEM(Setting.Module.System.class),
+
+	SYSTEM_STATUS(Setting.Module.SystemStatus.class);
+
+	/** 模块枚举类 */
+	final Class<? extends Enum<?>> clazz;
+
+	public static <T extends Enum<?>> SettingModule fromClass(Class<T> clazz) {
+		for (SettingModule value : values()) {
+			if (value.clazz.equals(clazz)) {
+				return value;
+			}
+		}
+		throw new TimiException(TimiCode.ERROR, "not found System Module: %s".formatted(clazz.getName()));
+	}
+}

src/main/java/com/imyeyu/api/modules/common/bean/attachment/AccessKey.java

@@ -0,0 +1,28 @@
+package com.imyeyu.api.modules.common.bean.attachment;
+
+import lombok.Data;
+
+/**
+ * 附件访问密钥 VO
+ *
+ * @author 夜雨
+ * @since 2026-01-13 10:05
+ */
+@Data
+public class AccessKey {
+
+	/** 访问密钥 */
+	private String value;
+
+	/** 附件 ID */
+	private String attachmentId;
+
+	/** true 为一次性访问 */
+	private boolean isDisposable;
+
+	/** 过期时间戳 */
+	private Long expiredAt;
+
+	/** 创建时间戳 */
+	private Long createdAt;
+}

src/main/java/com/imyeyu/api/modules/common/bean/attachment/MediaAttach.java

@@ -1,4 +1,4 @@
-package com.imyeyu.api.modules.common.bean;
+package com.imyeyu.api.modules.common.bean.attachment;
 
 /**
  * @author 夜雨

src/main/java/com/imyeyu/api/modules/common/bean/attachment/Metadata.java

@@ -1,4 +1,4 @@
-package com.imyeyu.api.modules.common.bean;
+package com.imyeyu.api.modules.common.bean.attachment;
 
 import lombok.Data;
 import lombok.EqualsAndHashCode;
@@ -33,10 +33,16 @@ public class Metadata {
 	@EqualsAndHashCode(callSuper = true)
 	public static class ThumbImage extends Image {
 
-		private long sourceId;
+		private String sourceId;
 
 		private String sourceMongoId;
 
 		private String sourceMimeType;
+
+		/** 请求宽度（缓存键之一，null 表示未指定） */
+		private Integer requestWidth;
+
+		/** 请求高度（缓存键之一，null 表示未指定） */
+		private Integer requestHeight;
 	}
 }

src/main/java/com/imyeyu/api/modules/common/bean/attachment/SettingSupport.java

@@ -0,0 +1,18 @@
+package com.imyeyu.api.modules.common.bean.attachment;
+
+import com.imyeyu.api.modules.common.entity.Setting;
+
+import java.util.List;
+
+/**
+ *
+ *
+ * @author 夜雨
+ * @since 2026-05-13 17:27
+ */
+public interface SettingSupport {
+
+	String getId();
+
+	List<Setting> getSettingList();
+}

src/main/java/com/imyeyu/api/modules/common/bean/attachment/TempFileMetaData.java

@@ -0,0 +1,25 @@
+package com.imyeyu.api.modules.common.bean.attachment;
+
+import lombok.Data;
+
+/**
+ * 临时文件元数据
+ *
+ * @author 夜雨
+ * @since 2025-09-27 01:47
+ */
+@Data
+public class TempFileMetaData {
+
+	/** 附件 ID */
+	private String id;
+
+	/** 文件名 */
+	private String name;
+
+	/** 原始文件名 */
+	private String originalName;
+
+	/** 储存 ID */
+	private String mongoId;
+}

src/main/java/com/imyeyu/api/modules/common/controller/AttachmentController.java

@@ -0,0 +1,281 @@
+package com.imyeyu.api.modules.common.controller;
+
+import com.imyeyu.api.modules.common.entity.Attachment;
+import com.imyeyu.api.modules.common.service.AttachmentService;
+import com.imyeyu.api.modules.common.service.TempFileService;
+import com.imyeyu.api.modules.common.vo.attach.BizDeleteReq;
+import com.imyeyu.api.modules.common.vo.attach.BizUpdateReq;
+import com.imyeyu.api.modules.common.vo.attach.TempFileResp;
+import com.imyeyu.java.TimiJava;
+import com.imyeyu.network.Network;
+import com.imyeyu.spring.TimiSpring;
+import com.imyeyu.spring.annotation.AOPLog;
+import com.imyeyu.spring.annotation.IgnoreGlobalReturn;
+import com.imyeyu.spring.annotation.RequestRateLimit;
+import com.imyeyu.spring.bean.Page;
+import com.imyeyu.spring.bean.PageResult;
+import com.imyeyu.utils.Time;
+import jakarta.servlet.http.HttpServletResponse;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.MediaType;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.io.UnsupportedEncodingException;
+import java.util.List;
+
+///
+///
+/// @author 夜雨
+/// @since 2026-07-27 19:26
+@Slf4j
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/attach")
+public class AttachmentController {
+
+	private final TempFileService tempFileService;
+	private final AttachmentService service;
+
+	/**
+	 * 查询附件详情
+	 *
+	 * @param id 附件 ID
+	 * @return 附件详情
+	 */
+	@RequestRateLimit
+	@PostMapping("/detail")
+	public Attachment detail(@RequestParam String id) {
+		return service.get(id);
+	}
+
+	/**
+	 * 创建附件
+	 *
+	 * @param attachment 附件
+	 * @return 创建结果
+	 */
+	@AOPLog
+	@RequestRateLimit
+	@PostMapping(value = "/create", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
+	public Attachment create(Attachment attachment) {
+		service.create(attachment);
+		return attachment;
+	}
+
+	/**
+	 * 更新附件
+	 *
+	 * @param attachment 附件
+	 */
+	@AOPLog
+	@RequestRateLimit
+	@PostMapping(value = "/update", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
+	public void update(Attachment attachment) {
+		service.update(attachment);
+	}
+
+	/**
+	 * 删除附件
+	 *
+	 * @param id 附件 ID
+	 */
+	@AOPLog
+	@RequestRateLimit
+	@PostMapping("/delete")
+	public void delete(@RequestParam String id) {
+		service.delete(id);
+	}
+
+	/**
+	 * 按业务查询单个附件
+	 *
+	 * @param bizType 业务类型
+	 * @param bizId   业务 ID
+	 * @return 附件详情
+	 */
+	@RequestRateLimit
+	@GetMapping("/detail/byBiz")
+	public Attachment detailByBiz(@RequestParam Attachment.BizType bizType, @RequestParam String bizId) {
+		return service.getByBizId(bizType, bizId);
+	}
+
+	/**
+	 * 按业务和附件类型查询单个附件
+	 *
+	 * @param bizType    业务类型
+	 * @param bizId      业务 ID
+	 * @param attachType 附件类型
+	 * @return 附件详情
+	 */
+	@RequestRateLimit
+	@GetMapping("/detail/byAttachType")
+	public Attachment detailByAttachType(
+		@RequestParam Attachment.BizType bizType,
+		@RequestParam String bizId,
+		@RequestParam String attachType
+	) {
+		return service.getByAttachType(bizType, bizId, attachType);
+	}
+
+	/**
+	 * 按业务查询附件列表
+	 *
+	 * @param bizType        业务类型
+	 * @param bizId          业务 ID
+	 * @param attachTypeList 附件类型列表
+	 * @return 附件列表
+	 */
+	@RequestRateLimit
+	@GetMapping("/list/biz")
+	public List<Attachment> listByBiz(
+		@RequestParam Attachment.BizType bizType,
+		@RequestParam String bizId,
+		@RequestParam(required = false) List<String> attachTypeList
+	) {
+		List<String> types = TimiJava.defaultIfNull(attachTypeList, List.of());
+		return service.listByBizId(bizType, bizId, types.toArray(String[]::new));
+	}
+
+	/**
+	 * 按业务统计附件数量
+	 *
+	 * @param bizType        业务类型
+	 * @param bizId          业务 ID
+	 * @param attachTypeList 附件类型列表
+	 * @return 附件数量
+	 */
+	@RequestRateLimit
+	@GetMapping("/count/biz")
+	public long countByBiz(
+		@RequestParam Attachment.BizType bizType,
+		@RequestParam String bizId,
+		@RequestParam(required = false) List<String> attachTypeList
+	) {
+		List<String> types = TimiJava.defaultIfNull(attachTypeList, List.of());
+		return service.countByBizId(bizType, bizId, types.toArray(String[]::new));
+	}
+
+	/**
+	 * 按业务分页查询附件
+	 *
+	 * @param bizType        业务类型
+	 * @param bizId          业务 ID
+	 * @param attachTypeList 附件类型列表
+	 * @param page           分页参数
+	 * @return 分页结果
+	 */
+	@RequestRateLimit
+	@PostMapping("/page/biz")
+	public PageResult<Attachment> pageByBiz(
+		@RequestParam Attachment.BizType bizType,
+		@RequestParam String bizId,
+		@RequestParam(required = false) List<String> attachTypeList,
+		@RequestBody Page<Attachment> page
+	) {
+		return service.pageByBizId(bizType, bizId, attachTypeList, page);
+	}
+
+	/**
+	 * 按业务差分更新附件
+	 *
+	 * @param req 更新请求
+	 */
+	@AOPLog
+	@RequestRateLimit
+	@PostMapping("/update/biz")
+	public void updateByBiz(@RequestBody BizUpdateReq req) {
+		service.updateByBiz(req);
+	}
+
+	/**
+	 * 按业务删除全部附件
+	 *
+	 * @param req 删除请求
+	 */
+	@AOPLog
+	@RequestRateLimit
+	@PostMapping("/delete/biz")
+	public void deleteByBiz(@RequestBody BizDeleteReq req) {
+		service.deleteByBiz(req);
+	}
+
+	@AOPLog
+	@RequestRateLimit
+	@IgnoreGlobalReturn
+	@GetMapping({"/read/{id}", "/download/{id}"})
+	public void readById(@PathVariable String id, @RequestParam(required = false) Integer thumbWidth, @RequestParam(required = false) Integer thumbHeight) throws UnsupportedEncodingException {
+		HttpServletResponse resp = TimiSpring.getResponse();
+		Attachment attach = service.get(id);
+		if (attach == null) {
+			resp.setStatus(HttpServletResponse.SC_NOT_FOUND);
+			return;
+		}
+		responseAttachment(attach, thumbWidth, thumbHeight);
+	}
+
+	@AOPLog
+	@PostMapping("/temp/upload")
+	public List<TempFileResp> upload(@RequestParam("file") List<MultipartFile> files, @RequestParam(value = "ttl", required = false) String ttl) {
+		return tempFileService.create(files, Time.D);
+	}
+
+	@AOPLog
+	@RequestRateLimit
+	@IgnoreGlobalReturn
+	@GetMapping({"/temp/read", "/temp/download"})
+	public void read(@RequestParam String id) throws UnsupportedEncodingException {
+		HttpServletResponse resp = TimiSpring.getResponse();
+		Attachment attach = service.get(id);
+		if (TimiSpring.getRequest().getRequestURI().endsWith("/download")) {
+			resp.setHeader("Content-Disposition", Network.getFileDownloadHeader(attach.getName()));
+		}
+		response(attach);
+	}
+
+	private void responseAttachment(Attachment attach, Integer thumbWidth, Integer thumbHeight) throws UnsupportedEncodingException {
+		HttpServletResponse resp = TimiSpring.getResponse();
+		if (attach != null && TimiSpring.getRequest().getRequestURI().endsWith("/download") && attach.getName() != null) {
+			resp.setHeader("Content-Disposition", Network.getFileDownloadHeader(attach.getName()));
+		}
+		responseThumb(attach, thumbWidth, thumbHeight);
+	}
+
+	protected void responseThumb(Attachment attachment, Integer thumbWidth, Integer thumbHeight) {
+		HttpServletResponse resp = TimiSpring.getResponse();
+		if (TimiJava.isEmpty(attachment)) {
+			resp.setStatus(HttpServletResponse.SC_NOT_FOUND);
+			return;
+		}
+		if (thumbWidth == null && thumbHeight == null) {
+			// 原图
+			response(attachment);
+			return;
+		}
+		// 缩略图
+		Attachment thumb = service.fetchThumb(attachment, thumbWidth, thumbHeight);
+		response(TimiJava.defaultIfNull(thumb, attachment));
+	}
+
+	protected void response(Attachment attachment) {
+		HttpServletResponse resp = TimiSpring.getResponse();
+		try {
+			if (TimiJava.isEmpty(attachment)) {
+				resp.setStatus(HttpServletResponse.SC_NOT_FOUND);
+				return;
+			}
+			resp.setContentType(attachment.getMimeType());
+			attachment.doResponse();
+		} catch (Exception e) {
+			log.error("response attachment error", e);
+			resp.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
+		}
+	}
+}

src/main/java/com/imyeyu/api/modules/common/controller/CommentController.java

@@ -1,87 +1,264 @@
 package com.imyeyu.api.modules.common.controller;
 
-import com.imyeyu.api.annotation.CaptchaValid;
-import com.imyeyu.api.annotation.EnableSetting;
-import com.imyeyu.api.bean.CaptchaFrom;
-import com.imyeyu.api.modules.common.bean.SettingKey;
+import com.fasterxml.jackson.annotation.JsonView;
 import com.imyeyu.api.modules.common.entity.Comment;
-import com.imyeyu.api.modules.common.entity.CommentReply;
-import com.imyeyu.api.modules.common.service.CommentReplyService;
+import com.imyeyu.api.modules.user.entity.UserBehaviorRecord;
 import com.imyeyu.api.modules.common.service.CommentService;
+import com.imyeyu.api.modules.common.vo.comment.CommentCreateReq;
+import com.imyeyu.api.modules.common.vo.comment.CommentLayerQueryReq;
+import com.imyeyu.api.modules.common.vo.comment.CommentLayerResp;
+import com.imyeyu.api.modules.common.vo.comment.CommentNodeResp;
+import com.imyeyu.api.modules.common.vo.comment.CommentReplyReq;
+import com.imyeyu.api.modules.common.vo.comment.CommentThreadResp;
+import com.imyeyu.api.modules.common.vo.comment.FlatCommentListResp;
+import com.imyeyu.api.modules.common.vo.comment.NestedCommentListResp;
+import com.imyeyu.spring.TimiSpring;
 import com.imyeyu.spring.annotation.AOPLog;
 import com.imyeyu.spring.annotation.RequestRateLimit;
-import com.imyeyu.spring.bean.CaptchaData;
 import com.imyeyu.spring.bean.Page;
 import com.imyeyu.spring.bean.PageResult;
+import com.imyeyu.spring.util.ResponseView;
 import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
 
 /**
  * 评论操作接口
- * <p>*评论回复只依赖评论而不含业务关联，评论有关联业务，所以此接口是通用接口
  *
  * @author 夜雨
  * @since 2021-02-23 21:36
  */
 @Slf4j
+@Validated
 @RestController
 @RequiredArgsConstructor
 @RequestMapping("/comment")
 public class CommentController {
 
 	private final CommentService service;
-	private final CommentReplyService replyService;
 
+	/**
+	 * 创建主评论
+	 *
+	 * @param req 创建请求
+	 * @return 评论树详情
+	 */
 	@AOPLog
-	@CaptchaValid(CaptchaFrom.COMMENT)
-	@EnableSetting(value = SettingKey.ENABLE_COMMENT, message = "comment.off_service")
+	@JsonView(ResponseView.Public.class)
 	@RequestRateLimit
 	@PostMapping("/create")
-	public void create(@Valid @RequestBody CaptchaData<Comment> captchaData) {
-		service.create(captchaData.getData());
-	}
-
-	@RequestRateLimit
-	@PostMapping("/list")
-	public PageResult<Comment> list(@Valid @RequestBody Page<Comment> page) {
-		return service.page(page);
+	public Comment create(@RequestBody @Valid CommentCreateReq req) {
+		Comment entity = new Comment();
+		entity.setBizType(req.getBizType());
+		entity.setBizId(req.getBizId());
+		entity.setUserId(req.getUserId());
+		entity.setUserNick(req.getUserNick());
+		entity.setContent(req.getContent());
+		entity.setIp(TimiSpring.getRequestIP());
+		service.create(entity);
+		return service.detailTree(entity.getId(), req.getUserId());
 	}
 
 	/**
-	 * 创建评论回复
+	 * 回复评论
 	 *
-	 * @param request 回复数据
+	 * @param req 回复请求
+	 * @return 评论树详情
 	 */
 	@AOPLog
-	@CaptchaValid(CaptchaFrom.COMMENT_REPLY)
-	@EnableSetting(value = SettingKey.ENABLE_COMMENT, message = "comment.off_service")
+	@JsonView(ResponseView.Public.class)
 	@RequestRateLimit
-	@PostMapping("/reply/create")
-	public void createReply(@Valid @RequestBody CaptchaData<CommentReply> request) {
-		replyService.create(request.getData());
+	@PostMapping("/reply")
+	public Comment reply(@RequestBody @Valid CommentReplyReq req) {
+		Comment entity = new Comment();
+		entity.setParentId(req.getParentId());
+		entity.setUserId(req.getUserId());
+		entity.setUserNick(req.getUserNick());
+		entity.setContent(req.getContent());
+		entity.setIp(TimiSpring.getRequestIP());
+		service.create(entity);
+		return service.detailTree(entity.getId(), req.getUserId());
 	}
 
 	/**
-	 * 获取回复列表
+	 * 删除当前用户自己的评论
 	 *
-	 * @param page 页面参数
-	 * @return 回复列表
+	 * @param id     评论 ID
+	 * @param userId 用户 ID
 	 */
+	@AOPLog
 	@RequestRateLimit
-	@RequestMapping("/reply/list")
-	public PageResult<CommentReply> pageReplies(@Valid @RequestBody Page<CommentReply> page) {
-		// 通用接口，只允许查询评论的回复
-		CommentReply example = new CommentReply();
-		if (page.getEqualsExample() != null) {
-			example.setCommentId(page.getEqualsExample().getCommentId());
-		}
-		page.setEqualsExample(example);
-		page.setLikesExample(null);
-		return replyService.page(page);
+	@PostMapping("/delete")
+	public void delete(@RequestParam String id, @RequestParam String userId) {
+		service.deleteOwned(id, userId);
+	}
+
+	/**
+	 * 点赞评论
+	 *
+	 * @param commentId 评论 ID
+	 * @param userId    用户 ID
+	 */
+	@AOPLog
+	@RequestRateLimit
+	@PostMapping("/like")
+	public void like(@RequestParam String commentId, @RequestParam String userId) {
+		service.like(commentId, userId);
+	}
+
+	/**
+	 * 不喜欢评论
+	 *
+	 * @param commentId 评论 ID
+	 * @param userId    用户 ID
+	 */
+	@AOPLog
+	@RequestRateLimit
+	@PostMapping("/unlike")
+	public void unlike(@RequestParam String commentId, @RequestParam String userId) {
+		service.unlike(commentId, userId);
+	}
+
+	/**
+	 * 查询用户点赞评论记录
+	 *
+	 * @param page   分页参数
+	 * @param userId 用户 ID
+	 * @return 点赞评论记录分页
+	 */
+	@JsonView(ResponseView.Public.class)
+	@RequestRateLimit
+	@PostMapping("/like/list")
+	public PageResult<UserBehaviorRecord> listLikedRecord(@RequestBody Page<UserBehaviorRecord> page, @RequestParam String userId) {
+		return service.listLikedRecord(page, userId);
+	}
+
+	/**
+	 * 查询扁平主评论列表
+	 *
+	 * @param bizType       业务类型
+	 * @param bizId         业务 ID
+	 * @param offset        起始偏移量
+	 * @param currentUserId 当前用户 ID，可为 null
+	 * @return 扁平主评论列表
+	 */
+	@JsonView(ResponseView.Public.class)
+	@RequestRateLimit
+	@GetMapping("/flat/list")
+	public FlatCommentListResp listFlatRoot(
+		@RequestParam String bizType,
+		@RequestParam String bizId,
+		@RequestParam(defaultValue = "0") int offset,
+		@RequestParam(required = false) String currentUserId
+	) {
+		return service.listFlatRoot(bizType, bizId, offset, currentUserId);
+	}
+
+	/**
+	 * 查询扁平评论线程
+	 *
+	 * @param commentId     评论 ID
+	 * @param offset        起始偏移量
+	 * @param currentUserId 当前用户 ID，可为 null
+	 * @return 评论线程
+	 */
+	@JsonView(ResponseView.Public.class)
+	@RequestRateLimit
+	@GetMapping("/flat/thread")
+	public CommentThreadResp getFlatThread(
+		@RequestParam String commentId,
+		@RequestParam(defaultValue = "0") int offset,
+		@RequestParam(required = false) String currentUserId
+	) {
+		return service.getUserThread(commentId, offset, currentUserId);
+	}
+
+	/**
+	 * 查询层级主评论列表
+	 *
+	 * @param bizType       业务类型
+	 * @param bizId         业务 ID
+	 * @param offset        起始偏移量
+	 * @param currentUserId 当前用户 ID，可为 null
+	 * @return 层级主评论列表
+	 */
+	@JsonView(ResponseView.Public.class)
+	@RequestRateLimit
+	@GetMapping("/nested/list")
+	public NestedCommentListResp listNestedRoot(
+		@RequestParam String bizType,
+		@RequestParam String bizId,
+		@RequestParam(defaultValue = "0") int offset,
+		@RequestParam(required = false) String currentUserId
+	) {
+		return service.listNestedRoot(bizType, bizId, offset, currentUserId);
+	}
+
+	/**
+	 * 查询评论节点
+	 *
+	 * @param commentId     评论 ID
+	 * @param currentUserId 当前用户 ID，可为 null
+	 * @return 评论节点
+	 */
+	@JsonView(ResponseView.Public.class)
+	@RequestRateLimit
+	@GetMapping("/nested/detail")
+	public CommentNodeResp getNestedDetail(@RequestParam String commentId, @RequestParam(required = false) String currentUserId) {
+		return service.getUserNode(commentId, currentUserId);
+	}
+
+	/**
+	 * 查询直属子评论分页
+	 *
+	 * @param commentId     评论 ID
+	 * @param offset        起始偏移量
+	 * @param currentUserId 当前用户 ID，可为 null
+	 * @return 子评论分页
+	 */
+	@JsonView(ResponseView.Public.class)
+	@RequestRateLimit
+	@GetMapping("/nested/children")
+	public CommentLayerResp getNestedChildren(
+		@RequestParam String commentId,
+		@RequestParam(defaultValue = "0") int offset,
+		@RequestParam(required = false) String currentUserId
+	) {
+		return service.getUserChildren(commentId, offset, currentUserId);
+	}
+
+	/**
+	 * 查询单层评论列表
+	 *
+	 * @param req           查询请求
+	 * @param currentUserId 当前用户 ID，可为 null
+	 * @return 评论层
+	 */
+	@JsonView(ResponseView.Public.class)
+	@RequestRateLimit
+	@PostMapping("/layer/list")
+	public CommentLayerResp listLayer(@RequestBody CommentLayerQueryReq req, @RequestParam(required = false) String currentUserId) {
+		return service.listSdkLayer(req, currentUserId);
+	}
+
+	/**
+	 * 查询评论树详情
+	 *
+	 * @param id            评论 ID
+	 * @param currentUserId 当前用户 ID，可为 null
+	 * @return 评论树详情
+	 */
+	@JsonView(ResponseView.Public.class)
+	@RequestRateLimit
+	@GetMapping("/detail/tree")
+	public Comment detailTree(@RequestParam String id, @RequestParam(required = false) String currentUserId) {
+		return service.detailTree(id, currentUserId);
 	}
 }

src/main/java/com/imyeyu/api/modules/common/controller/CommonController.java

@@ -1,78 +1,23 @@
 package com.imyeyu.api.modules.common.controller;
 
-import com.fasterxml.jackson.core.JsonProcessingException;
-import com.fasterxml.jackson.core.type.TypeReference;
-import com.fasterxml.jackson.databind.ObjectMapper;
-import com.imyeyu.api.bean.CaptchaFrom;
-import com.imyeyu.api.modules.common.bean.ImageType;
-import com.imyeyu.api.modules.common.bean.SettingKey;
-import com.imyeyu.api.modules.common.entity.Attachment;
-import com.imyeyu.api.modules.common.entity.Setting;
-import com.imyeyu.api.modules.common.entity.Task;
-import com.imyeyu.api.modules.common.entity.Template;
-import com.imyeyu.api.modules.common.entity.Version;
-import com.imyeyu.api.modules.common.service.AttachmentService;
-import com.imyeyu.api.modules.common.service.ClipboardService;
-import com.imyeyu.api.modules.common.service.FeedbackService;
-import com.imyeyu.api.modules.common.service.SettingService;
-import com.imyeyu.api.modules.common.service.TaskService;
-import com.imyeyu.api.modules.common.service.TempFileService;
-import com.imyeyu.api.modules.common.service.TemplateService;
-import com.imyeyu.api.modules.common.service.VersionService;
-import com.imyeyu.api.modules.common.vo.ClipboardRequest;
-import com.imyeyu.api.modules.common.vo.FeedbackRequest;
-import com.imyeyu.api.modules.common.vo.TempFileResponse;
-import com.imyeyu.api.modules.system.util.ResourceHandler;
 import com.imyeyu.api.util.CaptchaManager;
 import com.imyeyu.io.IO;
-import com.imyeyu.java.TimiJava;
 import com.imyeyu.java.bean.timi.TimiCode;
 import com.imyeyu.java.bean.timi.TimiException;
-import com.imyeyu.java.ref.Ref;
-import com.imyeyu.network.Network;
 import com.imyeyu.spring.TimiSpring;
 import com.imyeyu.spring.annotation.AOPLog;
-import com.imyeyu.spring.annotation.IgnoreGlobalReturn;
-import com.imyeyu.spring.annotation.RequestRateLimit;
-import com.imyeyu.spring.bean.CaptchaData;
-import com.imyeyu.spring.bean.RequestRange;
-import com.mongodb.client.gridfs.GridFSBucket;
-import com.mongodb.client.gridfs.GridFSDownloadStream;
-import com.mongodb.client.gridfs.model.GridFSFile;
-import jakarta.servlet.http.HttpServletRequest;
+import com.imyeyu.utils.Decoder;
+import jakarta.servlet.ServletOutputStream;
 import jakarta.servlet.http.HttpServletResponse;
-import jakarta.validation.Valid;
-import jakarta.validation.constraints.NotBlank;
-import jakarta.validation.constraints.NotNull;
-import lombok.Cleanup;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
-import org.apache.tika.Tika;
-import org.springframework.data.mongodb.gridfs.GridFsResource;
-import org.springframework.http.MediaType;
 import org.springframework.validation.annotation.Validated;
 import org.springframework.web.bind.annotation.GetMapping;
-import org.springframework.web.bind.annotation.PathVariable;
-import org.springframework.web.bind.annotation.PostMapping;
-import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
-import org.springframework.web.multipart.MultipartFile;
-import org.springframework.web.servlet.mvc.method.annotation.SseEmitter;
-import org.yaml.snakeyaml.Yaml;
 
 import javax.imageio.ImageIO;
-import java.awt.Graphics2D;
-import java.awt.RenderingHints;
-import java.awt.image.BufferedImage;
-import java.io.ByteArrayInputStream;
 import java.io.IOException;
-import java.nio.charset.StandardCharsets;
-import java.util.ArrayList;
-import java.util.List;
-import java.util.Map;
-import java.util.stream.Collectors;
 
 /**
  * 系统接口
@@ -87,20 +32,7 @@ import java.util.stream.Collectors;
 @RequestMapping("/")
 public class CommonController {
 
-	private final TaskService taskService;
-	private final VersionService versionService;
-	private final SettingService settingService;
-	private final FeedbackService feedbackService;
-	private final TemplateService templateService;
-	private final TempFileService tempFileService;
-	private final AttachmentService attachmentService;
-	private final ClipboardService clipboardService;
-
-	private final ObjectMapper jackson;
-	private final Yaml yaml;
-	private final GridFSBucket gridFSBucket;
 	private final CaptchaManager captchaManager;
-	private final ResourceHandler resourceHandler;
 
 	@AOPLog
 	@RequestMapping("")
@@ -108,399 +40,56 @@ public class CommonController {
 		return "IT WORKING! " + TimiSpring.getRequestIP();
 	}
 
-	/**
-	 * 获取共享剪切板内容
-	 *
-	 * @param id 会话 ID
-	 * @return 剪切板内容
-	 */
-	@AOPLog
-	@RequestRateLimit
-	@GetMapping("/clipboard/{id}")
-	public String clipboardGet(@Valid @NotBlank @PathVariable("id") String id) {
-		return clipboardService.getContent(id);
-	}
-
-	/**
-	 * 设置共享剪切板内容
-	 *
-	 * @param id      会话 ID
-	 * @param request 请求内容
-	 */
-	@AOPLog
-	@RequestRateLimit
-	@PostMapping("/clipboard/{id}")
-	public void clipboardSet(@Valid @NotBlank @PathVariable("id") String id, @Valid @RequestBody ClipboardRequest request) {
-		clipboardService.setContent(id, request.getContent());
-	}
-
-	/**
-	 * 订阅共享剪切板实时更新
-	 *
-	 * @param id 会话 ID
-	 * @return SSE 发射器
-	 */
-	@AOPLog
-	@IgnoreGlobalReturn
-	@GetMapping(value = "/clipboard/stream/{id}", produces = MediaType.TEXT_EVENT_STREAM_VALUE)
-	public SseEmitter clipboardStream(@Valid @NotBlank @PathVariable("id") String id) {
-		return clipboardService.subscribe(id);
-	}
-
 	/**
 	 * 获取验证码
 	 *
-	 * @param width    宽度
-	 * @param height   高度
-	 * @param from     来源
-	 * @param response 返回对象
+	 * @param width  宽度
+	 * @param height 高度
+	 * @return Base64 编码的图形验证码和唯一识别 ID
 	 */
-	@IgnoreGlobalReturn
 	@GetMapping("/captcha")
-	public void captcha(int width, int height, CaptchaFrom from, HttpServletResponse response) {
-		// 返回图像流
-		response.setHeader("Pragma", "no-cache");
-		response.setHeader("Cache-Control", "no-cache"); // 禁止缓存
-		response.setDateHeader("Expires", -1);
-		response.setContentType("image/jpg");
+	public CaptchaManager.Result captcha(Integer width, Integer height) {
+		TimiException.requiredTrue(width != null && 64 < width, "not found width or less than 64");
+		TimiException.requiredTrue(height != null && 19 < height, "not found height or less than 19");
+		return captchaManager.generate(width, height);
+	}
+
+	/**
+	 * 获取验证码（返回图形数据流，唯一识别 ID 在返回头 X-Captcha-ID）
+	 *
+	 * @param width  宽度
+	 * @param height 高度
+	 */
+	@GetMapping("/captcha/img")
+	public void captchaImg(Integer width, Integer height, HttpServletResponse resp) {
+		CaptchaManager.Result result = captchaManager.generate(width, height);
+		resp.setHeader("Pragma", "no-cache");
+		resp.setHeader("Cache-Control", "no-cache");
+		resp.setHeader("X-Captcha-ID", result.id());
+		resp.setHeader("Access-Control-Expose-Headers", "X-Captcha-ID");
+		resp.setDateHeader("Expires", -1);
+		resp.setContentType("image/png");
 		try {
-			// 宽度
+			ServletOutputStream os = resp.getOutputStream();
 			if (width < 64) {
-				ImageIO.write(captchaManager.error(TimiCode.ARG_BAD), "jpg", response.getOutputStream());
+				ImageIO.write(captchaManager.error(TimiCode.ARG_BAD), "png", os);
 				return;
 			}
 			// 高度
 			if (height < 19) {
-				ImageIO.write(captchaManager.error(TimiCode.ARG_BAD), "jpg", response.getOutputStream());
-				return;
-			}
-			// 来自
-			if (TimiJava.isEmpty(from)) {
-				ImageIO.write(captchaManager.error(TimiCode.ARG_MISS), "jpg", response.getOutputStream());
+				ImageIO.write(captchaManager.error(TimiCode.ARG_BAD), "png", os);
 				return;
 			}
 			// 输出图像流
-			ImageIO.write(captchaManager.generate(from, width, height), "jpg", response.getOutputStream());
-		} catch (Exception e) {
-			log.error("CommonController.getCaptcha", e);
+			IO.toOutputStream(os, Decoder.base64(result.data().split(",")[1]));
+		} catch (IOException e) {
+			log.error("captcha img error", e);
+			resp.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
 			try {
-				ImageIO.write(captchaManager.error(TimiCode.ERROR), "jpg", response.getOutputStream());
+				ImageIO.write(captchaManager.error(TimiCode.ERROR), "png", resp.getOutputStream());
 			} catch (IOException subE) {
 				log.error("write error image fail", subE);
 			}
 		}
 	}
-
-	/**
-	 * 获取软件最新版本状态
-	 *
-	 * @param name 软件名称
-	 * @return 最新版本状态
-	 * @deprecated 兼容旧程序
-	 */
-	@AOPLog
-	@GetMapping("/versions/{name}")
-	@Deprecated
-	public Version versions(@Valid @NotBlank @PathVariable("name") String name) {
-		return versionService.getByName(name);
-	}
-
-	/**
-	 * 获取软件最新版本状态
-	 *
-	 * @param name 软件名称
-	 * @return 最新版本状态
-	 */
-	@AOPLog
-	@GetMapping("/version/{name}")
-	public Version version(@Valid @NotBlank @PathVariable("name") String name) {
-		return versionService.getByName(name);
-	}
-
-	@AOPLog
-	@RequestRateLimit
-	@PostMapping("/feedback")
-	public void createFeedback(@Valid @NotNull @RequestBody CaptchaData<FeedbackRequest> request) {
-		captchaManager.test(request.getCaptcha(), request.getCaptchaId());
-		feedbackService.create(request.getData());
-	}
-
-	/** @return 公开任务信息 */
-	@AOPLog
-	@RequestRateLimit
-	@GetMapping("/tasklist")
-	public List<Task> getTasks() {
-		return taskService.listAll4Public();
-	}
-
-	@RequestRateLimit
-	@GetMapping("/template")
-	public String viewTemplate(@RequestParam Template.BizType bizType, @RequestParam String bizCode) {
-		return templateService.get(bizType, bizCode).getData();
-	}
-
-	@RequestRateLimit
-	@GetMapping("/setting/{key}")
-	public String settingByKey(@PathVariable("key") String key, @RequestParam(value = "as", required = false) Setting.Type asType) throws JsonProcessingException {
-		Setting setting = settingService.getByKey(SettingKey.valueOf(key.toUpperCase()));
-		if (setting.isPrivate()) {
-			throw new TimiException(TimiCode.PERMISSION_ERROR);
-		}
-		String result = setting.getValue();
-		if (asType == null) {
-			return result;
-		}
-		switch (asType) {
-			case JSON -> {
-				if (setting.getType() == Setting.Type.YAML) {
-					Map<String, Object> obj = yaml.load(setting.getValue());
-					result = jackson.writeValueAsString(obj);
-				}
-			}
-			case YAML -> {
-				if (setting.getType() == Setting.Type.JSON) {
-					Map<String, Object> obj = jackson.readValue(setting.getValue(), new TypeReference<>() {});
-					result = yaml.dump(obj);
-				}
-			}
-		}
-		return result;
-	}
-
-	@RequestRateLimit
-	@PostMapping("/setting/map")
-	public Map<SettingKey, String> mapSettingByKeys(@RequestBody Map<SettingKey, Map<String, Object>> settingMap) throws JsonProcessingException {
-		List<Setting> result = settingService.listByKeys(new ArrayList<>(settingMap.keySet()));
-		for (int i = 0; i < result.size(); i++) {
-			Setting setting = result.get(i);
-			if (setting.isPrivate()) {
-				throw new TimiException(TimiCode.PERMISSION_ERROR);
-			}
-			Map<String, Object> args = settingMap.get(setting.getKey());
-			if (args == null) {
-				continue;
-			}
-			if (args.containsKey("as")) {
-				switch (Ref.toType(Setting.Type.class, args.get("as").toString())) {
-					case JSON -> {
-						if (setting.getType() == Setting.Type.YAML) {
-							Map<String, Object> obj = new Yaml().load(setting.getValue());
-							setting.setValue(jackson.writeValueAsString(obj));
-						}
-					}
-					case YAML -> {
-						if (setting.getType() == Setting.Type.JSON) {
-							Map<String, Object> obj = jackson.readValue(setting.getValue(), new TypeReference<>() {});
-							setting.setValue(new Yaml().dump(obj));
-						}
-					}
-				}
-			}
-		}
-		return result.stream().collect(Collectors.toMap(Setting::getKey, Setting::getValue));
-	}
-
-	@AOPLog
-	@RequestRateLimit
-	@GetMapping("/attachment/{mongoId}")
-	public Attachment getAttachment(@PathVariable String mongoId) {
-		return attachmentService.getByMongoId(mongoId);
-	}
-
-	@AOPLog
-	@IgnoreGlobalReturn
-	@GetMapping("/attachment/read/{mongoId}")
-	public void readAttachment(
-			@PathVariable String mongoId,
-			@RequestParam(name = "size", required = false) Integer size,
-			@RequestParam(name = "type", required = false) String type,
-			HttpServletRequest req,
-			HttpServletResponse resp
-	) {
-		try {
-			GridFSFile file = attachmentService.readByMongoId(mongoId);
-			if (file == null) {
-				resp.setStatus(HttpServletResponse.SC_NOT_FOUND);
-				resp.setCharacterEncoding(StandardCharsets.UTF_8.toString());
-				return;
-			}
-			GridFSDownloadStream mimeReadStream = gridFSBucket.openDownloadStream(file.getObjectId());
-			String mimeType = new Tika().detect(mimeReadStream);
-			if (TimiJava.isNotEmpty(mimeType)) {
-				resp.setContentType(mimeType);
-			}
-			if (size != null) {
-				String fileType = switch (mimeType) {
-					case "image/png" -> "png";
-					case "image/jpeg" -> "jpg";
-					default -> throw new TimiException(TimiCode.ARG_BAD).msgKey("TODO not support Re render mineType");
-				};
-
-				switch (mimeType) {
-					case "image/png", "image/jpeg" -> {
-						// 图片缩放
-						GridFSDownloadStream stream = gridFSBucket.openDownloadStream(file.getObjectId());
-						byte[] bytes = IO.toBytes(stream);
-						BufferedImage imgSrc = ImageIO.read(new ByteArrayInputStream(bytes));
-
-						double scale;
-						if (imgSrc.getHeight() < imgSrc.getWidth()) {
-							// 横向
-							scale = 1D * size / imgSrc.getWidth();
-						} else {
-							scale = 1D * size / imgSrc.getHeight();
-						}
-						int width = (int) (imgSrc.getWidth() * scale);
-						int height = (int) (imgSrc.getHeight() * scale);
-						BufferedImage imgResult = new BufferedImage(width, height, BufferedImage.TYPE_INT_RGB);
-						Graphics2D g = imgResult.createGraphics();
-						if (ImageType.PIXELATED == Ref.toType(ImageType.class, type)) {
-							g.setRenderingHint(RenderingHints.KEY_INTERPOLATION, RenderingHints.VALUE_INTERPOLATION_NEAREST_NEIGHBOR);
-						} else {
-							g.setRenderingHint(RenderingHints.KEY_INTERPOLATION, RenderingHints.VALUE_INTERPOLATION_BICUBIC);
-							g.setRenderingHint(RenderingHints.KEY_ALPHA_INTERPOLATION, RenderingHints.VALUE_ALPHA_INTERPOLATION_QUALITY);
-							g.setRenderingHint(RenderingHints.KEY_COLOR_RENDERING, RenderingHints.VALUE_COLOR_RENDER_QUALITY);
-							g.setRenderingHint(RenderingHints.KEY_RENDERING, RenderingHints.VALUE_RENDER_QUALITY);
-							g.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);
-						}
-						g.drawImage(imgSrc, 0, 0, width, height, null);
-						ImageIO.write(imgResult, fileType, resp.getOutputStream());
-					}
-					default -> throw new TimiException(TimiCode.ARG_BAD).msgKey("TODO not support Re render mineType");
-				}
-			} else {
-				GridFSDownloadStream downloadStream = gridFSBucket.openDownloadStream(file.getObjectId());
-				GridFsResource gridFsResource = new GridFsResource(file, downloadStream);
-				req.setAttribute(ResourceHandler.ATTR_TYPE, ResourceHandler.Type.MONGO);
-				req.setAttribute(ResourceHandler.ATTR_VALUE, gridFsResource);
-				resourceHandler.handleRequest(req, resp);
-			}
-		} catch (Exception e) {
-			log.error("read attachment error", e);
-			resp.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
-			resp.setCharacterEncoding(StandardCharsets.UTF_8.toString());
-		}
-	}
-
-	@AOPLog
-	@RequestRateLimit
-	@IgnoreGlobalReturn
-	@GetMapping("/attachment/download/{mongoId}")
-	public void downloadAttachment(@PathVariable String mongoId, HttpServletResponse resp) {
-		try {
-			Attachment attachment = attachmentService.getByMongoId(mongoId);
-			GridFSFile file = attachmentService.readByMongoId(mongoId);
-			if (file == null) {
-				resp.setStatus(HttpServletResponse.SC_NOT_FOUND);
-				resp.setCharacterEncoding(StandardCharsets.UTF_8.toString());
-				return;
-			}
-			{
-				GridFSDownloadStream downloadStream = gridFSBucket.openDownloadStream(file.getObjectId());
-				String mimeType = new Tika().detect(downloadStream);
-				if (TimiJava.isNotEmpty(mimeType)) {
-					resp.setContentType(mimeType);
-				}
-			}
-			GridFSDownloadStream downloadStream = gridFSBucket.openDownloadStream(file.getObjectId());
-			resp.setHeader("Content-Disposition", Network.getFileDownloadHeader(file.getFilename()));
-			resp.setHeader("Content-Range", String.valueOf(attachment.getSize()));
-			resp.setHeader("Accept-Ranges", "bytes");
-			resp.setContentLengthLong(attachment.getSize());
-			IO.toOutputStream(downloadStream, resp.getOutputStream());
-			resp.flushBuffer();
-		} catch (Exception e) {
-			log.error("read attachment error", e);
-			resp.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
-			resp.setCharacterEncoding(StandardCharsets.UTF_8.toString());
-		}
-	}
-
-	/**
-	 * 上传临时文件
-	 *
-	 * @param files 文件列表
-	 * @param ttl   缓存时长（毫秒），最长 3 天（259200000ms）
-	 * @return 临时文件响应列表
-	 */
-	@AOPLog
-	@PostMapping("/temp/file/upload")
-	public List<TempFileResponse> tempFileUpload(@RequestParam("file") List<MultipartFile> files, @RequestParam(value = "ttl", required = false) Long ttl) {
-		return tempFileService.store(files, ttl);
-	}
-
-	/**
-	 * 读取临时文件
-	 *
-	 * @param mongoId mongoId
-	 * @param req     请求
-	 * @param resp    返回
-	 */
-	@AOPLog
-	@RequestRateLimit
-	@IgnoreGlobalReturn
-	@GetMapping("/temp/file/read/{mongoId}")
-	public void tempFileRead(@PathVariable String mongoId, HttpServletRequest req, HttpServletResponse resp) {
-		try {
-			Attachment attach = attachmentService.getByMongoId(mongoId);
-			if (TimiJava.isEmpty(attach)) {
-				resp.setStatus(HttpServletResponse.SC_NOT_FOUND);
-				return;
-			}
-			GridFSFile file = attachmentService.readByMongoId(attach.getMongoId());
-			GridFSDownloadStream downloadStream = gridFSBucket.openDownloadStream(file.getObjectId());
-			GridFsResource gridFsResource = new GridFsResource(file, downloadStream);
-			req.setAttribute(ResourceHandler.ATTR_TYPE, ResourceHandler.Type.MONGO);
-			req.setAttribute(ResourceHandler.ATTR_VALUE, gridFsResource);
-
-			resp.setContentType(attach.getMimeType());
-			resourceHandler.handleRequest(req, resp);
-		} catch (Exception e) {
-			resp.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
-		}
-	}
-
-	/**
-	 * 下载临时文件
-	 *
-	 * @param mongoId
-	 * @param resp
-	 */
-	@AOPLog
-	@RequestRateLimit
-	@IgnoreGlobalReturn
-	@RequestMapping("/temp/file/download/{mongoId}")
-	public void tempFileDownload(@PathVariable String mongoId, HttpServletResponse resp) {
-		try {
-			Attachment attach = attachmentService.getByMongoId(mongoId);
-			if (TimiJava.isEmpty(attach)) {
-				resp.setStatus(HttpServletResponse.SC_NOT_FOUND);
-				return;
-			}
-			resp.setContentType(attach.getMimeType());
-			resp.setHeader("Content-Disposition", Network.getFileDownloadHeader(attach.getName()));
-			resp.setHeader("Accept-Ranges", "bytes");
-
-			GridFSFile file = attachmentService.readByMongoId(mongoId);
-			@Cleanup
-			GridFSDownloadStream downloadStream = gridFSBucket.openDownloadStream(file.getObjectId());
-			RequestRange range = TimiSpring.getRequestRange(attach.getSize());
-			if (range == null) {
-				// 完整文件
-				resp.setContentLengthLong(attach.getSize());
-				resp.setStatus(HttpServletResponse.SC_OK);
-				IO.toOutputStream(downloadStream, resp.getOutputStream());
-			} else {
-				// 分片文件
-				resp.setStatus(HttpServletResponse.SC_PARTIAL_CONTENT);
-				resp.setHeader("Content-Range", "bytes %s-%s/%s".formatted(range.getStart(), range.getEnd(), attach.getSize()));
-				resp.setContentLengthLong(range.getLength());
-				IO.toOutputStream(downloadStream, resp.getOutputStream(), range.getStart(), range.getEnd());
-				resp.flushBuffer();
-			}
-		} catch (Exception e) {
-			log.error("download error", e);
-			resp.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
-		}
-	}
 }

src/main/java/com/imyeyu/api/modules/common/controller/IconController.java

@@ -1,26 +1,19 @@
 package com.imyeyu.api.modules.common.controller;
 
-import com.imyeyu.api.modules.common.entity.Icon;
 import com.imyeyu.api.modules.common.service.IconService;
-import com.imyeyu.api.modules.common.vo.icon.AllResponse;
-import com.imyeyu.api.modules.common.vo.icon.NamePage;
-import com.imyeyu.api.modules.common.vo.icon.UnicodePage;
-import com.imyeyu.spring.annotation.AOPLog;
-import com.imyeyu.spring.annotation.RequestRateLimit;
-import com.imyeyu.spring.bean.Page;
-import com.imyeyu.spring.bean.PageResult;
-import jakarta.validation.Valid;
+import com.imyeyu.network.Network;
+import com.imyeyu.spring.annotation.IgnoreGlobalReturn;
+import jakarta.servlet.http.HttpServletResponse;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.validation.annotation.Validated;
 import org.springframework.web.bind.annotation.GetMapping;
-import org.springframework.web.bind.annotation.PostMapping;
-import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
 
+import java.io.IOException;
 import java.util.List;
+import java.util.Map;
 
 /**
  * timi-icon 前端接口
@@ -38,60 +31,38 @@ public class IconController {
 	private final IconService service;
 
 	/**
-	 * 获取图标列表
+	 * 查询全部图标名称
 	 *
-	 * @param page 查询列表参数
-	 * @return 图标列表
+	 * @return 图标名称列表
 	 */
-	@RequestRateLimit
-	@PostMapping("/list")
-	public PageResult<Icon> list(@RequestBody Page page) {
-		return service.page(page);
+	@GetMapping("/name/list")
+	public List<String> listName() {
+		return service.listName();
+	}
+
+	@GetMapping("/svg/map")
+	public Map<String, String> mapSvg() {
+		return service.mapSvg();
+	}
+
+	@GetMapping("/unicode/map")
+	public Map<String, String> mapUnicode() {
+		return service.mapUnicode();
 	}
 
 	/**
-	 * 获取所有图标，为了减小传输数据，此接口只返回 name 名称、Unicode 代码和 SVG 路径
+	 * 导出 TTF 字体文件
 	 *
-	 * @param latest 请求缓存的最新数据时间
-	 * @return 所有图标，如果请求缓存的最新时间等于数据库的最新数据时间，不返回任何数据
+	 * @param resp HTTP 响应
+	 * @throws IOException 写出字体文件失败
 	 */
-	@RequestRateLimit
-	@GetMapping("/list/all")
-	public AllResponse listAll(@Valid @RequestParam Long latest) {
-		AllResponse resp = service.listAll(latest);
-		List<Icon> icons = resp.getIcons();
-		for (int i = 0; i < icons.size(); i++) {
-			Icon icon = icons.get(i);
-			icon.setId(null);
-			icon.setCreatedAt(null);
-			icon.setUpdatedAt(null);
-		}
-		return resp;
-	}
-
-	/**
-	 * 根据名称获取查询列表参数列表
-	 *
-	 * @param page 查询列表参数
-	 * @return 图标列表
-	 */
-	@AOPLog
-	@RequestRateLimit
-	@PostMapping("/list/name")
-	public PageResult<Icon> listByName(@Valid @RequestBody NamePage page) {
-		return service.pageByName(page);
-	}
-
-	/**
-	 * 根据 Unicode 获取图标列表
-	 *
-	 * @param page 查询列表参数
-	 * @return 图标列表
-	 */
-	@AOPLog
-	@RequestRateLimit
-	@PostMapping("/list/unicode")
-	public PageResult<Icon> listByUnicode(@Valid @RequestBody UnicodePage page) {
-		return service.pageByUnicode(page);
+	@IgnoreGlobalReturn
+	@GetMapping(value = "/export/ttf", produces = "font/ttf")
+	public void exportTtf(HttpServletResponse resp) throws IOException {
+		byte[] body = service.exportTtf();
+		resp.setContentType("font/ttf");
+		resp.setContentLength(body.length);
+		resp.setHeader("Content-Disposition", Network.getFileDownloadHeader("timi-icon.ttf"));
+		resp.getOutputStream().write(body);
 	}
 }

src/main/java/com/imyeyu/api/modules/common/controller/LoggerController.java

@@ -0,0 +1,35 @@
+package com.imyeyu.api.modules.common.controller;
+
+import com.imyeyu.api.modules.system.entity.Logger;
+import com.imyeyu.api.modules.system.service.LoggerService;
+import com.imyeyu.spring.annotation.AOPLog;
+import com.imyeyu.spring.annotation.RequiredToken;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+/**
+ *
+ *
+ * @author 夜雨
+ * @since 2026-06-13 09:31
+ */
+@Slf4j
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/log")
+public class LoggerController {
+
+	private final LoggerService service;
+
+	@AOPLog
+	@RequiredToken
+	@PostMapping("/create")
+	public void create(@Valid @RequestBody Logger logger) {
+		service.create(logger);
+	}
+}

src/main/java/com/imyeyu/api/modules/common/controller/MultilingualController.java

@@ -0,0 +1,94 @@
+package com.imyeyu.api.modules.common.controller;
+
+import com.fasterxml.jackson.annotation.JsonView;
+import com.imyeyu.api.annotation.RequireCorePermission;
+import com.imyeyu.api.annotation.RequireCoreRole;
+import com.imyeyu.api.bean.CorePermissionCode;
+import com.imyeyu.api.bean.CoreRoleCode;
+import com.imyeyu.api.modules.common.entity.Multilingual;
+import com.imyeyu.api.modules.common.service.MultilingualService;
+import com.imyeyu.spring.annotation.AOPLog;
+import com.imyeyu.spring.annotation.RequestRateLimit;
+import com.imyeyu.spring.util.ResponseView;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+/**
+ * 多语言管理接口
+ *
+ * @author Codex
+ * @since 2026-07-27
+ */
+@Slf4j
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/system/multilingual")
+public class MultilingualController {
+
+	private final MultilingualService service;
+
+	/**
+	 * 查询多语言详情
+	 *
+	 * @param id 多语言 ID
+	 * @return 多语言详情
+	 */
+	@JsonView(ResponseView.Admin.class)
+	@RequestRateLimit
+	@RequireCoreRole(CoreRoleCode.ADMIN)
+	@RequireCorePermission(CorePermissionCode.MULTILINGUAL_READ)
+	@PostMapping("/detail")
+	public Multilingual detail(@RequestParam String id) {
+		return service.get(id);
+	}
+
+	/**
+	 * 创建多语言
+	 *
+	 * @param multilingual 多语言
+	 * @return 创建结果
+	 */
+	@AOPLog
+	@JsonView(ResponseView.Admin.class)
+	@RequestRateLimit
+	@RequireCoreRole(CoreRoleCode.ADMIN)
+	@RequireCorePermission(CorePermissionCode.MULTILINGUAL_CREATE)
+	@PostMapping("/create")
+	public Multilingual create(@RequestBody Multilingual multilingual) {
+		service.create(multilingual);
+		return multilingual;
+	}
+
+	/**
+	 * 更新多语言
+	 *
+	 * @param multilingual 多语言
+	 */
+	@AOPLog
+	@RequestRateLimit
+	@RequireCoreRole(CoreRoleCode.ADMIN)
+	@RequireCorePermission(CorePermissionCode.MULTILINGUAL_UPDATE)
+	@PostMapping("/update")
+	public void update(@RequestBody Multilingual multilingual) {
+		service.update(multilingual);
+	}
+
+	/**
+	 * 删除多语言
+	 *
+	 * @param id 多语言 ID
+	 */
+	@AOPLog
+	@RequestRateLimit
+	@RequireCoreRole(CoreRoleCode.ADMIN)
+	@RequireCorePermission(CorePermissionCode.MULTILINGUAL_DELETE)
+	@PostMapping("/delete")
+	public void delete(@RequestParam String id) {
+		service.delete(id);
+	}
+}

src/main/java/com/imyeyu/api/modules/common/controller/SettingController.java

@@ -0,0 +1,100 @@
+package com.imyeyu.api.modules.common.controller;
+
+import com.fasterxml.jackson.annotation.JsonView;
+import com.imyeyu.api.annotation.RequireCorePermission;
+import com.imyeyu.api.bean.CorePermissionCode;
+import com.imyeyu.api.modules.common.entity.Setting;
+import com.imyeyu.api.modules.common.service.SettingService;
+import com.imyeyu.spring.annotation.AOPLog;
+import com.imyeyu.spring.annotation.RequestRateLimit;
+import com.imyeyu.spring.bean.Page;
+import com.imyeyu.spring.bean.PageResult;
+import com.imyeyu.spring.util.ResponseView;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+/**
+ *
+ *
+ * @author 夜雨
+ * @since 2026-04-23 16:31
+ */
+@Slf4j
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/system/setting")
+public class SettingController {
+
+	private final SettingService service;
+
+	/**
+	 * 查询配置列表
+	 *
+	 * @param page 分页查询
+	 * @return 配置列表
+	 */
+	@JsonView(ResponseView.Admin.class)
+	@RequestRateLimit
+	@RequireCorePermission(CorePermissionCode.SETTING_READ)
+	@PostMapping("/list")
+	public PageResult<Setting> list(@RequestBody Page<Setting> page) {
+		return service.page(page);
+	}
+
+	/**
+	 * 查询配置详情
+	 *
+	 * @param id 配置 ID
+	 * @return 配置详情
+	 */
+	@JsonView(ResponseView.Admin.class)
+	@RequestRateLimit
+	@PostMapping("/detail")
+	public Setting detail(@RequestBody String id) {
+		return service.get(id);
+	}
+
+	/**
+	 * 创建配置
+	 *
+	 * @param setting 配置
+	 * @return 配置
+	 */
+	@AOPLog
+	@JsonView(ResponseView.Admin.class)
+	@RequestRateLimit
+	@PostMapping("/create")
+	public Setting create(@RequestBody Setting setting) {
+		service.create(setting);
+		return setting;
+	}
+
+	/**
+	 * 更新配置
+	 *
+	 * @param setting 配置
+	 */
+	@AOPLog
+	@RequestRateLimit
+	@PostMapping("/update")
+	public void update(@RequestBody Setting setting) {
+		service.update(setting);
+	}
+
+	/**
+	 * 删除配置
+	 *
+	 * @param id 配置 ID
+	 */
+	@AOPLog
+	@RequestRateLimit
+	@RequireCorePermission(CorePermissionCode.SETTING_DELETE)
+	@PostMapping("/delete")
+	public void delete(@RequestBody String id) {
+		service.delete(id);
+	}
+}

src/main/java/com/imyeyu/api/modules/common/controller/UserController.java

@@ -1,316 +0,0 @@
-package com.imyeyu.api.modules.common.controller;
-
-import com.imyeyu.api.annotation.CaptchaValid;
-import com.imyeyu.api.annotation.EnableSetting;
-import com.imyeyu.api.bean.CaptchaFrom;
-import com.imyeyu.api.modules.common.bean.SettingKey;
-import com.imyeyu.api.modules.common.entity.Comment;
-import com.imyeyu.api.modules.common.entity.CommentReply;
-import com.imyeyu.api.modules.common.entity.UserConfig;
-import com.imyeyu.api.modules.common.entity.UserPrivacy;
-import com.imyeyu.api.modules.common.service.CommentReplyService;
-import com.imyeyu.api.modules.common.service.CommentService;
-import com.imyeyu.api.modules.common.service.UserConfigService;
-import com.imyeyu.api.modules.common.service.UserPrivacyService;
-import com.imyeyu.api.modules.common.service.UserProfileService;
-import com.imyeyu.api.modules.common.service.UserService;
-import com.imyeyu.api.modules.common.vo.user.EmailVerifyCallbackRequest;
-import com.imyeyu.api.modules.common.vo.user.LoginRequest;
-import com.imyeyu.api.modules.common.vo.user.LoginResponse;
-import com.imyeyu.api.modules.common.vo.user.RegisterRequest;
-import com.imyeyu.api.modules.common.vo.user.UpdatePasswordByKeyRequest;
-import com.imyeyu.api.modules.common.vo.user.UpdatePasswordRequest;
-import com.imyeyu.api.modules.common.vo.user.UserRequest;
-import com.imyeyu.api.modules.common.vo.user.UserView;
-import com.imyeyu.java.TimiJava;
-import com.imyeyu.java.bean.timi.TimiException;
-import com.imyeyu.spring.annotation.AOPLog;
-import com.imyeyu.spring.annotation.RequestRateLimit;
-import com.imyeyu.spring.annotation.RequiredToken;
-import com.imyeyu.spring.bean.CaptchaData;
-import com.imyeyu.spring.bean.Page;
-import com.imyeyu.spring.bean.PageResult;
-import com.imyeyu.utils.Time;
-import jakarta.validation.Valid;
-import jakarta.validation.constraints.Min;
-import jakarta.validation.constraints.NotNull;
-import lombok.RequiredArgsConstructor;
-import lombok.extern.slf4j.Slf4j;
-import org.springframework.validation.annotation.Validated;
-import org.springframework.web.bind.annotation.PathVariable;
-import org.springframework.web.bind.annotation.PostMapping;
-import org.springframework.web.bind.annotation.RequestBody;
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RestController;
-
-/**
- * 用户接口
- *
- * @author 夜雨
- * @since 2021-02-23 21:38
- */
-@Slf4j
-@Validated
-@RestController
-@RequiredArgsConstructor
-@RequestMapping("/user")
-public class UserController implements TimiJava {
-
-	private final UserService service;
-	private final CommentService commentService;
-	private final UserConfigService configService;
-	private final UserProfileService profileService;
-	private final UserPrivacyService privacyService;
-	private final CommentReplyService commentReplyService;
-
-	/**
-	 * 注册。执行成功会自动登录
-	 *
-	 * @param request 注册请求
-	 * @return 登录数据
-	 */
-	@AOPLog
-	@CaptchaValid(CaptchaFrom.REGISTER)
-	@EnableSetting(value = SettingKey.ENABLE_REGISTER, message = "user.register.off_service")
-	@RequestRateLimit(value = 1, lifeCycle = 60)
-	@PostMapping("/register")
-	public LoginResponse register(@Valid @RequestBody CaptchaData<RegisterRequest> request) {
-		return service.register(request.getData());
-	}
-
-	/**
-	 * 登录
-	 *
-	 * @param request 登录请求
-	 * @return 登录数据
-	 */
-	@AOPLog
-	@CaptchaValid(CaptchaFrom.LOGIN)
-	@EnableSetting(value = SettingKey.ENABLE_LOGIN, message = "user.login.off_service")
-	@RequestRateLimit
-	@PostMapping("/login")
-	public LoginResponse login(@Valid @RequestBody CaptchaData<LoginRequest> request) {
-		return service.login(request.getData());
-	}
-
-	/**
-	 * 根据令牌登录，请求头携带 Token 参数，通常用于延续登录令牌
-	 *
-	 * @return 登录数据
-	 */
-	@AOPLog
-	@EnableSetting(value = SettingKey.ENABLE_LOGIN, message = "user.login.off_service")
-	@RequestRateLimit
-	@PostMapping("/login/token")
-	public LoginResponse login4Token() {
-		return service.login4Token();
-	}
-
-	/** 登出 */
-	@AOPLog
-	@RequestRateLimit
-	@PostMapping("/logout")
-	public void logout() {
-		service.logout();
-	}
-
-	/** 发送邮箱验证邮件 */
-	@AOPLog
-	@RequiredToken
-	@RequestRateLimit(value = 1, lifeCycle = 50)
-	@PostMapping("/email/verify")
-	public void sendEmailVerify() {
-		service.sendEmailVerify();
-	}
-
-	/**
-	 * 邮箱验证邮件回调，验证请求的密钥来源于 {@link #sendEmailVerify()} 接口发送的邮件
-	 *
-	 * @param request 邮箱验证请求
-	 */
-	@AOPLog
-	@RequiredToken
-	@RequestRateLimit(value = 1, lifeCycle = 50)
-	@PostMapping("/email/verify/callback")
-	public void emailVerifyCallback(@Valid @RequestBody EmailVerifyCallbackRequest request) {
-		service.emailVerifyCallback(request.getKey());
-	}
-
-	/**
-	 * 修改密码，需要已登录状态，使用旧密码修改
-	 *
-	 * @param request 修改密码请求
-	 */
-	@AOPLog
-	@RequiredToken
-	@RequestRateLimit
-	@PostMapping("/password/update")
-	public void updatePassword(@Valid @RequestBody UpdatePasswordRequest request) {
-		service.updatePassword(request.getOldValue(), request.getNewValue());
-	}
-
-	/**
-	 * 发送用于重置密码的忘记密码邮件，入参数据可能是 UID、邮箱或用户名，该数据目标用户的邮箱需要通过验证
-	 *
-	 * @param request 忘记密码邮件请求
-	 */
-	@AOPLog
-	@CaptchaValid(CaptchaFrom.RESET_PASSWORD)
-	@RequestRateLimit(value = 1, lifeCycle = 50)
-	@PostMapping("/password/forget")
-	public void sendPasswordForgetVerify(@Valid @RequestBody CaptchaData<String> request) {
-		service.sendPasswordForgetVerify(request.getData());
-	}
-
-	/**
-	 * 修改密码，不需要登录状态，入参数据的密钥来源于 {@link #sendPasswordForgetVerify(CaptchaData)} 接口发送的邮件
-	 *
-	 * @param request 重置密码请求
-	 */
-	@AOPLog
-	@RequestRateLimit(value = 1, lifeCycle = 50)
-	@PostMapping("/password/reset")
-	public void resetPasswordByKey(@Valid @RequestBody UpdatePasswordByKeyRequest request) {
-		service.resetPasswordByKey(request.getKey(), request.getNewPassword());
-	}
-
-	/**
-	 * 注销账号，此操作将会标记此用户的所有数据为删除状态
-	 *
-	 * @param password 密码
-	 */
-	@AOPLog
-	@RequiredToken
-	@RequestRateLimit
-	@PostMapping("/cancel")
-	public void cancel(@RequestBody String password) {
-		service.cancel(password);
-	}
-
-	/**
-	 * 获取用户资料
-	 *
-	 * @param userId 目标用户 ID
-	 * @return 用户资料
-	 */
-	@AOPLog
-	@RequestRateLimit
-	@PostMapping("/view/{userId}")
-	public UserView view(@Min(1) @NotNull @PathVariable Long userId) throws Exception {
-		return service.view(userId).doFilter();
-	}
-
-	/**
-	 * 更新用户数据
-	 *
-	 * @param data 用户数据（包括账号数据）
-	 */
-	@AOPLog
-	@RequiredToken
-	@EnableSetting(value = SettingKey.ENABLE_USER_UPDATE, message = "user.data.off_service")
-	@RequestRateLimit
-	@PostMapping("/profile/update")
-	public void updateProfile(@Valid UserRequest data) {
-		profileService.update(data);
-	}
-
-	/**
-	 * 获取用户隐私控制
-	 *
-	 * @return 用户资料
-	 */
-	@AOPLog
-	@RequiredToken
-	@RequestRateLimit
-	@PostMapping("/privacy")
-	public UserPrivacy privacy() {
-		return privacyService.get(service.getLoginUser().getId());
-	}
-
-	@AOPLog
-	@RequiredToken
-	@RequestRateLimit
-	@PostMapping("/privacy/update")
-	public void updatePrivacy(@Valid @RequestBody UserPrivacy privacy) {
-		privacyService.update(privacy);
-	}
-
-	/**
-	 * 获取用户设置
-	 *
-	 * @return 用户设置
-	 */
-	@AOPLog
-	@RequiredToken
-	@RequestRateLimit
-	@PostMapping("/config")
-	public UserConfig config() {
-		return configService.get(service.getLoginUser().getId());
-	}
-
-	@AOPLog
-	@RequiredToken
-	@RequestRateLimit
-	@PostMapping("/config/update")
-	public void updateConfig(@Valid @RequestBody UserConfig config) {
-		configService.update(config);
-	}
-
-	/**
-	 * 获取用户评论
-	 */
-	@AOPLog
-	@RequiredToken
-	@RequestRateLimit
-	@PostMapping("/comment/list")
-	public PageResult<Comment> listComment(@Valid @RequestBody Page<Comment> page) {
-		Comment example = new Comment();
-		example.setUserId(service.getLoginUser().getId());
-		page.setEqualsExample(example);
-		return commentService.page(page);
-	}
-
-	@AOPLog
-	@RequiredToken
-	@RequestRateLimit
-	@PostMapping("/comment/delete")
-	public void deleteComment(@RequestBody Long commentId) {
-		commentService.get(commentId);
-		commentService.delete(commentId);
-	}
-
-	/**
-	 * 获取用户被回复的评论
-	 */
-	@AOPLog
-	@RequiredToken
-	@RequestRateLimit
-	@PostMapping("/comment/reply/list")
-	public PageResult<CommentReply> listCommentReply(@Valid @RequestBody Page<CommentReply> page) {
-		CommentReply example = new CommentReply();
-		example.setReceiverId(service.getLoginUser().getId());
-		page.setEqualsExample(example);
-		return commentReplyService.page(page);
-	}
-
-	@AOPLog
-	@RequiredToken
-	@RequestRateLimit
-	@PostMapping("/comment/reply/delete")
-	public void deleteCommentReply(@RequestBody Long replyId) {
-		CommentReply reply = commentReplyService.get(replyId);
-		TimiException.requiredTrue(reply.getSenderId().equals(service.getLoginUser().getId()), "user.comment.reply.delete.not_owner");
-		commentReplyService.delete(replyId);
-	}
-
-	@AOPLog
-	@RequiredToken
-	@RequestRateLimit
-	@PostMapping("/comment/reply/ignore")
-	public void ignoreCommentReply(@RequestBody Long replyId) {
-		CommentReply reply = commentReplyService.get(replyId);
-		TimiException.requiredTrue(reply.getReceiverId().equals(service.getLoginUser().getId()), "user.comment.reply.ignore.not_owner");
-		reply.setIgnoredAt(Time.now());
-		commentReplyService.update(reply);
-	}
-}

src/main/java/com/imyeyu/api/modules/common/entity/Article.java

@@ -0,0 +1,82 @@
+package com.imyeyu.api.modules.common.entity;
+
+import com.imyeyu.api.modules.common.bean.attachment.SettingSupport;
+import com.imyeyu.spring.annotation.table.PageIgnore;
+import com.imyeyu.spring.annotation.table.Transient;
+import com.imyeyu.spring.entity.UUIDEntity;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.util.List;
+
+/**
+ * 文章
+ *
+ * @author 夜雨
+ * @since 2021-03-01 17:10
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class Article extends UUIDEntity implements SettingSupport {
+
+	/**
+	 * 类型
+	 *
+	 * @author 夜雨
+	 * @since 2026-06-05 15:55
+	 */
+	public enum BizType {
+
+		/** 博客 */
+		BLOG
+	}
+
+	/**
+	 * 正文类型
+	 *
+	 * @author 夜雨
+	 * @since 2026-06-05 15:56
+	 */
+	public enum ContentType {
+
+		/** 纯文本 */
+		TEXT,
+
+		/** Markdown */
+		MARKDOWN,
+
+		/** TipTap 富文本 */
+		TIP_TAP
+	}
+
+	/** 业务类型 */
+	protected BizType bizType;
+
+	/** 业务 ID */
+	protected String bizId;
+
+	/** 标题 */
+	protected String title;
+
+	/** 摘要 */
+	protected String digest;
+
+	/** 正文类型 */
+	protected ContentType contentType;
+
+	/** 内容 */
+	@PageIgnore
+	protected String content;
+
+	/** 阅读数量 */
+	protected Integer reads;
+
+	/** 喜欢数量 */
+	protected Integer likes;
+
+	@Transient
+	protected List<Setting> settingList;
+
+	@Transient
+	protected List<Comment> commentList;
+}

src/main/java/com/imyeyu/api/modules/common/entity/Attachment.java

@@ -2,16 +2,17 @@ package com.imyeyu.api.modules.common.entity;
 
 import com.fasterxml.jackson.databind.JsonNode;
 import com.imyeyu.api.TimiServerAPI;
-import com.imyeyu.api.bean.MultilingualHandler;
+import com.imyeyu.api.modules.common.bean.attachment.AccessKey;
 import com.imyeyu.api.modules.common.service.AttachmentService;
 import com.imyeyu.java.ref.Ref;
+import com.imyeyu.spring.TimiSpring;
 import com.imyeyu.spring.annotation.table.Transient;
-import com.imyeyu.spring.entity.Entity;
-import lombok.AllArgsConstructor;
+import com.imyeyu.spring.entity.UUIDEntity;
 import lombok.Data;
 import lombok.EqualsAndHashCode;
-import lombok.Getter;
+import org.springframework.web.multipart.MultipartFile;
 
+import java.io.IOException;
 import java.io.InputStream;
 
 /**
@@ -20,61 +21,33 @@ import java.io.InputStream;
  */
 @Data
 @EqualsAndHashCode(callSuper = true)
-public class Attachment extends Entity implements MultilingualHandler {
+public class Attachment extends UUIDEntity {
 
-	/**
-	 * 附件类型
-	 *
-	 * @author 夜雨
-	 * @since 2023-08-21 16:32
-	 */
-	@Getter
-	@AllArgsConstructor
+	///
+	///
+	/// @author 夜雨
+	/// @since 2026-07-17 20:52
 	public enum BizType {
 
-		/** 用户 */
 		USER,
 
-		/** 文章 */
-		ARTICLE,
+		GAO_CUSTOMER,
 
-		/** Git */
-		GIT,
+		GAO_REGISTRATION_EVENT_RECORD,
 
-		/** 歌词 */
-		LYRIC,
+		TEMP_FILE,
 
-		/** ForeverMC */
-		FMC,
-
-		/** 镜像 */
-		MIRROR,
-
-		/** 日记 */
-		JOURNAL,
-
-		/** 日记出行 */
-		JOURNAL_TRAVEL,
-
-		/** 日记瞬间 */
-		JOURNAL_MOMENT,
-
-		/** 系统 */
-		SYSTEM,
-
-		/** 临时文件 */
-		TEMP_FILE
+		MIRROR
 	}
 
 	protected BizType bizType;
 
-	protected Long bizId;
+	protected String bizId;
 
 	protected String attachType;
 
 	protected String mongoId;
 
-	@MultilingualField
 	protected String title;
 
 	protected String name;
@@ -93,9 +66,22 @@ public class Attachment extends Entity implements MultilingualHandler {
 
 	protected Long destroyAt;
 
+	/** 数据流 */
 	@Transient
 	protected InputStream inputStream;
 
+	/** 保存自临时文件 ID */
+	@Transient
+	protected String tempFileId;
+
+	/** 访问密钥 */
+	@Transient
+	protected AccessKey accessKey;
+
+	/** 请求文件 */
+	@Transient
+	protected MultipartFile file;
+
 	public InputStream openInputStream() {
 		AttachmentService service = TimiServerAPI.applicationContext.getBean(AttachmentService.class);
 		return service.getInputStreamByMongoId(mongoId);
@@ -108,4 +94,9 @@ public class Attachment extends Entity implements MultilingualHandler {
 	public <T extends Enum<T>> T getAttachTypeValue(Class<T> attachTypeClass) {
 		return Ref.toType(attachTypeClass, attachType);
 	}
+
+	/** 执行接口流式返回 */
+	public void doResponse() throws IOException {
+		TimiSpring.responseRangeStream(openInputStream(), size);
+	}
 }

src/main/java/com/imyeyu/api/modules/common/entity/Comment.java

@@ -1,20 +1,11 @@
 package com.imyeyu.api.modules.common.entity;
 
-import com.imyeyu.api.modules.blog.entity.Article;
-import com.imyeyu.api.modules.blog.service.implement.ArticleServiceImplement;
-import com.imyeyu.api.modules.common.bean.CommentSupport;
-import com.imyeyu.api.modules.common.vo.user.UserView;
-import com.imyeyu.api.modules.git.bean.gitea.Repository;
-import com.imyeyu.api.modules.git.service.implement.IssueServiceImplement;
-import com.imyeyu.api.modules.git.service.implement.MergeServiceImplement;
+import com.imyeyu.api.modules.user.entity.User;
 import com.imyeyu.spring.annotation.table.Transient;
-import com.imyeyu.spring.entity.Entity;
-import com.imyeyu.spring.service.GettableService;
+import com.imyeyu.spring.entity.UUIDEntity;
 import jakarta.validation.constraints.NotBlank;
-import lombok.AllArgsConstructor;
 import lombok.Data;
 import lombok.EqualsAndHashCode;
-import lombok.Getter;
 import lombok.NoArgsConstructor;
 
 import java.util.List;
@@ -23,71 +14,94 @@ import java.util.List;
  * 评论
  *
  * @author 夜雨
- * @since 2021-02-25 14:46
+ * @since 2026-05-27 17:20
  */
 @Data
 @NoArgsConstructor
 @EqualsAndHashCode(callSuper = true)
-public class Comment extends Entity {
-
+public class Comment extends UUIDEntity {
 
 	/**
-	 * 关联业务类型
-	 * <p>
-	 * TODO 添加模块名称以便区别邮件通知推送来源，使用多语言键
+	 * 评论状态
 	 *
 	 * @author 夜雨
-	 * @since 2023-08-06 23:42
+	 * @since 2026-05-27 17:20
 	 */
-	@Getter
-	@AllArgsConstructor
-	public enum BizType {
+	public enum Status {
 
-		ARTICLE(ArticleServiceImplement.class),
+		/** 正常 */
+		NORMAL,
 
-		GIT_ISSUE(IssueServiceImplement.class),
-
-		GIT_MERGE(MergeServiceImplement.class);
-
-		final Class<? extends GettableService<? extends CommentSupport, Long>> serviceClass;
+		/** 隐藏 */
+		HIDDEN
 	}
 
-	/** 关联业务类型 */
-	private BizType bizType;
+	/** 业务类型 */
+	protected String bizType;
 
-	/** 关联业务 ID */
-	private Long bizId;
+	/** 业务 ID */
+	protected String bizId;
 
-	/** 发送用户 ID，登录用户评论有值，游客无 */
-	private Long userId;
+	/** 父评论 ID，主评论为 null */
+	protected String parentId;
 
-	/** 发送用户昵称，游客评论有值，登录用户无 */
-	private String nick;
+	/** 根评论 ID，主评论为自身 ID */
+	protected String rootId;
 
-	/** 评论数据 */
+	/** 评论用户 ID */
+	protected String userId;
+
+	/** 评论用户昵称，游客评论时使用 */
+	protected String userNick;
+
+	/** 被回复用户 ID */
+	protected String replyUserId;
+
+	/** 被回复用户昵称，被回复人为游客时使用 */
+	protected String replyUserNick;
+
+	/** 评论层级，1 为主评论 */
+	protected Integer level;
+
+	/** 评论内容 */
 	@NotBlank
-	private String content;
+	protected String content;
 
-	/** 发送用户 IP */
-	private String ip;
+	/** IP 地址 */
+	protected String ip;
 
-	/** 回复数量 */
+	/** 回复数 */
+	protected Integer replyCount;
+
+	/** 点赞数 */
+	protected Integer likeCount;
+
+	/** 评论状态 */
+	protected Status status;
+
+	/** true 为置顶 */
+	protected Boolean isTop;
+
+	/** 最后回复时间 */
+	protected Long lastReplyAt;
+
+	/** 评论用户信息 */
 	@Transient
-	private long repliesLength;
+	protected User user;
 
-	/** 发送用户 */
+	/** 被回复用户信息 */
 	@Transient
-	private UserView user;
+	protected User replyUser;
 
-	/** 关联文章 */
+	/** 子评论列表 */
 	@Transient
-	private Article article;
+	protected List<Comment> replyList;
 
-	/** 关联仓库 */
+	/** true 为当前用户已点赞 */
 	@Transient
-	private Repository repository;
+	protected Boolean liked;
 
-	/** 回复列表 */
+	/** true 为当前用户已不喜欢 */
 	@Transient
-	private List<CommentReply> replies;
+	protected Boolean unliked;
 }

src/main/java/com/imyeyu/api/modules/common/entity/CommentReply.java

@@ -1,59 +0,0 @@
-package com.imyeyu.api.modules.common.entity;
-
-import com.imyeyu.api.modules.common.vo.user.UserView;
-import com.imyeyu.spring.annotation.table.Transient;
-import com.imyeyu.spring.entity.Entity;
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.NoArgsConstructor;
-
-/**
- * 评论回复
- *
- * @author 夜雨
- * @since 2021-03-01 17:11
- */
-@Data
-@NoArgsConstructor
-@EqualsAndHashCode(callSuper = true)
-public class CommentReply extends Entity {
-
-	/** 所属评论 ID */
-	private Long commentId;
-
-	/** 被回复的回复，回复主评论时为 NULL */
-	private Long replyId;
-
-	/** 发送用户 ID，登录用户回复有值，游客无 */
-	private Long senderId;
-
-	/** 回复用户 ID，系统用户回复有值，游客无 */
-	private Long receiverId;
-
-	/** 发送用户昵称，游客回复有值，登录用户无 */
-	private String senderNick;
-
-	/** 回复用户昵称，游客回复有值，系统用户无 */
-	private String receiverNick;
-
-	/** 回复数据 */
-	private String content;
-
-	/** 发送用户 IP */
-	private String ip;
-
-	/** 被回复用户忽略该回复的时间 */
-	private Long ignoredAt;
-
-	/** 所属评论 */
-	@Transient
-	private Comment comment;
-
-	/** 发送用户 */
-	@Transient
-	private UserView sender;
-
-	/** 回复用户 */
-	@Transient
-	private UserView receiver;
-}

src/main/java/com/imyeyu/api/modules/common/entity/DataDict.java

@@ -0,0 +1,47 @@
+package com.imyeyu.api.modules.common.entity;
+
+import com.imyeyu.spring.annotation.table.Transient;
+import com.imyeyu.spring.entity.UUIDEntity;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.util.List;
+
+/**
+ * 数据字典
+ *
+ * @author 夜雨
+ * @since 2026-05-13 14:40
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class DataDict extends UUIDEntity {
+
+	/** 业务类型 */
+	private String bizType;
+
+	/** 代码 */
+	private String code;
+
+	/** 父级代码 */
+	private String parentCode;
+
+	/** 字典名称语言键 */
+	private String nameLangId;
+
+	/** 字典名称（读取） */
+	@Transient
+	protected String name;
+
+	/** 搜索名称 */
+	@Transient
+	protected String searchName;
+
+	/** 字典中文名称（写入） */
+	@Transient
+	protected String zhCN;
+
+	/** 选项列表 */
+	@Transient
+	protected List<DataDictOption> dataDictOptionList;
+}

src/main/java/com/imyeyu/api/modules/common/entity/DataDictOption.java

@@ -0,0 +1,50 @@
+package com.imyeyu.api.modules.common.entity;
+
+import com.imyeyu.spring.annotation.table.Transient;
+import com.imyeyu.spring.entity.UUIDEntity;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.util.List;
+
+/**
+ * 数据字典选项
+ *
+ * @author 夜雨
+ * @since 2026-05-13 14:40
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class DataDictOption extends UUIDEntity {
+
+	/** 所属字典 ID */
+	private String dictId;
+
+	/** 值代码 */
+	private String valueCode;
+
+	/** 父级值代码 */
+	private String valueParentCode;
+
+	/** 值语言键 */
+	private String valueLangId;
+
+	/** 值（读取） */
+	@Transient
+	protected String value;
+
+	/** 中文值（写入） */
+	@Transient
+	protected String zhCN;
+
+	@Transient
+	protected String searchValue;
+
+	/** 所属字典 */
+	@Transient
+	protected DataDict dataDict;
+
+	/** 附加参数设置 */
+	@Transient
+	protected List<Setting> settingList;
+}

src/main/java/com/imyeyu/api/modules/common/entity/EmailFilter.java

@@ -0,0 +1,34 @@
+package com.imyeyu.api.modules.common.entity;
+
+import com.imyeyu.spring.annotation.table.AutoUUID;
+import com.imyeyu.spring.annotation.table.DeleteColumn;
+import com.imyeyu.spring.annotation.table.Id;
+import com.imyeyu.spring.entity.Creatable;
+import com.imyeyu.spring.entity.Deletable;
+import com.imyeyu.spring.entity.IDEntity;
+import lombok.Data;
+
+/**
+ * 邮件过滤
+ *
+ * @author 夜雨
+ * @since 2026-05-13 14:40
+ */
+@Data
+public class EmailFilter implements IDEntity<String>, Creatable, Deletable {
+
+	/** 主键 */
+	@Id
+	@AutoUUID
+	private String id;
+
+	/** 邮箱 */
+	private String email;
+
+	/** 创建时间 */
+	private Long createdAt;
+
+	/** 删除时间 */
+	@DeleteColumn
+	private Long deletedAt;
+}

src/main/java/com/imyeyu/api/modules/common/entity/EmailQueue.java

@@ -1,43 +0,0 @@
-package com.imyeyu.api.modules.common.entity;
-
-import com.imyeyu.spring.annotation.table.AutoUUID;
-import com.imyeyu.spring.annotation.table.Id;
-import lombok.Data;
-
-/**
- * 邮件队列
- *
- * @author 夜雨
- * @since 2021-08-24 14:59
- */
-@Data
-public class EmailQueue {
-
-	/**
-	 * 业务类型
-	 *
-	 * @author 夜雨
-	 * @since 2021-08-24 15:54
-	 */
-	public enum BizType {
-
-		/** 回复提醒 */
-		REPLY_REMINAD,
-
-		/** 邮箱验证 */
-		EMAIL_VERIFY,
-
-		/** 重置密码 */
-		RESET_PASSWORD
-	}
-
-	@Id
-	@AutoUUID
-	private String UUID;
-
-	private BizType bizType;
-
-	private Long bizId;
-
-	private Long sendAt;
-}

src/main/java/com/imyeyu/api/modules/common/entity/EmailQueueLog.java

@@ -1,23 +0,0 @@
-package com.imyeyu.api.modules.common.entity;
-
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import com.imyeyu.spring.entity.Entity;
-
-/**
- * @author 夜雨
- * @since 2021-08-24 18:00
- */
-@Data
-@EqualsAndHashCode(callSuper = true)
-public class EmailQueueLog extends Entity {
-
-	private String UUID;
-	private EmailQueue.BizType bizType;
-	private Long bizId;
-	private String sendTo;
-	private Long sendAt;
-
-	private Boolean isSent;
-	private String exceptionMsg;
-}

src/main/java/com/imyeyu/api/modules/common/entity/Feedback.java

@@ -1,21 +0,0 @@
-package com.imyeyu.api.modules.common.entity;
-
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import com.imyeyu.spring.entity.Entity;
-
-/**
- * 反馈
- *
- * @author 夜雨
- * @since 2021-11-16 22:22
- */
-@Data
-@EqualsAndHashCode(callSuper = true)
-public class Feedback extends Entity {
-
-	private String from;
-	private String email;
-	private String data;
-	private String ip;
-}

src/main/java/com/imyeyu/api/modules/common/entity/Icon.java

@@ -2,7 +2,7 @@ package com.imyeyu.api.modules.common.entity;
 
 import lombok.Data;
 import lombok.EqualsAndHashCode;
-import com.imyeyu.spring.entity.Entity;
+import com.imyeyu.spring.entity.UUIDEntity;
 
 /**
  * 字体图标
@@ -12,7 +12,7 @@ import com.imyeyu.spring.entity.Entity;
  */
 @Data
 @EqualsAndHashCode(callSuper = true)
-public class Icon extends Entity {
+public class Icon extends UUIDEntity {
 
 	/** 名称 */
 	private String name;

src/main/java/com/imyeyu/api/modules/common/entity/Multilingual.java

@@ -1,28 +1,43 @@
 package com.imyeyu.api.modules.common.entity;
 
 import com.imyeyu.java.bean.Language;
-import com.imyeyu.spring.entity.Creatable;
-import com.imyeyu.spring.entity.Deletable;
-import com.imyeyu.spring.entity.IDEntity;
-import com.imyeyu.spring.entity.Updatable;
+import com.imyeyu.spring.entity.UUIDEntity;
 import lombok.Data;
 import lombok.EqualsAndHashCode;
 
-import java.io.Serializable;
-
 /**
  * @author 夜雨
  * @since 2023-10-24 16:41
  */
 @Data
 @EqualsAndHashCode(callSuper = true)
-public class Multilingual extends Language implements Serializable, IDEntity<Long>, Creatable, Updatable, Deletable {
+public class Multilingual extends UUIDEntity {
 
-	protected Long id;
+	protected String zhCN;
 
-	protected Long createdAt;
+	protected String zhTW;
 
-	protected Long updatedAt;
+	protected String enUS;
 
-	protected Long deletedAt;
+	protected String ruRU;
+
+	protected String jaJP;
+
+	protected String deDE;
+
+	protected String koKR;
+
+	protected Long lastAccessAt;
+
+	public String getValue(Language.Enum language) {
+		return switch (language) {
+			case zh_CN -> zhCN;
+			case zh_TW -> zhTW;
+			case en_US -> enUS;
+			case ru_RU -> ruRU;
+			case ja_JP -> jaJP;
+			case de_DE -> deDE;
+			case ko_KR -> koKR;
+		};
+	}
 }

src/main/java/com/imyeyu/api/modules/common/entity/Notify.java

@@ -0,0 +1,44 @@
+package com.imyeyu.api.modules.common.entity;
+
+import com.imyeyu.spring.annotation.table.AutoUUID;
+import com.imyeyu.spring.annotation.table.Id;
+import com.imyeyu.spring.annotation.table.Transient;
+import com.imyeyu.spring.entity.UUIDEntity;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.util.List;
+
+/**
+ * 通知
+ *
+ * @author 夜雨
+ * @since 2026-05-13 14:40
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class Notify extends UUIDEntity {
+
+	/** 主键 */
+	@Id
+	@AutoUUID
+	private String id;
+
+	/** 业务类型 */
+	private String bizType;
+
+	/** 提醒业务类型 */
+	private String bizRemindedType;
+
+	/** 提醒业务 ID */
+	private String bizRemindedId;
+
+	/** 参数 */
+	private String args;
+
+	/** 创建者 */
+	private String createdBy;
+
+	@Transient
+	protected List<NotifyDetail> detailList;
+}

src/main/java/com/imyeyu/api/modules/common/entity/NotifyDetail.java

@@ -0,0 +1,97 @@
+package com.imyeyu.api.modules.common.entity;
+
+import com.imyeyu.spring.annotation.table.Transient;
+import com.imyeyu.spring.entity.UUIDEntity;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+/**
+ * 通知详情
+ *
+ * @author 夜雨
+ * @since 2026-05-13 14:40
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class NotifyDetail extends UUIDEntity {
+
+	/**
+	 *
+	 *
+	 * @author 夜雨
+	 * @since 2025-10-28 15:53
+	 */
+	@AllArgsConstructor
+	public enum MsgType {
+
+		SMS,
+
+		MAIL,
+
+		HTTP,
+
+		WECHAT;
+	}
+
+	/**
+	 *
+	 *
+	 * @author 夜雨
+	 * @since 2025-10-28 15:55
+	 */
+	public enum Status {
+
+		WAITING,
+
+		REMINDED,
+
+		TIMEOUT,
+
+		CANCEL,
+
+		FAIL
+	}
+
+	/** 所属通知 ID */
+	private String notifyId;
+
+	/** 消息类型 */
+	private MsgType msgType;
+
+	/** 模板 ID */
+	private String templateId;
+
+	/** 标题 */
+	private String subject;
+
+	/** 内容 */
+	private String data;
+
+	/** 参数 */
+	private String args;
+
+	/** 发送来源 */
+	private String sendFrom;
+
+	/** 发送去向 */
+	private String sendTo;
+
+	/** 发送时间 */
+	private Long sendAt;
+
+	/** 重试计数 */
+	private Integer retry;
+
+	/** 超时时间 */
+	private Long timeoutAt;
+
+	/** 结果描述 */
+	private String resultDesc;
+
+	/** 状态 */
+	private Status status;
+
+	@Transient
+	protected Notify notify;
+}

src/main/java/com/imyeyu/api/modules/common/entity/Setting.java

@@ -1,10 +1,20 @@
 package com.imyeyu.api.modules.common.entity;
 
-import com.imyeyu.api.modules.common.bean.SettingKey;
-import com.imyeyu.spring.annotation.table.Id;
-import com.imyeyu.spring.entity.Creatable;
-import com.imyeyu.spring.entity.Updatable;
+import com.fasterxml.jackson.annotation.JsonView;
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.databind.node.ArrayNode;
+import com.fasterxml.jackson.databind.node.ObjectNode;
+import com.imyeyu.api.TimiServerAPI;
+import com.imyeyu.api.modules.common.bean.SettingModule;
+import com.imyeyu.spring.annotation.table.Transient;
+import com.imyeyu.spring.entity.UUIDEntity;
+import com.imyeyu.spring.util.ResponseView;
+import com.imyeyu.utils.Time;
 import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
 
 /**
  * 系统配置
@@ -13,7 +23,9 @@ import lombok.Data;
  * @since 2021-07-20 21:46
  */
 @Data
-public class Setting implements Creatable, Updatable {
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class Setting extends UUIDEntity {
 
 	/**
 	 *
@@ -21,31 +33,486 @@ public class Setting implements Creatable, Updatable {
 	 * @author 夜雨
 	 * @since 2025-01-10 17:08
 	 */
-	public enum Type {
-
-		INTEGER,
+	public enum ValueType {
 
+		/** 字符串 */
 		STRING,
 
-		JSON,
+		/** 单选 */
+		SELECT_RADIO,
 
-		YAML,
+		/** 多选 */
+		SELECT_CHECKBOX,
+
+		/** 整数 */
+		INTEGER,
+
+		/** 十六进制颜色 */
+		COLOR,
+
+		/** 浮点数 */
+		FLOAT,
+
+		/** 日期 */
+		DATE,
+
+		/** 日期时间 */
+		DATETIME,
+
+		/** 时间 */
+		TIME,
+
+		/** 时长 */
+		DURATION,
+
+		/** 布尔值 */
+		BOOLEAN,
+
+		/** JSON 列表 */
+		JSON_LIST,
+
+		/** JSON 对象 */
+		JSON_OBJECT
 	}
 
-	@Id
-	private SettingKey key;
+	@JsonView(ResponseView.Public.class)
+	private String bizType;
 
+	@JsonView(ResponseView.Public.class)
+	private String bizId;
+
+	@JsonView(ResponseView.Public.class)
+	private String code;
+
+	@JsonView(ResponseView.Public.class)
+	private String description;
+
+	@JsonView(ResponseView.Public.class)
 	private String value;
 
-	private Type type;
+	@JsonView(ResponseView.Public.class)
+	private ValueType valueType;
 
-	private boolean isPrivate;
+	@JsonView(ResponseView.Public.class)
+	private JsonNode valueArgs;
 
-	private Long createdAt;
+	@JsonView(ResponseView.Admin.class)
+	private Boolean isPrivate;
 
-	private Long updatedAt;
+	@Transient
+	private Enum<?> keyRaw;
 
-	public boolean isPublic() {
-		return !isPrivate;
+	public Setting(Enum<?> key) {
+		setKeyRaw(key);
+	}
+
+	public Setting(Enum<?> key, Object value, ValueType valueType) {
+		setKeyRaw(key);
+		this.value = value.toString();
+		this.valueType = valueType;
+	}
+
+	/**
+	 * 以字符串形式返回配置值
+	 *
+	 * @return 配置字符串值
+	 */
+	public String asString() {
+		return value;
+	}
+
+	public Long asTime() {
+		return Time.parseToMS(asString());
+	}
+
+	/**
+	 * 以整数形式返回配置值
+	 *
+	 * @return 配置整数值
+	 * @throws NumberFormatException 配置值不是合法整数
+	 */
+	public Integer asInteger() {
+		return Integer.parseInt(value);
+	}
+
+	/**
+	 * 以长整数形式返回配置值
+	 *
+	 * @return 配置长整数值
+	 * @throws NumberFormatException 配置值不是合法长整数
+	 */
+	public Long asLong() {
+		return Long.parseLong(value);
+	}
+
+	/**
+	 * 以双精度浮点数形式返回配置值
+	 *
+	 * @return 配置双精度浮点数值
+	 * @throws NumberFormatException 配置值不是合法双精度浮点数
+	 */
+	public Double asDouble() {
+		return Double.parseDouble(value);
+	}
+
+	/**
+	 * 以布尔值形式返回配置值
+	 *
+	 * @return 配置布尔值
+	 */
+	public Boolean asBoolean() {
+		return Boolean.parseBoolean(value);
+	}
+
+	public boolean isTrue() {
+		return asBoolean();
+	}
+
+	public boolean isFalse() {
+		return !isTrue();
+	}
+
+	/**
+	 * 以 JSON 节点形式返回配置值
+	 *
+	 * @return 配置 JSON 节点
+	 * @throws IllegalArgumentException 配置值不是合法 JSON
+	 */
+	public JsonNode asJsonNode() {
+		return asJsonNode(JsonNode.class);
+	}
+
+	/**
+	 * 以 JSON 数组形式返回配置值
+	 *
+	 * @return 配置 JSON 数组
+	 * @throws IllegalArgumentException 配置值不是合法 JSON 数组
+	 */
+	public ArrayNode asArrayNode() {
+		return asJsonNode(ArrayNode.class);
+	}
+
+	/**
+	 * 以 JSON 对象形式返回配置值
+	 *
+	 * @return 配置 JSON 对象
+	 * @throws IllegalArgumentException 配置值不是合法 JSON 对象
+	 */
+	public ObjectNode asObjectNode() {
+		return asJsonNode(ObjectNode.class);
+	}
+
+	/**
+	 * 解析配置 JSON 值
+	 *
+	 * @param type 目标类型
+	 * @param <T> 目标类型
+	 * @return 解析后的 JSON 节点
+	 * @throws IllegalArgumentException 配置值不是合法 JSON
+	 */
+	public <T extends JsonNode> T asJsonNode(Class<T> type) {
+		if (value == null) {
+			return null;
+		}
+		try {
+			ObjectMapper mapper = TimiServerAPI.applicationContext.getBean(ObjectMapper.class);
+			return mapper.readValue(value, type);
+		} catch (JsonProcessingException e) {
+			throw new IllegalArgumentException("setting value is not valid json: %s".formatted(value), e);
+		}
+	}
+
+	public void setKeyRaw(Enum<?> key) {
+		this.keyRaw = key;
+		this.bizType = SettingModule.fromClass(key.getClass()).toString();
+		this.code = key.toString();
+	}
+
+	public boolean is(Enum<?> key) {
+		return SettingModule.fromClass(key.getClass()).toString().equals(bizType) && key.toString().equals(code);
+	}
+
+	/**
+	 *
+	 *
+	 * @author 夜雨
+	 * @since 2026-04-24 14:23
+	 */
+	public static final class Module {
+
+		/**
+		 *
+		 *
+		 * @author 夜雨
+		 * @since 2026-04-24 15:39
+		 */
+		public enum Common {
+
+			/** 微信收款码 */
+			WECHAT_RECEIVE_QR_CODE
+		}
+
+		/**
+		 * 域名
+		 *
+		 * @author 夜雨
+		 * @since 2026-04-26 17:18
+		 */
+		public enum Domain {
+
+			ROOT,
+
+			API,
+
+			GIT,
+
+			BLOG,
+
+			SPACE,
+
+			FOREVER_MC
+		}
+
+		/**
+		 *
+		 *
+		 * @author 夜雨
+		 * @since 2026-04-24 15:14
+		 */
+		public enum Blog {
+
+		}
+
+		/**
+		 *
+		 *
+		 * @author 夜雨
+		 * @since 2026-04-24 15:03
+		 */
+		public enum User {
+
+			/** 启用登录 */
+			ENABLE_LOGIN,
+
+			/** 启用注册 */
+			ENABLE_REGISTER,
+
+			/** 允许数据更新 */
+			ENABLE_PROFILE_UPDATE,
+
+			/** 令牌有效期 */
+			TOKEN_TTL
+		}
+
+		/**
+		 *
+		 *
+		 * @author 夜雨
+		 * @since 2026-04-24 15:21
+		 */
+		public enum Comment {
+
+			/** 启用服务 */
+			ENABLE
+		}
+
+		/**
+		 *
+		 *
+		 * @author 夜雨
+		 * @since 2026-04-24 15:03
+		 */
+		public enum ICP {
+
+			IMYEYU_COM
+		}
+
+		/**
+		 *
+		 *
+		 * @author 夜雨
+		 * @since 2026-04-24 15:01
+		 */
+		public enum ForeverMC {
+
+			PLAYER_BIND_MAX,
+
+			LOGIN_TOKEN_TTL
+		}
+
+		/**
+		 *
+		 *
+		 * @author 夜雨
+		 * @since 2026-04-24 14:57
+		 */
+		public enum Multilingual {
+
+			/** 翻译 API */
+			TRANSLATE_API,
+
+			/** 翻译 AppId */
+			TRANSLATE_APP_ID,
+
+			/** 翻译密钥 */
+			TRANSLATE_KEY,
+
+			/** 翻译计划任务表达式 */
+			TRANSLATE_CORN,
+
+			/** 缓存时长 */
+			CACHE_TTL
+		}
+
+		/**
+		 *
+		 *
+		 * @author 夜雨
+		 * @since 2026-04-24 14:55
+		 */
+		public enum Gitea {
+
+			/** 接口地址 */
+			API,
+
+			/** 关于页面所属文章 ID */
+			ABOUT_ARTICLE_ID,
+
+			/** 仓库文件地址 */
+			REPOSITORY_PATH
+		}
+
+		/**
+		 *
+		 *
+		 * @author 夜雨
+		 * @since 2026-04-24 14:52
+		 */
+		public enum Music {
+
+			/** 启用服务 */
+			ENABLE,
+
+			/** 通信消息最大帧长度 */
+			MAX_FRAME_LENGTH,
+
+			/** 受控端 IP */
+			PLAYER_IP,
+
+			/** 受控端端口 */
+			PLAYER_PORT,
+
+			/** 控制端 IP */
+			CONTROLLER_IP,
+
+			/** 控制端端口 */
+			CONTROLLER_PORT,
+
+			/** 控制端入口地址 */
+			CONTROLLER_URI,
+		}
+
+		/**
+		 *
+		 *
+		 * @author 夜雨
+		 * @since 2026-04-24 14:49
+		 */
+		public enum Journal {
+
+			/** 启用服务 */
+			ENABLE,
+
+			/** 审核中 */
+			REVIEWING,
+
+			/** 访问密钥 */
+			KEY,
+
+			/** 微信小程序 AppId */
+			APP_ID,
+
+			/** 微信小程序 AppSecret */
+			APP_SECRET,
+
+			/** 备忘录内容 */
+			MEMO,
+		}
+
+		/**
+		 *
+		 *
+		 * @author 夜雨
+		 * @since 2026-04-24 14:47
+		 */
+		public enum TempFile {
+
+			/** 启用服务 */
+			ENABLE,
+
+			/** 最小缓存时长 */
+			TTL_MIN,
+
+			/** 默认缓存时长 */
+			TTL_DEFAULT,
+
+			/** 最大缓存时长 */
+			TTL_MAX,
+
+			/** 已过期文件残留时长 */
+			RESIDUE_TTL,
+
+			/** 每个 IP 限制有效临时文件容量 */
+			LIMIT_SIZE_OF_IP
+		}
+
+		/**
+		 *
+		 *
+		 * @author 夜雨
+		 * @since 2026-04-27 14:35
+		 */
+		public enum FileSync {
+
+			ENABLE,
+
+			CRON,
+		}
+
+		/**
+		 *
+		 *
+		 * @author 夜雨
+		 * @since 2026-04-24 14:23
+		 */
+		public enum System {
+
+			/** 文件系统基准路径 */
+			FILE_BASE_PATH,
+
+			/** 设置缓存时长 */
+			SETTING_TTL,
+
+			/** 哀悼滤镜 */
+			ENABLE_MOURN_FILTER,
+		}
+
+		/**
+		 *
+		 *
+		 * @author 夜雨
+		 * @since 2026-04-24 14:23
+		 */
+		public enum SystemStatus {
+
+			/** 状态采集数据量 */
+			LIMIT,
+
+			/** 状态采集网卡 */
+			NETWORK_MAC,
+
+			/** 状态采集频率 */
+			RATE,
+		}
 	}
 }

src/main/java/com/imyeyu/api/modules/common/entity/Tag.java

@@ -1,7 +1,7 @@
 package com.imyeyu.api.modules.common.entity;
 
-import com.imyeyu.api.bean.MultilingualHandler;
-import com.imyeyu.spring.entity.Entity;
+import com.imyeyu.spring.annotation.table.Transient;
+import com.imyeyu.spring.entity.UUIDEntity;
 import lombok.Data;
 import lombok.EqualsAndHashCode;
 
@@ -11,29 +11,13 @@ import lombok.EqualsAndHashCode;
  */
 @Data
 @EqualsAndHashCode(callSuper = true)
-public class Tag extends Entity implements MultilingualHandler {
+public class Tag extends UUIDEntity {
 
-	/**
-	 *
-	 *
-	 * @author 夜雨
-	 * @since 2024-08-28 14:26
-	 */
-	public enum BizType {
+	protected String langKey;
 
-		ARTICLE,
-
-		MUSIC,
-
-		SERVER_FILE,
-
-		WALLPAPER
-	}
-
-	protected BizType bizType;
-
-	protected String bizID;
-
-	@MultilingualHandler.MultilingualField
+	@Transient
 	protected String value;
+
+	@Transient
+	protected String zhCN;
 }

src/main/java/com/imyeyu/api/modules/common/entity/TagApply.java

@@ -0,0 +1,25 @@
+package com.imyeyu.api.modules.common.entity;
+
+import com.imyeyu.spring.entity.UUIDEntity;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+/**
+ * 标签应用
+ *
+ * @author 夜雨
+ * @since 2025-12-02 17:01
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class TagApply extends UUIDEntity {
+
+	/** 业务类型 */
+	protected String bizType;
+
+	/** 业务 ID */
+	protected String bizId;
+
+	/** 标签 ID */
+	protected String tagId;
+}

src/main/java/com/imyeyu/api/modules/common/entity/Task.java

@@ -1,40 +0,0 @@
-package com.imyeyu.api.modules.common.entity;
-
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.Getter;
-import com.imyeyu.spring.entity.Entity;
-
-import java.util.List;
-
-/**
- * 开发任务
- *
- * @author 夜雨
- * @since 2022-02-26 11:12
- */
-@Data
-@EqualsAndHashCode(callSuper = true)
-public class Task extends Entity {
-
-	/**
-	 * 任务状态
-	 *
-	 * @author 夜雨
-	 * @since 2022-02-26 11:53
-	 */
-	@Getter
-	public enum Status {
-
-		UPDATE, WITH, WAIT, KEEP, DIE;
-
-		final int sort = ordinal();
-	}
-
-	private String name;
-	private Status status;
-	private String digest;
-
-	// 关联数据
-	private List<TaskDetail> details;
-}

src/main/java/com/imyeyu/api/modules/common/entity/TaskDetail.java

@@ -1,48 +0,0 @@
-package com.imyeyu.api.modules.common.entity;
-
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import lombok.Getter;
-import lombok.NoArgsConstructor;
-import com.imyeyu.spring.entity.Entity;
-
-/**
- * 开发任务详细信息
- *
- * @author 夜雨
- * @since 2022-02-27 17:58
- */
-@Data
-@NoArgsConstructor
-@EqualsAndHashCode(callSuper = true)
-public class TaskDetail extends Entity {
-
-	/**
-	 * 类型
-	 *
-	 * @author 夜雨
-	 * @since 2022-02-27 18:03
-	 */
-	@Getter
-	public enum Type {
-
-		BUG, FEATURE
-	}
-
-	/**
-	 * 状态
-	 *
-	 * @author 夜雨
-	 * @since 2022-02-27 18:06
-	 */
-	@Getter
-	public enum Status {
-
-		UPDATE, WAIT, FINISH, CLOSE
-	}
-
-	private Long taskId;
-	private Type type;
-	private Status status;
-	private String digest;
-}

src/main/java/com/imyeyu/api/modules/common/entity/Template.java

@@ -1,33 +0,0 @@
-package com.imyeyu.api.modules.common.entity;
-
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import com.imyeyu.spring.entity.Entity;
-
-/**
- * @author 夜雨
- * @since 2023-09-21 00:53
- */
-@Data
-@EqualsAndHashCode(callSuper = true)
-public class Template extends Entity {
-
-	/**
-	 *
-	 *
-	 * @author 夜雨
-	 * @since 2023-09-22 16:38
-	 */
-	public enum BizType {
-
-		GIT,
-
-		FOREVER_MC
-	}
-
-	private BizType bizType;
-
-	private String bizCode;
-
-	private String data;
-}

src/main/java/com/imyeyu/api/modules/common/entity/User.java

@@ -1,68 +0,0 @@
-package com.imyeyu.api.modules.common.entity;
-
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import com.imyeyu.spring.entity.Entity;
-import com.imyeyu.utils.Time;
-
-/**
- * 用户
- *
- * @author 夜雨
- * @since 2021-03-01 17:11
- */
-@Data
-@EqualsAndHashCode(callSuper = true)
-public class User extends Entity {
-
-	/**
-	 *
-	 *
-	 * @author 夜雨
-	 * @since 2024-02-21 14:48
-	 */
-	public enum AttachType {
-
-		AVATAR,
-
-		WRAPPER,
-
-		LICENSE,
-
-		DEFAULT_AVATAR,
-
-		DEFAULT_WRAPPER
-	}
-
-	/** 用户名 */
-	protected String name;
-
-	/** 密码 */
-	protected String password;
-
-	/** 邮箱 */
-	protected String email;
-
-	/** 邮箱验证时间 */
-	protected Long emailVerifyAt;
-
-	/** 解除禁言时间 */
-	protected Long unmuteAt;
-
-	/** 解除封禁时间 */
-	protected Long unbanAt;
-
-	/** @return true 为禁言中 */
-	public boolean isMuting() {
-		return unmuteAt != null && Time.now() < unmuteAt;
-	}
-
-	/** @return true 为封禁中 */
-	public boolean isBanning() {
-		return unbanAt != null && Time.now() < unbanAt;
-	}
-
-	public boolean emailVerified() {
-		return emailVerifyAt != null;
-	}
-}

src/main/java/com/imyeyu/api/modules/common/entity/UserConfig.java

@@ -1,33 +0,0 @@
-package com.imyeyu.api.modules.common.entity;
-
-import com.imyeyu.spring.annotation.table.Id;
-import com.imyeyu.spring.entity.Updatable;
-import jakarta.validation.constraints.Min;
-import lombok.Data;
-
-/**
- * 用户设置
- *
- * @author 夜雨
- * @since 2021-08-12 15:06
- */
-@Data
-public class UserConfig implements Updatable {
-
-	@Min(1)
-	@Id
-	private Long userId;
-
-	private Boolean emailReplyRemind;
-
-	private Long updatedAt;
-
-	public UserConfig(Long uid) {
-		this.userId = uid;
-		emailReplyRemind = true;
-	}
-
-	public Boolean isEmailReplyRemind() {
-		return emailReplyRemind;
-	}
-}

src/main/java/com/imyeyu/api/modules/common/entity/UserPrivacy.java

@@ -1,51 +0,0 @@
-package com.imyeyu.api.modules.common.entity;
-
-import com.imyeyu.java.ref.Ref;
-import com.imyeyu.spring.annotation.table.Id;
-import com.imyeyu.spring.entity.Updatable;
-import jakarta.validation.constraints.Min;
-import lombok.Data;
-import lombok.NoArgsConstructor;
-
-import java.lang.reflect.Field;
-import java.util.List;
-
-/**
- * 用户隐私控制
- *
- * @author 夜雨
- * @since 2021-07-27 16:51
- */
-@Data
-@NoArgsConstructor
-public class UserPrivacy implements Updatable {
-
-	@Min(1)
-	@Id
-	private Long userId;
-
-	private boolean email;
-	private boolean sex;
-	private boolean birthdate;
-	private boolean qq;
-	private boolean lastLoginAt;
-	private boolean createdAt;
-
-	private Long updatedAt;
-
-	public UserPrivacy(Long uid) {
-		this.userId = uid;
-	}
-
-	/** @return 过滤字段列表 */
-	public List<String> listFilterFields() {
-		return Ref.listFields(getClass()).stream().filter(f -> {
-			try {
-				f.setAccessible(true);
-				return boolean.class.isAssignableFrom(f.getType()) && !(boolean) f.get(this);
-			} catch (IllegalAccessException e) {
-				throw new RuntimeException(e);
-			}
-		}).map(Field::getName).toList();
-	}
-}

src/main/java/com/imyeyu/api/modules/common/entity/UserProfile.java

@@ -1,66 +0,0 @@
-package com.imyeyu.api.modules.common.entity;
-
-import com.imyeyu.api.modules.common.bean.ImageType;
-import com.imyeyu.spring.annotation.table.Id;
-import com.imyeyu.spring.entity.Updatable;
-import jakarta.validation.constraints.Max;
-import jakarta.validation.constraints.Min;
-import jakarta.validation.constraints.Pattern;
-import jakarta.validation.constraints.Size;
-import lombok.Data;
-import lombok.NoArgsConstructor;
-
-/**
- * 用户数据
- *
- * @author 夜雨
- * @since 2021-05-29 15:58
- */
-@Data
-@NoArgsConstructor
-public class UserProfile implements Updatable {
-
-	/** 用户 ID */
-	@Min(1)
-	@Id
-	protected Long userId;
-
-	/** 封面类型 */
-	protected ImageType wrapperType;
-
-	/** 头像类型 */
-	protected ImageType avatarType;
-
-	/** 经验值 */
-	protected Integer exp;
-
-	/** 性别 */
-	@Max(1)
-	@Min(0)
-	protected Byte sex;
-
-	/** 出生日期 */
-	@Min(0)
-	protected Long birthdate;
-
-	/** QQ */
-	@Pattern(regexp = "[1-9]\\d{4,14}")
-	protected String qq;
-
-	/** 说明 */
-	@Size(max = 240)
-	protected String description;
-
-	/** 最近登录 IP */
-	protected String lastLoginIP;
-
-	/** 最近登录时间 */
-	protected Long lastLoginAt;
-
-	/** 修改时间 */
-	protected Long updatedAt;
-
-	public UserProfile(Long userId) {
-		this.userId = userId;
-	}
-}

src/main/java/com/imyeyu/api/modules/common/entity/Version.java

@@ -1,21 +0,0 @@
-package com.imyeyu.api.modules.common.entity;
-
-import lombok.Data;
-import lombok.EqualsAndHashCode;
-import com.imyeyu.spring.entity.Entity;
-
-/**
- * 版本管理
- *
- * @author 夜雨
- * @since 2021-06-10 16:01
- */
-@Data
-@EqualsAndHashCode(callSuper = true)
-public class Version extends Entity {
-
-	private String name;
-	private String version;
-	private String content;
-	private String url;
-}

src/main/java/com/imyeyu/api/modules/common/mapper/ArticleMapper.java

@@ -0,0 +1,20 @@
+package com.imyeyu.api.modules.common.mapper;
+
+import com.imyeyu.api.modules.common.entity.Article;
+import com.imyeyu.spring.mapper.BaseMapper;
+import org.apache.ibatis.annotations.Select;
+
+/**
+ * 文章
+ *
+ * @author 夜雨
+ * @since 2021-02-23 21:34
+ */
+public interface ArticleMapper extends BaseMapper<Article, String> {
+
+	@Select("UPDATE `article` SET `likes` = `likes` + 1 WHERE `id` = #{articleId}")
+	void like(Long articleId);
+
+	@Select("UPDATE `article` SET `reads` = `reads` + 1 WHERE `id` = #{articleId}")
+	void read(Long articleId);
+}

src/main/java/com/imyeyu/api/modules/common/mapper/AttachmentMapper.java

@@ -12,25 +12,46 @@ import java.util.List;
  * @author 夜雨
  * @since 2023-08-15 10:22
  */
-public interface AttachmentMapper extends BaseMapper<Attachment, Long>, RawMapper<Attachment, Long> {
+public interface AttachmentMapper extends BaseMapper<Attachment, String>, RawMapper<Attachment, String> {
 
 	/** 有效条件，非删除和销毁 */
 	String VALID = NOT_DELETE + " AND (`destroy_at` IS NULL OR " + UNIX_TIME + " < `destroy_at`)";
 
 	@Select("SELECT * FROM attachment WHERE biz_type = #{bizType} AND biz_id = #{bizId} " + VALID + LIMIT_1)
-	Attachment selectByBizId(Attachment.BizType bizType, long bizId);
+	Attachment selectByBizId(Attachment.BizType bizType, String bizId);
+
+	@Select("SELECT * FROM attachment WHERE biz_type = #{bizType} AND biz_id = #{bizId} " + VALID)
+	List<Attachment> selectAllByBizId(Attachment.BizType bizType, String bizId);
 
 	@Select("SELECT * FROM attachment WHERE mongo_id = #{mongoId} " + VALID + LIMIT_1)
 	Attachment selectByMongoId(String mongoId);
 
 	@Select("SELECT * FROM attachment WHERE biz_type = #{bizType} AND biz_id = #{bizId} AND attach_type = #{attachType} " + VALID + LIMIT_1)
-	Attachment selectByAttachType(Attachment.BizType bizType, long bizId, Enum<?> attachType);
+	Attachment selectByAttachType(Attachment.BizType bizType, String bizId, String attachType);
 
-	List<Attachment> listByBizId(Attachment.BizType bizType, Long bizId, List<Enum<?>> attachTypes, Page<Attachment> page);
+	List<Attachment> selectByBizId(Attachment.BizType bizType, String bizId, List<String> attachTypes, Page<Attachment> page);
 
-	long countByBizId(Attachment.BizType bizType, Long bizId, List<Enum<?>> attachTypes);
+	long countByBizId(Attachment.BizType bizType, String bizId, List<String> attachTypes);
 
-	List<Attachment> listByMd5s(Attachment.BizType bizType, Long bizId, List<Enum<?>> attachTypes, List<String> md5s);
+	/**
+	 * 按源附件 ID 与请求尺寸查询已缓存缩略图
+	 *
+	 * @param bizType       源附件业务类型
+	 * @param sourceId      源附件 ID
+	 * @param requestWidth  请求宽度，{@code null} 表示未指定
+	 * @param requestHeight 请求高度，{@code null} 表示未指定
+	 * @return 缩略图附件，不存在返回 {@code null}
+	 */
+	Attachment selectThumb(Attachment.BizType bizType, String sourceId, Integer requestWidth, Integer requestHeight);
+
+	/**
+	 * 查询源附件的所有未销毁缩略图（含已软删除）
+	 *
+	 * @param sourceId 源附件 ID
+	 * @return 缩略图列表
+	 */
+	@Select("SELECT * FROM attachment WHERE biz_id = #{sourceId} AND attach_type = 'THUMB' AND is_destroyed = FALSE")
+	List<Attachment> selectThumbsBySourceId(String sourceId);
 
 	@Select("SELECT * FROM attachment WHERE `is_destroyed` = FALSE AND `destroy_at` < " + UNIX_TIME)
 	List<Attachment> selectNeedDestroy();

src/main/java/com/imyeyu/api/modules/common/mapper/CommentMapper.java

@@ -2,18 +2,154 @@ package com.imyeyu.api.modules.common.mapper;
 
 import com.imyeyu.api.modules.common.entity.Comment;
 import com.imyeyu.spring.mapper.BaseMapper;
+import org.apache.ibatis.annotations.Select;
 import org.apache.ibatis.annotations.Update;
 
+import java.util.List;
+
 /**
- * 评论
+ * 评论 Mapper
  *
  * @author 夜雨
- * @since 2021-2-23 21:33
+ * @since 2026-05-27 17:20
  */
-public interface CommentMapper extends BaseMapper<Comment, Long> {
+public interface CommentMapper extends BaseMapper<Comment, String> {
 
-	long countAll(Comment.BizType bizType, Long bizId);
+	/**
+	 * 根据 ID 列表查询评论
+	 *
+	 * @param idList 评论 ID 列表
+	 * @return 评论列表
+	 */
+	List<Comment> listByIdList(List<String> idList);
 
-	@Update("UPDATE comment SET deleted_at = FLOOR(UNIX_TIMESTAMP(NOW(3)) * 1000) WHERE user_id = #{userId} ")
-	void deleteByUserId(Long userId);
+	/**
+	 * 查询业务下的主评论列表
+	 *
+	 * @param bizType 业务类型
+	 * @param bizId   业务 ID
+	 * @param offset  起始偏移量
+	 * @param limit   查询条数
+	 * @return 主评论列表
+	 */
+	List<Comment> selectRootList(String bizType, String bizId, int offset, int limit);
+
+	/**
+	 * 统计业务下的主评论数量
+	 *
+	 * @param bizType 业务类型
+	 * @param bizId   业务 ID
+	 * @return 主评论数量
+	 */
+	long countRoot(String bizType, String bizId);
+
+	/**
+	 * 查询多个根评论下的回复预览列表
+	 *
+	 * @param rootIdList 根评论 ID 列表
+	 * @param limit      每个根评论最多返回条数
+	 * @return 回复列表
+	 */
+	List<Comment> selectReplyPreviewByRootIds(List<String> rootIdList, int limit);
+
+	/**
+	 * 查询父评论下的回复列表
+	 *
+	 * @param parentId 父评论 ID
+	 * @param offset   起始偏移量
+	 * @param limit    查询条数
+	 * @return 回复列表
+	 */
+	List<Comment> selectReplyListByParentId(String parentId, int offset, int limit);
+
+	/**
+	 * 查询根评论下的回复列表
+	 *
+	 * @param rootId 根评论 ID
+	 * @param offset 起始偏移量
+	 * @param limit  查询条数
+	 * @return 回复列表
+	 */
+	List<Comment> selectReplyListByRootId(String rootId, int offset, int limit);
+
+	/**
+	 * 统计父评论下的回复数量
+	 *
+	 * @param parentId 父评论 ID
+	 * @return 回复数量
+	 */
+	long countReplyByParentId(String parentId);
+
+	/**
+	 * 统计根评论下的回复数量
+	 *
+	 * @param rootId 根评论 ID
+	 * @return 回复数量
+	 */
+	long countReplyByRootId(String rootId);
+
+	/**
+	 * 查询多个根评论下的全部回复列表
+	 *
+	 * @param rootIdList 根评论 ID 列表
+	 * @return 回复列表
+	 */
+	List<Comment> selectAllReplyListByRootIds(List<String> rootIdList);
+
+	/**
+	 * 查询根评论下的全部回复列表
+	 *
+	 * @param rootId 根评论 ID
+	 * @return 回复列表
+	 */
+	List<Comment> selectAllReplyListByRootId(String rootId);
+
+	/**
+	 * 查询单层评论列表
+	 *
+	 * @param bizType  业务类型
+	 * @param bizId    业务 ID
+	 * @param parentId 父评论 ID
+	 * @param offset   起始偏移量
+	 * @param limit    查询条数
+	 * @return 评论列表
+	 */
+	List<Comment> selectLayerList(String bizType, String bizId, String parentId, int offset, int limit);
+
+	/**
+	 * 统计单层评论数量
+	 *
+	 * @param bizType  业务类型
+	 * @param bizId    业务 ID
+	 * @param parentId 父评论 ID
+	 * @return 评论数量
+	 */
+	long countLayer(String bizType, String bizId, String parentId);
+
+	/**
+	 * 查询根评论最新回复时间
+	 *
+	 * @param rootId 根评论 ID
+	 * @return 最新回复时间
+	 */
+	@Select("SELECT created_at FROM comment WHERE root_id = #{rootId} AND parent_id IS NOT NULL" + NOT_DELETE + "ORDER BY created_at DESC LIMIT 1")
+	Long selectLatestReplyAtByRootId(String rootId);
+
+	/**
+	 * 调整回复数
+	 *
+	 * @param id    评论 ID
+	 * @param delta 变更值
+	 */
+	@Update("UPDATE comment SET reply_count = GREATEST(reply_count + #{delta}, 0), updated_at = " + UNIX_TIME + " WHERE id = #{id}" + NOT_DELETE)
+	void increaseReplyCount(String id, int delta);
+
+	/**
+	 * 调整点赞数
+	 *
+	 * @param id    评论 ID
+	 * @param delta 变更值
+	 */
+	@Update("UPDATE comment SET like_count = GREATEST(like_count + #{delta}, 0), updated_at = " + UNIX_TIME + " WHERE id = #{id}" + NOT_DELETE)
+	void increaseLikeCount(String id, int delta);
 }

src/main/java/com/imyeyu/api/modules/common/mapper/CommentRemindQueueMapper.java

@@ -1,19 +0,0 @@
-package com.imyeyu.api.modules.common.mapper;
-
-import com.imyeyu.api.modules.blog.entity.CommentRemindQueue;
-import com.imyeyu.spring.mapper.BaseMapper;
-import org.apache.ibatis.annotations.Select;
-
-import java.util.List;
-
-/**
- * 评论回复提醒队列
- *
- * @author 夜雨
- * @since 2021-08-25 00:15
- */
-public interface CommentRemindQueueMapper extends BaseMapper<CommentRemindQueue, String> {
-
-	@Select("SELECT * FROM comment_remind_queue WHERE user_id = #{userId}")
-	List<CommentRemindQueue> listByUserId(Long userId);
-}

src/main/java/com/imyeyu/api/modules/common/mapper/CommentReplyMapper.java

@@ -1,14 +0,0 @@
-package com.imyeyu.api.modules.common.mapper;
-
-
-import com.imyeyu.api.modules.common.entity.CommentReply;
-import com.imyeyu.spring.mapper.BaseMapper;
-
-/**
- * 评论回复
- *
- * @author 夜雨
- * @since 2021-08-24 10:36
- */
-public interface CommentReplyMapper extends BaseMapper<CommentReply, Long> {
-}

src/main/java/com/imyeyu/api/modules/common/mapper/DataDictMapper.java

@@ -0,0 +1,13 @@
+package com.imyeyu.api.modules.common.mapper;
+
+import com.imyeyu.api.modules.common.entity.DataDict;
+import com.imyeyu.spring.mapper.BaseMapper;
+
+/**
+ * 数据字典 Mapper
+ *
+ * @author 夜雨
+ * @since 2026-05-13 14:46
+ */
+public interface DataDictMapper extends BaseMapper<DataDict, String> {
+}

src/main/java/com/imyeyu/api/modules/common/mapper/DataDictOptionMapper.java

@@ -0,0 +1,13 @@
+package com.imyeyu.api.modules.common.mapper;
+
+import com.imyeyu.api.modules.common.entity.DataDictOption;
+import com.imyeyu.spring.mapper.BaseMapper;
+
+/**
+ * 数据字典选项 Mapper
+ *
+ * @author 夜雨
+ * @since 2026-05-13 14:46
+ */
+public interface DataDictOptionMapper extends BaseMapper<DataDictOption, String> {
+}

src/main/java/com/imyeyu/api/modules/common/mapper/EmailFilterMapper.java

@@ -0,0 +1,13 @@
+package com.imyeyu.api.modules.common.mapper;
+
+import com.imyeyu.api.modules.common.entity.EmailFilter;
+import com.imyeyu.spring.mapper.BaseMapper;
+
+/**
+ * 邮件过滤 Mapper
+ *
+ * @author 夜雨
+ * @since 2026-05-13 14:46
+ */
+public interface EmailFilterMapper extends BaseMapper<EmailFilter, String> {
+}

src/main/java/com/imyeyu/api/modules/common/mapper/EmailQueueLogMapper.java

@@ -1,11 +0,0 @@
-package com.imyeyu.api.modules.common.mapper;
-
-import com.imyeyu.api.modules.common.entity.EmailQueueLog;
-import com.imyeyu.spring.mapper.BaseMapper;
-
-/**
- * @author 夜雨
- * @since 2023-08-10 10:38
- */
-public interface EmailQueueLogMapper extends BaseMapper<EmailQueueLog, Long> {
-}

src/main/java/com/imyeyu/api/modules/common/mapper/EmailQueueMapper.java

@@ -1,22 +0,0 @@
-package com.imyeyu.api.modules.common.mapper;
-
-import com.imyeyu.api.modules.common.entity.EmailQueue;
-import com.imyeyu.spring.mapper.BaseMapper;
-import org.apache.ibatis.annotations.Select;
-
-import java.util.List;
-
-/**
- * 邮件推送队列
- *
- * @author 夜雨
- * @since 2021-08-24 16:22
- */
-public interface EmailQueueMapper extends BaseMapper<EmailQueue, String> {
-
-	@Select("SELECT * FROM email_queue WHERE biz_type = #{bizType} AND biz_id = #{bizId}")
-	EmailQueue query(EmailQueue.BizType bizType, Long bizId);
-
-	@Select("SELECT * FROM email_queue")
-	List<EmailQueue> listAll();
-}

src/main/java/com/imyeyu/api/modules/common/mapper/FeedbackMapper.java

@@ -1,13 +0,0 @@
-package com.imyeyu.api.modules.common.mapper;
-
-import com.imyeyu.api.modules.common.entity.Feedback;
-import com.imyeyu.spring.mapper.BaseMapper;
-
-/**
- * 反馈
- *
- * @author 夜雨
- * @since 2021-11-16 22:28
- */
-public interface FeedbackMapper extends BaseMapper<Feedback, Long> {
-}

src/main/java/com/imyeyu/api/modules/common/mapper/IconMapper.java

@@ -2,9 +2,6 @@ package com.imyeyu.api.modules.common.mapper;
 
 import com.imyeyu.api.modules.common.entity.Icon;
 import com.imyeyu.spring.mapper.BaseMapper;
-import org.apache.ibatis.annotations.Select;
-
-import java.util.List;
 
 /**
  * 图标
@@ -12,24 +9,5 @@ import java.util.List;
  * @author 夜雨
  * @since 2022-09-15 00:02
  */
-public interface IconMapper extends BaseMapper<Icon, Long> {
-
-	@Select("SELECT * FROM icon WHERE 1 = 1" + NOT_DELETE)
-	List<Icon> listAll();
-
-	@Select("SELECT COUNT(1) FROM icon WHERE name LIKE CONCAT('%', #{name}, '%')" + NOT_DELETE)
-	long countByName(String name);
-
-	@Select("SELECT * FROM icon WHERE name LIKE CONCAT('%', #{name}, '%')" + PAGE)
-	List<Icon> listByName(String name, long offset, long limit);
-
-	long countByLabel(String lang, String label);
-
-	List<Icon> listByLabel(String lang, String label, long offset, long limit);
-
-	@Select("SELECT COUNT(1) FROM icon WHERE unicode = #{unicode}" + NOT_DELETE)
-	long countByUnicode(String unicode);
-
-	@Select("SELECT * FROM icon WHERE unicode = #{unicode}" + PAGE)
-	List<Icon> listByUnicode(String unicode, long offset, long limit);
+public interface IconMapper extends BaseMapper<Icon, String> {
 }

src/main/java/com/imyeyu/api/modules/common/mapper/MultilingualMapper.java

@@ -2,7 +2,6 @@ package com.imyeyu.api.modules.common.mapper;
 
 import com.imyeyu.api.modules.common.entity.Multilingual;
 import com.imyeyu.spring.mapper.BaseMapper;
-import org.apache.ibatis.annotations.Select;
 
 import java.util.List;
 
@@ -10,23 +9,7 @@ import java.util.List;
  * @author 夜雨
  * @since 2023-10-25 10:47
  */
-public interface MultilingualMapper extends BaseMapper<Multilingual, Long> {
+public interface MultilingualMapper extends BaseMapper<Multilingual, String> {
 
-	// 以下临时
-
-	@Select("SELECT * FROM multilingual WHERE key LIKE CONCAT('%', #{key}, '%')" + NOT_DELETE)
-	List<Multilingual> selectByKeyLike(String key);
-
-	List<Multilingual> selectByKeyList(List<String> keys);
-
-	// 以上临时
-
-	@Select("SELECT * FROM multilingual WHERE zh_cn = #{zhCN}" + NOT_DELETE + LIMIT_1)
-	Multilingual selectByZhCN(String zhCN);
-
-	@Select("SELECT * FROM multilingual WHERE en_US IS NULL OR en_US = ''" + NOT_DELETE)
-	List<Multilingual> selectByNotTranslate();
-
-	@Select("SELECT * FROM multilingual WHERE `key` = #{key}" + NOT_DELETE + LIMIT_1)
-	Multilingual selectByKey(String key);
+	List<Multilingual> selectByIdList(List<String> idList);
 }

src/main/java/com/imyeyu/api/modules/common/mapper/NotifyDetailMapper.java

@@ -0,0 +1,13 @@
+package com.imyeyu.api.modules.common.mapper;
+
+import com.imyeyu.api.modules.common.entity.NotifyDetail;
+import com.imyeyu.spring.mapper.BaseMapper;
+
+/**
+ * 通知详情 Mapper
+ *
+ * @author 夜雨
+ * @since 2026-05-13 14:46
+ */
+public interface NotifyDetailMapper extends BaseMapper<NotifyDetail, String> {
+}

src/main/java/com/imyeyu/api/modules/common/mapper/NotifyMapper.java

@@ -0,0 +1,13 @@
+package com.imyeyu.api.modules.common.mapper;
+
+import com.imyeyu.api.modules.common.entity.Notify;
+import com.imyeyu.spring.mapper.BaseMapper;
+
+/**
+ * 通知 Mapper
+ *
+ * @author 夜雨
+ * @since 2026-05-13 14:46
+ */
+public interface NotifyMapper extends BaseMapper<Notify, String> {
+}

src/main/java/com/imyeyu/api/modules/common/mapper/SettingMapper.java

@@ -1,11 +1,7 @@
 package com.imyeyu.api.modules.common.mapper;
 
-import com.imyeyu.api.modules.common.bean.SettingKey;
 import com.imyeyu.api.modules.common.entity.Setting;
 import com.imyeyu.spring.mapper.BaseMapper;
-import org.apache.ibatis.annotations.Select;
-
-import java.util.List;
 
 /**
  * 系统配置
@@ -14,10 +10,4 @@ import java.util.List;
  * @since 2021-07-20 22:26
  */
 public interface SettingMapper extends BaseMapper<Setting, String> {
-
-	@Select("SELECT * FROM `setting` WHERE `key` = #{key}")
-	Setting selectByKey(SettingKey key);
-
-	@Select("SELECT * FROM `setting`")
-	List<Setting> listAll();
 }