---
sync_policy: engine_only
---
package {{basePackage}}.service.impl;

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;

/**
 * {{ModuleName}} 服务实现 — 提供 {{moduleName}} 模块业务逻辑的具体实现。
 */
@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;
    }

    /**
     * 查询 {{moduleName}} 列表。
     * @return {{moduleName}} 数据传输对象列表
     */
    @Override
    public List<{{ModuleName}}DTO> list() {
        log.debug("查询{{ModuleName}}列表");
        return List.of();
    }

    /**
     * 根据主键查询 {{moduleName}} 详情。
     * @param id 主键标识
     * @return {{moduleName}} 数据传输对象，不存在时返回 null
     */
    @Override
    public {{ModuleName}}DTO getById(Long id) {
        log.debug("查询{{ModuleName}}详情 id={}", id);
        return null;
    }

    /**
     * 创建 {{moduleName}} 业务对象。
     * @param dto 创建请求数据
     * @return 创建后的 {{moduleName}} 数据传输对象
     */
    @Override
    public {{ModuleName}}DTO create({{ModuleName}}DTO dto) {
        // 创建入口必须记录请求标识，便于排查重复提交和事务失败。
        log.info("创建{{ModuleName}}开始 requestId={}", dto.getId());
        // 示例脚手架不直接落库；真实项目应在此处补充写入、校验和审计边界。
        log.info("创建{{ModuleName}}完成 requestId={}", dto.getId());
        return dto;
    }

    /**
     * 更新 {{moduleName}} 业务对象。
     * @param id 主键标识
     * @param dto 更新请求数据
     * @return 更新后的 {{moduleName}} 数据传输对象
     */
    @Override
    public {{ModuleName}}DTO update(Long id, {{ModuleName}}DTO dto) {
        // 更新入口必须记录目标主键，便于定位并发覆盖和审计问题。
        log.info("更新{{ModuleName}}开始 id={}", id);
        log.info("更新{{ModuleName}}完成 id={}", id);
        return dto;
    }

    /**
     * 删除 {{moduleName}} 业务对象。
     * @param id 主键标识
     */
    @Override
    public void delete(Long id) {
        // 删除入口必须记录目标主键，真实项目应补充级联校验和审计记录。
        log.info("删除{{ModuleName}}开始 id={}", id);
        log.info("删除{{ModuleName}}完成 id={}", id);
    }
}