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

import com.yhy.module.core.controller.admin.config.vo.ConfigProjectTreeRespVO;
import com.yhy.module.core.controller.admin.config.vo.ConfigProjectTreeSaveReqVO;
import com.yhy.module.core.controller.admin.config.vo.ConfigProjectTreeSwapSortReqVO;
import java.util.List;
import javax.validation.Valid;

/**
 * 项目界面配置树 Service 接口
 *
 * @author yhy
 */
public interface ConfigProjectTreeService {

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

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

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

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

    /**
     * 获取树形结构
     *
     * @return 树形结构
     */
    List<ConfigProjectTreeRespVO> getConfigProjectTreeList();

    /**
     * 交换排序
     *
     * @param swapReqVO 交换信息
     */
    void swapSort(@Valid ConfigProjectTreeSwapSortReqVO swapReqVO);

    /**
     * 获取行业下拉选项（两级联动：省市 -> 行业）
     *
     * @return 省市列表（包含行业子节点）
     */
    List<ConfigProjectTreeRespVO> getIndustryOptions();
}
