Verbly: 내가 쓴 영어일기를 AI와 원어민이 듀얼 첨삭해주는 서비스

🌍 프로젝트 소개

“AI 1차 교정 + 원어민 2차 첨삭의 2단계 학습 플랫폼"

많은 한국인 학습자들은 틀릴까 봐 영어 사용을 망설입니다.

버블리는 이 장벽을 낮추기 위해 AI의 빠른 문법 교정과 원어민의 문화적·맥락적 피드백을 결합했습니다.

교정된 문장은 자동으로 개인 라이브러리에 저장되고, 퀴즈와 복습을 통해 장기 기억으로 전환됩니다.

학습은 혼자가 아니라, 글로벌 커뮤니티 속에서 함께 성장하는 경험이 됩니다.

🚀 배포 주소

🌐 프론트엔드 주소: https://www.verbly.kr
⚙️ 백엔드 주소: https://api.verbly.kr

👫 팀원 소개

지니(김현진)	유니(정세윤)	파울로(박시윤)	또치(박소희)	솜(윤영주)
@tellgeniewish	@yunnij	@keypang	@Ddiy0ng	@som141

💻 사용 기술 스택

분류	기술
Backend Library	SpringBoot
Language	Java
DataBase	MySQL
Cloud	AWS

📚 git 컨벤션

브랜치 전략

Git Flow 방식: main ← dev ← feat/닉네임/이슈번호

• main: 배포 브랜치
• dev: 개발 브랜치
• feat/닉네임/이슈 번호: 기능 개발 브랜치

브랜치 명명 규칙

브랜치 형식: 브랜치종류/닉네임/이슈번호

• 브랜치 종류: feat, refactor, bug 등등…

커밋 메세지 규칙

Gitmoji 사용

이모지	타입	설명
✨	Feat	새로운 기능 추가
🐛	Bug	오류 수정
🔨	Fix	코드 수정
♻️	Refactor	코드 리팩토링
🚑	Hotfix	급한 오류 수정
👷	Ci	ci/cd 파이프라인 구축

커밋 메세지 형식

:이모지: [Feat/Bug/Refactor] Title

ex) ✨[Feat] API 구현

🗂️ 폴더 구조

verbly.spring
├── domain
│   ├── controller
│   ├── service
│   ├── repository
│   ├── entity
│   ├── dto
│   │   ├── request
│   │   └── response
│   ├── converter
│   ├── validator
│   ├── enums
│   └── exception
│
├── global
│   ├── common
│   │   ├── code
│   │   ├── constants
│   │   ├── entity
│   │   ├── exception
│   │   ├── handler
│   │   ├── response
│   │   └── utils
│   │
│   ├── config
│   │   └── properties
│   │
│   ├── infrastructure
│   │   ├── aws
│   │   │   └── s3
│   │   ├── gemini
│   │       └── dto
│   │   ├── kakao
│   │   │   └── dto
│   │   ├── openai
│   │   │   └── dto
│   │   └── paypal
│   │       └── dto
│   │
│   ├── security
│   │   ├── auth
│   │   ├── config
│   │   ├── handler
│   │   ├── jwt
│   │   │   ├── handler
│   │   │   ├── service
│   │   │   └── userinfo
│   │   ├── oauth
│   │   └── utils
│   │
│   └── websocket
│       ├── exception
│       ├── handler
│       ├── interceptor
│       └── utils