How ortolanph/plm-back works
Personal Loan Manager is a Spring backend for tracking lenders, loan transactions, repayments, settlements, and history. Its main workflow is API request → service logic → repositories, with responses assembled for the client; settlement moves transaction details into history. Separate branches expose debt summaries, reports, and generated-code operations. The source index and excerpts establish the main service and persistence relationships; unsampled controllers and service details are represented only where the index documents their dependencies.
Main entry points: LenderService.java Lender management · TransactionService.java Transactions and history · TransactionHistoryRepository.java History repository · ReportService.java Report generation
Components 19
HTTP API
- Lender endpoints
src/main/java/pt/pauloortolan/plm_back/controller/LenderController.java - Transaction endpoints
src/main/java/pt/pauloortolan/plm_back/controller/TransactionController.java - Debt endpoint
src/main/java/pt/pauloortolan/plm_back/controller/DebtController.java - Report endpoints
src/main/java/pt/pauloortolan/plm_back/controller/ReportController.java - Code endpoints
src/main/java/pt/pauloortolan/plm_back/controller/CodeController.java - API data contracts
src/main/java/pt/pauloortolan/plm_back/dto
Loan Domain
- Lender management
src/main/java/pt/pauloortolan/plm_back/service/LenderService.java - Transactions and history
src/main/java/pt/pauloortolan/plm_back/service/TransactionService.java - Lender mapping
src/main/java/pt/pauloortolan/plm_back/mapper/LenderMapper.java - Transaction mapping
src/main/java/pt/pauloortolan/plm_back/mapper/TransactionMapper.java - Domain entities and types
src/main/java/pt/pauloortolan/plm_back/model
Persistence
- Lender repository
src/main/java/pt/pauloortolan/plm_back/repository/LenderRepository.java - Transaction repository
src/main/java/pt/pauloortolan/plm_back/repository/TransactionRepository.java - History repository
src/main/java/pt/pauloortolan/plm_back/repository/TransactionHistoryRepository.java - Generated-code repository
src/main/java/pt/pauloortolan/plm_back/repository/GeneratedCodeRepository.java
Reports And Codes
- Code generation
src/main/java/pt/pauloortolan/plm_back/service/CodeService.java - Report generation
src/main/java/pt/pauloortolan/plm_back/service/ReportService.java - History retention
src/main/java/pt/pauloortolan/plm_back/service/HistoryPurgeService.java
Other components
- API client
Connections 28
- API client → Lender endpoints: calls
src/main/java/pt/pauloortolan/plm_back/controller/LenderController.java - API client → Transaction endpoints: calls
src/main/java/pt/pauloortolan/plm_back/controller/TransactionController.java - API client → Debt endpoint: calls
src/main/java/pt/pauloortolan/plm_back/controller/DebtController.java - API client → Report endpoints: calls
src/main/java/pt/pauloortolan/plm_back/controller/ReportController.java - API client → Code endpoints: calls
src/main/java/pt/pauloortolan/plm_back/controller/CodeController.java - Lender endpoints → Lender management: delegates to
src/main/java/pt/pauloortolan/plm_back/controller/LenderController.java - Lender endpoints → Transactions and history: delegates history queries
src/main/java/pt/pauloortolan/plm_back/controller/LenderController.java - Transaction endpoints → Transactions and history: delegates to
src/main/java/pt/pauloortolan/plm_back/controller/TransactionController.java - Debt endpoint → Lender management: requests debts
src/main/java/pt/pauloortolan/plm_back/controller/DebtController.java - Report endpoints → Report generation: delegates to
src/main/java/pt/pauloortolan/plm_back/controller/ReportController.java - Code endpoints → Code generation: delegates to
src/main/java/pt/pauloortolan/plm_back/controller/CodeController.java - Lender management → Lender repository: reads and writes
src/main/java/pt/pauloortolan/plm_back/service/LenderService.java - Lender management → Transaction repository: reads and deletes
src/main/java/pt/pauloortolan/plm_back/service/LenderService.java - Lender management → History repository: records settlements
src/main/java/pt/pauloortolan/plm_back/service/LenderService.java - Lender management → Lender mapping: maps lender data
src/main/java/pt/pauloortolan/plm_back/service/LenderService.java - Transactions and history → Lender repository: loads lender
src/main/java/pt/pauloortolan/plm_back/service/TransactionService.java - Transactions and history → Transaction repository: reads and writes
src/main/java/pt/pauloortolan/plm_back/service/TransactionService.java - Transactions and history → History repository: queries history
src/main/java/pt/pauloortolan/plm_back/service/TransactionService.java - Transactions and history → Transaction mapping: maps transactions
src/main/java/pt/pauloortolan/plm_back/service/TransactionService.java - Lender repository → Domain entities and types: persists lender
src/main/java/pt/pauloortolan/plm_back/repository/LenderRepository.java - Transaction repository → Domain entities and types: persists transactions
src/main/java/pt/pauloortolan/plm_back/repository/TransactionRepository.java - History repository → Domain entities and types: persists history
src/main/java/pt/pauloortolan/plm_back/repository/TransactionHistoryRepository.java - Code generation → Generated-code repository: stores generated codes
src/main/java/pt/pauloortolan/plm_back/service/CodeService.java - Generated-code repository → Domain entities and types: persists code records
src/main/java/pt/pauloortolan/plm_back/repository/GeneratedCodeRepository.java - Report generation → Lender repository: reads lenders
src/main/java/pt/pauloortolan/plm_back/service/ReportService.java - Report generation → Transaction repository: reads transactions
src/main/java/pt/pauloortolan/plm_back/service/ReportService.java - Report generation → History repository: reads history
src/main/java/pt/pauloortolan/plm_back/service/ReportService.java - History retention → History repository: purges old records
src/main/java/pt/pauloortolan/plm_back/service/HistoryPurgeService.java