학생·기수·교재 정보

요청은 아발론 원문의 필드명과 평면 구조를 사용합니다. 학생·기수·교재 정보를 별도 객체로 묶지 않으며, CSV 다운로드 API로 제공하는 class_task_id를 추가합니다.

아발론 원문	요청 필드	의미
memIdx	memIdx	학생 고유 ID. 앞자리 0을 보존하는 문자열
regYear	regYear	기수 연도
season	season	1: 봄, 2: 여름, 3: 가을, 4: 겨울
활동 목록 CSV	class_task_id	CSV에서 선택한 실행 대상 활동 ID
studyType	studyType	학습 유형
level	level	교재 레벨이자 해당 기수의 OrgGroupSet 식별 코드
layer	layer	교재 레이어이자 해당 OrgGroupSet의 OrgGroup 식별 코드
unitCd	unitCd	외부 교재 회차
regYm	regYm	해당 교재 회차가 귀속되는 월, YYYYMM

regYm은 실제 학습을 수행한 날짜와 구분합니다. 예를 들어 9월 귀속 학습을 10월에 수행했다면 교재 귀속 월은 9월이고 실제 학습일은 10월입니다. 기수는 전달받은 연도·season을 사용하며 서버가 달력 분기에서 추정하지 않습니다.

기수별 그룹 생성 규칙

그룹은 아발론 조직 → regYear·season 기수 → level(OrgGroupSet) → layer(OrgGroup) 순서로 구분합니다.

요청 예시	처리
2026 / season 3 / MA / RED 첫 요청	해당 기수에 MA 그룹 세트와 그 아래 RED 그룹 생성
2026 / season 3 / MA / RED 재요청	기존 MA 그룹 세트·RED 그룹 재사용
2026 / season 4 / MA / RED	새 기수에 별도의 MA 그룹 세트·RED 그룹 생성
2027 / season 4 / MA / RED	연도가 다르므로 새 기수에 별도 생성

같은 기수라도 level이 다르면 서로 다른 그룹 세트이며, 같은 이름의 layer도 각 그룹 세트 안에서 별도로 관리합니다. 귀속 월·교재 회차·활동 ID만 바뀌면 그룹을 새로 만들지 않습니다. 새 기수 생성 시 이전 기수의 그룹이나 학습 결과를 덮어쓰지 않습니다.

RA·WR·SP 및 대응 IBT 유형의 지원을 검토합니다. 자료 간 표기가 다른 TT, IBTS, IBTSP의 의미와 최종 코드는 확정이 필요합니다.