package com.ruoyi.task.api.spi;
|
|
import com.ruoyi.common.core.domain.entity.SysDept;
|
|
/**
|
* 科室查询能力 —— <b>ruoyi-task 的对外 SPI，由 smartor 侧实现</b>。
|
*
|
* <h3>用途</h3>
|
* 任务创建/子任务组装时按科室编码反查科室信息
|
* （原 {@code SysDept2Mapper#selectDeptByCode(deptCode, orgid)}，
|
* 见 {@code ServiceSubtaskServiceImpl} L1004 / L5488）。
|
* {@code sys_dept} 属系统域，ruoyi-task 不得自写 SQL，也不依赖 ruoyi-system，
|
* 因此经本端口取用。
|
*
|
* <h3>为什么不需要新 DTO</h3>
|
* 返回类型 {@link SysDept} 本身就在 {@code ruoyi-common}，双方可见，直接用实体。
|
*
|
* <h3>⚠️ 实现必须保持"纯转发"</h3>
|
* 只转发到 {@code SysDept2Mapper}，不得加入默认值补齐或兜底查询等新逻辑。
|
*/
|
public interface TaskSysDeptPort {
|
|
/**
|
* 按科室编码查科室（原 {@code SysDept2Mapper#selectDeptByCode}）。
|
*
|
* @param deptCode 科室编码
|
* @param orgid 机构 id（可为 {@code null}）
|
* @return 科室；不存在返回 {@code null}
|
*/
|
SysDept selectDeptByCode(String deptCode, String orgid);
|
}
|
