# capstonedesign-taxicarpool/team_be architecture

> Architecture diagram of the GitHub repository capstonedesign-taxicarpool/team_be, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/capstonedesign-taxicarpool/team_be
- Repository: https://github.com/capstonedesign-taxicarpool/team_be

## Overview

##### Project Type and Purpose
- This is a Java Spring Boot–based backend (monolithic) application named “taxi-carpool.”
- It provides RESTful and WebSocket APIs for a taxi‐carpooling service, handling user management, authentication (JWT), chat, party (ride grouping), email verification, and external map lookups (Kakao API).

##### File Structure Analysis
- Top‐level: “taxi-carpool” Gradle project with standard Spring Boot layout:
- src/main/java/…/taxicarpool – root package
- Subpackages by feature: auth, chatting, config, email, exception, map, member, party
- src/main/resources – application.properties (profiles)
- src/test – unit/integration tests
- MVC / layered pattern:
- Controllers (API endpoints)
- Services (business logic)
- Repositories (Spring Data JPA interfaces)
- Entities, DTOs, Mappers
- Configuration classes: SecurityConfig, SwaggerConfig, WebSocketConfig
- Build & CI: Gradle wrapper, GitHub Actions workflow

##### Key Architecture Points from README
- README only gives project name (“team_BE”); details inferred from structure and naming.

