# codetravelerlee/s-top-backend architecture

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

- Interactive diagram: https://gitdiagram.com/codetravelerlee/s-top-backend
- Repository: https://github.com/codetravelerlee/s-top-backend

## Overview

S-TOP is a Spring backend for a student-oriented community and career platform. Its apparent workflows cover social sign-in and registration, project discovery and interaction, proposals and inquiries, event announcements, and learning content such as interviews, talks, and quizzes. Services connect these domains to persistence, files, email, and external OAuth. The README identifies the backend and its REST documentation but gives no feature-level workflow; several controller-to-service links below are therefore marked unverified, and unsampled subsystems are represented at their known source paths.

Main entry points: [`src/main/java/com/scg/stop/auth/service/AuthService.java`](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/auth/service/AuthService.java) (Social login & tokens), [`src/main/java/com/scg/stop/proposal/service/ProposalService.java`](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/proposal/service/ProposalService.java) (Proposal services), [`src/main/java/com/scg/stop/user/service/UserService.java`](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/user/service/UserService.java) (User accounts), [`src/main/java/com/scg/stop/file/service/FileService.java`](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/file/service/FileService.java) (File management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity &amp; users"]
  node_auth_api["Auth endpoints"]
  node_auth["Social login &amp; tokens<br/>[AuthService.java]"]
  node_kakao["Kakao OAuth"]
  node_jwt["JWT handling<br/>[JwtUtil.java]"]
  node_users["User accounts<br/>[UserService.java]"]
  node_user_api["User endpoints"]
  node_user_store[("User persistence")]
end

subgraph group_community["Projects &amp; proposals"]
  node_projects_api["Project endpoints"]
  node_projects["Project services"]
  node_project_store[("Project persistence")]
  node_inquiries["Project inquiries"]
  node_proposals_api["Proposal endpoints"]
  node_proposals["Proposal services"]
  node_proposal_store[("Proposal persistence")]
end

subgraph group_content["Events &amp; content"]
  node_events["Event notices"]
  node_event_api["Event endpoints"]
  node_notices["Notices<br/>[NoticeService.java]"]
  node_gallery["Gallery"]
end

subgraph group_learning["Career learning"]
  node_videos["Talks &amp; interviews<br/>[TalkService.java]"]
  node_quiz["Quiz workflow<br/>[QuizService.java]"]
  node_jobinfo["Job information"]
  node_aihub["AI Hub integration<br/>[AiHubService.java]"]
end

subgraph group_shared["Shared services"]
  node_files["File management<br/>[FileService.java]"]
  node_object_store["MinIO storage"]
  node_email["Email service<br/>[EmailService.java]"]
end

node_visitor(("Platform user"))

node_visitor -.->|"signs in"| node_auth_api
node_auth_api -.->|"delegates to"| node_auth
node_auth -->|"requests identity"| node_kakao
node_auth -->|"creates tokens"| node_jwt
node_auth -->|"loads users"| node_user_store
node_auth -.->|"registers accounts"| node_users
node_visitor -.->|"browses projects"| node_projects_api
node_projects_api -.->|"delegates to"| node_projects
node_projects -->|"queries projects"| node_project_store
node_visitor -.->|"submits proposal"| node_proposals_api
node_proposals_api -.->|"delegates to"| node_proposals
node_proposals -->|"saves proposals"| node_proposal_store
node_proposals -->|"loads attachments"| node_files
node_proposals -->|"sends email"| node_email
node_event_api -.->|"delegates to"| node_events
node_events -->|"loads attachments"| node_files
node_visitor -.->|"manages account"| node_user_api
node_user_api -.->|"delegates to"| node_users
node_users -.->|"persists users"| node_user_store
node_files -.->|"stores objects"| node_object_store

click node_auth_api "https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/auth/controller/AuthController.java"
click node_auth "https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/auth/service/AuthService.java"
click node_kakao "https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/auth/infrastructure/KakaoOAuthProvider.java"
click node_jwt "https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/auth/JwtUtil.java"
click node_users "https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/user/service/UserService.java"
click node_user_api "https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/user/controller/UserController.java"
click node_user_store "https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/user/repository/UserRepository.java"
click node_projects_api "https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/project/controller/ProjectController.java"
click node_projects "https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/project/service/ProjectService.java"
click node_project_store "https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/project/repository/ProjectRepository.java"
click node_inquiries "https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/project/service/InquiryService.java"
click node_proposals_api "https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/proposal/controller/ProposalController.java"
click node_proposals "https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/proposal/service/ProposalService.java"
click node_proposal_store "https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/proposal/repository/ProposalRepository.java"
click node_events "https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/event/service/EventNoticeService.java"
click node_event_api "https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/event/controller/EventNoticeController.java"
click node_notices "https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/notice/service/NoticeService.java"
click node_gallery "https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/gallery/service/GalleryService.java"
click node_videos "https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/video/service/TalkService.java"
click node_quiz "https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/video/service/QuizService.java"
click node_jobinfo "https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/jobInfo/service/JobInfoService.java"
click node_aihub "https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/aihub/service/AiHubService.java"
click node_files "https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/file/service/FileService.java"
click node_object_store "https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/file/service/MinioClientService.java"
click node_email "https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/global/infrastructure/EmailService.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_auth,node_kakao,node_jwt,node_users,node_user_api,node_user_store,node_visitor toneBlue
class node_projects_api,node_projects,node_project_store,node_inquiries,node_proposals_api,node_proposals,node_proposal_store toneAmber
class node_events,node_event_api,node_notices,node_gallery toneMint
class node_videos,node_quiz,node_jobinfo,node_aihub toneRose
class node_files,node_object_store,node_email toneIndigo
```

## Components

### Identity & users

- [Auth endpoints](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/auth/controller/AuthController.java): `src/main/java/com/scg/stop/auth/controller/AuthController.java`
- [Social login & tokens](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/auth/service/AuthService.java): `src/main/java/com/scg/stop/auth/service/AuthService.java`
- [Kakao OAuth](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/auth/infrastructure/KakaoOAuthProvider.java): `src/main/java/com/scg/stop/auth/infrastructure/KakaoOAuthProvider.java`
- [JWT handling](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/auth/JwtUtil.java): `src/main/java/com/scg/stop/auth/JwtUtil.java`
- [User accounts](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/user/service/UserService.java): `src/main/java/com/scg/stop/user/service/UserService.java`
- [User endpoints](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/user/controller/UserController.java): `src/main/java/com/scg/stop/user/controller/UserController.java`
- [User persistence](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/user/repository/UserRepository.java): `src/main/java/com/scg/stop/user/repository/UserRepository.java`

### Projects & proposals

- [Project endpoints](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/project/controller/ProjectController.java): `src/main/java/com/scg/stop/project/controller/ProjectController.java`
- [Project services](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/project/service/ProjectService.java): `src/main/java/com/scg/stop/project/service/ProjectService.java`
- [Project persistence](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/project/repository/ProjectRepository.java): `src/main/java/com/scg/stop/project/repository/ProjectRepository.java`
- [Project inquiries](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/project/service/InquiryService.java): `src/main/java/com/scg/stop/project/service/InquiryService.java`
- [Proposal endpoints](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/proposal/controller/ProposalController.java): `src/main/java/com/scg/stop/proposal/controller/ProposalController.java`
- [Proposal services](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/proposal/service/ProposalService.java): `src/main/java/com/scg/stop/proposal/service/ProposalService.java`
- [Proposal persistence](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/proposal/repository/ProposalRepository.java): `src/main/java/com/scg/stop/proposal/repository/ProposalRepository.java`

### Events & content

- [Event notices](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/event/service/EventNoticeService.java): `src/main/java/com/scg/stop/event/service/EventNoticeService.java`
- [Event endpoints](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/event/controller/EventNoticeController.java): `src/main/java/com/scg/stop/event/controller/EventNoticeController.java`
- [Notices](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/notice/service/NoticeService.java): `src/main/java/com/scg/stop/notice/service/NoticeService.java`
- [Gallery](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/gallery/service/GalleryService.java): `src/main/java/com/scg/stop/gallery/service/GalleryService.java`

### Career learning

- [Talks & interviews](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/video/service/TalkService.java): `src/main/java/com/scg/stop/video/service/TalkService.java`
- [Quiz workflow](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/video/service/QuizService.java): `src/main/java/com/scg/stop/video/service/QuizService.java`
- [Job information](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/jobInfo/service/JobInfoService.java): `src/main/java/com/scg/stop/jobInfo/service/JobInfoService.java`
- [AI Hub integration](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/aihub/service/AiHubService.java): `src/main/java/com/scg/stop/aihub/service/AiHubService.java`

### Shared services

- [File management](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/file/service/FileService.java): `src/main/java/com/scg/stop/file/service/FileService.java`
- [MinIO storage](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/file/service/MinioClientService.java): `src/main/java/com/scg/stop/file/service/MinioClientService.java`
- [Email service](https://github.com/codetravelerlee/s-top-backend/blob/develop/src/main/java/com/scg/stop/global/infrastructure/EmailService.java): `src/main/java/com/scg/stop/global/infrastructure/EmailService.java`

### Other components

- **Platform user**

## Connections

- Platform user → Auth endpoints: signs in
- Auth endpoints → Social login & tokens: delegates to (evidence: `src/main/java/com/scg/stop/auth/controller/AuthController.java`)
- Social login & tokens → Kakao OAuth: requests identity (evidence: `src/main/java/com/scg/stop/auth/service/AuthService.java`)
- Social login & tokens → JWT handling: creates tokens (evidence: `src/main/java/com/scg/stop/auth/service/AuthService.java`)
- Social login & tokens → User persistence: loads users (evidence: `src/main/java/com/scg/stop/auth/service/AuthService.java`)
- Social login & tokens → User accounts: registers accounts
- Platform user → Project endpoints: browses projects
- Project endpoints → Project services: delegates to (evidence: `src/main/java/com/scg/stop/project/controller/ProjectController.java`)
- Project services → Project persistence: queries projects (evidence: `src/main/java/com/scg/stop/project/service/ProjectService.java`)
- Platform user → Proposal endpoints: submits proposal
- Proposal endpoints → Proposal services: delegates to (evidence: `src/main/java/com/scg/stop/proposal/controller/ProposalController.java`)
- Proposal services → Proposal persistence: saves proposals (evidence: `src/main/java/com/scg/stop/proposal/service/ProposalService.java`)
- Proposal services → File management: loads attachments (evidence: `src/main/java/com/scg/stop/proposal/service/ProposalService.java`)
- Proposal services → Email service: sends email (evidence: `src/main/java/com/scg/stop/proposal/service/ProposalService.java`)
- Event endpoints → Event notices: delegates to (evidence: `src/main/java/com/scg/stop/event/controller/EventNoticeController.java`)
- Event notices → File management: loads attachments (evidence: `src/main/java/com/scg/stop/event/service/EventNoticeService.java`)
- Platform user → User endpoints: manages account
- User endpoints → User accounts: delegates to (evidence: `src/main/java/com/scg/stop/user/controller/UserController.java`)
- User accounts → User persistence: persists users (evidence: `src/main/java/com/scg/stop/user/service/UserService.java`)
- File management → MinIO storage: stores objects (evidence: `src/main/java/com/scg/stop/file/service/FileService.java`)
