# nubblee/nubblev2-be architecture

> Architecture diagram of the GitHub repository nubblee/nubblev2-be, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nubblee/nubblev2-be
- Repository: https://github.com/nubblee/nubblev2-be

## Overview

##### Project type and purpose
- This is a backend-only, monolithic Spring Boot REST API (“NubbleV2-BE”) for a coding-study recruitment platform (“너블투”).
- It exposes HTTP endpoints for user registration, authentication, study announcements, group creation, and application form submission.

##### File structure
- Top-level artifacts: Dockerfile, docker-compose.yaml (local dev), Gradle build files, application.yaml.
- src/main/java/dev/biddan/nubblev2:
– config: Spring configurations (JPA auditing, BlazePersistence, WebMvc)
– http: cookie management, IP extraction
– interceptor/auth: custom annotations and interceptors for session checks
– argument/userid: argument resolver for current user injection
– openapi: SpringDoc/OpenAPI customizers
– auth, user, study/announcement, study/group, study/applicationform, study/member: each sub-package splits into controller → service → repository → domain → DTOs
– exception: global and HTTP-code‐mapped exceptions, validation handlers
- src/main/resources: application.yaml
- Docker subfolder: docker/compose.yaml for spinning up Postgres (or another DB)
- Tests mirror the main packages, exercising controllers and services end-to-end and in isolation.