a. Main Components
- External Clients: Web/Mobile Apps
- API Layer: REST Controllers & WebSocket Endpoints
- Business Layer: AuthService, MemberService, PartyService, MapService, EmailService, ChatService
- Data Layer: Repositories → Relational Database (e.g., PostgreSQL/MySQL)
- Cross‐cutting/Config: SecurityConfig (JWT filter), WebSocketConfig, SwaggerConfig
- External Dependencies:
- Kakao Map API (HTTP)
- SMTP server (Email)
b. Relationships & Interactions
- Clients → HTTP(S) → AuthController / MemberController / PartyController / MapController / EmailVerificationController
- Clients → WebSocket → Chat endpoint (MessageEntity flow)
- Controllers call Services → Services call Repositories → Database
- AuthService issues JWTs and stores RefreshTokenEntity
- EmailService sends verification codes via SMTP
- MapService calls external Kakao API, parses MapPlaceDTO
c. Architectural Patterns & Principles
- Layered (Controller → Service → Repository)
- Feature grouping by package
- JWT‐based stateless authentication
- WebSocket for real‐time chat
- Exception‐handling via GlobalExceptionHandler
d. Technologies & Frameworks
- Spring Boot (Web, Data JPA, Security, WebSocket)
- Gradle build system
- JWT (via custom JwtUtil, filter)
- Swagger for API docs
- Kakao REST API integration
- SMTP for email

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Clients
    subgraph "Clients"
        direction TB
        WebApp["Web Application"]:::external
        MobileApp["Mobile Application"]:::external
    end

    %% Security Filter
    JwtFilter["JwtAuthenticationFilter"]:::security

    %% API Layer
    subgraph "API Layer"
        direction TB
        AuthController["AuthController"]:::internal
        MemberController["MemberController"]:::internal
        PartyController["PartyController"]:::internal
        MapController["MapController"]:::internal
        EmailController["EmailVerificationController"]:::internal
        ChatEndpoint["WebSocket Chat Endpoint"]:::internal
    end

    %% Business Layer
    subgraph "Business Services"
        direction TB
        AuthService["AuthService"]:::internal
        MemberService["MemberService"]:::internal
        PartyService["PartyService"]:::internal
        MapService["MapService"]:::internal
        EmailService["EmailVerificationService"]:::internal
        ChatService["ChatService"]:::internal
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        RefreshTokenRepo["RefreshTokenRepository"]:::internal
        MemberRepo["MemberRepository"]:::internal
        PartyRepo["PartyRepository"]:::internal
        EmailRepo["EmailVerificationRepository"]:::internal
        ChatRepo["MessageRepository"]:::internal
        DB["Relational Database"]:::database
    end

    %% External Services
    subgraph "External Services"
        direction TB
        KakaoAPI["Kakao Map API"]:::external
        SMTP["SMTP Email Server"]:::external
    end

    %% Config & Cross-cutting
    subgraph "Configuration"
        direction TB
        SecurityConfig["SecurityConfig"]:::security
        SwaggerConfig["SwaggerConfig"]:::internal
        WebSocketConfig["WebSocketConfig"]:::internal
        JwtUtil["JwtUtil"]:::security
        ExceptionHandler["GlobalExceptionHandler"]:::security
    end

    %% Connections
    WebApp -->|HTTP/HTTPS| JwtFilter
    MobileApp -->|HTTP/HTTPS| JwtFilter
    JwtFilter --> AuthController
    JwtFilter --> MemberController
    JwtFilter --> PartyController
    JwtFilter --> MapController
    JwtFilter --> EmailController

    AuthController --> AuthService
    MemberController --> MemberService
    PartyController --> PartyService
    MapController --> MapService
    EmailController --> EmailService
    ChatEndpoint --> ChatService

    AuthService --> RefreshTokenRepo
    AuthService --> JwtUtil
    AuthService -->|issues JWT| JwtUtil
    MemberService --> MemberRepo
    PartyService --> PartyRepo
    EmailService --> EmailRepo
    ChatService --> ChatRepo
    MapService --> KakaoAPI
    EmailService --> SMTP

    RefreshTokenRepo --> DB
    MemberRepo --> DB
    PartyRepo --> DB
    EmailRepo --> DB
    ChatRepo --> DB

    %% Click Events
    click AuthController "https://github.com/capstonedesign-taxicarpool/team_be/blob/main/taxi-carpool/src/main/java/edu/kangwon/university/taxicarpool/auth/AuthController.java"
    click JwtFilter "https://github.com/capstonedesign-taxicarpool/team_be/blob/main/taxi-carpool/src/main/java/edu/kangwon/university/taxicarpool/auth/JwtAuthenticationFilter.java"
    click JwtUtil "https://github.com/capstonedesign-taxicarpool/team_be/blob/main/taxi-carpool/src/main/java/edu/kangwon/university/taxicarpool/auth/JwtUtil.java"
    click AuthService "https://github.com/capstonedesign-taxicarpool/team_be/blob/main/taxi-carpool/src/main/java/edu/kangwon/university/taxicarpool/auth/AuthService.java"
    click RefreshTokenRepo "https://github.com/capstonedesign-taxicarpool/team_be/blob/main/taxi-carpool/src/main/java/edu/kangwon/university/taxicarpool/auth/RefreshTokenRepository.java"
    click MemberController "https://github.com/capstonedesign-taxicarpool/team_be/blob/main/taxi-carpool/src/main/java/edu/kangwon/university/taxicarpool/member/MemberController.java"
    click MemberService "https://github.com/capstonedesign-taxicarpool/team_be/blob/main/taxi-carpool/src/main/java/edu/kangwon/university/taxicarpool/member/MemberService.java"
    click MemberRepo "https://github.com/capstonedesign-taxicarpool/team_be/blob/main/taxi-carpool/src/main/java/edu/kangwon/university/taxicarpool/member/MemberRepository.java"
    click PartyController "https://github.com/capstonedesign-taxicarpool/team_be/blob/main/taxi-carpool/src/main/java/edu/kangwon/university/taxicarpool/party/PartyController.java"
    click PartyService "https://github.com/capstonedesign-taxicarpool/team_be/blob/main/taxi-carpool/src/main/java/edu/kangwon/university/taxicarpool/party/PartyService.java"
    click PartyRepo "https://github.com/capstonedesign-taxicarpool/team_be/blob/main/taxi-carpool/src/main/java/edu/kangwon/university/taxicarpool/party/PartyRepository.java"
    click MapController "https://github.com/capstonedesign-taxicarpool/team_be/blob/main/taxi-carpool/src/main/java/edu/kangwon/university/taxicarpool/map/MapController.java"
    click MapService "https://github.com/capstonedesign-taxicarpool/team_be/blob/main/taxi-carpool/src/main/java/edu/kangwon/university/taxicarpool/map/MapService.java"
    click EmailController "https://github.com/capstonedesign-taxicarpool/team_be/blob/main/taxi-carpool/src/main/java/edu/kangwon/university/taxicarpool/email/EmailVerificationController.java"
    click EmailService "https://github.com/capstonedesign-taxicarpool/team_be/blob/main/taxi-carpool/src/main/java/edu/kangwon/university/taxicarpool/email/EmailVerificationService.java"
    click EmailRepo "https://github.com/capstonedesign-taxicarpool/team_be/blob/main/taxi-carpool/src/main/java/edu/kangwon/university/taxicarpool/email/EmailVerificationRepository.java"
    click ChatRepo "https://github.com/capstonedesign-taxicarpool/team_be/blob/main/taxi-carpool/src/main/java/edu/kangwon/university/taxicarpool/chatting/MessageRepository.java"
    click SecurityConfig "https://github.com/capstonedesign-taxicarpool/team_be/blob/main/taxi-carpool/src/main/java/edu/kangwon/university/taxicarpool/config/SecurityConfig.java"
    click SwaggerConfig "https://github.com/capstonedesign-taxicarpool/team_be/blob/main/taxi-carpool/src/main/java/edu/kangwon/university/taxicarpool/config/SwaggerConfig.java"
    click WebSocketConfig "https://github.com/capstonedesign-taxicarpool/team_be/blob/main/taxi-carpool/src/main/java/edu/kangwon/university/taxicarpool/config/WebSocketConfig.java"
    click ExceptionHandler "https://github.com/capstonedesign-taxicarpool/team_be/blob/main/taxi-carpool/src/main/java/edu/kangwon/university/taxicarpool/exception/GlobalExceptionHandler.java"

    %% Styles
    classDef internal fill:#cce5ff,stroke:#2a9df4,color:#000
    classDef external fill:#e0e0e0,stroke:#888,color:#000
    classDef database fill:#d4edda,stroke:#2e7d32,color:#000
    classDef security fill:#fff3cd,stroke:#856404,color:#000
    classDef internal internal
    classDef external external
    classDef database database
    classDef security security
```
