# yash-2720/kinthrahub-backend architecture

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

- Interactive diagram: https://gitdiagram.com/yash-2720/kinthrahub-backend
- Repository: https://github.com/yash-2720/kinthrahub-backend

## Overview

CareBridge is a Spring Boot REST API for donation management. Users authenticate to receive a JWT, then use protected endpoints to manage donation requests and related records; donation services provide request handling and summary operations. The API also exposes employee and account administration, donation plans and transactions, payroll, hospitals, roles, and dashboard functionality. The tree and source index identify these subsystems, but implementation details for many are unsampled; those links are therefore omitted or marked unverified.

Main entry points: [`src/main/java/com/kinthrahub/backend/authentication/impl/AuthenticationServiceImpl.java`](https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/authentication/impl/AuthenticationServiceImpl.java) (Login Service), [`src/main/java/com/kinthrahub/backend/authentication/AuthenticationController.java`](https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/authentication/AuthenticationController.java) (Login API), [`src/main/java/com/kinthrahub/backend/security/CustomUserDetailsService.java`](https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/security/CustomUserDetailsService.java) (User Lookup), [`src/main/java/com/kinthrahub/backend/controller/DonationRequestController.java`](https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/controller/DonationRequestController.java) (Donation Request API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_auth["Authentication"]
  node_auth_controller["Login API"]
  node_auth_impl["Login Service"]
  node_user_details["User Lookup"]
  node_jwt["JWT Service<br/>[JwtService.java]"]
end

subgraph group_donations["Donation Management"]
  node_donation_api["Donation Request API"]
  node_donation_service["Request Handling"]
  node_donation_repo[("Request Store")]
  node_donation_model["Donation Records"]
  node_plan_api["Donation Plans"]
  node_transaction_api["Transactions"]
  node_transaction_service["Transaction Service"]
end

subgraph group_people["People and Access"]
  node_user_repo[("Account Store")]
  node_employee_api["Employee API"]
  node_employee_service["Employee Service"]
  node_employee_repo[("Employee Store")]
  node_user_api["Account API"]
  node_user_service["Account Service"]
end

subgraph group_operations["Business Operations"]
  node_payroll_api["Payroll Runs"]
  node_hospital_api["Hospitals"]
  node_role_api["Roles"]
  node_dashboard_api["Dashboard"]
end

node_client(("API Client"))

node_client -->|"submits login"| node_auth_controller
node_auth_controller -->|"calls login"| node_auth_impl
node_auth_impl -->|"creates token"| node_jwt
node_auth_impl -->|"uses principal"| node_user_details
node_user_details -->|"loads account"| node_user_repo
node_client -->|"manages donations"| node_donation_api
node_donation_api -->|"calls service"| node_donation_service
node_donation_service -->|"queries requests"| node_donation_repo
node_donation_repo -->|"persists records"| node_donation_model
node_client -.->|"accesses transactions"| node_transaction_api
node_transaction_api -->|"calls service"| node_transaction_service
node_client -.->|"manages plans"| node_plan_api
node_client -.->|"manages employees"| node_employee_api
node_employee_api -->|"calls service"| node_employee_service
node_employee_service -.->|"accesses records"| node_employee_repo
node_client -.->|"manages accounts"| node_user_api
node_user_api -->|"calls service"| node_user_service
node_client -.->|"manages payroll"| node_payroll_api
node_client -.->|"manages hospitals"| node_hospital_api
node_client -.->|"manages roles"| node_role_api
node_client -.->|"views dashboard"| node_dashboard_api

click node_auth_controller "https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/authentication/AuthenticationController.java"
click node_auth_impl "https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/authentication/impl/AuthenticationServiceImpl.java"
click node_user_details "https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/security/CustomUserDetailsService.java"
click node_jwt "https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/security/jwt/JwtService.java"
click node_user_repo "https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/repository/ApplicationUserRepository.java"
click node_donation_api "https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/controller/DonationRequestController.java"
click node_donation_service "https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/service/impl/DonationRequestServiceImpl.java"
click node_donation_repo "https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/repository/DonationRequestRepository.java"
click node_donation_model "https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/entity/DonationRequest.java"
click node_plan_api "https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/controller/DonationPlanController.java"
click node_transaction_api "https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/controller/DonationTransactionController.java"
click node_transaction_service "https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/service/DonationTransactionService.java"
click node_employee_api "https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/controller/EmployeeController.java"
click node_employee_service "https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/service/EmployeeService.java"
click node_employee_repo "https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/repository/EmployeeRepository.java"
click node_user_api "https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/controller/ApplicationUserController.java"
click node_user_service "https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/service/ApplicationUserService.java"
click node_payroll_api "https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/controller/PayrollRunController.java"
click node_hospital_api "https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/controller/HospitalController.java"
click node_role_api "https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/controller/RoleController.java"
click node_dashboard_api "https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/controller/DashboardController.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_auth_controller,node_auth_impl,node_user_details,node_jwt,node_client toneBlue
class node_donation_api,node_donation_service,node_donation_repo,node_donation_model,node_plan_api,node_transaction_api,node_transaction_service toneAmber
class node_user_repo,node_employee_api,node_employee_service,node_employee_repo,node_user_api,node_user_service toneMint
class node_payroll_api,node_hospital_api,node_role_api,node_dashboard_api toneRose
```

## Components

### Authentication

- [Login API](https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/authentication/AuthenticationController.java): `src/main/java/com/kinthrahub/backend/authentication/AuthenticationController.java`
- [Login Service](https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/authentication/impl/AuthenticationServiceImpl.java): `src/main/java/com/kinthrahub/backend/authentication/impl/AuthenticationServiceImpl.java`
- [User Lookup](https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/security/CustomUserDetailsService.java): `src/main/java/com/kinthrahub/backend/security/CustomUserDetailsService.java`
- [JWT Service](https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/security/jwt/JwtService.java): `src/main/java/com/kinthrahub/backend/security/jwt/JwtService.java`

### Donation Management

- [Donation Request API](https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/controller/DonationRequestController.java): `src/main/java/com/kinthrahub/backend/controller/DonationRequestController.java`
- [Request Handling](https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/service/impl/DonationRequestServiceImpl.java): `src/main/java/com/kinthrahub/backend/service/impl/DonationRequestServiceImpl.java`
- [Request Store](https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/repository/DonationRequestRepository.java): `src/main/java/com/kinthrahub/backend/repository/DonationRequestRepository.java`
- [Donation Records](https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/entity/DonationRequest.java): `src/main/java/com/kinthrahub/backend/entity/DonationRequest.java`
- [Donation Plans](https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/controller/DonationPlanController.java): `src/main/java/com/kinthrahub/backend/controller/DonationPlanController.java`
- [Transactions](https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/controller/DonationTransactionController.java): `src/main/java/com/kinthrahub/backend/controller/DonationTransactionController.java`
- [Transaction Service](https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/service/DonationTransactionService.java): `src/main/java/com/kinthrahub/backend/service/DonationTransactionService.java`

### People and Access

- [Account Store](https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/repository/ApplicationUserRepository.java): `src/main/java/com/kinthrahub/backend/repository/ApplicationUserRepository.java`
- [Employee API](https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/controller/EmployeeController.java): `src/main/java/com/kinthrahub/backend/controller/EmployeeController.java`
- [Employee Service](https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/service/EmployeeService.java): `src/main/java/com/kinthrahub/backend/service/EmployeeService.java`
- [Employee Store](https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/repository/EmployeeRepository.java): `src/main/java/com/kinthrahub/backend/repository/EmployeeRepository.java`
- [Account API](https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/controller/ApplicationUserController.java): `src/main/java/com/kinthrahub/backend/controller/ApplicationUserController.java`
- [Account Service](https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/service/ApplicationUserService.java): `src/main/java/com/kinthrahub/backend/service/ApplicationUserService.java`

### Business Operations

- [Payroll Runs](https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/controller/PayrollRunController.java): `src/main/java/com/kinthrahub/backend/controller/PayrollRunController.java`
- [Hospitals](https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/controller/HospitalController.java): `src/main/java/com/kinthrahub/backend/controller/HospitalController.java`
- [Roles](https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/controller/RoleController.java): `src/main/java/com/kinthrahub/backend/controller/RoleController.java`
- [Dashboard](https://github.com/yash-2720/kinthrahub-backend/blob/main/src/main/java/com/kinthrahub/backend/controller/DashboardController.java): `src/main/java/com/kinthrahub/backend/controller/DashboardController.java`

### Other components

- **API Client**

## Connections

- API Client → Login API: submits login (evidence: `src/main/java/com/kinthrahub/backend/authentication/AuthenticationController.java`)
- Login API → Login Service: calls login (evidence: `src/main/java/com/kinthrahub/backend/authentication/AuthenticationController.java`)
- Login Service → JWT Service: creates token (evidence: `src/main/java/com/kinthrahub/backend/authentication/impl/AuthenticationServiceImpl.java`)
- Login Service → User Lookup: uses principal (evidence: `src/main/java/com/kinthrahub/backend/authentication/impl/AuthenticationServiceImpl.java`)
- User Lookup → Account Store: loads account (evidence: `src/main/java/com/kinthrahub/backend/security/CustomUserDetailsService.java`)
- API Client → Donation Request API: manages donations (evidence: `README.md`)
- Donation Request API → Request Handling: calls service (evidence: `src/main/java/com/kinthrahub/backend/controller/DonationRequestController.java`)
- Request Handling → Request Store: queries requests (evidence: `src/main/java/com/kinthrahub/backend/service/impl/DonationRequestServiceImpl.java`)
- Request Store → Donation Records: persists records (evidence: `src/main/java/com/kinthrahub/backend/repository/DonationRequestRepository.java`)
- API Client → Transactions: accesses transactions
- Transactions → Transaction Service: calls service (evidence: `src/main/java/com/kinthrahub/backend/controller/DonationTransactionController.java`)
- API Client → Donation Plans: manages plans
- API Client → Employee API: manages employees
- Employee API → Employee Service: calls service (evidence: `src/main/java/com/kinthrahub/backend/controller/EmployeeController.java`)
- Employee Service → Employee Store: accesses records
- API Client → Account API: manages accounts
- Account API → Account Service: calls service (evidence: `src/main/java/com/kinthrahub/backend/controller/ApplicationUserController.java`)
- API Client → Payroll Runs: manages payroll
- API Client → Hospitals: manages hospitals
- API Client → Roles: manages roles
- API Client → Dashboard: views dashboard
