ai-engineering-init 1.3.4 → 1.4.0

package/.codex/skills/file-oss-management/references/entities.md

@@ -0,0 +1,105 @@
+# OSS 数据库实体类定义
+
+## SysOss 实体
+
+```java
+@Data
+@EqualsAndHashCode(callSuper = true)
+@TableName("sys_oss")
+public class SysOss extends TenantEntity {
+
+    @TableId(value = "oss_id")
+    private Long ossId;
+
+    private String fileName;         // OSS对象键
+    private String originalName;     // 原始文件名
+    private String fileSuffix;       // 后缀名（如 .jpg）
+    private String url;              // URL地址
+    private String ext1;             // 扩展字段（JSON）
+    private String service;          // 服务商标识
+
+    // 继承自 TenantEntity: tenantId, createTime, createBy, updateTime, updateBy, delFlag
+}
+```
+
+## SysOssVo 视图对象
+
+```java
+@Data
+@AutoMapper(target = SysOss.class)
+public class SysOssVo implements Serializable {
+
+    private Long ossId;
+    private String fileName;
+    private String originalName;
+    private String fileSuffix;
+    private String url;
+    private String ext1;
+    private Date createTime;
+    private Long createBy;
+
+    @Translation(type = TransConstant.USER_ID_TO_NAME, mapper = "createBy")
+    private String createByName;  // 上传人名称（自动翻译）
+
+    private String service;
+}
+```
+
+## SysOssBo 业务对象
+
+```java
+@Data
+@EqualsAndHashCode(callSuper = true)
+@AutoMapper(target = SysOss.class, reverseConvertGenerate = false)
+public class SysOssBo extends BaseEntity {
+
+    private Long ossId;
+    private String fileName;
+    private String originalName;
+    private String fileSuffix;
+    private String url;
+    private String ext1;
+    private String service;
+}
+```
+
+## SysOssExt 扩展信息对象
+
+> 以 JSON 字符串形式存储在 ext1 字段中
+
+```java
+@Data
+public class SysOssExt implements Serializable {
+
+    private String bizType;         // 业务类型（avatar、report等）
+    private Long fileSize;          // 文件大小（字节）
+    private String contentType;     // MIME类型
+    private String source;          // 来源标识
+    private String uploadIp;        // 上传IP
+    private String remark;          // 备注
+    private List<String> tags;      // 标签
+    private String refId;           // 绑定业务ID
+    private String refType;         // 绑定业务类型
+    private Boolean isTemp;         // 是否临时文件
+    private String md5;             // 文件MD5值
+}
+```
+
+## OssProperties 配置类
+
+```java
+@Data
+public class OssProperties {
+
+    private String tenantId;
+    private String endpoint;       // 访问站点
+    private String domain;         // 自定义域名
+    private String prefix;         // 文件前缀
+    private String accessKey;
+    private String secretKey;
+    private String bucketName;
+    private String region;
+    private String isHttps;        // Y/N
+    private String accessPolicy;   // 0-private, 1-public, 2-custom
+}
+```

package/.codex/skills/file-oss-management/references/service-impl.md

