package go.kr.project.common.service;

import go.kr.project.common.model.CmmnCodeSearchVO;
import go.kr.project.system.code.model.CodeDetailVO;

import java.util.List;

/**
 * packageName    : go.kr.project.common.service
 * fileName       : CommonCodeService
 * author         : 개발자
 * date           : 2025-05-10
 * description    : 공통 코드 관련 비즈니스 로직을 처리하는 서비스 인터페이스
 * ===========================================================
 * DATE              AUTHOR             NOTE
 * -----------------------------------------------------------
 * 2025-05-10        개발자       최초 생성
 */
public interface CommonCodeService {

    /**
     * 특정 코드 그룹에 속한 코드 상세 목록을 조회합니다.
     * 
     * @param cdGroupId 코드 그룹 ID
     * @return 코드 상세 목록
     */
    List<CodeDetailVO> selectCodeDetailListByGroupId(String cdGroupId);

    /**
     * 검색 조건에 맞는 코드 상세 목록을 조회합니다.
     *
     * @param searchVO 코드 상세 검색을 위한 검색 조건을 담은 VO 객체
     * @return 검색 조건에 맞는 코드 상세 목록
     */
    List<CodeDetailVO> selectCodeDetailList(CmmnCodeSearchVO searchVO);
}