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);
}