# abhii-2010/sadagati-microfinance-backup architecture

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

- Interactive diagram: https://gitdiagram.com/abhii-2010/sadagati-microfinance-backup
- Repository: https://github.com/abhii-2010/sadagati-microfinance-backup

## Overview

Sadagati is a microfinance operations application: staff sign in, manage borrowers and loan applications, review and disburse loans, record collections, and monitor accounting and audit information. The React client presents role-oriented workflows and centralizes session and application state; its API client connects to an Express backend whose routes dispatch to domain controllers and services. The backend persists through Prisma, with Redis supporting session operations. The README is only a Vite template, so product capabilities are inferred from the source tree and sampled references; unsampled domain links are omitted or marked unverified.

Main entry points: [`src/App.jsx`](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/src/App.jsx) (App shell), [`backend/src/app.ts`](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/app.ts) (Express application), [`backend/src/middleware/authMiddleware.ts`](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/middleware/authMiddleware.ts) (Authorization middleware), [`backend/src/controllers/authController.ts`](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/controllers/authController.ts) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Operations Client"]
  node_app["App shell<br/>[App.jsx]"]
  node_session["Session and state"]
  node_api_client["API client<br/>[apiClient.js]"]
end

subgraph group_loan["Lending Operations"]
  node_loanui["Loan workflows"]
  node_fieldui["Field operations"]
  node_calc["Loan calculations"]
  node_holiday["Holiday scheduling<br/>[holidayEngine.js]"]
end

subgraph group_admin["Administration"]
  node_accountui["Accounting views<br/>[AccountingView.jsx]"]
  node_adminui["Admin views"]
  node_migrationui["Data migration"]
  node_accountctl["Accounting controller"]
  node_userctl["User controller<br/>[userController.ts]"]
end

subgraph group_api["API and Security"]
  node_server["Express application<br/>[app.ts]"]
  node_authroutes["Authentication routes<br/>[authRoutes.ts]"]
  node_authctl["Authentication<br/>[authController.ts]"]
  node_authmw["Authorization middleware<br/>[authMiddleware.ts]"]
  node_loanroutes["Lending routes"]
  node_paymentroutes["Payment routes<br/>[paymentRoutes.ts]"]
  node_account_routes["Accounting routes"]
  node_user_routes["User routes<br/>[userRoutes.ts]"]
end

subgraph group_data["Persistence and Services"]
  node_accountsvc["Accounting service"]
  node_payment_service["Payment service<br/>[paymentService.ts]"]
  node_loan_services["Loan services"]
  node_dbconfig["Database client<br/>[database.ts]"]
  node_database[("PostgreSQL")]
  node_redis[("Redis sessions<br/>[redis.ts]")]
  node_crypto["Token and password crypto<br/>[cryptoService.ts]"]
  node_audit["Audit service<br/>[auditService.ts]"]
end

node_staff(("Staff user"))

node_staff -->|"uses"| node_app
node_app -->|"loads state"| node_session
node_app -->|"renders"| node_loanui
node_app -->|"renders"| node_fieldui
node_app -.->|"renders"| node_accountui
node_app -.->|"renders"| node_adminui
node_app -->|"renders"| node_migrationui
node_session -->|"calls"| node_api_client
node_session -->|"uses"| node_calc
node_calc -->|"uses"| node_holiday
node_api_client -.->|"HTTP requests"| node_server
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_loanroutes
node_server -->|"mounts"| node_paymentroutes
node_server -->|"mounts"| node_account_routes
node_server -->|"mounts"| node_user_routes
node_authroutes -->|"dispatches"| node_authctl
node_authroutes -->|"guards"| node_authmw
node_paymentroutes -->|"guards"| node_authmw
node_account_routes -->|"guards"| node_authmw
node_account_routes -->|"dispatches"| node_accountctl
node_user_routes -->|"dispatches"| node_userctl
node_accountctl -->|"calls"| node_accountsvc
node_userctl -->|"queries"| node_dbconfig
node_userctl -->|"hashes passwords"| node_crypto
node_userctl -->|"records changes"| node_audit
node_authctl -->|"queries"| node_dbconfig
node_authctl -->|"verifies credentials"| node_crypto
node_authctl -->|"revokes tokens"| node_redis
node_authctl -->|"records events"| node_audit
node_authmw -->|"verifies tokens"| node_crypto
node_authmw -->|"checks revocation"| node_redis
node_authmw -->|"loads user"| node_dbconfig
node_accountsvc -->|"queries"| node_dbconfig
node_accountsvc -->|"records events"| node_audit
node_dbconfig -->|"connects"| node_database