##### README
- Confirms “NubbleV2-BE” is the backend for a newly born coding-study recruitment platform.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Client & External"
        Client["Browser/Mobile"]:::external
        Swagger["Swagger UI/OpenAPI"]:::external
    end

    subgraph "API Layer"
        A1["AuthApiController"]:::controller
        A2["UserApiController"]:::controller
        A3["StudyAnnouncementApiController"]:::controller
        A4["StudyGroupApiController"]:::controller
        A5["ApplicationFormApiController"]:::controller
    end

    subgraph "Business Layer"
        S1["AuthService"]:::service
        S2["UserService"]:::service
        S3["StudyAnnouncementService"]:::service
        S4["StudyGroupService"]:::service
        S5["ApplicationFormService"]:::service
    end

    subgraph "Persistence Layer"
        R1["AuthSessionRepository"]:::repo
        R2["UserRepository"]:::repo
        R3["StudyAnnouncementRepository"]:::repo
        R4["StudyGroupRepository"]:::repo
        R5["StudyApplicationFormRepository"]:::repo
    end

    subgraph "Infrastructure & Cross-cutting"
        C1["BlazePersistenceConfig"]:::infra
        C2["JpaAuditingConfig"]:::infra
        C3["WebMvcConfig"]:::infra
        C4["OpenAPIConfig"]:::infra
        I1["AuthSessionCheckInterceptor"]:::infra
        I2["CurrentUserIdArgumentResolver"]:::infra
        E1["GlobalExceptionHandler"]:::infra
    end

    subgraph "Database & Deployment"
        DB[(PostgreSQL DB)]:::database
        App["Spring Boot App"]:::deployment
        DC["docker/compose.yaml"]:::deployment
        DF["Dockerfile"]:::deployment
    end

    Client -->|HTTP| A1
    Client -->|HTTP| A2
    Client -->|HTTP| A3
    Client -->|HTTP| A4
    Client -->|HTTP| A5

    A1 -->|"invoke"| S1
    A2 -->|"invoke"| S2
    A3 -->|"invoke"| S3
    A4 -->|"invoke"| S4
    A5 -->|"invoke"| S5

    S1 -->|"CRUD"| R1
    S2 -->|"CRUD"| R2
    S3 -->|"CRUD"| R3
    S4 -->|"CRUD"| R4
    S5 -->|"CRUD"| R5

    R1 -->|JDBC| DB
    R2 -->|JDBC| DB
    R3 -->|JDBC| DB
    R4 -->|JDBC| DB
    R5 -->|JDBC| DB

    I1 --> A1
    I1 --> A2
    I1 --> A3
    I1 --> A4
    I1 --> A5

    I2 --> A1
    I2 --> A2
    I2 --> A3
    I2 --> A4
    I2 --> A5

    A1 -->|throws| E1
    A2 -->|throws| E1
    A3 -->|throws| E1
    A4 -->|throws| E1
    A5 -->|throws| E1
    S1 -->|throws| E1
    S2 -->|throws| E1
    S3 -->|throws| E1
    S4 -->|throws| E1
    S5 -->|throws| E1

    C1 -.-> S1
    C2 -.-> R1
    C3 -.-> A1
    C4 -.-> Swagger

    Swagger -->|reads| C4

    DF -.-> App
    DC -.-> DB

    App -->|runs| A1

    classDef controller fill:#cbe6ff,stroke:#026bfa
    classDef service fill:#daf5d6,stroke:#28a42b
    classDef repo fill:#ffe5b4,stroke:#e18e00
    classDef infra fill:#d3d3d3,stroke:#888888
    classDef external fill:#f0e68c,stroke:#d4af37
    classDef database fill:#fff2cc,stroke:#d6b656
    classDef deployment fill:#e6e6e6,stroke:#999999

    click A1 "https://github.com/nubblee/nubblev2-be/blob/main/src/main/java/dev/biddan/nubblev2/auth/controller/AuthApiController.java"
    click A2 "https://github.com/nubblee/nubblev2-be/blob/main/src/main/java/dev/biddan/nubblev2/user/controller/UserApiController.java"
    click A3 "https://github.com/nubblee/nubblev2-be/blob/main/src/main/java/dev/biddan/nubblev2/study/announcement/controller/StudyAnnouncementApiController.java"
    click A4 "https://github.com/nubblee/nubblev2-be/blob/main/src/main/java/dev/biddan/nubblev2/study/group/controller/StudyGroupApiController.java"
    click A5 "https://github.com/nubblee/nubblev2-be/blob/main/src/main/java/dev/biddan/nubblev2/study/applicationform/controller/ApplicationFormApiController.java"
    click S1 "https://github.com/nubblee/nubblev2-be/blob/main/src/main/java/dev/biddan/nubblev2/auth/service/AuthService.java"
    click S2 "https://github.com/nubblee/nubblev2-be/blob/main/src/main/java/dev/biddan/nubblev2/user/service/UserService.java"
    click S3 "https://github.com/nubblee/nubblev2-be/blob/main/src/main/java/dev/biddan/nubblev2/study/announcement/service/StudyAnnouncementService.java"
    click S4 "https://github.com/nubblee/nubblev2-be/blob/main/src/main/java/dev/biddan/nubblev2/study/group/service/StudyGroupService.java"
    click S5 "https://github.com/nubblee/nubblev2-be/blob/main/src/main/java/dev/biddan/nubblev2/study/applicationform/service/ApplicationFormService.java"
    click R1 "https://github.com/nubblee/nubblev2-be/blob/main/src/main/java/dev/biddan/nubblev2/auth/repository/AuthSessionRepository.java"
    click R2 "https://github.com/nubblee/nubblev2-be/blob/main/src/main/java/dev/biddan/nubblev2/user/repository/UserRepository.java"
    click R3 "https://github.com/nubblee/nubblev2-be/blob/main/src/main/java/dev/biddan/nubblev2/study/announcement/repository/StudyAnnouncementRepository.java"
    click R4 "https://github.com/nubblee/nubblev2-be/blob/main/src/main/java/dev/biddan/nubblev2/study/group/repository/StudyGroupRepository.java"
    click R5 "https://github.com/nubblee/nubblev2-be/blob/main/src/main/java/dev/biddan/nubblev2/study/applicationform/repository/StudyApplicationFormRepository.java"
    click C1 "https://github.com/nubblee/nubblev2-be/blob/main/src/main/java/dev/biddan/nubblev2/config/BlazePersistenceConfig.java"
    click C2 "https://github.com/nubblee/nubblev2-be/blob/main/src/main/java/dev/biddan/nubblev2/config/JpaAuditingConfig.java"
    click C3 "https://github.com/nubblee/nubblev2-be/blob/main/src/main/java/dev/biddan/nubblev2/config/WebMvcConfig.java"
    click C4 "https://github.com/nubblee/nubblev2-be/blob/main/src/main/java/dev/biddan/nubblev2/openapi/OpenAPiConfig.java"
    click I1 "https://github.com/nubblee/nubblev2-be/blob/main/src/main/java/dev/biddan/nubblev2/interceptor/auth/AuthSessionCheckInterceptor.java"
    click I2 "https://github.com/nubblee/nubblev2-be/blob/main/src/main/java/dev/biddan/nubblev2/argument/userid/CurrentUserIdArgumentResolver.java"
    click E1 "https://github.com/nubblee/nubblev2-be/blob/main/src/main/java/dev/biddan/nubblev2/exception/GlobalExceptionHandler.java"
    click DC "https://github.com/nubblee/nubblev2-be/blob/main/docker/compose.yaml"
    click DF "https://github.com/nubblee/nubblev2-be/tree/main/Dockerfile"
    click App "https://github.com/nubblee/nubblev2-be/blob/main/src/main/java/dev/biddan/nubblev2/Application.java"
```
