package com.yhy.module.core.service.boq;

import com.yhy.module.core.controller.admin.boq.vo.BoqGuideTreeRespVO;
import com.yhy.module.core.controller.admin.boq.vo.BoqGuideTreeSaveReqVO;
import java.util.List;
import javax.validation.Valid;

/**
 * 清单指引树 Service 接口
 *
 * @author yhy
 */
public interface BoqGuideTreeService {

    /**
     * 创建节点
     *
     * @param createReqVO 创建信息
     * @return 节点ID
     */
    Long createNode(@Valid BoqGuideTreeSaveReqVO createReqVO);

    /**
     * 更新节点
     *
     * @param updateReqVO 更新信息
     */
    void updateNode(@Valid BoqGuideTreeSaveReqVO updateReqVO);

    /**
     * 删除节点
     *
     * @param id 节点ID
     */
    void deleteNode(Long id);

    /**
     * 获取节点详情
     *
     * @param id 节点ID
     * @return 节点信息
     */
    BoqGuideTreeRespVO getNode(Long id);

    /**
     * 获取树形结构
     *
     * @param boqSubItemId 清单子项ID
     * @return 树形结构
     */
    List<BoqGuideTreeRespVO> getTree(Long boqSubItemId);

    /**
     * 获取列表
     *
     * @param boqSubItemId 清单子项ID
     * @return 列表
     */
    List<BoqGuideTreeRespVO> getList(Long boqSubItemId);

    /**
     * 交换排序
     *
     * @param nodeId1 节点ID1
     * @param nodeId2 节点ID2
     */
    void swapSort(Long nodeId1, Long nodeId2);

    /**
     * 根据编码验证定额是否存在于绑定范围内
     *
     * @param boqSubItemId 清单子项ID
     * @param code 定额编码
     * @return 定额基价ID，如果不存在返回null
     */
    Long validateQuotaCodeInRange(Long boqSubItemId, String code);

    /**
     * 根据编码验证定额是否存在于绑定范围内，并返回定额信息
     *
     * @param boqSubItemId 清单子项ID
     * @param code 定额编码
     * @return 定额信息（包含id、code、name、unit），如果不存在返回null
     */
    com.yhy.module.core.controller.admin.boq.vo.QuotaCodeValidateRespVO validateQuotaCodeWithInfo(Long boqSubItemId, String code);
}
