package go.kr.project.system.code.service;

import go.kr.project.system.code.model.*;

import java.util.List;

/**
 * packageName    : go.kr.project.system.code.service
 * fileName       : CodeService
 * author         : 개발자
 * date           : 2025-05-09
 * description    : 공통 코드 관련 비즈니스 로직을 처리하는 서비스 인터페이스
 * ===========================================================
 * DATE              AUTHOR             NOTE
 * -----------------------------------------------------------
 * 2025-05-09        개발자       최초 생성
 * 2025-05-13        개발자       CodeMaster를 CodeGroup으로 변경
 */
public interface CodeService {

    /**
     * 코드 그룹 목록을 조회합니다.
     * 
     * @param vo 검색 조건을 담은 VO 객체
     * @return 코드 그룹 목록
     */
    List<CodeGroupVO> selectCodeGroupList(CodeSearchVO vo);

    /**
     * 코드 그룹 목록의 총 개수를 조회합니다.
     * 
     * @param vo 검색 조건을 담은 VO 객체
     * @return 코드 그룹 목록의 총 개수
     */
    int selectCodeGroupListTotalCount(CodeSearchVO vo);

    /**
     * 코드 상세 목록을 조회합니다.
     * 
     * @param vo 검색 조건을 담은 VO 객체
     * @return 코드 상세 목록
     */
    List<CodeDetailVO> selectCodeDetailList(CodeSearchVO vo);

    /**
     * 코드 상세 목록의 총 개수를 조회합니다.
     * 
     * @param vo 검색 조건을 담은 VO 객체
     * @return 코드 상세 목록의 총 개수
     */
    int selectCodeDetailListTotalCount(CodeSearchVO vo);

    /**
     * 여러 코드 상세 정보를 일괄 저장합니다.
     * 
     * @param modifyData 저장할 코드 상세 정보 목록
     * @return 등록, 수정, 삭제 된 행의 수
     */
    int saveCodeDetails(CodeDetailModifiedDataVO modifyData);

    /**
     * 여러 코드 그룹 정보를 일괄 저장합니다.
     * 
     * @param modifyData 저장할 코드 그룹 정보 목록
     * @return 등록, 수정, 삭제 된 행의 수
     */
    int saveCodeGroups(CodeGroupModifiedDataVO modifyData);

    /**
     * 코드 상세 정보의 중복 여부를 확인합니다.
     * 
     * @param vo 확인할 코드 상세 정보를 담은 VO 객체
     * @return 중복 여부 (true: 중복, false: 중복 아님)
     */
    boolean isCodeDetailDuplicated(CodeDetailVO vo);
}
