선생님 기능 개요

K-Lounge는 선생님들이 효과적으로 한국어 수업을 관리할 수 있도록 다양한 기능을 제공합니다.

📋 목차

  1. 강의 관리
  2. 챕터/레슨 관리
  3. 과제 관리
  4. 공지사항 관리
  5. 학생 진도 추적
  6. AI 자동 채점
  7. 출석 체크 시스템
  8. 선생님 대시보드
  9. 성적 관리 시스템
  10. 수동 채점

🎓 강의 관리

선생님은 커뮤니티 내에서 여러 강의를 생성하고 관리할 수 있습니다.

주요 기능

접근 경로

/c/{slug}/settings → 강의 관리 섹션

자세한 내용: 강의 관리 문서

📚 챕터/레슨 관리

각 강의는 챕터로 구성되고, 각 챕터는 여러 레슨을 포함할 수 있습니다.

주요 기능

구조

강의 (Course) └── 챕터 1 (Chapter) ├── 레슨 1-1 (Lesson) ├── 레슨 1-2 (Lesson) └── 레슨 1-3 (Lesson) └── 챕터 2 (Chapter) ├── 레슨 2-1 (Lesson) └── 레슨 2-2 (Lesson)

자세한 내용: 챕터/레슨 관리 문서

📝 과제 관리

선생님은 학생들에게 과제를 배정하고 자동으로 채점받을 수 있습니다.

주요 기능

과제 생성 흐름

  1. /c/{slug}/settings에서 "새 과제 추가" 클릭
  2. 과제 제목, 설명, 안내사항 작성 (BlockNote 에디터 사용)
  3. 마감일 및 만점 설정
  4. (선택) 연결할 강의 선택
  5. 저장

AI 자동 채점

학생이 과제를 제출하면 AI가 자동으로:

평가 기준:

  1. 과제 지시사항 준수 여부
  2. 한국어 문법과 표현 정확성
  3. 내용 충실성 및 논리성
  4. 창의성과 노력도

자세한 내용: 과제 관리 문서

📢 공지사항 관리

커뮤니티 멤버들에게 중요한 소식을 공지할 수 있습니다.

주요 기능

접근 경로

자세한 내용: 공지사항 관리 문서

📊 학생 진도 추적

선생님은 각 학생의 학습 진행 상황을 확인할 수 있습니다.

추적 항목

확인 방법

  1. 강의실 페이지: /c/{slug}/classroom/{courseId}

    • 각 학생의 레슨 완료 현황 확인
    • 체크마크(✓)로 완료 표시

  2. 과제 페이지: /c/{slug}/assignments

    • 전체 과제 목록
    • 제출/미제출/채점 완료 통계

  3. 리더보드: /c/{slug}/leaderboard

    • 학생별 포인트 랭킹
    • 레벨 및 Streak 확인

🤖 AI 자동 채점

K-Lounge의 핵심 기능 중 하나는 AI를 활용한 자동 채점 시스템입니다.

작동 방식

  1. 학생 과제 제출

    • 학생이 /c/{slug}/assignments/{id} 페이지에서 과제 제출
    • 최소 10자 이상 필수

  2. AI 채점 시작

    • OpenAI GPT-4o-mini 모델 사용
    • 과제 제목, 지시사항, 제출 내용 분석

  3. 채점 결과 생성

    • 점수 (0-100점, 만점에 맞게 스케일링)
    • 종합 피드백
    • 잘한 점 3가지
    • 개선할 점 3가지

  4. 자동 저장

    • DB에 채점 결과 저장
    • gradedBy 필드가 null (AI 채점 표시)
    • 즉시 학생에게 결과 표시

  5. 포인트 지급

    • 과제 제출 시 20 포인트 자동 지급
    • Streak 업데이트

코드 위치

예시 피드백

전반적으로 한국 문화에 대한 이해가 잘 드러나는 에세이입니다. 문법적으로 큰 오류 없이 자연스럽게 작성하셨습니다. ✅ 잘한 점: • 한국의 전통 문화와 현대 문화를 균형있게 다루었습니다 • 문단 구성이 논리적이며 흐름이 자연스럽습니다 • 다양한 어휘를 활용하여 표현력이 풍부합니다 💡 개선할 점: • 일부 조사 사용이 부정확합니다 (예: "에서"와 "에게" 혼동) • 구체적인 예시를 더 추가하면 설득력이 높아집니다 • 결론 부분을 좀 더 강하게 마무리하면 좋겠습니다

