# codergogh/meetup architecture

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

- Interactive diagram: https://gitdiagram.com/codergogh/meetup
- Repository: https://github.com/codergogh/meetup

## Overview

어디가?는 로그인 없이 공유 링크로 모임 방에 들어가 장소와 활동을 정하고, 참여자 이동시간을 비교해 투표로 확정하는 서비스입니다. 주요 흐름은 방 생성·참여, 후보지와 대중교통 이동시간 제공, 방 단계 전이와 확정입니다. 별도로 로컬 역·이동시간 데이터 적재와 지하철 그래프 지원 기능이 있습니다. 핵심 서비스·저장소·경로 조회의 일부 연결은 발췌 코드로 확인했습니다. 후보 선정·행렬 적재·투표 세부 연결은 트리와 README만으로 구현을 확인할 수 없어 일부 관계를 생략했습니다.

Main entry points: [`src/main/java/com/meetup/room/ParticipantService.java`](https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/room/ParticipantService.java) (참여자 입장), [`src/main/java/com/meetup/room/RoomRepository.java`](https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/room/RoomRepository.java) (방·참여자 저장소), [`src/main/java/com/meetup/room/RoomController.java`](https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/room/RoomController.java) (방 API), [`src/main/java/com/meetup/loader/GraphMatrixLoader.java`](https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/loader/GraphMatrixLoader.java) (행렬 적재)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_room["모임 방"]
  node_room_api["방 API"]
  node_room_service["방 서비스<br/>[RoomService.java]"]
  node_participants["참여자 입장"]
  node_participant_api["참여자 API"]
  node_transition_api["단계 전이 API"]
  node_state_machine["방 상태 머신"]
  node_room_store["방·참여자 저장소"]
end

subgraph group_places["장소와 이동"]
  node_candidate_data["장소 후보<br/>[Candidate.java]"]
  node_place_store["장소 조회 저장소"]
  node_subway_graph["지하철 그래프<br/>[SubwayGraph.java]"]
  node_travel_matrix[("이동시간 행렬<br/>[TravelTime.java]")]
end

subgraph group_loader["데이터 적재"]
  node_loader_runner["적재 실행기<br/>[LoaderRunner.java]"]
  node_station_import["역 데이터 적재"]
  node_matrix_loader["행렬 적재"]
  node_route_clients["경로 조회·추정"]
end

subgraph group_common["공통 기반"]
  node_idempotency["요청 멱등성<br/>[Idempotency.java]"]
  node_errors["API 오류 응답"]
end

node_organizer(("모임 사용자"))
node_redis[("Redis")]
node_odsay{{"ODsay 경로 API"}}

node_organizer -->|"방 요청"| node_room_api
node_room_api -->|"생성·조회"| node_room_service
node_room_api -->|"멱등 처리"| node_idempotency
node_room_service -->|"방 읽기·쓰기"| node_room_store
node_organizer -->|"링크로 입장"| node_participant_api
node_participant_api -->|"입장 요청"| node_participants
node_participants -->|"방 검증"| node_room_service
node_participants -->|"참여자 등록"| node_room_store
node_participants -->|"상태 변경 요청"| node_state_machine
node_room_store -->|"상태 저장"| node_redis
node_organizer -->|"단계 진행"| node_transition_api
node_transition_api -->|"전이 실행"| node_state_machine
node_state_machine -->|"단계 CAS"| node_room_store
node_organizer -->|"후보 비교·투표"| node_candidate_data
node_place_store -->|"후보 조회"| node_candidate_data
node_subway_graph -->|"역 위치 계산"| node_candidate_data
node_loader_runner -.->|"역 적재"| node_station_import
node_loader_runner -.->|"행렬 적재"| node_matrix_loader
node_matrix_loader -.->|"경로 조회"| node_route_clients
node_route_clients -->|"대중교통 경로 요청"| node_odsay
node_matrix_loader -.->|"이동시간 기록"| node_travel_matrix
node_errors -.->|"오류 응답"| node_organizer

