package shop.alien.storeplatform.service;

import shop.alien.entity.store.vo.StoreDictionaryVo;

import java.util.List;

/**
 * 经营板块服务接口
 * 提供经营板块的三级分类查询服务
 *
 * @author alien-cloud
 * @date 2025-12-01
 */
public interface BusinessSectionService {

    /**
     * 查询经营板块一级分类列表
     * 返回所有一级分类（特色美食、酒店/民宿、KTV、洗浴汗蒸等）
     *
     * @return 一级分类列表
     */
    List<StoreDictionaryVo> getFirstLevelList();

    /**
     * 查询经营板块二级分类列表
     * 根据一级分类的字典ID查询对应的二级分类
     *
     * @param parentDictId 一级分类的字典ID（dict_id）
     * @return 二级分类列表
     */
    List<StoreDictionaryVo> getSecondLevelList(String parentDictId);

    /**
     * 查询经营板块三级分类列表
     * 根据二级分类的字典ID查询对应的三级分类
     *
     * @param parentDictId 二级分类的字典ID（dict_id）
     * @return 三级分类列表
     */
    List<StoreDictionaryVo> getThirdLevelList(String parentDictId);

    /**
     * 查询经营板块树形结构（三级联动）
     * 返回完整的三级分类树形结构，包含所有层级的子节点
     *
     * @return 树形结构数据（包含一级、二级、三级）
     */
    List<StoreDictionaryVo> getTreeStructure();

    /**
     * 根据字典ID查询完整路径
     * 返回从一级到当前级别的完整分类路径
     *
     * @param dictId 字典ID
     * @return 分类路径（从一级到当前级）
     */
    List<StoreDictionaryVo> getFullPath(String dictId);
}

