How khu-hackhu/hackhu-hp works
HacKHU-HP is a club website with a React frontend and Spring API. The visible backend workflow covers account signup and session-based authentication, plus gallery uploads that are confirmed into albums and then queried for public display. The graph includes the frontend gallery surface and shared security/storage layers. The README also names a board feature, but no board source is present in this file tree; several auth, security, and integration links are therefore omitted where the excerpts do not establish their callers.
Main entry points: AlbumCommandService.java Album creation · LoginService.java Login service · TokenRefreshService.java Token refresh · UploadConfirmService.java Upload confirmation
Components 25
Web frontend
- React app
frontend/src/App.tsx - Gallery screens
frontend/src/features/gallery/GalleryPage.tsx - Gallery API client
frontend/src/features/gallery/api.ts
Accounts and sessions
- Auth endpoints
backend/src/main/java/com/hackhu/hp/domain/auth/controller/AuthController.java - Login service
backend/src/main/java/com/hackhu/hp/domain/auth/service/LoginService.java - Token refresh
backend/src/main/java/com/hackhu/hp/domain/auth/service/TokenRefreshService.java - Session issuer
backend/src/main/java/com/hackhu/hp/domain/auth/service - Session repositories
backend/src/main/java/com/hackhu/hp/domain/auth/repository - Signup endpoint
backend/src/main/java/com/hackhu/hp/domain/user/controller/SignupController.java - Signup service
backend/src/main/java/com/hackhu/hp/domain/user/service/SignupService.java - User repository
backend/src/main/java/com/hackhu/hp/domain/user/repository/UserRepository.java
Gallery
- Upload URL issuance
backend/src/main/java/com/hackhu/hp/domain/gallery/service/GalleryUploadService.java - Album creation
backend/src/main/java/com/hackhu/hp/domain/gallery/service/AlbumCommandService.java - Album queries
backend/src/main/java/com/hackhu/hp/domain/gallery/service/AlbumQueryService.java - Album repository
backend/src/main/java/com/hackhu/hp/domain/gallery/repository/AlbumRepository.java - Photo repository
backend/src/main/java/com/hackhu/hp/domain/gallery/repository/PhotoRepository.java - Photo URL resolver
backend/src/main/java/com/hackhu/hp/domain/gallery/service/PhotoUrlResolver.java
Shared platform
- Upload confirmation
backend/src/main/java/com/hackhu/hp/global/storage/UploadConfirmService.java - Upload records
backend/src/main/java/com/hackhu/hp/global/storage/UploadRecordRepository.java - Presigned URLs
backend/src/main/java/com/hackhu/hp/global/storage/PresignedUrlService.java - S3 object store
backend/src/main/java/com/hackhu/hp/global/storage/S3ObjectStore.java - Request security
backend/src/main/java/com/hackhu/hp/global/security/SecurityConfig.java - Access tokens
backend/src/main/java/com/hackhu/hp/global/auth/AccessTokenService.java
Other components
- Browser
- CloudFront CDN
Connections 25
- Browser → React app: opens
README.md - React app → Gallery screens: renders
frontend/src/App.tsx - Auth endpoints → Login service: calls
backend/src/main/java/com/hackhu/hp/domain/auth/controller/AuthController.java - Auth endpoints → Token refresh: calls
backend/src/main/java/com/hackhu/hp/domain/auth/controller/AuthController.java - Login service → User repository: reads
backend/src/main/java/com/hackhu/hp/domain/auth/service/LoginService.java - Login service → Session repositories: uses
backend/src/main/java/com/hackhu/hp/domain/auth/service/LoginService.java - Login service → Session issuer: starts session
backend/src/main/java/com/hackhu/hp/domain/auth/service/LoginService.java - Token refresh → Session repositories: reads and updates
backend/src/main/java/com/hackhu/hp/domain/auth/service/TokenRefreshService.java - Token refresh → User repository: reads
backend/src/main/java/com/hackhu/hp/domain/auth/service/TokenRefreshService.java - Token refresh → Session issuer: rotates tokens
backend/src/main/java/com/hackhu/hp/domain/auth/service/TokenRefreshService.java - Signup service → User repository: saves user
backend/src/main/java/com/hackhu/hp/domain/user/service/SignupService.java - Upload URL issuance → Presigned URLs: requests URLs
backend/src/main/java/com/hackhu/hp/domain/gallery/service/GalleryUploadService.java - Upload URL issuance → Upload records: saves records
backend/src/main/java/com/hackhu/hp/domain/gallery/service/GalleryUploadService.java - Upload URL issuance → Upload confirmation: hands off confirmation
- Presigned URLs → S3 object store: authorizes upload
- Album creation → Upload confirmation: confirms images
backend/src/main/java/com/hackhu/hp/domain/gallery/service/AlbumCommandService.java - Album creation → Album repository: saves album
backend/src/main/java/com/hackhu/hp/domain/gallery/service/AlbumCommandService.java - Album creation → Photo repository: saves photos
backend/src/main/java/com/hackhu/hp/domain/gallery/service/AlbumCommandService.java - Album creation → Photo URL resolver: resolves photo URLs
backend/src/main/java/com/hackhu/hp/domain/gallery/service/AlbumCommandService.java - Album queries → Album repository: queries albums
backend/src/main/java/com/hackhu/hp/domain/gallery/service/AlbumQueryService.java - Album queries → Photo repository: queries photos
backend/src/main/java/com/hackhu/hp/domain/gallery/service/AlbumQueryService.java - Album queries → Photo URL resolver: resolves photo URLs
backend/src/main/java/com/hackhu/hp/domain/gallery/service/AlbumQueryService.java - Photo URL resolver → CloudFront CDN: resolves through
- Upload confirmation → Upload records: claims records
backend/src/main/java/com/hackhu/hp/global/storage/UploadConfirmService.java - Upload confirmation → S3 object store: checks and cleans
backend/src/main/java/com/hackhu/hp/global/storage/UploadConfirmService.java