package cn.iocoder.yudao.module.wxcp.service.member;

import cn.iocoder.yudao.module.wxcp.controller.admin.member.vo.WxCpDepartmentRespVO;
import cn.iocoder.yudao.module.wxcp.controller.admin.member.vo.WxCpMemberRespVO;

import java.util.List;

/**
 * 企业微信通讯录 Service 接口
 *
 * 数据实时取自企业微信接口。企业微信对通讯录接口有频率限制，
 * 调用方（管理后台页面）应避免高频轮询。
 *
 * @author 超级管理员
 */
public interface WxCpMemberService {

    /**
     * 获得部门树（含成员数）
     *
     * @return 部门树，根节点为顶级部门
     */
    List<WxCpDepartmentRespVO> getDepartmentTree();

    /**
     * 获得部门平铺列表
     *
     * @return 部门列表
     */
    List<WxCpDepartmentRespVO> getDepartmentList();

    /**
     * 获得成员列表
     *
     * @param departmentId 部门ID；传 null 时取根部门（即全部可见成员）
     * @param fetchChild   是否递归获取子部门成员
     * @return 成员列表
     */
    List<WxCpMemberRespVO> getMemberList(Long departmentId, Boolean fetchChild);

}