How tonylimps/unifs-backend works
UniFS-Backend is a Spring Boot API for public-key challenge registration and login, JWT-authenticated user profile operations, and persistence of users and rooms. The main workflow runs from HTTP endpoints through services: registration/login issue and verify challenges, update or create user records, then return JWTs; later requests pass JWT security filtering before user operations. The README documents users, rooms, and their membership schema, but the tree shows no room-management service or controller. Relationships below are limited to indexed source references and documented schema; room workflow wiring is not evidenced.
Main entry points: RegisterService.java Registration service · LoginService.java Login service · UserMapper.java User mapper · BusinessException.java Business errors
Components 24
HTTP API
- Registration routes
src/main/java/org/tonylimps/unifs/controller/RegisterController.java - Login routes
src/main/java/org/tonylimps/unifs/controller/LoginController.java - User routes
src/main/java/org/tonylimps/unifs/controller/UserController.java - Auth request DTOs
src/main/java/org/tonylimps/unifs/model/dto/request - Auth response DTOs
src/main/java/org/tonylimps/unifs/model/dto/response - User DTOs
src/main/java/org/tonylimps/unifs/model/dto
Authentication
- Registration service
src/main/java/org/tonylimps/unifs/service/RegisterService.java - Login service
src/main/java/org/tonylimps/unifs/service/LoginService.java - Auth sessions
src/main/java/org/tonylimps/unifs/model/pojo/AuthSession.java - Challenge verification
src/main/java/org/tonylimps/unifs/util/PassKeyUtil.java - JWT utility
src/main/java/org/tonylimps/unifs/util/JwtUtil.java - JWT filter
src/main/java/org/tonylimps/unifs/config/JwtFilter.java - Security configuration
src/main/java/org/tonylimps/unifs/config/SecurityConfig.java
User operations
- User service
src/main/java/org/tonylimps/unifs/service/UserService.java
Persistence and policy
- User entity
src/main/java/org/tonylimps/unifs/model/entity/User.java - Room entity
src/main/java/org/tonylimps/unifs/model/entity/Room.java - Room membership
src/main/java/org/tonylimps/unifs/model/entity/UserRoom.java - User mapper
src/main/java/org/tonylimps/unifs/mapper/UserMapper.java - Room mapper
src/main/java/org/tonylimps/unifs/mapper/RoomMapper.java - Membership mapper
src/main/java/org/tonylimps/unifs/mapper/UserRoomMapper.java - Business errors
src/main/java/org/tonylimps/unifs/exception/BusinessException.java - Error handler
src/main/java/org/tonylimps/unifs/exception/GlobalExceptionHandler.java
Other components
- API client
- Relational database
Connections 29
- API client → Registration routes: submits registration
src/main/java/org/tonylimps/unifs/controller/RegisterController.java - API client → Login routes: submits login
src/main/java/org/tonylimps/unifs/controller/LoginController.java - API client → User routes: requests profile
- Registration routes → Registration service: calls
src/main/java/org/tonylimps/unifs/controller/RegisterController.java - Login routes → Login service: calls
src/main/java/org/tonylimps/unifs/controller/LoginController.java - User routes → User service: delegates to
src/main/java/org/tonylimps/unifs/controller/UserController.java - Registration service → Challenge verification: verifies challenge
src/main/java/org/tonylimps/unifs/service/RegisterService.java - Login service → Challenge verification: verifies challenge
src/main/java/org/tonylimps/unifs/service/LoginService.java - Registration service → Auth sessions: stores session
src/main/java/org/tonylimps/unifs/service/RegisterService.java - Login service → Auth sessions: stores session
src/main/java/org/tonylimps/unifs/service/LoginService.java - Registration service → JWT utility: issues token
src/main/java/org/tonylimps/unifs/service/RegisterService.java - Login service → JWT utility: issues token
src/main/java/org/tonylimps/unifs/service/LoginService.java - Registration service → User mapper: inserts user
src/main/java/org/tonylimps/unifs/service/RegisterService.java - Login service → User mapper: reads and updates
src/main/java/org/tonylimps/unifs/service/LoginService.java - User service → User mapper: reads and writes
src/main/java/org/tonylimps/unifs/service/UserService.java - Registration service → User entity: creates
src/main/java/org/tonylimps/unifs/service/RegisterService.java - Login service → User entity: uses
src/main/java/org/tonylimps/unifs/service/LoginService.java - User mapper → User entity: maps
src/main/java/org/tonylimps/unifs/mapper/UserMapper.java - JWT filter → JWT utility: validates token
src/main/java/org/tonylimps/unifs/config/JwtFilter.java - Security configuration → JWT filter: configures
src/main/java/org/tonylimps/unifs/config/SecurityConfig.java - User mapper → Relational database: persists users
README.md - Room mapper → Relational database: room persistence
README.md - Membership mapper → Relational database: membership persistence
README.md - Room mapper → Room entity: maps
src/main/java/org/tonylimps/unifs/mapper/RoomMapper.java - Membership mapper → Room membership: maps
src/main/java/org/tonylimps/unifs/mapper/UserRoomMapper.java - Registration service → Business errors: raises
src/main/java/org/tonylimps/unifs/service/RegisterService.java - Login service → Business errors: raises
src/main/java/org/tonylimps/unifs/service/LoginService.java - User service → Business errors: raises
src/main/java/org/tonylimps/unifs/service/UserService.java - Error handler → Business errors: handles
src/main/java/org/tonylimps/unifs/exception/GlobalExceptionHandler.java