click node_app "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/src/App.jsx"
click node_session "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/src/context/DashboardContext.jsx"
click node_loanui "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/src/components/views/LoanApplicationsView.jsx"
click node_fieldui "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/src/components/views/FieldVisitsView.jsx"
click node_accountui "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/src/components/views/AccountingView.jsx"
click node_adminui "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/src/components/views/UserManagementView.jsx"
click node_migrationui "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/src/components/views/DataMigrationView.jsx"
click node_calc "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/src/services/loanCalculationService.js"
click node_holiday "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/src/services/holidayEngine.js"
click node_api_client "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/src/services/apiClient.js"
click node_server "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/app.ts"
click node_authroutes "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/routes/authRoutes.ts"
click node_authctl "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/controllers/authController.ts"
click node_authmw "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/middleware/authMiddleware.ts"
click node_loanroutes "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/routes/loanApplicationRoutes.ts"
click node_paymentroutes "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/routes/paymentRoutes.ts"
click node_account_routes "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/routes/accountingRoutes.ts"
click node_user_routes "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/routes/userRoutes.ts"
click node_accountctl "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/controllers/accountingController.ts"
click node_userctl "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/controllers/userController.ts"
click node_accountsvc "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/services/accountingService.ts"
click node_payment_service "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/services/paymentService.ts"
click node_loan_services "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/services/loanApplicationService.ts"
click node_dbconfig "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/config/database.ts"
click node_redis "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/config/redis.ts"
click node_crypto "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/services/cryptoService.ts"
click node_audit "https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/services/auditService.ts"

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_app,node_session,node_api_client,node_staff toneBlue
class node_loanui,node_fieldui,node_calc,node_holiday toneAmber
class node_accountui,node_adminui,node_migrationui,node_accountctl,node_userctl toneMint
class node_server,node_authroutes,node_authctl,node_authmw,node_loanroutes,node_paymentroutes,node_account_routes,node_user_routes toneRose
class node_accountsvc,node_payment_service,node_loan_services,node_dbconfig,node_database,node_redis,node_crypto,node_audit toneIndigo
```

## Components

### Operations Client

- [App shell](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/src/App.jsx): `src/App.jsx`
- [Session and state](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/src/context/DashboardContext.jsx): `src/context/DashboardContext.jsx`
- [API client](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/src/services/apiClient.js): `src/services/apiClient.js`

### Lending Operations

- [Loan workflows](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/src/components/views/LoanApplicationsView.jsx): `src/components/views/LoanApplicationsView.jsx`
- [Field operations](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/src/components/views/FieldVisitsView.jsx): `src/components/views/FieldVisitsView.jsx`
- [Loan calculations](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/src/services/loanCalculationService.js): `src/services/loanCalculationService.js`
- [Holiday scheduling](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/src/services/holidayEngine.js): `src/services/holidayEngine.js`

### Administration

- [Accounting views](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/src/components/views/AccountingView.jsx): `src/components/views/AccountingView.jsx`
- [Admin views](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/src/components/views/UserManagementView.jsx): `src/components/views/UserManagementView.jsx`
- [Data migration](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/src/components/views/DataMigrationView.jsx): `src/components/views/DataMigrationView.jsx`
- [Accounting controller](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/controllers/accountingController.ts): `backend/src/controllers/accountingController.ts`
- [User controller](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/controllers/userController.ts): `backend/src/controllers/userController.ts`

### API and Security

- [Express application](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/app.ts): `backend/src/app.ts`
- [Authentication routes](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/routes/authRoutes.ts): `backend/src/routes/authRoutes.ts`
- [Authentication](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/controllers/authController.ts): `backend/src/controllers/authController.ts`
- [Authorization middleware](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/middleware/authMiddleware.ts): `backend/src/middleware/authMiddleware.ts`
- [Lending routes](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/routes/loanApplicationRoutes.ts): `backend/src/routes/loanApplicationRoutes.ts`
- [Payment routes](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/routes/paymentRoutes.ts): `backend/src/routes/paymentRoutes.ts`
- [Accounting routes](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/routes/accountingRoutes.ts): `backend/src/routes/accountingRoutes.ts`
- [User routes](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/routes/userRoutes.ts): `backend/src/routes/userRoutes.ts`

### Persistence and Services

- [Accounting service](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/services/accountingService.ts): `backend/src/services/accountingService.ts`
- [Payment service](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/services/paymentService.ts): `backend/src/services/paymentService.ts`
- [Loan services](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/services/loanApplicationService.ts): `backend/src/services/loanApplicationService.ts`
- [Database client](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/config/database.ts): `backend/src/config/database.ts`
- **PostgreSQL**
- [Redis sessions](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/config/redis.ts): `backend/src/config/redis.ts`
- [Token and password crypto](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/services/cryptoService.ts): `backend/src/services/cryptoService.ts`
- [Audit service](https://github.com/abhii-2010/sadagati-microfinance-backup/blob/main/backend/src/services/auditService.ts): `backend/src/services/auditService.ts`

### Other components

- **Staff user**

## Connections

- Staff user → App shell: uses
- App shell → Session and state: loads state (evidence: `src/App.jsx`)
- App shell → Loan workflows: renders (evidence: `src/App.jsx`)
- App shell → Field operations: renders (evidence: `src/App.jsx`)
- App shell → Accounting views: renders (evidence: `src/App.jsx`)
- App shell → Admin views: renders (evidence: `src/App.jsx`)
- App shell → Data migration: renders (evidence: `src/App.jsx`)
- Session and state → API client: calls (evidence: `src/context/DashboardContext.jsx`)
- Session and state → Loan calculations: uses (evidence: `src/context/DashboardContext.jsx`)
- Loan calculations → Holiday scheduling: uses (evidence: `src/services/loanCalculationService.js`)
- API client → Express application: HTTP requests
- Express application → Authentication routes: mounts (evidence: `backend/src/app.ts`)
- Express application → Lending routes: mounts (evidence: `backend/src/app.ts`)
- Express application → Payment routes: mounts (evidence: `backend/src/app.ts`)
- Express application → Accounting routes: mounts (evidence: `backend/src/app.ts`)
- Express application → User routes: mounts (evidence: `backend/src/app.ts`)
- Authentication routes → Authentication: dispatches (evidence: `backend/src/routes/authRoutes.ts`)
- Authentication routes → Authorization middleware: guards (evidence: `backend/src/routes/authRoutes.ts`)
- Payment routes → Authorization middleware: guards (evidence: `backend/src/routes/paymentRoutes.ts`)
- Accounting routes → Authorization middleware: guards (evidence: `backend/src/routes/accountingRoutes.ts`)
- Accounting routes → Accounting controller: dispatches (evidence: `backend/src/routes/accountingRoutes.ts`)
- User routes → User controller: dispatches (evidence: `backend/src/routes/userRoutes.ts`)
- Accounting controller → Accounting service: calls (evidence: `backend/src/controllers/accountingController.ts`)
- User controller → Database client: queries (evidence: `backend/src/controllers/userController.ts`)
- User controller → Token and password crypto: hashes passwords (evidence: `backend/src/controllers/userController.ts`)
- User controller → Audit service: records changes (evidence: `backend/src/controllers/userController.ts`)
- Authentication → Database client: queries (evidence: `backend/src/controllers/authController.ts`)
- Authentication → Token and password crypto: verifies credentials (evidence: `backend/src/controllers/authController.ts`)
- Authentication → Redis sessions: revokes tokens (evidence: `backend/src/controllers/authController.ts`)
- Authentication → Audit service: records events (evidence: `backend/src/controllers/authController.ts`)
- Authorization middleware → Token and password crypto: verifies tokens (evidence: `backend/src/middleware/authMiddleware.ts`)
- Authorization middleware → Redis sessions: checks revocation (evidence: `backend/src/middleware/authMiddleware.ts`)
- Authorization middleware → Database client: loads user (evidence: `backend/src/middleware/authMiddleware.ts`)
- Accounting service → Database client: queries (evidence: `backend/src/services/accountingService.ts`)
- Accounting service → Audit service: records events (evidence: `backend/src/services/accountingService.ts`)
- Database client → PostgreSQL: connects (evidence: `backend/src/config/database.ts`)
