# 2026-line4thon-team6/boongboongus-backend architecture

> Architecture diagram of the GitHub repository 2026-line4thon-team6/boongboongus-backend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/2026-line4thon-team6/boongboongus-backend
- Repository: https://github.com/2026-line4thon-team6/boongboongus-backend

## Overview

붕붕어스는 커플의 드라이브와 여행 기록을 위한 Spring 백엔드입니다. 주 흐름은 카카오 인증으로 회원을 식별하고, 초대로 커플을 연결한 뒤, 동의된 위치정보로 주행을 준비·기록하고 완료 카드와 미디어를 관리하는 것입니다. 장소 탐색·공유, 알림, 게임·비동기 작업, 음악·라디오 등도 별도 기능으로 제공됩니다. 관계는 발췌 소스에서 확인되거나 README에 명시된 것만 표시했습니다. 여러 서비스 구현은 발췌되지 않아 일부 기능 간 연결은 생략했습니다.

Main entry points: [`src/main/java/com/boongboongus/backend/domain/drive/DrivePreparationService.java`](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/drive/DrivePreparationService.java) (Drive Lifecycle), [`src/main/java/com/boongboongus/backend/domain/card/CardService.java`](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/card/CardService.java) (Drive Cards), [`src/main/java/com/boongboongus/backend/domain/notification/service/NotificationService.java`](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/notification/service/NotificationService.java) (In-App Notifications), [`src/main/java/com/boongboongus/backend/domain/auth/controller/AuthController.java`](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/auth/controller/AuthController.java) (Auth API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity &amp; Accounts"]
  node_auth_api["Auth API"]
  node_profile_api["Profile API<br/>[MeController.java]"]
  node_auth_flow["Token &amp; Reauth"]
  node_account_delete["Account Deletion"]
end

subgraph group_relationships["Couple &amp; Devices"]
  node_couple_api["Couple API"]
  node_invite_api["Invite API"]
  node_couple_service["Couple Management<br/>[CoupleService.java]"]
  node_push_api["Push Registration"]
end

subgraph group_drive["Drive Records"]
  node_drive_api["Drive Preparation"]
  node_drive_service["Drive Lifecycle"]
  node_drive_store[("Drive State")]
  node_card_service["Drive Cards<br/>[CardService.java]"]
  node_media_service["Photo Media<br/>[MediaService.java]"]
end

subgraph group_discovery["Places &amp; Notifications"]
  node_home_api["Home &amp; Places"]
  node_place_search["Place Search"]
  node_place_route["Place Routes"]
  node_notifications["In-App Notifications"]
end

subgraph group_experiences["Interactive Features"]
  node_game["Couple Games<br/>[GameService.java]"]
  node_jobs["Async Jobs<br/>[JobService.java]"]
  node_playlist["Music Playlists"]
  node_radio["Radio<br/>[RadioService.java]"]
  node_faq["FAQ<br/>[FaqController.java]"]
  node_legal["Legal Documents"]
end

node_client(("Mobile Client"))
node_kakao{{"Kakao Login"}}

node_client -->|"starts login"| node_auth_api
node_auth_api -.->|"exchanges tokens"| node_auth_flow
node_auth_flow -->|"exchanges code"| node_kakao
node_client -->|"manages profile"| node_profile_api
node_client -->|"manages connection"| node_couple_api
node_client -->|"manages invites"| node_invite_api
node_client -->|"registers token"| node_push_api
node_client -.->|"controls drive"| node_drive_api
node_drive_api -.->|"delegates"| node_drive_service
node_drive_service -->|"reads and writes"| node_drive_store
node_drive_service -->|"creates completion card"| node_card_service
node_client -->|"edits drive cards"| node_card_service
node_card_service -->|"attaches photos"| node_media_service
node_client -.->|"explores places"| node_home_api
node_home_api -.->|"searches places"| node_place_search
node_client -->|"plans route"| node_place_route
node_client -->|"reads notifications"| node_notifications
node_client -->|"plays games"| node_game
node_client -->|"checks job status"| node_jobs
node_game -->|"creates jobs"| node_jobs
node_client -.->|"manages playlists"| node_playlist
node_client -.->|"uses radio"| node_radio
node_client -->|"reads FAQs"| node_faq
node_client -->|"reads documents"| node_legal
node_client -->|"requests deletion"| node_account_delete
node_account_delete -->|"unlinks account"| node_kakao
node_couple_service -->|"notifies changes"| node_notifications
node_place_route -->|"notifies sharing"| node_notifications

click node_auth_api "https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/auth/controller/AuthController.java"
click node_profile_api "https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/auth/controller/MeController.java"
click node_auth_flow "https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/auth/service/AuthTokenService.java"
click node_account_delete "https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/auth/service/AccountDeletionService.java"
click node_couple_api "https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/couple/controller/CoupleController.java"
click node_invite_api "https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/couple/controller/CoupleInviteController.java"
click node_couple_service "https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/couple/service/CoupleService.java"
click node_push_api "https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/device/controller/DevicePushTokenController.java"
click node_drive_api "https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/drive/DrivePreparationController.java"
click node_drive_service "https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/drive/DrivePreparationService.java"
click node_drive_store "https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/drive/DrivePreparationStore.java"
click node_card_service "https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/card/CardService.java"
click node_media_service "https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/media/MediaService.java"
click node_home_api "https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/home/HomeExploreController.java"
click node_place_search "https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/home/PlaceSearchService.java"
click node_place_route "https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/home/PlaceRouteService.java"
click node_notifications "https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/notification/service/NotificationService.java"
click node_game "https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/game/service/GameService.java"
click node_jobs "https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/job/service/JobService.java"
click node_playlist "https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/playlist/service/PlaylistService.java"
click node_radio "https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/radio/service/RadioService.java"
click node_faq "https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/faq/FaqController.java"
click node_legal "https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/legal/LegalDocumentService.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_auth_api,node_profile_api,node_auth_flow,node_account_delete,node_client toneBlue
class node_couple_api,node_invite_api,node_couple_service,node_push_api toneAmber
class node_drive_api,node_drive_service,node_drive_store,node_card_service,node_media_service toneMint
class node_home_api,node_place_search,node_place_route,node_notifications toneRose
class node_game,node_jobs,node_playlist,node_radio,node_faq,node_legal,node_kakao toneIndigo
```

## Components

### Identity & Accounts

- [Auth API](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/auth/controller/AuthController.java): `src/main/java/com/boongboongus/backend/domain/auth/controller/AuthController.java`
- [Profile API](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/auth/controller/MeController.java): `src/main/java/com/boongboongus/backend/domain/auth/controller/MeController.java`
- [Token & Reauth](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/auth/service/AuthTokenService.java): `src/main/java/com/boongboongus/backend/domain/auth/service/AuthTokenService.java`
- [Account Deletion](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/auth/service/AccountDeletionService.java): `src/main/java/com/boongboongus/backend/domain/auth/service/AccountDeletionService.java`

### Couple & Devices

- [Couple API](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/couple/controller/CoupleController.java): `src/main/java/com/boongboongus/backend/domain/couple/controller/CoupleController.java`
- [Invite API](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/couple/controller/CoupleInviteController.java): `src/main/java/com/boongboongus/backend/domain/couple/controller/CoupleInviteController.java`
- [Couple Management](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/couple/service/CoupleService.java): `src/main/java/com/boongboongus/backend/domain/couple/service/CoupleService.java`
- [Push Registration](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/device/controller/DevicePushTokenController.java): `src/main/java/com/boongboongus/backend/domain/device/controller/DevicePushTokenController.java`

### Drive Records

- [Drive Preparation](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/drive/DrivePreparationController.java): `src/main/java/com/boongboongus/backend/domain/drive/DrivePreparationController.java`
- [Drive Lifecycle](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/drive/DrivePreparationService.java): `src/main/java/com/boongboongus/backend/domain/drive/DrivePreparationService.java`
- [Drive State](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/drive/DrivePreparationStore.java): `src/main/java/com/boongboongus/backend/domain/drive/DrivePreparationStore.java`
- [Drive Cards](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/card/CardService.java): `src/main/java/com/boongboongus/backend/domain/card/CardService.java`
- [Photo Media](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/media/MediaService.java): `src/main/java/com/boongboongus/backend/domain/media/MediaService.java`

### Places & Notifications

- [Home & Places](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/home/HomeExploreController.java): `src/main/java/com/boongboongus/backend/domain/home/HomeExploreController.java`
- [Place Search](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/home/PlaceSearchService.java): `src/main/java/com/boongboongus/backend/domain/home/PlaceSearchService.java`
- [Place Routes](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/home/PlaceRouteService.java): `src/main/java/com/boongboongus/backend/domain/home/PlaceRouteService.java`
- [In-App Notifications](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/notification/service/NotificationService.java): `src/main/java/com/boongboongus/backend/domain/notification/service/NotificationService.java`

### Interactive Features

- [Couple Games](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/game/service/GameService.java): `src/main/java/com/boongboongus/backend/domain/game/service/GameService.java`
- [Async Jobs](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/job/service/JobService.java): `src/main/java/com/boongboongus/backend/domain/job/service/JobService.java`
- [Music Playlists](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/playlist/service/PlaylistService.java): `src/main/java/com/boongboongus/backend/domain/playlist/service/PlaylistService.java`
- [Radio](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/radio/service/RadioService.java): `src/main/java/com/boongboongus/backend/domain/radio/service/RadioService.java`
- [FAQ](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/faq/FaqController.java): `src/main/java/com/boongboongus/backend/domain/faq/FaqController.java`
- [Legal Documents](https://github.com/2026-line4thon-team6/boongboongus-backend/blob/main/src/main/java/com/boongboongus/backend/domain/legal/LegalDocumentService.java): `src/main/java/com/boongboongus/backend/domain/legal/LegalDocumentService.java`

### Other components

- **Mobile Client**
- **Kakao Login**

## Connections

- Mobile Client → Auth API: starts login
- Auth API → Token & Reauth: exchanges tokens (evidence: `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 (evidence: `src/main/java/com/boongboongus/backend/domain/drive/DrivePreparationService.java`)
- Drive Lifecycle → Drive Cards: creates completion card (evidence: `src/main/java/com/boongboongus/backend/domain/drive/DrivePreparationService.java`)
- Mobile Client → Drive Cards: edits drive cards
- Drive Cards → Photo Media: attaches photos (evidence: `src/main/java/com/boongboongus/backend/domain/card/CardService.java`)
- Mobile Client → Home & Places: explores places
- Home & Places → Place Search: searches places (evidence: `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 (evidence: `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 (evidence: `src/main/java/com/boongboongus/backend/domain/couple/service/CoupleService.java`)
- Place Routes → In-App Notifications: notifies sharing
