저장소: octxxiii/teacher-copilot

AI 학부모 피드백 비서 (Teacher Copilot)

학원/과외 선생님이 학부모에게 보내는 피드백·공지·숙제 안내를 빠르고 품질 높게 만들 수 있도록 돕는 Next.js 기반 SaaS MVP입니다.

주요 기능

• 로그인 / 요금제

  • NextAuth 기반 로그인 (테스트 계정 + Google/Kakao 준비)
  • Stripe 연동을 고려한 3단계 요금제(1반·2반·3반) UI

• 피드백 비서 (/assistant)

  • 학생·반 선택 후, 오늘 학습 내용 / 태도 / 말투만 입력하면 학부모용 피드백 문장 자동 생성
  • 로그인 전에는 실제 OpenAI API를 호출하지 않는 데모 모드로 동작 (말투에 따라 다른 예시 문장 생성)
  • 로그인 후에는 OpenAI gpt-4o-mini API를 사용해 실제로 메시지 생성
  • 결과를 한 번에 복사하거나, 카카오톡으로 공유하기(클립보드 + 공유 시트) 버튼 제공

• 반/학생 관리 (/students)

  • 반 생성·삭제, 반별 학생 등록/삭제
  • 학생 메모(학년, 과목, 요일 등)를 함께 저장
  • 데이터는 브라우저 localStorage에 저장되어 간단하게 테스트 가능

• 반별 공지·숙제 보드 (/board)

  • 선택한 반에 대해 공지사항과 숙제를 한 화면에서 관리
  • 공지/숙제 입력 후, 버튼 한 번으로 카카오톡 반 단톡방에 바로 붙여넣기 좋은 안내문을 생성
  • (현재는 localStorage 기반, 추후 DB 연동 및 학부모 전용 뷰로 확장 가능)

기술 스택

• Framework: Next.js 14 (App Router)
• Language: TypeScript
• Styling: Tailwind CSS
• Auth: NextAuth (Credentials + Google/Kakao Provider)
• AI: OpenAI SDK (gpt-4o-mini)
• UI Icons: lucide-react

실행 방법

git clone https://github.com/octxxiii/teacher-copilot.git
cd teacher-copilot
npm install

루트에 .env.local 파일을 만들고, 필요 시 아래와 같은 키를 설정합니다.

OPENAI_API_KEY=sk-...
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=임의의_긴_문자열

# 테스트 계정(선택)
TEST_USER_EMAIL=teacher@test.com
TEST_USER_PASSWORD=test1234!

# Stripe (선택)
STRIPE_SECRET_KEY=sk_test_...
STRIPE_PRICE_CLASS1=price_...
STRIPE_PRICE_CLASS2=price_...
STRIPE_PRICE_CLASS3=price_...

그 다음 개발 서버를 실행합니다.

npm run dev

브라우저에서 http://localhost:3000으로 접속하면,

• 메인 페이지: 서비스 소개 + 선생님 로그인 / 로그인 없이 체험 버튼
• /assistant: 피드백 비서 (로그인 여부에 따라 데모/실제 모드)
• /students: 반·학생 관리
• /board: 반별 공지·숙제 보드
• /billing: 요금제/결제 페이지

를 확인할 수 있습니다.

개발 메모

• 현재 데이터 저장은 간단한 MVP를 위해 브라우저 localStorage 를 사용합니다.
  • 추후 DB(Supabase/PlanetScale 등)로 이관하기 쉽도록 타입과 키를 분리해 두었습니다.
• OpenAI 호출은 로그인한 사용자에 한해서만 실제 API를 사용하도록 설계되어 있습니다.
  • 로그인하지 않은 사용자는 토큰 비용 없이 말투별 예시 결과만 체험할 수 있습니다.