과외 피드백 자동 생성 시스템

수학 과외 선생님을 위한 AI 기반 피드백 자동 생성 시스템입니다.

🚀 주요 기능

1. 기존 학생 피드백 생성

• CSV 데이터에서 기존 학생 정보 로드
• 이전 수업 기록과 비교하여 점수 변화 분석
• AI를 활용한 맞춤형 피드백 생성

2. 신규 학생 추가 및 피드백 생성 ⭐ NEW!

• CSV에 없는 새로운 학생을 실시간으로 추가
• 신규 학생용 맞춤형 피드백 생성 (이전 기록 없이)
• 학생 ID, 이름, 학년, 과목 정보 입력

3. AI 피드백 구성

• 수업보완: 부족한 부분과 개선 방향 (3-5문장)
• 수업태도: 참여도와 학습 자세 평가 (3-5문장)
• 전체 Comment: 종합적 평가와 향후 방향 (4-6문장)

📋 시스템 요구사항

• Python 3.8+
• Upstage API 키
• 필요한 Python 패키지 (requirements.txt 참조)

🛠️ 설치 및 설정

1. 저장소 클론

git clone <repository-url>
cd 27th-project-feedback

2. 의존성 설치

pip install -r requirements.txt

3. 환경변수 설정

.env 파일을 생성하고 Upstage API 키를 설정하세요:

UPSTAGE_API_KEY=your_api_key_here

🎯 사용법

기본 실행

python app.py

팀원 작업물 실행

python demo.py

📁 프로젝트 구조

27th-project-feedback/
├── app.py                 # 메인 애플리케이션
├── feedback_system.py     # 피드백 시스템 핵심
├── demo.py               # 팀원 작업물 (유지)
├── data/
│   └── math_feedback.csv # 학생 데이터
├── requirements.txt       # Python 의존성
├── README.md             # 프로젝트 설명
└── .env                  # 환경변수 (API 키)

🔧 핵심 기능 설명

학생 관리

• 기존 학생: 이름 입력 시 자동으로 기존 학생 인식
• 신규 학생: 자동 ID 생성 (S0001, S0002, ...)
• 과제 평가: 과제가 없을 경우 99로 입력 가능

피드백 생성

• 기존 학생: 이전 수업 기록과 비교하여 변화점 분석
• 신규 학생: 첫 수업 평가에 집중한 맞춤형 피드백
• 학부모 대상: 존댓말 사용, 정중한 어조로 작성

점수 시스템

• 수업태도, 수업이해도, 과제평가, 질문상호작용
• 1-5점 척도 (과제 없음: 99)
• 이전 수업과의 변화 추이 시각화

📊 데이터 형식

CSV 컬럼 구조

• date: 수업 날짜
• student_id: 학생 ID
• student_name: 학생 이름
• grade: 학년
• subject: 과목
• attitude_score: 수업태도 점수
• understanding_score: 수업이해도 점수
• homework_score: 과제평가 점수
• qa_score: 질문상호작용 점수
• progress_text: 수업 진도
• class_memo: 특이사항

🎨 피드백 예시

기존 학생 피드백

**1. 수업보완: 부족한 부분과 개선 방향**
김도현 학생은 최근 수업에서 숙제를 제출하지 않아 이해도를 높이는 데 어려움을 겪고 있습니다...

**2. 수업태도: 참여도와 학습 자세 평가**
김도현 학생은 이전 수업에서는 적극적이고 참여도가 높은 태도를 보였으나...

**3. 전체 Comment: 종합적 평가와 향후 방향**
김도현 학생은 이전 수업에서 뛰어난 이해도와 참여도를 보여주었으며...

🤝 기여

이 프로젝트는 팀원들의 협력으로 개발되었습니다:

• app.py: 메인 시스템 개발
• demo.py: 팀원 작업물
• feedback_system.py: AI 피드백 시스템

📝 라이선스

이 프로젝트는 교육 목적으로 개발되었습니다.