How apptivedev/fin-be works
Y-FIN is a Spring backend for youth-oriented finance discovery and planning. The principal workflow takes a user's product criteria, resolves eligibility and personalization, ranks eligible product options, and returns recommendations with matching details. Related capabilities cover OAuth2/JWT access, profiles and terms, favorites, policy calendars, and savings calculators. The graph reflects README-described API capabilities and the source references shown in the index; several domain implementations were not excerpted, so their internal links are intentionally limited.
Main entry points: SearchService.java Recommendation search · AuthService.java Token lifecycle · OAuth2UserService.java OAuth2 login · AuthController.java Auth endpoints
Components 20
Identity & Profile
- OAuth2 login
src/main/java/apptive/fin/auth/oauth/OAuth2UserService.java - Auth endpoints
src/main/java/apptive/fin/auth/controller/AuthController.java - Token lifecycle
src/main/java/apptive/fin/auth/service/AuthService.java - Refresh tokens
src/main/java/apptive/fin/auth/repository/RefreshTokenRepository.java - User accounts
src/main/java/apptive/fin/user/entity/User.java - User profile
src/main/java/apptive/fin/user/service/UserProfileService.java - Terms & consent
src/main/java/apptive/fin/term/service/TermService.java
Product Discovery
- Search endpoints
src/main/java/apptive/fin/search/controller/SearchController.java - Recommendation search
src/main/java/apptive/fin/search/service/SearchService.java - Eligibility filtering
src/main/java/apptive/fin/search/service/EligibilityFilterService.java - Match scoring
src/main/java/apptive/fin/search/service/MatchScoreService.java - Rate & return estimates
src/main/java/apptive/fin/search/service/RateCalculatorService.java - Financial products
src/main/java/apptive/fin/search/entity/Product.java
Planning Tools
- Policy calendar
src/main/java/apptive/fin/calendar/service/CalendarService.java - Savings calculator
src/main/java/apptive/fin/calculator/service/CalculatorService.java
Catalog & Favorites
- Categories
src/main/java/apptive/fin/category/service/CategoryService.java - Favorites
src/main/java/apptive/fin/myfin/service/MyFinService.java - Favorite records
src/main/java/apptive/fin/myfin/repository/MyFinRepository.java - Providers
src/main/java/apptive/fin/provider/service/ProviderService.java
Other components
- Finance client
Connections 19
- Finance client → OAuth2 login: starts login
- Finance client → Auth endpoints: manages tokens
- OAuth2 login → User accounts: resolves account
src/main/java/apptive/fin/auth/oauth/OAuth2UserService.java - Auth endpoints → Token lifecycle: handles auth
src/main/java/apptive/fin/auth/controller/AuthController.java - Token lifecycle → Refresh tokens: rotates tokens
src/main/java/apptive/fin/auth/service/AuthService.java - Token lifecycle → Terms & consent: checks consent
src/main/java/apptive/fin/auth/service/AuthService.java - Finance client → User profile: manages profile
- Finance client → Terms & consent: records consent
- Finance client → Categories: requests categories
- Finance client → Search endpoints: submits criteria
- Search endpoints → Recommendation search: dispatches search
src/main/java/apptive/fin/search/controller/SearchController.java - Recommendation search → Eligibility filtering: filters options
src/main/java/apptive/fin/search/service/SearchService.java - Recommendation search → Match scoring: scores matches
src/main/java/apptive/fin/search/service/SearchService.java - Recommendation search → Rate & return estimates: calculates returns
src/main/java/apptive/fin/search/service/SearchService.java - Recommendation search → Financial products: reads products
- Finance client → Favorites: manages favorites
- Favorites → Favorite records: stores favorites
src/main/java/apptive/fin/myfin/service/MyFinService.java - Finance client → Policy calendar: views schedules
- Finance client → Savings calculator: calculates savings