How codetravelerlee/s-top-backend works
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: AuthService.java Social login & tokens · ProposalService.java Proposal services · UserService.java User accounts · FileService.java File management
Components 26
Identity & users
- Auth endpoints
src/main/java/com/scg/stop/auth/controller/AuthController.java - Social login & tokens
src/main/java/com/scg/stop/auth/service/AuthService.java - Kakao OAuth
src/main/java/com/scg/stop/auth/infrastructure/KakaoOAuthProvider.java - JWT handling
src/main/java/com/scg/stop/auth/JwtUtil.java - User accounts
src/main/java/com/scg/stop/user/service/UserService.java - User endpoints
src/main/java/com/scg/stop/user/controller/UserController.java - User persistence
src/main/java/com/scg/stop/user/repository/UserRepository.java
Projects & proposals
- Project endpoints
src/main/java/com/scg/stop/project/controller/ProjectController.java - Project services
src/main/java/com/scg/stop/project/service/ProjectService.java - Project persistence
src/main/java/com/scg/stop/project/repository/ProjectRepository.java - Project inquiries
src/main/java/com/scg/stop/project/service/InquiryService.java - Proposal endpoints
src/main/java/com/scg/stop/proposal/controller/ProposalController.java - Proposal services
src/main/java/com/scg/stop/proposal/service/ProposalService.java - Proposal persistence
src/main/java/com/scg/stop/proposal/repository/ProposalRepository.java
Events & content
- Event notices
src/main/java/com/scg/stop/event/service/EventNoticeService.java - Event endpoints
src/main/java/com/scg/stop/event/controller/EventNoticeController.java - Notices
src/main/java/com/scg/stop/notice/service/NoticeService.java - Gallery
src/main/java/com/scg/stop/gallery/service/GalleryService.java
Career learning
- Talks & interviews
src/main/java/com/scg/stop/video/service/TalkService.java - Quiz workflow
src/main/java/com/scg/stop/video/service/QuizService.java - Job information
src/main/java/com/scg/stop/jobInfo/service/JobInfoService.java - AI Hub integration
src/main/java/com/scg/stop/aihub/service/AiHubService.java
Shared services
- File management
src/main/java/com/scg/stop/file/service/FileService.java - MinIO storage
src/main/java/com/scg/stop/file/service/MinioClientService.java - Email service
src/main/java/com/scg/stop/global/infrastructure/EmailService.java
Other components
- Platform user
Connections 20
- Platform user → Auth endpoints: signs in
- Auth endpoints → Social login & tokens: delegates to
src/main/java/com/scg/stop/auth/controller/AuthController.java - Social login & tokens → Kakao OAuth: requests identity
src/main/java/com/scg/stop/auth/service/AuthService.java - Social login & tokens → JWT handling: creates tokens
src/main/java/com/scg/stop/auth/service/AuthService.java - Social login & tokens → User persistence: loads users
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
src/main/java/com/scg/stop/project/controller/ProjectController.java - Project services → Project persistence: queries projects
src/main/java/com/scg/stop/project/service/ProjectService.java - Platform user → Proposal endpoints: submits proposal
- Proposal endpoints → Proposal services: delegates to
src/main/java/com/scg/stop/proposal/controller/ProposalController.java - Proposal services → Proposal persistence: saves proposals
src/main/java/com/scg/stop/proposal/service/ProposalService.java - Proposal services → File management: loads attachments
src/main/java/com/scg/stop/proposal/service/ProposalService.java - Proposal services → Email service: sends email
src/main/java/com/scg/stop/proposal/service/ProposalService.java - Event endpoints → Event notices: delegates to
src/main/java/com/scg/stop/event/controller/EventNoticeController.java - Event notices → File management: loads attachments
src/main/java/com/scg/stop/event/service/EventNoticeService.java - Platform user → User endpoints: manages account
- User endpoints → User accounts: delegates to
src/main/java/com/scg/stop/user/controller/UserController.java - User accounts → User persistence: persists users
src/main/java/com/scg/stop/user/service/UserService.java - File management → MinIO storage: stores objects
src/main/java/com/scg/stop/file/service/FileService.java