# recruiting-your-club/ryc architecture

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

- Interactive diagram: https://gitdiagram.com/recruiting-your-club/ryc
- Repository: https://github.com/recruiting-your-club/ryc

## Overview

##### Project Type and Purpose
- This is a full-stack web application (“RYC”) that manages the club recruitment process for a university.
- The client directory is a React+TypeScript front-end; the server directory is a Spring Boot monolithic REST API built with Java/Gradle.

##### File Structure Analysis
- Top-level:
- .github, README.md, client/, server/
- client/:
- Standard React project (public/, src/, package.json, Babel, Webpack configs, Storybook, ESLint, Prettier, Husky)
- src/components, src/pages, src/layouts, src/hooks, src/utils, src/constants → a component library + feature pages
- src/router.tsx orchestrates page navigation
- server/:
- Gradle wrapper, build.gradle, settings.gradle
- src/main/java/com/ryc/api: Spring Boot entrypoint + config (Security, WebConfig, Swagger)
- api/v1 and api/v2 packages: versioned REST controllers, services, repositories, DTOs, entities
- Cross-cutting concerns: common AOP for role checks, exception handlers
- Persistence: Spring Data JPA repositories, domain entities
- Tests: src/test/java covering v2 club business, infra and presentation layers

##### README Insights
- Very brief description: “세종대학교 동아리 모집 프로세스 관리 서비스”

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Front-end"
        Browser["Web Browser"]:::external
        FE["React+TypeScript App"]:::frontend
        Browser -->|"loads app"| FE
        Router["Router"]:::frontend
        FE -->|"routes"| Router

        subgraph "Pages"
            MainPage["MainPage"]:::frontend
            ClubDetailPage["ClubDetailPage"]:::frontend
            ClubApplyPage["ClubApplyPage"]:::frontend
        end
        Router --> MainPage
        Router --> ClubDetailPage
        Router --> ClubApplyPage

        subgraph "Shared Components"
            ClubCard["ClubCard"]:::frontend
            FileUpLoader["FileUpLoader"]:::frontend
        end
        MainPage -->|"uses"| ClubCard
        ClubDetailPage -->|"uses"| ClubCard
        ClubApplyPage -->|"uses"| FileUpLoader
    end

    subgraph "Back-end"
        APIApp["ApiApplication"]:::backend
        ConfigSec["SecurityConfiguration"]:::config
        ConfigWeb["WebConfig"]:::config
        ConfigSwagger["SwaggerConfiguration"]:::config
        APIApp --> ConfigSec
        APIApp --> ConfigWeb
        APIApp --> ConfigSwagger

        Filter["JwtAuthenticationFilter"]:::backend
        TokenMgr["JwtTokenManager"]:::backend
        APIApp --> Filter
        APIApp --> TokenMgr

        AOPAspect["ClubRoleAuthenticationAspect"]:::backend
        AOPAnnot["HasPresidentRoleSecured"]:::backend
        APIApp --> AOPAspect
        AOPAspect --> AOPAnnot

        subgraph "API v1 Controllers"
            AuthCtrl["AuthController"]:::controller
            RefreshCtrl["RefreshTokenController"]:::controller
            ApplicantCtrl["ApplicantController"]:::controller
            ClubCtrl["ClubController"]:::controller
        end

        subgraph "v1 Services"
            AuthSvc["AuthServiceImpl"]:::service
            RefreshSvc["RefreshTokenServiceImpl"]:::service
            ClubSvc["ClubServiceImpl"]:::service
        end

        subgraph "v1 Repositories"
            ClubRepo["ClubRepository"]:::repository
        end

        subgraph "v1 Domain"
            ClubEntity["Club Entity"]:::entity
        end

        AuthCtrl --> AuthSvc
        RefreshCtrl --> RefreshSvc
        ClubCtrl --> ClubSvc
        ClubSvc --> ClubRepo
        ClubRepo --> ClubEntity

        subgraph "API v2 Announcement"
            AnnouncementApi["AnnouncementHttpApi"]:::controller2
            AnnouncementSvc["AnnouncementService"]:::service2
            AnnouncementRepo["AnnouncementRepositoryImpl"]:::repository2
            AnnouncementEntity["Announcement Entity"]:::entity2
            AnnouncementSched["AnnouncementStatusScheduler"]:::service2
            EmailStub["Email Module"]:::external
        end
        AnnouncementApi --> AnnouncementSvc
        AnnouncementSvc --> AnnouncementRepo
        AnnouncementRepo --> AnnouncementEntity
        AnnouncementSched --> AnnouncementRepo
        AnnouncementSvc --> EmailStub

        DB["Relational Database"]:::external
        SwaggerUI["Swagger UI"]:::external

        ClubRepo --> DB
        AnnouncementRepo --> DB
        SwaggerUI --> ConfigSwagger
        SwaggerUI --> AuthCtrl
    end

    Browser -->|"HTTPS/REST, JWT"| AuthCtrl

    classDef frontend fill:#bbdefb,stroke:#1e88e5,color:#0d47a1
    classDef external fill:#eeeeee,stroke:#888888,color:#333333
    classDef backend fill:#c8e6c9,stroke:#388e3c,color:#1b5e20
    classDef config fill:#ffe082,stroke:#ffa000,color:#bf360c
    classDef controller fill:#a5d6a7,stroke:#2e7d32,color:#1b5e20
    classDef service fill:#fff9c4,stroke:#fbc02d,color:#f57f17
    classDef repository fill:#ffe0b2,stroke:#ef6c00,color:#e65100
    classDef entity fill:#d7ccc8,stroke:#6d4c41,color:#3e2723
    classDef controller2 fill:#a5d6a7,stroke:#2e7d32,color:#1b5e20
    classDef service2 fill:#fff9c4,stroke:#fbc02d,color:#f57f17
    classDef repository2 fill:#ffe0b2,stroke:#ef6c00,color:#e65100
    classDef entity2 fill:#d7ccc8,stroke:#6d4c41,color:#3e2723

    click Router "https://github.com/recruiting-your-club/ryc/blob/main/client/src/router.tsx"
    click MainPage "https://github.com/recruiting-your-club/ryc/blob/main/client/src/pages/MainPage/MainPage.tsx"
    click ClubDetailPage "https://github.com/recruiting-your-club/ryc/blob/main/client/src/pages/ClubDetailPage/ClubDetailPage.tsx"
    click ClubApplyPage "https://github.com/recruiting-your-club/ryc/blob/main/client/src/pages/ClubApplyPage/ClubApplyPage.tsx"
    click FileUpLoader "https://github.com/recruiting-your-club/ryc/blob/main/client/src/components/FileUpLoader/FileUpLoader.tsx"
    click ClubCard "https://github.com/recruiting-your-club/ryc/blob/main/client/src/components/ClubCard/ClubCard.tsx"

    click APIApp "https://github.com/recruiting-your-club/ryc/blob/main/server/src/main/java/com/ryc/api/ApiApplication.java"
    click ConfigSec "https://github.com/recruiting-your-club/ryc/blob/main/server/src/main/java/com/ryc/api/config/SecurityConfiguration.java"
    click ConfigWeb "https://github.com/recruiting-your-club/ryc/blob/main/server/src/main/java/com/ryc/api/config/WebConfig.java"
    click ConfigSwagger "https://github.com/recruiting-your-club/ryc/blob/main/server/src/main/java/com/ryc/api/config/SwaggerConfiguration.java"
    click AuthCtrl "https://github.com/recruiting-your-club/ryc/blob/main/server/src/main/java/com/ryc/api/v1/auth/controller/AuthController.java"
    click RefreshCtrl "https://github.com/recruiting-your-club/ryc/blob/main/server/src/main/java/com/ryc/api/v1/auth/controller/RefreshTokenController.java"
    click ApplicantCtrl "https://github.com/recruiting-your-club/ryc/blob/main/server/src/main/java/com/ryc/api/v1/applicant/controller/ApplicantController.java"
    click ClubCtrl "https://github.com/recruiting-your-club/ryc/blob/main/server/src/main/java/com/ryc/api/v1/club/controller/ClubController.java"
    click AuthSvc "https://github.com/recruiting-your-club/ryc/blob/main/server/src/main/java/com/ryc/api/v1/auth/service/AuthServiceImpl.java"
    click RefreshSvc "https://github.com/recruiting-your-club/ryc/blob/main/server/src/main/java/com/ryc/api/v1/auth/service/RefreshTokenServiceImpl.java"
    click ClubSvc "https://github.com/recruiting-your-club/ryc/blob/main/server/src/main/java/com/ryc/api/v1/club/service/ClubServiceImpl.java"
    click ClubRepo "https://github.com/recruiting-your-club/ryc/blob/main/server/src/main/java/com/ryc/api/v1/club/repository/ClubRepository.java"
    click ClubEntity "https://github.com/recruiting-your-club/ryc/blob/main/server/src/main/java/com/ryc/api/v1/club/domain/Club.java"
    click AOPAspect "https://github.com/recruiting-your-club/ryc/blob/main/server/src/main/java/com/ryc/api/v1/common/aop/aspect/ClubRoleAuthenticationAspect.java"
    click AOPAnnot "https://github.com/recruiting-your-club/ryc/blob/main/server/src/main/java/com/ryc/api/v1/common/aop/annotation/HasPresidentRoleSecured.java"
    click TokenMgr "https://github.com/recruiting-your-club/ryc/blob/main/server/src/main/java/com/ryc/api/v1/security/jwt/JwtTokenManager.java"
    click Filter "https://github.com/recruiting-your-club/ryc/blob/main/server/src/main/java/com/ryc/api/v1/security/filter/JwtAuthenticationFilter.java"
    click AnnouncementSvc "https://github.com/recruiting-your-club/ryc/blob/main/server/src/main/java/com/ryc/api/v2/announcement/service/AnnouncementService.java"
    click AnnouncementApi "https://github.com/recruiting-your-club/ryc/blob/main/server/src/main/java/com/ryc/api/v2/announcement/presentation/AnnouncementHttpApi.java"
    click AnnouncementEntity "https://github.com/recruiting-your-club/ryc/blob/main/server/src/main/java/com/ryc/api/v2/announcement/domain/Announcement.java"
    click AnnouncementRepo "https://github.com/recruiting-your-club/ryc/blob/main/server/src/main/java/com/ryc/api/v2/announcement/infra/AnnouncementRepositoryImpl.java"
    click AnnouncementSched "https://github.com/recruiting-your-club/ryc/blob/main/server/src/main/java/com/ryc/api/v2/announcement/infra/scheduler/AnnouncementStatusScheduler.java"
    click EmailStub "https://github.com/recruiting-your-club/ryc/tree/main/server/src/main/java/com/ryc/api/v2/email"
```
