package com.ruoyi.task.api.spi;

import com.ruoyi.common.core.domain.entity.SysUserDept;

import java.util.List;

/**
 * 「用户-科室/病区」关系查询能力 —— <b>ruoyi-task 的对外 SPI，由 smartor 侧实现</b>。
 *
 * <h3>用途</h3>
 * 子任务统计（原 {@code ServiceSubtaskController} L610 / L625 / L903 / L909）要按当前登录人
 * 查出其科室、病区列表，用于"按科室/病区分组"的统计过滤。
 * {@code sys_user_dept} 属系统域，ruoyi-task <b>不得依赖 ruoyi-system</b>，故经本端口取用。
 *
 * <h3>为什么不需要新 DTO</h3>
 * 参数与返回类型 {@link SysUserDept} 本就在 {@code ruoyi-common}，双方可见。
 *
 * <h3>⚠️ 实现必须保持"纯转发"</h3>
 * 实现方只转发到 {@code ISysUserDeptService#selectSysUserDeptList}，不加任何兜底/默认值逻辑。
 */
public interface TaskSysUserDeptPort {

    /**
     * 按条件查用户-科室关系（原 {@code ISysUserDeptService#selectSysUserDeptList}）。
     *
     * @param query 查询条件（非 null 字段参与过滤）
     * @return 关系列表
     */
    List<SysUserDept> selectSysUserDeptList(SysUserDept query);
}