create-yss-spec 3.1.3 → 3.3.0

package/template/.trae/skills/yss-mybatis/assets/EntityQueryAspect.java

@@ -1,37 +0,0 @@
-package com.yss.cloud.mybatis.aop;
-
-import com.github.pagehelper.Page;
-import com.github.pagehelper.PageHelper;
-import com.yss.cloud.dto.page.PageQuery;
-import lombok.SneakyThrows;
-import org.aspectj.lang.ProceedingJoinPoint;
-import org.aspectj.lang.annotation.Around;
-import org.aspectj.lang.annotation.Aspect;
-
-@Aspect
-public class EntityQueryAspect {
-
-    /**
-     * 字段开启分页的方法
-     *
-     * @apiNote 1. 包命名需符合规范 com.yss.datamiddle.(项目名).service?.impl.serviceImpl.method <br/> 2. 参数为pageQuery dto的方法
-     * @param joinPoint 加入切点
-     * @param pageQuery 查询分页对象dtp
-     * @return 执行结果
-     */
-    @Around("( (execution(public * (@org.springframework.stereotype.Repository *).*(..)) || execution(* com.yss..*.gateway.impl.*.*(..))))&& (args(pageQuery)||args(pageQuery,..))")
-    @SneakyThrows
-    public Object interceptEntityQueries(ProceedingJoinPoint joinPoint, PageQuery pageQuery) {
-        if (pageQuery != null) {
-            //分页查询开始
-            Page<Object> page = PageHelper.offsetPage(pageQuery.getOffset(), pageQuery.getPageSize());
-            // 继续执行目标方法
-            Object result = joinPoint.proceed();
-            long total = page.getTotal();
-            pageQuery.setTempTotalCount(total);
-            return result;
-        }
-        // 不满足条件时直接执行目标方法
-        return joinPoint.proceed();
-    }
-}

package/template/.trae/skills/yss-mybatis/assets/MybatisBaseConfiguration.java

@@ -1,18 +0,0 @@
-package com.yss.cloud.mybatis;
-
-import com.yss.cloud.mybatis.config.PageQueryEntityConfigration;
-import org.springframework.boot.context.properties.EnableConfigurationProperties;
-import org.springframework.context.annotation.Configuration;
-import org.springframework.context.annotation.Import;
-
-
-@Configuration
-@Import({
-        PageQueryEntityConfigration.class}
-)
-@EnableConfigurationProperties({PrimaryDataSourceProperties.class,
-        MybatisPlusGlobalProperties.class,
-        YssMybatisMapperProperties.class})
-public class MybatisBaseConfiguration {
-
-}

package/template/.trae/skills/yss-mybatis/assets/PageQueryEntityConfigration.java

@@ -1,18 +0,0 @@
-package com.yss.cloud.mybatis.config;
-
-import com.yss.cloud.mybatis.aop.EntityQueryAspect;
-import lombok.extern.slf4j.Slf4j;
-import org.springframework.context.annotation.Bean;
-import org.springframework.context.annotation.Configuration;
-import org.springframework.context.annotation.Primary;
-
-@Configuration
-@Slf4j
-public class PageQueryEntityConfigration {
-    @Primary
-    @Bean
-    public EntityQueryAspect entityQueryAspect() {
-        log.info("【MapperConfiguration】DataSource 获取数据源primaryDataSourceProperties配置");
-        return new EntityQueryAspect();
-    }
-}

package/template/.trae/skills/yss-mybatis/references/README.md

@@ -1,57 +0,0 @@
-# 参考资料
-
-本文档详细介绍了 `yss-component-mybatis-starter` 模块中的核心类和配置类，这些类构成了通用 MyBatis 模式的基础。
-
-## 核心类 (Core Classes)
-
-### 1. BaseRepository.java
-**位置**: `../assets/BaseRepository.java`
-
-`BaseRepository<T, D>` 是通用 MyBatis 模式下的核心 Mapper 接口，所有业务 Repository 都应继承它。
-
-**主要特性**:
-- **继承链**: 继承了 `io.mybatis.mapper.BaseMapper` (基础 CRUD), `io.mybatis.mapper.list.ListMapper` (批量操作), 和 `com.baomidou.mybatisplus.core.mapper.Mapper` (兼容性)。
-- **通用方法**:
-  - `insert`, `update`, `delete`: 标准的单表操作。
-  - `selectBatchIds`, `deleteBatchIds`: 批量操作。
-  - `selectByMap`, `selectMaps`, `selectObjs`: 基于 Map 和 Wrapper 的查询。
-- **扩展点**: 允许用户通过继承此接口，获得开箱即用的 CRUD 能力，无需编写 XML。
-
-### 2. EntityQueryAspect.java
-**位置**: `../assets/EntityQueryAspect.java`
-
-这是一个 AOP 切面，用于实现非侵入式的自动分页功能。
-
-**工作原理**:
-- **切点**: 拦截所有 Repository 层 (`@Repository`) 和 Gateway 实现层的方法。
-- **条件**: 方法参数中必须包含 `com.yss.cloud.dto.page.PageQuery` 对象。
-- **逻辑**:
-  1. 检查 `PageQuery` 参数是否非空。
-  2. 调用 `PageHelper.offsetPage(offset, pageSize)` 开启分页。
-  3. 执行目标方法。
-  4. 获取分页结果的总记录数 (`page.getTotal()`)。
-  5. 将总数回填到 `PageQuery.tempTotalCount` 字段中。
-
-### 3. MybatisBaseConfiguration.java
-**位置**: `../assets/MybatisBaseConfiguration.java`
-
-MyBatis 基础配置类，负责加载核心组件。
-
-**主要功能**:
-- **导入配置**: 导入了 `PageQueryEntityConfigration`，确保分页切面生效。
-- **启用属性**: 启用了 `PrimaryDataSourceProperties`, `MybatisPlusGlobalProperties`, `YssMybatisMapperProperties` 等配置属性类。
-
-### 4. PageQueryEntityConfigration.java
-**位置**: `../assets/PageQueryEntityConfigration.java`
-
-负责注册分页查询切面。
-
-**主要功能**:
-- 定义了 `entityQueryAspect` Bean，使其受 Spring 容器管理，从而激活自动分页拦截功能。
-
-## 使用建议
-
-当您在开发中使用通用 MyBatis 模式时：
-1. **定义 Repository**: 直接继承 `BaseRepository<Entity, ID>`。
-2. **分页查询**: 在方法参数中添加 `PageQuery`，框架会自动处理分页逻辑。
-3. **批量操作**: 使用 `insertList`, `updateList` 等方法进行高效的数据处理。

