🧑‍🏫 TeachING

흩어진 정보를 연결해 나만의 지식으로 만드는 AI 학습 서비스

URL로 저장한 학습 자료(블로그, 유튜브 등)를 AI가 자동 분석·요약하고,
RAG 기반 챗봇과 개인 맞춤형 학습 경로 '티칭맵'을 통해
단계별로 학습을 이끌어주는 AI 학습 관리 서비스입니다.

📖 서비스 소개

TeachING은 흩어진 온라인 학습 자료를 한곳에 모으고, AI가 튜터처럼 함께 학습을 이끌어주는 개인 학습 관리 서비스입니다.

블로그, 유튜브 등에서 발견한 자료의 URL을 저장하면 AI가 자동으로 본문(또는 영상 스크립트)을 분석해 요약과 상세 해설을 생성하고, 벡터 검색(RAG) 기반으로 색인합니다. 사용자는 저장된 자료들을 폴더와 태그로 자유롭게 정리할 수 있고, 궁금한 점은 채팅으로 질문하면 AI가 내가 저장한 자료를 근거로 답변하며 — 관련 자료가 없을 때는 일반 지식으로 보완해 답합니다.

가장 큰 특징은 티칭맵입니다. 폴더 안의 자료들을 순서가 있는 학습 단계로 재구성해, 마치 커리큘럼처럼 하나씩 따라가며 학습할 수 있습니다. 각 단계에서 중요한 부분을 하이라이트하면 사용자가 설정한 성향(다정한/엄격한/응원하는)의 'AI 선생님'이 그 부분을 짚어 설명해주고, 학습 진행률도 함께 추적됩니다.

카카오·구글 소셜 로그인으로 간편하게 시작할 수 있으며, 무료/프리미엄 멤버십을 통해 더 많은 자료 저장과 폴더 생성이 가능합니다.

✨ 주요 기능

📄 자료 관리 블로그, 유튜브 등 온라인 자료의 URL을 저장하면 AI가 본문/스크립트를 추출해 요약·상세 분석 생성 분석 결과는 chunk로 나눠 Qdrant에 벡터 색인 AI 요약/상세 분석은 직접 수정 가능 폴더 생성·자료 이동·태그·휴지통으로 자료 정리

💬 챗봇 (RAG) 채팅방을 만들고 내가 저장한 자료에 대해 자유롭게 질문 질문을 벡터 검색으로 관련 자료를 찾아 근거로 답변 생성 관련 자료가 없으면 일반 지식 기반 fallback 응답 답변에 인용된 출처 자료 함께 표시

🗺️ 티칭맵 폴더 속 자료들을 순서가 있는 학습 스텝으로 재구성 하이라이트한 부분에 AI 선생님 해설 제공 말투는 다정한 / 엄격한 / 응원하는 페르소나 중 선택 스텝 완료 토글로 진행률 자동 갱신, 임시저장 지원

🔐 인증 & 멤버십 카카오 · 구글 OAuth2 소셜 로그인, JWT 기반 인증 카카오페이 연동 TeachING Plus 구독 결제 FREE / PREMIUM 멤버십 등급 구분 마이페이지에서 프로필 · 알림 · AI 선생님 설정 관리

🛠 기술 스택

Backend

Database

AI · 자료 수집

결제 · Infra · CI/CD

Docs

🏗 아키텍처

🌿 협업 규칙

구분	내용
🌿 브랜치	type/#이슈번호/설명 (예: feat/#69/material-url) → main 으로 PR
📝 커밋	Type: 설명 (Feat Fix Docs Test Refactor Chore 등)
🔍 PR	GitHub Actions CI(Gradle 빌드) 통과 후 머지
🚀 배포	main push 시 ECR 이미지 빌드 → EC2 Docker Compose 자동 배포

👥 팀원

@hwiyoon20010309 백엔드 📄 자료 · URL 분석 💬 챗봇(RAG)

@Mymyseoyoung 백엔드 🗺️ 티칭맵 🔐 인증 · 약관

@m00nsh 백엔드 📄 자료 · 폴더 🔔 알림 · 홈

@EH-OI 백엔드 🗑️ 휴지통 💳 결제

📁 저장소 구조

