# pratikgholam/loan-application-api architecture

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

- Interactive diagram: https://gitdiagram.com/pratikgholam/loan-application-api
- Repository: https://github.com/pratikgholam/loan-application-api

## Overview

This is an ASP.NET Core REST API for applicants to register, create profiles, submit and track loan applications, and for loan officers/admins to review them and view status summaries. The main workflow runs from the application controller through the application service to loan-domain transitions and PostgreSQL persistence; status changes append audit history. Authentication and reporting are separate branches. Some links are grounded in README statements or the source index rather than complete excerpts, so those links are marked dashed when the runtime call is not directly shown.

Main entry points: [`src/LoanApplication.Api/Controllers/ApplicationsController.cs`](https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Controllers/ApplicationsController.cs) (Applications API), [`src/LoanApplication.Api/Controllers/AuthController.cs`](https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Controllers/AuthController.cs) (Authentication API), [`src/LoanApplication.Api/Services/ApplicationService.cs`](https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Services/ApplicationService.cs) (Application service), [`src/LoanApplication.Api/Services/ReportService.cs`](https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Services/ReportService.cs) (Status reporting)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API endpoints"]
  node_applications_api["Applications API"]
  node_auth_api["Authentication API<br/>[AuthController.cs]"]
  node_reports_api["Reports API"]
  node_api_contracts["API contracts<br/>[DTOs]"]
end

subgraph group_identity["Identity and access"]
  node_current_user["Current user"]
  node_user_entity["User and roles<br/>[User.cs]"]
  node_password_hasher["Password hashing<br/>[PasswordHasher.cs]"]
  node_token_service["JWT tokens<br/>[TokenService.cs]"]
end

subgraph group_loans["Loan lifecycle"]
  node_application_service["Application service"]
  node_loan_domain["Loan lifecycle<br/>[Loan.cs]"]
  node_audit_history["Status history<br/>[StatusHistory.cs]"]
  node_applicant_entity["Applicant profile<br/>[Applicant.cs]"]
end

subgraph group_persistence["Persistence and reporting"]
  node_db_context["EF Core context<br/>[AppDbContext.cs]"]
  node_postgres[("PostgreSQL")]
  node_report_service["Status reporting<br/>[ReportService.cs]"]
end

node_applicant(("Applicant"))
node_officer(("Loan officer"))

node_applicant -->|"registers or logs in"| node_auth_api
node_applicant -->|"submits and tracks"| node_applications_api
node_officer -->|"reviews applications"| node_applications_api
node_officer -->|"requests summaries"| node_reports_api
node_applications_api -->|"dispatches"| node_application_service
node_applications_api -->|"gets identity"| node_current_user
node_applications_api -->|"accepts and returns"| node_api_contracts
node_application_service -->|"reads and writes"| node_db_context
node_application_service -->|"creates and transitions"| node_loan_domain
node_application_service -->|"loads and creates"| node_applicant_entity
node_loan_domain -->|"appends transitions"| node_audit_history
node_db_context -.->|"persists data"| node_postgres
node_auth_api -->|"reads and writes users"| node_db_context
node_auth_api -.->|"hashes credentials"| node_password_hasher
node_auth_api -.->|"issues tokens"| node_token_service
node_user_entity -.->|"provides role identity"| node_current_user
node_reports_api -->|"requests summary"| node_report_service
node_report_service -.->|"queries aggregates"| node_postgres
node_report_service -.->|"returns summary DTO"| node_api_contracts

