package com.cico.nest.lcdp.boot.core.qxsd.application.service;

import jakarta.validation.*;
import com.cico.nest.lcdp.boot.core.qxsd.adapter.web.vo.tunnelHole.*;
import com.cico.nest.lcdp.boot.core.qxsd.infrastructure.gatewayimpl.database.dataobject.TunnelHoleV2DO;
import com.cico.nest.lcdp.framework.common.pojo.PageResult;

import java.util.List;

/**
 * 隧道设施上下行洞 Service 接口
 *
 * @author 管理员
 */
public interface TunnelHoleService {

    /**
     * 创建隧道设施上下行洞
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    String createTunnelHole(@Valid TunnelHoleSaveReqVO createReqVO);

    /**
     * 更新隧道设施上下行洞
     *
     * @param updateReqVO 更新信息
     */
    void updateTunnelHole(@Valid TunnelHoleSaveReqVO updateReqVO);

    /**
     * 删除隧道设施上下行洞
     *
     * @param id 编号
     */
    void deleteTunnelHole(String id);

    /**
     * 获得隧道设施上下行洞
     *
     * @param id 编号
     * @return 隧道设施上下行洞
     */
    TunnelHoleV2DO getTunnelHole(String id);

    /**
     * 获得隧道设施上下行洞分页
     *
     * @param pageReqVO 分页查询
     * @return 隧道设施上下行洞分页
     */
    PageResult<TunnelHoleV2DO> getTunnelHolePage(TunnelHolePageReqVO pageReqVO);


    /**
     * 根据sfHoleId获取隧道设施上下行洞
     * @param sfHoleId
     * @return
     */
    TunnelHoleV2DO getTunnelSfHoleId(String sfHoleId);


    /**
     * 获得隧道tunnelId 关联的洞信息
     *
     * @param baseTunnelId 编号
     * @return 隧道设施上下行洞
     */
    List<TunnelHoleV2DO> getTunnelBaseId(String baseTunnelId);
}
