ai-engineering-init 1.3.3 → 1.4.0

package/.claude/skills/security-guard/references/encrypt-config.md

@@ -0,0 +1,103 @@
+# 数据加密详细配置
+
+## 加密配置（application.yml）
+
+```yaml
+mybatis-encryptor:
+  enable: true
+  algorithm: AES
+  password: your-aes-key-16bit    # AES 密钥（16/24/32位）
+  encode: BASE64
+  publicKey: xxx                  # RSA 公钥
+  privateKey: xxx                 # RSA 私钥
+```
+
+## EncryptUtils 工具类
+
+```java
+import org.dromara.common.encrypt.utils.EncryptUtils;
+
+// AES
+String encrypted = EncryptUtils.encryptByAes(data, aesKey);
+String decrypted = EncryptUtils.decryptByAes(encrypted, aesKey);
+
+// RSA（公钥加密，私钥解密）
+String encrypted = EncryptUtils.encryptByRsa(data, publicKey);
+String decrypted = EncryptUtils.decryptByRsa(encrypted, privateKey);
+
+// SM2 国密
+String encrypted = EncryptUtils.encryptBySm2(data, publicKey);
+String decrypted = EncryptUtils.decryptBySm2(encrypted, privateKey);
+
+// SM4 国密
+String encrypted = EncryptUtils.encryptBySm4(data, sm4Key);
+String decrypted = EncryptUtils.decryptBySm4(encrypted, sm4Key);
+
+// BASE64
+String encoded = EncryptUtils.encryptByBase64(data);
+String decoded = EncryptUtils.decryptByBase64(encoded);
+```
+
+## 字段加密完整示例
+
+```java
+import org.dromara.common.encrypt.annotation.EncryptField;
+import org.dromara.common.encrypt.enumd.AlgorithmType;
+import org.dromara.common.encrypt.enumd.EncodeType;
+
+public class User {
+    @EncryptField                                                          // 使用全局配置
+    private String password;
+
+    @EncryptField(algorithm = AlgorithmType.AES)                          // AES
+    private String idCard;
+
+    @EncryptField(algorithm = AlgorithmType.SM4)                          // SM4
+    private String phone;
+
+    @EncryptField(algorithm = AlgorithmType.AES, encode = EncodeType.HEX) // AES + HEX 编码
+    private String bankCard;
+}
+```
+
+## @RateLimiter 注解参数
+
+| 参数 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `key` | String | `""` | 限流 key，支持 SpEL |
+| `time` | int | `60` | 时间窗口（秒） |
+| `count` | int | `100` | 最大请求次数 |
+| `limitType` | LimitType | `DEFAULT` | 限流类型（DEFAULT/IP/CLUSTER） |
+| `message` | String | 国际化 key | 错误提示 |
+| `timeout` | int | `86400` | Redis 超时时间（秒） |
+
+## @RepeatSubmit 注解参数
+
+| 参数 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `interval` | int | `5000` | 间隔时间 |
+| `timeUnit` | TimeUnit | `MILLISECONDS` | 时间单位 |
+| `message` | String | 国际化 key | 错误提示 |
+
+## 文件上传安全模板
+
+```java
+private static final Set<String> ALLOWED_TYPES = Set.of(
+    "image/jpeg", "image/png", "image/gif", "image/webp"
+);
+private static final long MAX_FILE_SIZE = 10 * 1024 * 1024; // 10MB
+
+public void uploadFile(MultipartFile file) {
+    if (!ALLOWED_TYPES.contains(file.getContentType())) {
+        throw new ServiceException("不支持的文件类型");
+    }
+    if (file.getSize() > MAX_FILE_SIZE) {
+        throw new ServiceException("文件大小不能超过10MB");
+    }
+    String extension = getExtension(file.getOriginalFilename());
+    if (!Set.of(".jpg", ".jpeg", ".png", ".gif", ".webp").contains(extension.toLowerCase())) {
+        throw new ServiceException("不支持的文件扩展名");
+    }
+    String newName = UUID.randomUUID() + extension; // 重命名防路径穿越
+}
+```

package/.claude/skills/security-guard/references/sensitive-strategies.md

@@ -0,0 +1,42 @@
+# 数据脱敏策略完整列表（17种）
+
+> 来源：`ruoyi-common-sensitive/.../core/SensitiveStrategy`
+
+| 策略 | 枚举值 | 脱敏效果 | 说明 |
+|------|--------|---------|------|
+| 身份证 | `ID_CARD` | `110***********1234` | 保留前3位和后4位 |
+| 手机号 | `PHONE` | `138****8888` | 保留前3位和后4位 |
+| 邮箱 | `EMAIL` | `t**@example.com` | 保留用户名首尾和完整域名 |
+| 银行卡 | `BANK_CARD` | `6222***********1234` | 保留前4位和后4位 |
+| 中文姓名 | `CHINESE_NAME` | `张*` | 保留姓氏 |
+| 地址 | `ADDRESS` | `北京市朝阳区****` | 保留前8个字符 |
+| 固定电话 | `FIXED_PHONE` | `010****1234` | 保留区号和后4位 |
+| 密码 | `PASSWORD` | `******` | 全部掩码 |
+| IPv4 地址 | `IPV4` | `192.168.***.***` | 保留网络段 |
+| IPv6 地址 | `IPV6` | 部分隐藏 | 保留前缀 |
+| 车牌号 | `CAR_LICENSE` | `京A***12` | 支持普通和新能源 |
+| 用户ID | `USER_ID` | 随机数字 | 生成随机数字替代 |
+| 首字符保留 | `FIRST_MASK` | `张***` | 只显示第一个字符 |
+| 通用掩码 | `STRING_MASK` | `1234**7890` | 前4+4个*+后4 |
+| 高安全级别 | `MASK_HIGH_SECURITY` | `to******en` | 前2后2可见 |
+| 清空 | `CLEAR` | 空字符串 | 返回空字符串 |
+| 置空 | `CLEAR_TO_NULL` | `null` | 返回 null |
+
+## 用法示例
+
+```java
+@Sensitive(strategy = SensitiveStrategy.PHONE)
+private String phone;
+
+@Sensitive(strategy = SensitiveStrategy.ID_CARD)
+private String idCard;
+
+@Sensitive(strategy = SensitiveStrategy.ADDRESS)
+private String address;
+
+@Sensitive(strategy = SensitiveStrategy.IPV4)
+private String loginIp;
+
+@Sensitive(strategy = SensitiveStrategy.CAR_LICENSE)
+private String carNumber;
+```