How min-thant794/usermanagementsystem works
This Spring Boot REST API serves a React account workspace and administrator workspace. Its main flow is registration or sign-in (including Google), then verified, session-based JWT access to profile, password, photo, and session operations; administrators can manage users and inspect audit activity. Services coordinate PostgreSQL-backed repositories, cache behavior, email, and Cloudinary. The README also documents rate limiting, Redis caching, and scheduled token cleanup; those branches are shown at directory-level paths because their source was not sampled. Edges use only excerpted calls or explicit README relationships.
Main entry points: AuthService.java Signup & login · UserService.java Profile & passwords · UsermanagementsystemApplication.java Spring REST API · EmailVerificationService.java Email verification
Components 30
Identity & sessions
- Auth endpoints
src/main/java/com/minthanttun/usermanagementsystem/auth/AuthController.java - Signup & login
src/main/java/com/minthanttun/usermanagementsystem/auth/AuthService.java - Email verification
src/main/java/com/minthanttun/usermanagementsystem/auth/EmailVerificationService.java - Email delivery
src/main/java/com/minthanttun/usermanagementsystem/auth/EmailService.java - Refresh sessions
src/main/java/com/minthanttun/usermanagementsystem/security/jwt/TokenIssuer.java - Token hashing
src/main/java/com/minthanttun/usermanagementsystem/security/jwt/TokenHasher.java - Google sign-in
src/main/java/com/minthanttun/usermanagementsystem/security/oauth2/CustomOidcUserService.java - Session endpoints
src/main/java/com/minthanttun/usermanagementsystem/auth/SessionService.java - Session metadata
src/main/java/com/minthanttun/usermanagementsystem/security/session/GeoLocationService.java
Account management
- Profile endpoints
src/main/java/com/minthanttun/usermanagementsystem/user/UserController.java - Profile & passwords
src/main/java/com/minthanttun/usermanagementsystem/user/UserService.java - Profile photos
src/main/java/com/minthanttun/usermanagementsystem/user/ProfileImageService.java
Administration & audit
- Admin endpoints
src/main/java/com/minthanttun/usermanagementsystem/admin/AdminUserController.java - User administration
src/main/java/com/minthanttun/usermanagementsystem/admin/AdminUserService.java - Audit endpoints
src/main/java/com/minthanttun/usermanagementsystem/admin/AdminAuditLogController.java - Audit recording
src/main/java/com/minthanttun/usermanagementsystem/audit/AuditService.java
Security & infrastructure
- Spring REST API
src/main/java/com/minthanttun/usermanagementsystem/UsermanagementsystemApplication.java - User persistence
src/main/java/com/minthanttun/usermanagementsystem/user/UserRepository.java - User account model
src/main/java/com/minthanttun/usermanagementsystem/user/User.java - Refresh-token store
src/main/java/com/minthanttun/usermanagementsystem/auth/RefreshTokenRepository.java - Audit log store
src/main/java/com/minthanttun/usermanagementsystem/audit/AuditLogRepository.java - JWT & request security
src/main/java/com/minthanttun/usermanagementsystem/config/SecurityConfig.java - Rate limiting
src/main/java/com/minthanttun/usermanagementsystem/security/ratelimit/RateLimitFilter.java - Redis caching
src/main/java/com/minthanttun/usermanagementsystem/config/RedisCacheConfig.java - Token cleanup
src/main/java/com/minthanttun/usermanagementsystem/common/TokenCleanupJob.java
Other components
- Browser client
- SMTP provider
- Cloudinary
- PostgreSQL
- Redis / Valkey
Connections 30
- Browser client → Spring REST API: sends requests
- Spring REST API → PostgreSQL: persists data
- Spring REST API → Redis / Valkey: uses cache
- Spring REST API → SMTP provider: sends mail
- Spring REST API → Cloudinary: stores photos
- Auth endpoints → Signup & login: delegates auth
- Signup & login → User persistence: reads and saves
src/main/java/com/minthanttun/usermanagementsystem/auth/AuthService.java - Signup & login → Email verification: starts verification
src/main/java/com/minthanttun/usermanagementsystem/auth/AuthService.java - Signup & login → Token hashing: hashes tokens
src/main/java/com/minthanttun/usermanagementsystem/auth/AuthService.java - Signup & login → Refresh sessions: issues sessions
src/main/java/com/minthanttun/usermanagementsystem/auth/AuthService.java - Signup & login → Refresh-token store: rotates tokens
src/main/java/com/minthanttun/usermanagementsystem/auth/AuthService.java - Email verification → Email delivery: sends verification
src/main/java/com/minthanttun/usermanagementsystem/auth/EmailVerificationService.java - Email verification → User persistence: updates account
src/main/java/com/minthanttun/usermanagementsystem/auth/EmailVerificationService.java - Google sign-in → User persistence: loads identity
src/main/java/com/minthanttun/usermanagementsystem/security/oauth2/CustomOidcUserService.java - Session endpoints → Refresh-token store: reads and revokes
src/main/java/com/minthanttun/usermanagementsystem/auth/SessionService.java - Session endpoints → Token hashing: hashes current token
src/main/java/com/minthanttun/usermanagementsystem/auth/SessionService.java - Session endpoints → Session metadata: describes location
src/main/java/com/minthanttun/usermanagementsystem/auth/SessionService.java - Profile endpoints → Profile & passwords: delegates profile
src/main/java/com/minthanttun/usermanagementsystem/user/UserController.java - Profile & passwords → User persistence: reads and saves
src/main/java/com/minthanttun/usermanagementsystem/user/UserService.java - Profile & passwords → Profile photos: uploads or deletes
src/main/java/com/minthanttun/usermanagementsystem/user/UserService.java - Profile & passwords → Email verification: requests verification
src/main/java/com/minthanttun/usermanagementsystem/user/UserService.java - Profile & passwords → Refresh-token store: revokes sessions
- Admin endpoints → User administration: delegates admin work
src/main/java/com/minthanttun/usermanagementsystem/admin/AdminUserController.java - User administration → User persistence: searches and updates
src/main/java/com/minthanttun/usermanagementsystem/admin/AdminUserService.java - User administration → Audit recording: records changes
src/main/java/com/minthanttun/usermanagementsystem/admin/AdminUserService.java - User administration → Email verification: requests verification
src/main/java/com/minthanttun/usermanagementsystem/admin/AdminUserService.java - Audit endpoints → Audit recording: queries audit
- Audit recording → Audit log store: stores audit logs
src/main/java/com/minthanttun/usermanagementsystem/audit/AuditService.java - JWT & request security → Rate limiting: applies filters
- Token cleanup → Refresh-token store: cleans expired tokens