click node_applications_api "https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Controllers/ApplicationsController.cs"
click node_auth_api "https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Controllers/AuthController.cs"
click node_reports_api "https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Controllers/ReportsController.cs"
click node_application_service "https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Services/ApplicationService.cs"
click node_loan_domain "https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Entities/Loan.cs"
click node_audit_history "https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Entities/StatusHistory.cs"
click node_applicant_entity "https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Entities/Applicant.cs"
click node_api_contracts "https://github.com/pratikgholam/loan-application-api/tree/main/src/LoanApplication.Api/DTOs"
click node_current_user "https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Common/CurrentUserService.cs"
click node_user_entity "https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Entities/User.cs"
click node_password_hasher "https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Services/PasswordHasher.cs"
click node_token_service "https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Services/TokenService.cs"
click node_db_context "https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Data/AppDbContext.cs"
click node_report_service "https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Services/ReportService.cs"

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_applications_api,node_auth_api,node_reports_api,node_api_contracts toneBlue
class node_current_user,node_user_entity,node_password_hasher,node_token_service toneAmber
class node_application_service,node_loan_domain,node_audit_history,node_applicant_entity toneMint
class node_db_context,node_postgres,node_report_service toneRose
class node_applicant,node_officer toneIndigo
```

## Components

### API endpoints

- [Applications API](https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Controllers/ApplicationsController.cs): `src/LoanApplication.Api/Controllers/ApplicationsController.cs`
- [Authentication API](https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Controllers/AuthController.cs): `src/LoanApplication.Api/Controllers/AuthController.cs`
- [Reports API](https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Controllers/ReportsController.cs): `src/LoanApplication.Api/Controllers/ReportsController.cs`
- [API contracts](https://github.com/pratikgholam/loan-application-api/tree/main/src/LoanApplication.Api/DTOs): `src/LoanApplication.Api/DTOs`

### Identity and access

- [Current user](https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Common/CurrentUserService.cs): `src/LoanApplication.Api/Common/CurrentUserService.cs`
- [User and roles](https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Entities/User.cs): `src/LoanApplication.Api/Entities/User.cs`
- [Password hashing](https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Services/PasswordHasher.cs): `src/LoanApplication.Api/Services/PasswordHasher.cs`
- [JWT tokens](https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Services/TokenService.cs): `src/LoanApplication.Api/Services/TokenService.cs`

### Loan lifecycle

- [Application service](https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Services/ApplicationService.cs): `src/LoanApplication.Api/Services/ApplicationService.cs`
- [Loan lifecycle](https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Entities/Loan.cs): `src/LoanApplication.Api/Entities/Loan.cs`
- [Status history](https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Entities/StatusHistory.cs): `src/LoanApplication.Api/Entities/StatusHistory.cs`
- [Applicant profile](https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Entities/Applicant.cs): `src/LoanApplication.Api/Entities/Applicant.cs`

### Persistence and reporting

- [EF Core context](https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Data/AppDbContext.cs): `src/LoanApplication.Api/Data/AppDbContext.cs`
- **PostgreSQL**
- [Status reporting](https://github.com/pratikgholam/loan-application-api/blob/main/src/LoanApplication.Api/Services/ReportService.cs): `src/LoanApplication.Api/Services/ReportService.cs`

### Other components

- **Applicant**
- **Loan officer**

## Connections

- Applicant → Authentication API: registers or logs in (evidence: `README.md`)
- Applicant → Applications API: submits and tracks (evidence: `README.md`)
- Loan officer → Applications API: reviews applications (evidence: `README.md`)
- Loan officer → Reports API: requests summaries (evidence: `README.md`)
- Applications API → Application service: dispatches (evidence: `src/LoanApplication.Api/Controllers/ApplicationsController.cs`)
- Applications API → Current user: gets identity (evidence: `src/LoanApplication.Api/Controllers/ApplicationsController.cs`)
- Applications API → API contracts: accepts and returns (evidence: `src/LoanApplication.Api/Controllers/ApplicationsController.cs`)
- Application service → EF Core context: reads and writes (evidence: `src/LoanApplication.Api/Services/ApplicationService.cs`)
- Application service → Loan lifecycle: creates and transitions (evidence: `src/LoanApplication.Api/Services/ApplicationService.cs`)
- Application service → Applicant profile: loads and creates (evidence: `src/LoanApplication.Api/Services/ApplicationService.cs`)
- Loan lifecycle → Status history: appends transitions (evidence: `src/LoanApplication.Api/Entities/Loan.cs`)
- EF Core context → PostgreSQL: persists data (evidence: `README.md`)
- Authentication API → EF Core context: reads and writes users (evidence: `src/LoanApplication.Api/Controllers/AuthController.cs`)
- Authentication API → Password hashing: hashes credentials (evidence: `src/LoanApplication.Api/Controllers/AuthController.cs`)
- Authentication API → JWT tokens: issues tokens (evidence: `src/LoanApplication.Api/Controllers/AuthController.cs`)
- User and roles → Current user: provides role identity (evidence: `src/LoanApplication.Api/Common/CurrentUserService.cs`)
- Reports API → Status reporting: requests summary (evidence: `src/LoanApplication.Api/Controllers/ReportsController.cs`)
- Status reporting → PostgreSQL: queries aggregates (evidence: `README.md`)
- Status reporting → API contracts: returns summary DTO (evidence: `src/LoanApplication.Api/Services/ReportService.cs`)
