WEB4_5_NOBREAKTIME_BE

[저희는 쉬는시간 없나요?] 팀의 AI 기반 언어 학습 플랫폼 "말랑(mallang)"

저희는 쉬는시간 없나요? 팀을 소개합니다

문권이	장무영	최지선	엄현수	서세훈	신동우
PO	BE 팀장	TM	TM	TM	TM
GitHub	GitHub	GitHub	GitHub	GitHub	GitHub

☕ Project Overview

1. 프로젝트 명

AI 기반 언어 학습 플랫폼 "말랑(mallang)"

2. 프로젝트 소개

유튜브 영상을 학습 콘텐츠로 활용하여, 자막 생성, 해석, 표현 분석, 반복 학습 등 실질적인 언어 습득을 지원하는 플랫폼

3. 기능

🔑 핵심 기능 구성

기능 영역	세부 내용
🧑 회원 관리	- 카카오, 구글, 네이버 SSO 로그인 - 이메일 로그인 및 회원가입 - 이메일 인증 기능
✨ 영상 탐색	- 필터를 설정해 영상 검색 - 학습 인기 동영상 목록 조회
🎙️ 자막 생성	- 유튜브 API로 영상 선택 - Clova Speech API로 음성 추출 및 자막 변환
🌐 자막 번역	- 생성된 자막을 Papago API로 번역 - 전체 스크립트 제공 - 이중 자막 표시 가능
🧠 단어/표현 설명 (AI)	- 단어를 사전 API로 해석 및 설명 - 문장별 표현을 LLM 기반으로 의미 및 문맥 설명 - 헷갈리는 표현은 대체 표현과 비교 제공
📝 개인 학습 도구	- 단어/표현을 '내 단어장', '내 표현함'에 저장 - 저장된 항목 기반 학습 퀴즈 제공

⏹️ 추가 기능 ⏹️

기능 영역	세부 내용
📆 학습 계획	- 학습 일정 관리 - 복습 주기 설정 - 오늘의 학습 표현 제공
📊 학습 통계	- 일일 학습량, 학습 현황 요약 - 학습 레벨 및 시간 확인 - 일정 기간 학습 통계 시각화
🌟 추천 콘텐츠	- 추천 수 높은 영상/강의 메인 노출 - 카테고리별 랭킹 제공
💳 결제	- 결제 API 기반 구독 시스템 - 베이직, 스탠다드, 프리미엄 플랜 제공
📚 추가 단어장/표현함	- 스탠다드/프리미엄 회원 추가 단어장·표현함 생성 가능
🌍 추가 언어 선택	- 프리미엄 회원 추가 학습 언어 선택 가능
🧩 분석	- 전체 스크립트 요약 제공
🛠️ 관리자	- 회원 정보, 게시판, 문의사항 관리
🕓 히스토리 저장	- 최근 학습 영상 히스토리 저장

4. 작업 및 역할 분담

이름	프로필	주요 역할
문권이		PO (Product Owner) 프로젝트 일정 관리 및 프론트/백엔드 팀 협업 조율 프론트엔드 코드 관리 기술 문서화 OpenAI 모듈을 활용한 문제 제작/번역/사전/문법 분석/레벨 분석 기능 개발
장무영		백엔드 팀장 (BE 리딩 및 기술 문서 작성) 백엔드 전반 기술 검토 및 품질 관리 유튜브 Data API를 활용한 영상 조회/선택/히스토리 기능 구현 영상 내 퀴즈 프로세스 구현
최지선		AWS 인프라 및 서버 관리 GitHub Actions 기반 CI/CD 구축 및 운영 TossPayment API를 활용한 결제 시스템 구현 구글 / 카카오 / 네이버 소셜 로그인 구현
엄현수		Clova Speech API를 활용한 음성 추출 및 자막 변환 모듈 개발 단어장 및 단어, 표현, 대시보드 통합 랜덤 퀴즈 프로세스 구현 일본어 학습 기능 구현
서세훈		유튜브 Data API를 활용한 영상 조회/선택/히스토리 기능 구현 표현함 기능 구현 프론트엔드 코드 관리
신동우		Clova Speech API를 활용한 음성 추출 및 자막 변환 모듈 개발 단어장 및 단어, 표현, 대시보드 통합 랜덤 퀴즈 프로세스 구현 일본어 학습 기능 구현

🛠️ Tech

기술 스택

프론트엔드

백엔드

Database

IDLE&Tool

OPEN API

Deployment&Infra

Monitoring

Version management and collaboration tools

UML

ERD

[ERD]

System Architecture

Flow Chart

[🗃️ Flow Chart]

🏷️ 브랜치 전략

• main: 실제 운영(배포)되는 코드만 존재
• develop: 다음 배포를 위한 최신 개발 코드가 모임

기능/릴리즈/핫픽스 브랜치

브랜치 유형	네이밍 규칙	용도/설명
feature	feature/기능명	새로운 기능 개발 (develop에서 분기)
hotfix	hotfix/이슈명	운영 중 긴급 버그 수정(main에서 분기)

모든 브랜치는 영어로 작성 예시: feature/oauth-login, hotfix/payment-error

브랜치 요약

• main: 운영 배포 코드
• develop: 최신 개발 코드
• feature/*: 기능 단위 개발
• hotfix/*: 운영 긴급 수정

API 명세서

[📝 API 명세서]

컨벤션

[🎯 Commit Convention]