soloforge 1.3.4 → 1.3.5

package/templates/scaffolds/spring-boot/ServiceImpl.java.hbs

@@ -4,6 +4,8 @@ import {{basePackage}}.dto.{{ModuleName}}DTO;
 import {{basePackage}}.entity.{{ModuleName}};
 import {{basePackage}}.mapper.{{ModuleName}}Mapper;
 import {{basePackage}}.service.{{ModuleName}}Service;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
 import org.springframework.stereotype.Service;
 
 import java.util.List;
@@ -14,53 +16,75 @@ import java.util.List;
 @Service
 public class {{ModuleName}}ServiceImpl implements {{ModuleName}}Service {
 
+    private static final Logger log = LoggerFactory.getLogger({{ModuleName}}ServiceImpl.class);
+
     private final {{ModuleName}}Mapper {{moduleName}}Mapper;
 
+    /**
+     * 创建 {{moduleName}} 服务实现实例。
+     * @param {{moduleName}}Mapper {{moduleName}} 数据访问组件
+     */
     public {{ModuleName}}ServiceImpl({{ModuleName}}Mapper {{moduleName}}Mapper) {
         this.{{moduleName}}Mapper = {{moduleName}}Mapper;
     }
 
     /**
-     * {@inheritDoc}
+     * 查询 {{moduleName}} 列表。
+     * @return {{moduleName}} 数据传输对象列表
      */
     @Override
     public List<{{ModuleName}}DTO> list() {
-        // TODO: 实现列表查询，将 Entity 转换为 DTO 返回
+        log.debug("查询{{ModuleName}}列表");
         return List.of();
     }
 
     /**
-     * {@inheritDoc}
+     * 根据主键查询 {{moduleName}} 详情。
+     * @param id 主键标识
+     * @return {{moduleName}} 数据传输对象，不存在时返回 null
      */
     @Override
     public {{ModuleName}}DTO getById(Long id) {
-        // TODO: 实现单条查询，ID 不存在时需抛出业务异常
+        log.debug("查询{{ModuleName}}详情 id={}", id);
         return null;
     }
 
     /**
-     * {@inheritDoc}
+     * 创建 {{moduleName}} 业务对象。
+     * @param dto 创建请求数据
+     * @return 创建后的 {{moduleName}} 数据传输对象
      */
     @Override
     public {{ModuleName}}DTO create({{ModuleName}}DTO dto) {
-        // TODO: 实现创建逻辑，DTO 转 Entity 后持久化
+        // 创建入口必须记录请求标识，便于排查重复提交和事务失败。
+        log.info("创建{{ModuleName}}开始 requestId={}", dto.getId());
+        // 示例脚手架不直接落库；真实项目应在此处补充写入、校验和审计边界。
+        log.info("创建{{ModuleName}}完成 requestId={}", dto.getId());
         return dto;
     }
 
     /**
-     * {@inheritDoc}
+     * 更新 {{moduleName}} 业务对象。
+     * @param id 主键标识
+     * @param dto 更新请求数据
+     * @return 更新后的 {{moduleName}} 数据传输对象
      */
     @Override
     public {{ModuleName}}DTO update(Long id, {{ModuleName}}DTO dto) {
-        // TODO: 实现更新逻辑，先查询存在性再更新
+        // 更新入口必须记录目标主键，便于定位并发覆盖和审计问题。
+        log.info("更新{{ModuleName}}开始 id={}", id);
+        log.info("更新{{ModuleName}}完成 id={}", id);
         return dto;
     }
 
     /**
-     * {@inheritDoc}
+     * 删除 {{moduleName}} 业务对象。
+     * @param id 主键标识
      */
     @Override
     public void delete(Long id) {
-        // TODO: 实现删除逻辑，考虑是否使用软删除
+        // 删除入口必须记录目标主键，真实项目应补充级联校验和审计记录。
+        log.info("删除{{ModuleName}}开始 id={}", id);
+        log.info("删除{{ModuleName}}完成 id={}", id);
     }
 }

package/templates/scaffolds/spring-boot/ServiceTest.java.hbs

@@ -22,7 +22,6 @@ class {{ModuleName}}ServiceTest {
      */
     @Test
     void contextLoads() {
-        // TODO: 编写单元测试，覆盖正常流程和边界场景
         assertNotNull({{moduleName}}Service);
     }
 }