How 2026-line4thon-team6/boongboongus-backend works
붕붕어스는 커플의 드라이브와 여행 기록을 위한 Spring 백엔드입니다. 주 흐름은 카카오 인증으로 회원을 식별하고, 초대로 커플을 연결한 뒤, 동의된 위치정보로 주행을 준비·기록하고 완료 카드와 미디어를 관리하는 것입니다. 장소 탐색·공유, 알림, 게임·비동기 작업, 음악·라디오 등도 별도 기능으로 제공됩니다. 관계는 발췌 소스에서 확인되거나 README에 명시된 것만 표시했습니다. 여러 서비스 구현은 발췌되지 않아 일부 기능 간 연결은 생략했습니다.
Main entry points: DrivePreparationService.java Drive Lifecycle · CardService.java Drive Cards · NotificationService.java In-App Notifications · AuthController.java Auth API
Components 25
Identity & Accounts
- Auth API
src/main/java/com/boongboongus/backend/domain/auth/controller/AuthController.java - Profile API
src/main/java/com/boongboongus/backend/domain/auth/controller/MeController.java - Token & Reauth
src/main/java/com/boongboongus/backend/domain/auth/service/AuthTokenService.java - Account Deletion
src/main/java/com/boongboongus/backend/domain/auth/service/AccountDeletionService.java
Couple & Devices
- Couple API
src/main/java/com/boongboongus/backend/domain/couple/controller/CoupleController.java - Invite API
src/main/java/com/boongboongus/backend/domain/couple/controller/CoupleInviteController.java - Couple Management
src/main/java/com/boongboongus/backend/domain/couple/service/CoupleService.java - Push Registration
src/main/java/com/boongboongus/backend/domain/device/controller/DevicePushTokenController.java
Drive Records
- Drive Preparation
src/main/java/com/boongboongus/backend/domain/drive/DrivePreparationController.java - Drive Lifecycle
src/main/java/com/boongboongus/backend/domain/drive/DrivePreparationService.java - Drive State
src/main/java/com/boongboongus/backend/domain/drive/DrivePreparationStore.java - Drive Cards
src/main/java/com/boongboongus/backend/domain/card/CardService.java - Photo Media
src/main/java/com/boongboongus/backend/domain/media/MediaService.java
Places & Notifications
- Home & Places
src/main/java/com/boongboongus/backend/domain/home/HomeExploreController.java - Place Search
src/main/java/com/boongboongus/backend/domain/home/PlaceSearchService.java - Place Routes
src/main/java/com/boongboongus/backend/domain/home/PlaceRouteService.java - In-App Notifications
src/main/java/com/boongboongus/backend/domain/notification/service/NotificationService.java
Interactive Features
- Couple Games
src/main/java/com/boongboongus/backend/domain/game/service/GameService.java - Async Jobs
src/main/java/com/boongboongus/backend/domain/job/service/JobService.java - Music Playlists
src/main/java/com/boongboongus/backend/domain/playlist/service/PlaylistService.java - Radio
src/main/java/com/boongboongus/backend/domain/radio/service/RadioService.java - FAQ
src/main/java/com/boongboongus/backend/domain/faq/FaqController.java - Legal Documents
src/main/java/com/boongboongus/backend/domain/legal/LegalDocumentService.java
Other components
- Mobile Client
- Kakao Login
Connections 28
- Mobile Client → Auth API: starts login
- Auth API → Token & Reauth: exchanges tokens
src/main/java/com/boongboongus/backend/domain/auth/controller/AuthController.java - Token & Reauth → Kakao Login: exchanges code
- Mobile Client → Profile API: manages profile
- Mobile Client → Couple API: manages connection
- Mobile Client → Invite API: manages invites
- Mobile Client → Push Registration: registers token
- Mobile Client → Drive Preparation: controls drive
- Drive Preparation → Drive Lifecycle: delegates
- Drive Lifecycle → Drive State: reads and writes
src/main/java/com/boongboongus/backend/domain/drive/DrivePreparationService.java - Drive Lifecycle → Drive Cards: creates completion card
src/main/java/com/boongboongus/backend/domain/drive/DrivePreparationService.java - Mobile Client → Drive Cards: edits drive cards
- Drive Cards → Photo Media: attaches photos
src/main/java/com/boongboongus/backend/domain/card/CardService.java - Mobile Client → Home & Places: explores places
- Home & Places → Place Search: searches places
src/main/java/com/boongboongus/backend/domain/home/PlaceSearchService.java - Mobile Client → Place Routes: plans route
- Mobile Client → In-App Notifications: reads notifications
- Mobile Client → Couple Games: plays games
- Mobile Client → Async Jobs: checks job status
- Couple Games → Async Jobs: creates jobs
src/main/java/com/boongboongus/backend/domain/game/service/GameService.java - Mobile Client → Music Playlists: manages playlists
- Mobile Client → Radio: uses radio
- Mobile Client → FAQ: reads FAQs
- Mobile Client → Legal Documents: reads documents
- Mobile Client → Account Deletion: requests deletion
- Account Deletion → Kakao Login: unlinks account
- Couple Management → In-App Notifications: notifies changes
src/main/java/com/boongboongus/backend/domain/couple/service/CoupleService.java - Place Routes → In-App Notifications: notifies sharing