# ortolanph/plm-back architecture

> Architecture diagram of the GitHub repository ortolanph/plm-back, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ortolanph/plm-back
- Repository: https://github.com/ortolanph/plm-back

## Overview

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: [`src/main/java/pt/pauloortolan/plm_back/service/LenderService.java`](https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/service/LenderService.java) (Lender management), [`src/main/java/pt/pauloortolan/plm_back/service/TransactionService.java`](https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/service/TransactionService.java) (Transactions and history), [`src/main/java/pt/pauloortolan/plm_back/repository/TransactionHistoryRepository.java`](https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/repository/TransactionHistoryRepository.java) (History repository), [`src/main/java/pt/pauloortolan/plm_back/service/ReportService.java`](https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/service/ReportService.java) (Report generation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_lender_api["Lender endpoints"]
  node_transaction_api["Transaction endpoints"]
  node_debt_api["Debt endpoint"]
  node_report_api["Report endpoints"]
  node_code_api["Code endpoints"]
  node_dtos["API data contracts"]
end

subgraph group_domain["Loan Domain"]
  node_lender_service["Lender management<br/>[LenderService.java]"]
  node_transaction_service["Transactions and history"]
  node_lender_mapper["Lender mapping<br/>[LenderMapper.java]"]
  node_transaction_mapper["Transaction mapping"]
  node_models["Domain entities and types"]
end

subgraph group_persistence["Persistence"]
  node_lender_repo["Lender repository"]
  node_transaction_repo["Transaction repository"]
  node_history_repo["History repository"]
  node_code_repo["Generated-code repository"]
end

subgraph group_features["Reports And Codes"]
  node_code_service["Code generation<br/>[CodeService.java]"]
  node_report_service["Report generation<br/>[ReportService.java]"]
  node_purge_service["History retention"]
end

node_client(("API client"))

node_client -->|"calls"| node_lender_api
node_client -->|"calls"| node_transaction_api
node_client -->|"calls"| node_debt_api
node_client -->|"calls"| node_report_api
node_client -->|"calls"| node_code_api
node_lender_api -->|"delegates to"| node_lender_service
node_lender_api -->|"delegates history queries"| node_transaction_service
node_transaction_api -->|"delegates to"| node_transaction_service
node_debt_api -->|"requests debts"| node_lender_service
node_report_api -->|"delegates to"| node_report_service
node_code_api -->|"delegates to"| node_code_service
node_lender_service -->|"reads and writes"| node_lender_repo
node_lender_service -->|"reads and deletes"| node_transaction_repo
node_lender_service -->|"records settlements"| node_history_repo
node_lender_service -->|"maps lender data"| node_lender_mapper
node_transaction_service -->|"loads lender"| node_lender_repo
node_transaction_service -->|"reads and writes"| node_transaction_repo
node_transaction_service -->|"queries history"| node_history_repo
node_transaction_service -->|"maps transactions"| node_transaction_mapper
node_lender_repo -->|"persists lender"| node_models
node_transaction_repo -->|"persists transactions"| node_models
node_history_repo -->|"persists history"| node_models
node_code_service -->|"stores generated codes"| node_code_repo
node_code_repo -->|"persists code records"| node_models
node_report_service -->|"reads lenders"| node_lender_repo
node_report_service -->|"reads transactions"| node_transaction_repo
node_report_service -->|"reads history"| node_history_repo
node_purge_service -->|"purges old records"| node_history_repo

click node_lender_api "https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/controller/LenderController.java"
click node_transaction_api "https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/controller/TransactionController.java"
click node_debt_api "https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/controller/DebtController.java"
click node_report_api "https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/controller/ReportController.java"
click node_code_api "https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/controller/CodeController.java"
click node_lender_service "https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/service/LenderService.java"
click node_transaction_service "https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/service/TransactionService.java"
click node_lender_mapper "https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/mapper/LenderMapper.java"
click node_transaction_mapper "https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/mapper/TransactionMapper.java"
click node_models "https://github.com/ortolanph/plm-back/tree/master/src/main/java/pt/pauloortolan/plm_back/model"
click node_dtos "https://github.com/ortolanph/plm-back/tree/master/src/main/java/pt/pauloortolan/plm_back/dto"
click node_lender_repo "https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/repository/LenderRepository.java"
click node_transaction_repo "https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/repository/TransactionRepository.java"
click node_history_repo "https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/repository/TransactionHistoryRepository.java"
click node_code_service "https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/service/CodeService.java"
click node_code_repo "https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/repository/GeneratedCodeRepository.java"
click node_report_service "https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/service/ReportService.java"
click node_purge_service "https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/service/HistoryPurgeService.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_lender_api,node_transaction_api,node_debt_api,node_report_api,node_code_api,node_dtos,node_client toneBlue
class node_lender_service,node_transaction_service,node_lender_mapper,node_transaction_mapper,node_models toneAmber
class node_lender_repo,node_transaction_repo,node_history_repo,node_code_repo toneMint
class node_code_service,node_report_service,node_purge_service toneRose
```

## Components

### HTTP API

- [Lender endpoints](https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/controller/LenderController.java): `src/main/java/pt/pauloortolan/plm_back/controller/LenderController.java`
- [Transaction endpoints](https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/controller/TransactionController.java): `src/main/java/pt/pauloortolan/plm_back/controller/TransactionController.java`
- [Debt endpoint](https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/controller/DebtController.java): `src/main/java/pt/pauloortolan/plm_back/controller/DebtController.java`
- [Report endpoints](https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/controller/ReportController.java): `src/main/java/pt/pauloortolan/plm_back/controller/ReportController.java`
- [Code endpoints](https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/controller/CodeController.java): `src/main/java/pt/pauloortolan/plm_back/controller/CodeController.java`
- [API data contracts](https://github.com/ortolanph/plm-back/tree/master/src/main/java/pt/pauloortolan/plm_back/dto): `src/main/java/pt/pauloortolan/plm_back/dto`

### Loan Domain

- [Lender management](https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/service/LenderService.java): `src/main/java/pt/pauloortolan/plm_back/service/LenderService.java`
- [Transactions and history](https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/service/TransactionService.java): `src/main/java/pt/pauloortolan/plm_back/service/TransactionService.java`
- [Lender mapping](https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/mapper/LenderMapper.java): `src/main/java/pt/pauloortolan/plm_back/mapper/LenderMapper.java`
- [Transaction mapping](https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/mapper/TransactionMapper.java): `src/main/java/pt/pauloortolan/plm_back/mapper/TransactionMapper.java`
- [Domain entities and types](https://github.com/ortolanph/plm-back/tree/master/src/main/java/pt/pauloortolan/plm_back/model): `src/main/java/pt/pauloortolan/plm_back/model`

### Persistence

- [Lender repository](https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/repository/LenderRepository.java): `src/main/java/pt/pauloortolan/plm_back/repository/LenderRepository.java`
- [Transaction repository](https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/repository/TransactionRepository.java): `src/main/java/pt/pauloortolan/plm_back/repository/TransactionRepository.java`
- [History repository](https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/repository/TransactionHistoryRepository.java): `src/main/java/pt/pauloortolan/plm_back/repository/TransactionHistoryRepository.java`
- [Generated-code repository](https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/repository/GeneratedCodeRepository.java): `src/main/java/pt/pauloortolan/plm_back/repository/GeneratedCodeRepository.java`

### Reports And Codes

- [Code generation](https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/service/CodeService.java): `src/main/java/pt/pauloortolan/plm_back/service/CodeService.java`
- [Report generation](https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/service/ReportService.java): `src/main/java/pt/pauloortolan/plm_back/service/ReportService.java`
- [History retention](https://github.com/ortolanph/plm-back/blob/master/src/main/java/pt/pauloortolan/plm_back/service/HistoryPurgeService.java): `src/main/java/pt/pauloortolan/plm_back/service/HistoryPurgeService.java`

### Other components

- **API client**

## Connections

- API client → Lender endpoints: calls (evidence: `src/main/java/pt/pauloortolan/plm_back/controller/LenderController.java`)
- API client → Transaction endpoints: calls (evidence: `src/main/java/pt/pauloortolan/plm_back/controller/TransactionController.java`)
- API client → Debt endpoint: calls (evidence: `src/main/java/pt/pauloortolan/plm_back/controller/DebtController.java`)
- API client → Report endpoints: calls (evidence: `src/main/java/pt/pauloortolan/plm_back/controller/ReportController.java`)
- API client → Code endpoints: calls (evidence: `src/main/java/pt/pauloortolan/plm_back/controller/CodeController.java`)
- Lender endpoints → Lender management: delegates to (evidence: `src/main/java/pt/pauloortolan/plm_back/controller/LenderController.java`)
- Lender endpoints → Transactions and history: delegates history queries (evidence: `src/main/java/pt/pauloortolan/plm_back/controller/LenderController.java`)
- Transaction endpoints → Transactions and history: delegates to (evidence: `src/main/java/pt/pauloortolan/plm_back/controller/TransactionController.java`)
- Debt endpoint → Lender management: requests debts (evidence: `src/main/java/pt/pauloortolan/plm_back/controller/DebtController.java`)
- Report endpoints → Report generation: delegates to (evidence: `src/main/java/pt/pauloortolan/plm_back/controller/ReportController.java`)
- Code endpoints → Code generation: delegates to (evidence: `src/main/java/pt/pauloortolan/plm_back/controller/CodeController.java`)
- Lender management → Lender repository: reads and writes (evidence: `src/main/java/pt/pauloortolan/plm_back/service/LenderService.java`)
- Lender management → Transaction repository: reads and deletes (evidence: `src/main/java/pt/pauloortolan/plm_back/service/LenderService.java`)
- Lender management → History repository: records settlements (evidence: `src/main/java/pt/pauloortolan/plm_back/service/LenderService.java`)
- Lender management → Lender mapping: maps lender data (evidence: `src/main/java/pt/pauloortolan/plm_back/service/LenderService.java`)
- Transactions and history → Lender repository: loads lender (evidence: `src/main/java/pt/pauloortolan/plm_back/service/TransactionService.java`)
- Transactions and history → Transaction repository: reads and writes (evidence: `src/main/java/pt/pauloortolan/plm_back/service/TransactionService.java`)
- Transactions and history → History repository: queries history (evidence: `src/main/java/pt/pauloortolan/plm_back/service/TransactionService.java`)
- Transactions and history → Transaction mapping: maps transactions (evidence: `src/main/java/pt/pauloortolan/plm_back/service/TransactionService.java`)
- Lender repository → Domain entities and types: persists lender (evidence: `src/main/java/pt/pauloortolan/plm_back/repository/LenderRepository.java`)
- Transaction repository → Domain entities and types: persists transactions (evidence: `src/main/java/pt/pauloortolan/plm_back/repository/TransactionRepository.java`)
- History repository → Domain entities and types: persists history (evidence: `src/main/java/pt/pauloortolan/plm_back/repository/TransactionHistoryRepository.java`)
- Code generation → Generated-code repository: stores generated codes (evidence: `src/main/java/pt/pauloortolan/plm_back/service/CodeService.java`)
- Generated-code repository → Domain entities and types: persists code records (evidence: `src/main/java/pt/pauloortolan/plm_back/repository/GeneratedCodeRepository.java`)
- Report generation → Lender repository: reads lenders (evidence: `src/main/java/pt/pauloortolan/plm_back/service/ReportService.java`)
- Report generation → Transaction repository: reads transactions (evidence: `src/main/java/pt/pauloortolan/plm_back/service/ReportService.java`)
- Report generation → History repository: reads history (evidence: `src/main/java/pt/pauloortolan/plm_back/service/ReportService.java`)
- History retention → History repository: purges old records (evidence: `src/main/java/pt/pauloortolan/plm_back/service/HistoryPurgeService.java`)