click node_room_api "https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/room/RoomController.java"
click node_room_service "https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/room/RoomService.java"
click node_participants "https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/room/ParticipantService.java"
click node_participant_api "https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/room/ParticipantController.java"
click node_transition_api "https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/room/TransitionController.java"
click node_state_machine "https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/room/RoomStateMachine.java"
click node_room_store "https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/room/RoomRepository.java"
click node_candidate_data "https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/place/Candidate.java"
click node_place_store "https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/place/PlaceRepository.java"
click node_subway_graph "https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/subway/SubwayGraph.java"
click node_travel_matrix "https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/place/TravelTime.java"
click node_loader_runner "https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/loader/LoaderRunner.java"
click node_station_import "https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/loader/SeoulStationImporter.java"
click node_matrix_loader "https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/loader/GraphMatrixLoader.java"
click node_route_clients "https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/loader/OdsayRouteClient.java"
click node_idempotency "https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/common/Idempotency.java"
click node_errors "https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/common/ApiExceptionHandler.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_room_api,node_room_service,node_participants,node_participant_api,node_transition_api,node_state_machine,node_room_store toneBlue
class node_candidate_data,node_place_store,node_subway_graph,node_travel_matrix,node_redis toneAmber
class node_loader_runner,node_station_import,node_matrix_loader,node_route_clients,node_odsay toneMint
class node_idempotency,node_errors toneRose
class node_organizer toneIndigo
```

## Components

### 모임 방

- [방 API](https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/room/RoomController.java): `src/main/java/com/meetup/room/RoomController.java`
- [방 서비스](https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/room/RoomService.java): `src/main/java/com/meetup/room/RoomService.java`
- [참여자 입장](https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/room/ParticipantService.java): `src/main/java/com/meetup/room/ParticipantService.java`
- [참여자 API](https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/room/ParticipantController.java): `src/main/java/com/meetup/room/ParticipantController.java`
- [단계 전이 API](https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/room/TransitionController.java): `src/main/java/com/meetup/room/TransitionController.java`
- [방 상태 머신](https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/room/RoomStateMachine.java): `src/main/java/com/meetup/room/RoomStateMachine.java`
- [방·참여자 저장소](https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/room/RoomRepository.java): `src/main/java/com/meetup/room/RoomRepository.java`

### 장소와 이동

- [장소 후보](https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/place/Candidate.java): `src/main/java/com/meetup/place/Candidate.java`
- [장소 조회 저장소](https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/place/PlaceRepository.java): `src/main/java/com/meetup/place/PlaceRepository.java`
- [지하철 그래프](https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/subway/SubwayGraph.java): `src/main/java/com/meetup/subway/SubwayGraph.java`
- [이동시간 행렬](https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/place/TravelTime.java): `src/main/java/com/meetup/place/TravelTime.java`

### 데이터 적재

- [적재 실행기](https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/loader/LoaderRunner.java): `src/main/java/com/meetup/loader/LoaderRunner.java`
- [역 데이터 적재](https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/loader/SeoulStationImporter.java): `src/main/java/com/meetup/loader/SeoulStationImporter.java`
- [행렬 적재](https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/loader/GraphMatrixLoader.java): `src/main/java/com/meetup/loader/GraphMatrixLoader.java`
- [경로 조회·추정](https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/loader/OdsayRouteClient.java): `src/main/java/com/meetup/loader/OdsayRouteClient.java`

### 공통 기반

- [요청 멱등성](https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/common/Idempotency.java): `src/main/java/com/meetup/common/Idempotency.java`
- [API 오류 응답](https://github.com/codergogh/meetup/blob/main/src/main/java/com/meetup/common/ApiExceptionHandler.java): `src/main/java/com/meetup/common/ApiExceptionHandler.java`

### Other components

- **모임 사용자**
- **Redis**
- **ODsay 경로 API**

## Connections

- 모임 사용자 → 방 API: 방 요청
- 방 API → 방 서비스: 생성·조회 (evidence: `src/main/java/com/meetup/room/RoomController.java`)
- 방 API → 요청 멱등성: 멱등 처리 (evidence: `src/main/java/com/meetup/room/RoomController.java`)
- 방 서비스 → 방·참여자 저장소: 방 읽기·쓰기 (evidence: `src/main/java/com/meetup/room/RoomService.java`)
- 모임 사용자 → 참여자 API: 링크로 입장
- 참여자 API → 참여자 입장: 입장 요청 (evidence: `src/main/java/com/meetup/room/ParticipantController.java`)
- 참여자 입장 → 방 서비스: 방 검증 (evidence: `src/main/java/com/meetup/room/ParticipantService.java`)
- 참여자 입장 → 방·참여자 저장소: 참여자 등록 (evidence: `src/main/java/com/meetup/room/ParticipantService.java`)
- 참여자 입장 → 방 상태 머신: 상태 변경 요청 (evidence: `src/main/java/com/meetup/room/ParticipantService.java`)
- 방·참여자 저장소 → Redis: 상태 저장 (evidence: `src/main/java/com/meetup/room/RoomRepository.java`)
- 모임 사용자 → 단계 전이 API: 단계 진행
- 단계 전이 API → 방 상태 머신: 전이 실행 (evidence: `src/main/java/com/meetup/room/TransitionController.java`)
- 방 상태 머신 → 방·참여자 저장소: 단계 CAS (evidence: `src/main/java/com/meetup/room/RoomStateMachine.java`)
- 모임 사용자 → 장소 후보: 후보 비교·투표
- 장소 조회 저장소 → 장소 후보: 후보 조회 (evidence: `src/main/java/com/meetup/place/PlaceRepository.java`)
- 지하철 그래프 → 장소 후보: 역 위치 계산 (evidence: `src/main/java/com/meetup/subway/SubwayGraph.java`)
- 적재 실행기 → 역 데이터 적재: 역 적재
- 적재 실행기 → 행렬 적재: 행렬 적재
- 행렬 적재 → 경로 조회·추정: 경로 조회
- 경로 조회·추정 → ODsay 경로 API: 대중교통 경로 요청 (evidence: `src/main/java/com/meetup/loader/OdsayRouteClient.java`)
- 행렬 적재 → 이동시간 행렬: 이동시간 기록
- API 오류 응답 → 모임 사용자: 오류 응답