backend/
├── src/main/java/com/teaching/backend/
│   ├── domain/     도메인별 패키지 (controller · service · entity · repository · dto)
│   │   ├── auth · user · material · folder · chat
│   │   ├── teachingmap · trash · tag · notification
│   │   └── payment · term · home · support
│   └── global/     공통 설정 (security · config · ai · storage · exception · response)
├── docker-compose.yml   app(Spring Boot) + qdrant 컨테이너 구성
└── .github/workflows/   CI(빌드 검증) · CD(ECR/EC2 배포) 워크플로

📖 도메인별 상세 API 명세 (펼쳐보기)

Auth (/api/v1/auth)

• POST /reissue — AccessToken 재발급
• POST /signup — 회원가입(닉네임 확정 · 약관 동의 등록)
• POST /logout — 로그아웃
• GET /check-nickname — 닉네임 중복 확인
• GET /oauth2/authorization/{kakao|google} — 소셜 로그인 진입점

User (/users)

• GET /me — 내 정보 조회
• PATCH /me — 프로필 수정 (multipart)
• PATCH /me/notifications — 알림 설정 변경
• DELETE /me — 회원 탈퇴
• PATCH /me/teacher-persona — AI 선생님 페르소나 변경

Material (/materials, /api/v1/materials)

• GET /materials — 자료 목록 조회
• POST /materials/{materialId}/index — 자료 색인(Qdrant)
• POST /api/v1/materials/analyze — URL 기반 AI 분석 요청
• PATCH /api/v1/materials/{materialId}/finalize — 분석 결과 저장 확정

Folder (/api/folders)

• GET / · POST / — 폴더 목록 조회 · 생성
• GET /{folderId} · PATCH /{folderId} — 폴더 상세 조회 · 이름 수정
• GET /{folderId}/materials — 폴더 내 자료 목록
• PATCH /{folderId}/trash · PATCH /{folderId}/restore — 폴더 휴지통 이동 · 복구
• GET/PATCH /{folderId}/materials/{materialId}/analysis(/summary|/detail) — AI 분석 조회 · 수정
• GET /{folderId}/materials/{materialId}/tags — 태그 조회
• GET /{folderId}/materials/{materialId}/origin-url — 원본 URL 조회
• PATCH /{folderId}/materials/move|trash|restore — 자료 이동 · 휴지통 이동 · 복구

ChatRoom / ChatMessage (/chatrooms)

• GET / · POST / — 채팅방 목록 조회(커서 페이지네이션) · 생성
• GET /{chatRoomId}/messages — 메시지 히스토리 조회(출처 포함)
• POST /{chatRoomId}/messages — 질문하기(RAG 기반 답변 생성)

TeachingMap (/api/v1/teaching-maps)

• GET / · POST / — 티칭맵 목록 조회 · 생성(폴더 기반)
• GET /{teachingMapId} · PATCH /{teachingMapId} — 단건 조회 · 제목/설명 수정
• GET /{teachingMapId}/steps/{stepId} — 스텝 상세 조회
• PATCH /{teachingMapId}/steps/{stepId}/toggle — 스텝 완료 토글
• GET /materials/{materialId}/highlights/{highlightId}/analysis — 하이라이트 AI 선생님 해설 조회/생성
• PATCH /trash — 티칭맵 다중 휴지통 이동
• POST /temp — 임시저장

Trash (/api/v1/trash)

• GET /folders|materials|teaching-maps — 휴지통 목록 조회
• GET /folders/{folderId}/materials — 휴지통 폴더 상세(내부 자료) 조회
• PATCH /folders|materials|teaching-maps/restore — 다중 복구

Notification (/api/v1/notifications)

• GET / · GET /summary — 알림 목록 · 요약 조회
• PATCH /{notificationId}/read — 읽음 처리

Payment (/api/v1/payments)

• POST /ready — 구독 결제 준비(카카오페이)
• GET /success|cancel|fail — 결제 결과 콜백

Term (/api/v1/terms)

• GET / — 약관 목록 조회

Home (/api/v1/home)

• GET / — 홈 대시보드 조회

🧑‍🏫 TeachING · Made with care by the TeachING-Dev team

_{2026. 08. 13. ver.}