연동 흐름

아발론 서버가 암호화 코드를 만들고, 학생의 학습 창이 그 코드를 플랭에 form POST하면 지정된 학습이 시작됩니다.

1. 아발론 서버가 자사 학생의 로그인 상태와 활동 접근 권한을 확인합니다.
2. 학생 ID·학습 유형·level·layer·단원 코드(unitCd)·기수·귀속 월과 만료 정보를 담은 일회용 암호화 코드를 생성합니다. 플랭은 studyType·level·layer·unitCd·regYear·season 6개 값으로 학습할 활동을 찾습니다.
3. 학생이 시작 버튼을 누르면 새 창을 열고 플랭의 고정 진입 주소에 코드를 form POST합니다.
4. 플랭은 최초 요청에서 코드와 활동을 검증하고 필요한 학생·그룹·학습 기록을 생성하거나 재사용합니다. 별도 로그인 화면 없이 지정 태스크로 진입합니다. 이미 완료한 활동이면 완료 화면을 보여 주고, 학생이 다시 해보기를 누르면 새 회차로 다시 학습합니다.
5. 새 실행이 성공하면 동일 학생의 다른 실행 창은 차시·활동에 관계없이 만료됩니다. 저장된 학습 기록은 유지됩니다.
6. 학생은 지정된 활동만 수행하며 목록이나 다른 활동으로 이동할 수 없습니다. 제출 완료 후 학습 창을 닫습니다.
7. 아발론 서버가 학생 ID와 같은 6개 값으로 학습 상태와 결과를 조회합니다.

플랭의 URL 발급 API나 별도 코드 교환 API를 사전 호출하지 않습니다. 요청 UUID도 필요하지 않습니다. 암호화 코드는 일회용이므로 새로 진입하려면 아발론 서버에서 새 코드를 생성합니다. 새 코드를 만들어도 같은 활동이면 같은 학습 기록을 이어 갑니다.

학생 제출 완료와 AI 분석 완료는 서로 다른 시점입니다. 창이 닫힌 후에도 분석과 종합 코멘트 생성이 진행될 수 있습니다. 학습 완료 여부는 창 닫힘만으로 판단하지 않고 결과 API로 확인합니다.