package/template/.trae/skills/yss-repository/references/infrastructure-layer-guide.md

@@ -1,107 +0,0 @@
-# YSS Infrastructure Target Profile 指南
-
-本指南只定义 `target-domain-model + mybatis-plus`。历史 `Entity + DTO/VO Gateway` 为 `unsupported`，不存在旧架构 Profile。
-
-## 1. 职责
-
-- 实现既有 Domain Gateway，负责 Aggregate 持久化；不创建或改写 Gateway interface。
-- 实现 Application Query Port，负责分页、列表和读模型。
-- 定义 PO、MyBatis-Plus Repository/Mapper、XML 和数据源适配。
-- 通过 Spring MapStruct Bean 完成 `PO <-> Domain Model`、`PO -> Application Result`。
-
-Infrastructure 不拥有业务事务边界，不向 Application/Web 暴露 PO，也不直接生成 HTTP VO。
-
-## 2. 包结构
-
-```text
-{base_package}.infrastructure
-├── persistence
-│   ├── po
-│   ├── repository
-│   ├── convertor
-│   └── gateway
-└── query
-    ├── adapter
-    └── convertor
-```
-
-新脚手架固定使用 `{base_package}.infrastructure`。已有 `{base_package}.repository` 工程不由 scaffold 改写；需要现代化时单独立项。
-
-## 3. Domain Gateway 实现
-
-```java
-@Repository
-@RequiredArgsConstructor
-public class QualityTemplateGatewayImpl implements QualityTemplateGateway {
-    private final QualityTemplateRepository repository;
-    private final QualityTemplatePersistenceConvertor convertor;
-
-    @Override
-    public Optional<QualityTemplate> findById(QualityTemplateId id) {
-        return Optional.ofNullable(repository.selectById(id.value()))
-                .map(convertor::toDomain);
-    }
-
-    @Override
-    public void save(QualityTemplate aggregate) {
-        repository.insertOrUpdate(convertor.toPO(aggregate));
-    }
-}
-```
-
-GatewayImpl 不接收 Web Cmd/Query，不返回 VO/PageResult，不声明新的业务事务。
-
-## 4. Query Port 实现
-
-分页/列表属于 Application Query Port：
-
-```java
-@Repository
-@RequiredArgsConstructor
-public class QualityTemplateQueryAdapter implements QualityTemplateQueryPort {
-    private final QualityTemplateRepository repository;
-    private final QualityTemplateQueryConvertor convertor;
-
-    @Override
-    public PageResult<QualityTemplateResult> page(QualityTemplatePageQuery query) {
-        // orderBy/groupBy 必须先映射到批准列白名单，再构造 MyBatis 条件。
-        return convertor.toResultPage(repository.selectPage(...));
-    }
-}
-```
-
-`PageQuery` 可以在 Web/Application/Infrastructure 协作链使用，但不得进入 Domain。`orderBy` / `groupBy` 禁止直接拼接 SQL。
-
-## 5. PO 与 Repository
-
-- Target Profile 使用 `*PO`；旧式 `*Entity` 布局为 `unsupported`。
-- PO 默认使用最小 Lombok 注解，不无条件使用 `@Data`。
-- 当前实现继承项目既有 `BasePlusRepository<PO>`；普通 MyBatis 为 `unsupported`。
-- Mapper XML 位于项目既有扫描路径；扫描包和 XML 路径必须由集成测试证明。
-
-## 6. MapStruct
-
-```java
-@Mapper(componentModel = "spring")
-public interface QualityTemplatePersistenceConvertor {
-    QualityTemplate toDomain(QualityTemplatePO source);
-    QualityTemplatePO toPO(QualityTemplate source);
-}
-```
-
-- 禁止 `INSTANCE = Mappers.getMapper(...)`。
-- Convertor 使用构造器注入。
-- 父 POM 必须配置 `mapstruct-processor`、Lombok 和 `lombok-mapstruct-binding`。
-- 验证必须编译生成实现，不能只检查接口文本。
-
-## 7. 验证
-
-- Domain Gateway：保存后可通过 Gateway seam 重新加载等价 Aggregate。
-- Query Port：分页、total、排序白名单和空结果。
-- Mapper/Repository：实际 MyBatis-Plus/H2 或批准数据库 fixture。
-- Architecture：Infrastructure 可以依赖 Application/Domain；反向依赖必须失败。
-- 使用项目根 `./mvnw test/package` 留证。
-
-## 8. 旧架构边界
-
-检测到 Repository 直接接收 client Query、返回 VO、Convertor 做 `PO -> VO` 或使用旧式 Entity 布局时，返回 `unsupported`，不得由新 scaffold 自动改写。旧项目继续按原工程维护；现代化改造必须单独立项。