@@ -0,0 +1,104 @@
+# SysOssServiceImpl 完整实现
+
+> 位置：`ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/impl/SysOssServiceImpl.java`
+
+## 文件上传
+
+```java
+@RequiredArgsConstructor
+@Service
+public class SysOssServiceImpl implements ISysOssService {
+
+    private final SysOssMapper baseMapper;
+
+    @Override
+    public SysOssVo upload(MultipartFile file) {
+        if (ObjectUtil.isNull(file) || file.isEmpty()) {
+            throw new ServiceException("上传文件不能为空");
+        }
+
+        String originalfileName = file.getOriginalFilename();
+        String suffix = StringUtils.substring(originalfileName,
+                                             originalfileName.lastIndexOf("."),
+                                             originalfileName.length());
+
+        OssClient storage = OssFactory.instance();
+
+        UploadResult uploadResult;
+        try {
+            uploadResult = storage.uploadSuffix(file.getBytes(), suffix, file.getContentType());
+        } catch (IOException e) {
+            throw new ServiceException(e.getMessage());
+        }
+
+        SysOssExt ext1 = new SysOssExt();
+        ext1.setFileSize(file.getSize());
+        ext1.setContentType(file.getContentType());
+
+        return buildResultEntity(originalfileName, suffix,
+            storage.getConfigKey(), uploadResult, ext1);
+    }
+
+    private SysOssVo buildResultEntity(String originalfileName, String suffix,
+        String configKey, UploadResult uploadResult, SysOssExt ext1) {
+
+        SysOss oss = new SysOss();
+        oss.setUrl(uploadResult.getUrl());
+        oss.setFileSuffix(suffix);
+        oss.setFileName(uploadResult.getFilename());       // 小写 'n'
+        oss.setOriginalName(originalfileName);
+        oss.setService(configKey);
+        oss.setExt1(JsonUtils.toJsonString(ext1));
+
+        baseMapper.insert(oss);
+        SysOssVo sysOssVo = MapstructUtils.convert(oss, SysOssVo.class);
+        return this.matchingUrl(sysOssVo);
+    }
+}
+```
+
+## 文件下载
+
+```java
+@Override
+public void download(Long ossId, HttpServletResponse response) throws IOException {
+    SysOssVo sysOss = SpringUtils.getAopProxy(this).getById(ossId);
+    if (ObjectUtil.isNull(sysOss)) {
+        throw new ServiceException("文件数据不存在!");
+    }
+
+    FileUtils.setAttachmentResponseHeader(response, sysOss.getOriginalName());
+    response.setContentType(MediaType.APPLICATION_OCTET_STREAM_VALUE + "; charset=UTF-8");
+
+    OssClient storage = OssFactory.instance(sysOss.getService());
+    storage.download(sysOss.getFileName(),
+        response.getOutputStream(),
+        response::setContentLengthLong);
+}
+```
+
+## 文件删除
+
+```java
+@Override
+public Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid) {
+    List<SysOss> list = baseMapper.selectByIds(ids);
+    for (SysOss sysOss : list) {
+        OssClient storage = OssFactory.instance(sysOss.getService());
+        storage.delete(sysOss.getUrl());
+    }
+    return baseMapper.deleteByIds(ids) > 0;
+}
+```
+
+## 私有桶预签名URL
+
+```java
+private SysOssVo matchingUrl(SysOssVo oss) {
+    OssClient storage = OssFactory.instance(oss.getService());
+    if (AccessPolicyType.PRIVATE == storage.getAccessPolicy()) {
+        oss.setUrl(storage.createPresignedGetUrl(oss.getFileName(), Duration.ofSeconds(120)));
+    }
+    return oss;
+}
+```

package/.codex/skills/git-workflow/SKILL.md

@@ -75,11 +75,23 @@ git commit -m "feat(system): 新增xxx功能"
 ### 不要提交的文件
 
 ```bash
-# ❌ 配置文件（绝对不提交）
+# ❌ 团队项目配置文件（绝对不提交，包含数据库/中间件/环境信息）
+core-base/src/main/resources/bootstrap.yml
+core-base/src/main/resources/bootstrap-dev.yml
+core-base/src/main/resources/ConfigSource.properties
+core-base/src/main/resources/license.dat
+core-base/src/main/resources/logback-spring.xml
+core-base/src/main/resources/message_*.properties
+
+# ❌ 通用配置文件（绝对不提交）
 ruoyi-admin/src/main/resources/application.yml
 ruoyi-admin/src/main/resources/application-*.yml
 ruoyi-common/**/resources/*.yml
 
+# ❌ 测试/迁移基础设施文件（包含本地数据源配置，不提交）
+**/WebMvcTestConfig.java
+**/DataSourceMigration.java
+
 # ❌ IDE 配置
 .idea/
 .vscode/
@@ -335,14 +347,15 @@ git log --author="作者名"
 
 1. **不要强制推送到主分支**
    ```bash
-   # ❌ 禁止
-   git push --force origin 5.X
+   # ❌ 禁止（团队主分支为 master）
+   git push --force origin master
+   git push --force origin main
    ```
 
 2. **不要在主分支直接开发**
    ```bash
-   # ❌ 禁止
-   git checkout 5.X
+   # ❌ 禁止（团队主分支为 master，不在此分支直接提交）
+   git checkout master
    # 直接修改代码...
    ```
 
@@ -352,8 +365,17 @@ git log --author="作者名"
    application.yml
    application-dev.yml
    application-prod.yml
+   bootstrap.yml
+   bootstrap-dev.yml
+   ConfigSource.properties
+   license.dat
+   logback-spring.xml
+   message_*.properties
    credentials.json
    password.txt
+   # ❌ 禁止提交（包含本地数据源/测试环境配置）
+   WebMvcTestConfig.java
+   DataSourceMigration.java
    ```
 
 4. **不要自动 push（除非用户明确要求）**