package shop.alien.store.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import org.springframework.web.multipart.MultipartFile;
import shop.alien.entity.result.R;
import shop.alien.entity.store.LawFirm;
import shop.alien.entity.store.vo.LawFirmPaymentVO;

import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.List;

/**
 * 律所表 服务类
 *
 * @author system
 * @since 2025-01-XX
 */
public interface StoreLawFirmService extends IService<LawFirm> {

    /**
     * 分页查询律所列表
     *
     * @param pageNum  页码
     * @param pageSize 页容
     * @param firmName 律所名称
     * @param status   状态
     * @return IPage<LawFirm>
     */
    R<IPage<LawFirm>> getLawFirmList(int pageNum, int pageSize, String firmName, Integer status);


    /**
     * 批量填充律所的收款账号列表
     *
     * @param lawFirmList 律所列表
     */
    void fillPaymentList(List<LawFirm> lawFirmList);

    /**
     * 新增律所
     *
     * @param lawFirm 律所
     * @return R<LawFirm>
     */
    R<LawFirm> addLawFirm(LawFirm lawFirm);

    /**
     * 编辑律所
     *
     * @param lawFirm 律所
     * @return R<LawFirm>
     */
    R<LawFirm> editLawFirm(LawFirm lawFirm);

    /**
     * 删除律所
     *
     * @param id 主键
     * @return R<Boolean>
     */
    R<Boolean> deleteLawFirm(Integer id);

    /**
     * 导出律所数据到Excel
     *
     * @param response HTTP响应
     * @throws IOException IO异常
     */
    void exportLawFirm(HttpServletResponse response) throws IOException;

    /**
     * 导入律所数据从Excel
     *
     * @param file Excel文件
     * @return R<String> 返回导入结果信息
     */
    R<String> importLawFirm(MultipartFile file);

    /**
     * 获取律所详情
     *
     * @param id 律所ID
     * @return R<LawFirm>
     */
    R<LawFirm> getLawFirmDetail(Integer id);

    /**
     * 下载律所Excel导入模板
     *
     * @param response HTTP响应
     * @throws IOException IO异常
     */
    void downloadTemplate(HttpServletResponse response) throws IOException;

    /**
     * 分页查询律所子表关联律所表
     *
     * @param pageNum 页码
     * @param pageSize 页容
     * @param firmId 律所ID
     * @param paymentAccount 收款账号（模糊查询）
     * @param firmName 律所名称（模糊查询）
     * @param creditCode 统一社会信用代码
     * @param status 律所状态
     * @param certificationStatus 认证状态
     * @param directorName 负责人姓名（模糊查询）
     * @param createdTimeStart 创建时间开始
     * @param createdTimeEnd 创建时间结束
     * @return IPage<LawFirmPaymentVO>
     */
    R<IPage<LawFirmPaymentVO>> getPaymentPageWithFirm(
            int pageNum, int pageSize,
            Integer firmId, String paymentAccount, String firmName, String creditCode,
            Integer status, Integer certificationStatus, String directorName, String phone,
            String createdTimeStart, String createdTimeEnd
    );
}