✅ 출석 체크 시스템

선생님은 실시간으로 출석 코드를 생성하고, 학생들은 해당 코드를 입력하여 출석 체크를 할 수 있습니다.

주요 기능

접근 경로

사용 시나리오

  1. 수업 시작 시 선생님이 "출석 세션 생성" 클릭
  2. 8자리 코드를 화면에 표시하거나 구두로 공지
  3. 학생들이 Check-in 페이지에서 코드 입력
  4. 출석 완료 시 +5 포인트 자동 지급
  5. 실시간으로 출석 현황 확인

자세한 내용: 출석 체크 시스템 문서

📊 선생님 대시보드

커뮤니티의 전반적인 학습 현황을 한눈에 파악할 수 있는 통합 관리 페이지입니다.

주요 기능

접근 경로

/c/{slug}/teacher-dashboard

활용 방법

자세한 내용: 선생님 대시보드 문서

📈 성적 관리 시스템

모든 학생의 과제 및 퀴즈 성적을 한눈에 볼 수 있는 종합 성적표입니다.

주요 기능

접근 경로

/c/{slug}/grades

활용 방법

자세한 내용: 성적 관리 시스템 문서

✏️ 수동 채점

AI 자동 채점 결과를 검토하고, 필요한 경우 수동으로 점수를 수정하거나 추가 피드백을 제공할 수 있습니다.

주요 기능

접근 경로

/c/{slug}/assignments/[assignmentId]/grading

채점 워크플로우

  1. 채점 대기 목록에서 AI 채점 결과 확인
  2. 과제 내용과 루브릭 기준 검토
  3. AI 점수가 적절하면 그대로 사용, 부적절하면 수동 점수 입력
  4. 추가 피드백 작성 후 저장
  5. 학생에게 최종 점수 및 피드백 전달

자세한 내용: 수동 채점 문서

학생 진도 상세 추적

각 학생의 학습 진행 상황을 개별적으로 상세히 확인할 수 있습니다.

주요 기능:

접근 경로:

자세한 내용: 학생 진도 추적 문서

🎯 권한 시스템

선생님 기능은 커뮤니티 내 역할에 따라 접근이 제한됩니다.

역할별 권한

기능OwnerAdminModeratorMember
강의 생성/수정/삭제✅✅❌❌
챕터/레슨 관리✅✅❌❌
과제 생성/수정/삭제✅✅❌❌
공지사항 작성✅✅✅❌
공지사항 고정✅✅❌❌
학생 진도 확인✅✅✅❌
과제 제출✅✅✅✅
출석 세션 생성✅✅❌❌
출석 체크✅✅✅✅
선생님 대시보드✅✅❌❌
성적 관리✅✅❌❌
수동 채점✅✅❌❌
학생 진도 상세 추적✅✅❌❌

📱 사용자 인터페이스

커뮤니티 설정 페이지

경로: /c/{slug}/settings

이 페이지에서 다음을 관리할 수 있습니다:

  1. 기본 정보 (커뮤니티 이름, 설명)
  2. 포인트 설정 (활동별 획득 포인트)
  3. 강의 관리
  4. 공지사항 관리
  5. 과제 관리
  6. 초대 링크
  7. 위험 구역 (커뮤니티 삭제)

BlockNote 에디터 적용 영역

BlockNote 기능:

🧪 E2E 테스트

모든 선생님 기능은 Playwright를 사용한 E2E 테스트가 작성되어 있습니다.

테스트 파일

테스트 실행

# 전체 선생님 기능 테스트 npx playwright test e2e/13-courses.spec.ts e2e/14-chapters-lessons.spec.ts e2e/15-announcements.spec.ts e2e/16-assignments.spec.ts # 특정 테스트만 실행 npx playwright test e2e/16-assignments.spec.ts

🔜 향후 개선 사항

완료된 기능 ✅

계획 중인 기능

📞 지원

문제가 발생하거나 질문이 있으시면: