브레인맵 사용 방법

브레인맵 화면은 학생별 학습 성취도를 3D/2D 시각화로 보여주고, AI 진단과 피드백 시험지, 성장 리포트까지 한 곳에서 처리할 수 있는 통합 분석 도구입니다.

1. 화면 구성

왼쪽 사이드바: 학생 선택, 4개의 기능 탭, 해당 탭의 세부 정보 영역
오른쪽 메인 영역: 3D 브레인맵 또는 2D 브레인맵 뷰
우상단 컨트롤: 3D/2D 전환, 뷰 초기화, 오버레이 초기화
하단 범례: 중심/과목/대단원/중단원/소단원 노드 표시 토글

2. 학생 선택

학습자 선택 드롭다운에서 분석할 학생을 선택합니다.
학생을 선택하면 해당 학생의 성취도 데이터가 서버에서 로드되고 브레인맵에 색상이 적용됩니다.
학생이 선택되지 않은 상태에서는 학생을 선택하면 개념별 성취도가 표시됩니다 안내가 표시됩니다.

3. 기간 필터

전체 기간, 이번주, 이번달, 기간 설정 버튼을 통해 기간 필터를 적용할 수 있습니다.
기간 설정을 선택하면 달력 팝업이 열리며 시작일과 종료일을 선택할 수 있습니다.
기간 필터를 변경하면 성취도 데이터가 다시 로드됩니다.

4. 탭별 기능

왼쪽 사이드바에는 네 개의 탭이 있습니다.

4.1 학습 레이더

성취도 색상 범례로 강점/보통/취약/매우 취약/미평가를 확인합니다.
통계 카드: 평가된 개념 수, 평균 성취도
강점/보통/취약 버튼을 누르면 해당 개념 리스트가 표시됩니다.
개념 리스트에서 즉각 피드백 문항 생성 버튼을 눌러 해당 개념 기반 문제를 생성할 수 있습니다.
노드를 클릭하면 하단에 선택된 개념 상세 카드가 열리고, 성취도 점수와 피드백 버튼이 표시됩니다.

4.2 AI 진단

AI 분석 시작 버튼을 눌러 해당 학생의 성취도 데이터를 AI가 분석합니다.
분석 결과에는 다음이 포함됩니다:
- 전반적 평가
- 우선순위별 취약 영역
- 강점 개념 태그
- 학습 조언
AI 진단 결과는 피드백 플랜과 성장 리포트 탭을 활성화합니다.

4.3 피드백 플랜

AI 진단 결과 기반으로 취약 영역을 선택해 피드백 시험지를 생성합니다.
설정 항목:
- 취약 개념 체크박스
- 시험지 제목 입력
- 총 문항 수 입력
피드백 시험지 생성 버튼으로 즉시 보완 시험지를 만들 수 있습니다.
생성 후에는 시험지 화면에서 확인 링크로 이동하여 결과를 확인할 수 있습니다.

4.4 성장 리포트

AI 진단 데이터를 바탕으로 AI 성장 리포트 생성 버튼을 눌러 리포트를 작성합니다.
리포트에는 다음 항목이 포함될 수 있습니다:
- 요약 및 결론
- 성취도 변화 비교
- 강점 영역
- 개선 필요 영역
- 실행 계획
- 동기 부여 메시지
생성된 리포트는 리포트 저장 버튼을 눌러 로컬에 저장할 수 있습니다.

5. 3D/2D 브레인맵

뷰 전환

우상단 버튼으로 3D 보기와 2D 보기를 전환할 수 있습니다.
2D 보기로 전환하면 노드 레벨 토글, 라벨 토글, 확대/축소, 전체 보기, 기본값 복원 등의 제어를 사용할 수 있습니다.

맵 제어

시점 초기화: 브레인맵을 기본 시점으로 되돌립니다.
오버레이 초기화: 성취도 색상 오버레이를 초기 상태로 되돌립니다.
하단 범례에서 각 레벨 노드(중심/과목/대단원/중단원/소단원)를 켜고 끌 수 있습니다.

6. 개념 상세 보기

노드를 클릭하면 우측 사이드바에 개념 상세 정보가 표시됩니다.
표시되는 정보:
- 개념 이름
- 개념 레벨 (과목, 대단원, 중단원, 소단원 등)
- 성취도 퍼센트
- 성취도 막대그래프
성취도 정보가 있는 경우 피드백 문항 생성 버튼이 나타나고, 바로 문제 생성을 요청할 수 있습니다.

7. 데이터 로드와 상태 초기화

학생 선택 시 /api/protected/mastery/{studentId} API로 성취도 데이터를 가져옵니다.
기간 필터 변경 시 데이터가 다시 로드됩니다.
WebGL 3D 렌더링이 지원되지 않으면 자동으로 2D 모드로 전환하여 계속 사용할 수 있습니다.

8. 사용 팁

학생을 선택한 뒤 먼저 AI 분석 시작을 눌러 진단 결과를 확보하세요.
취약 개념을 발견하면 해당 개념의 즉각 피드백 문항 생성 버튼을 활용하여 빠르게 보완 학습 자료를 만드세요.
성장 리포트 생성으로 학부모 또는 학생에게 공유할 수 있는 분석 보고서를 작성할 수 있습니다.

9. 요약

브레인맵은 학생별 학습 성취도를 시각화하고, AI 진단과 피드백 시험지 생성, 성장 리포트 작성까지 통합 지원하는 화면입니다. 교육 상담과 학습 계획 수립에 필요한 모든 분석 도구를 한 곳에서 제공합니다.