# sellamuthu2007/digibank architecture

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

- Interactive diagram: https://gitdiagram.com/sellamuthu2007/digibank
- Repository: https://github.com/sellamuthu2007/digibank

## Overview

DigiBank is a certificate lifecycle platform for students, issuing institutions, and organizational verifiers. Its principal workflow is a student requesting a certificate, an institution issuing it, the student approving it, then sharing or presenting it for verification. The sampled backend implements these operations through Express routes and MongoDB models; blockchain and IPFS are documented capabilities, but the sampled controller generates mock hashes rather than integrating with those services. Frontend-to-API links and several unsampled screens are shown only where documented; uncertain links are dashed.

Main entry points: [`frontend/src/pages/Student_page/Student_dashboard.jsx`](https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/pages/Student_page/Student_dashboard.jsx) (Student dashboard), [`backend/routes/CertificateRoutes.js`](https://github.com/sellamuthu2007/digibank/blob/main/backend/routes/CertificateRoutes.js) (Certificate routes), [`frontend/src/App.jsx`](https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/App.jsx) (Route application), [`frontend/src/pages/Institution_page/InstitutionDashboardEnhanced.jsx`](https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/pages/Institution_page/InstitutionDashboardEnhanced.jsx) (Issuer dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_app["Route application<br/>[App.jsx]"]
  node_student_dashboard["Student dashboard"]
  node_student_wallet["Certificate wallet"]
  node_student_certs["My certificates<br/>[MyCertificates.jsx]"]
  node_student_request["Request certificate"]
  node_student_requests["Request tracking<br/>[MyRequests.jsx]"]
  node_student_share["Share certificate"]
  node_institution_dashboard["Issuer dashboard"]
  node_pending_requests["Pending requests"]
  node_issued_certs["Issued certificates"]
  node_organization_dashboard["Verifier dashboard"]
  node_verify_view["Certificate lookup"]
  node_verify_page["Public verification"]
  node_auth_ui["Role registration and login"]
end

subgraph group_identity["Identity and access"]
  node_auth_routes["Identity routes<br/>[AuthRoutes.js]"]
  node_auth_controller["Identity controller<br/>[AuthController.js]"]
  node_identity_models[("Account and OTP models")]
end

subgraph group_lifecycle["Certificate lifecycle"]
  node_api["Express API<br/>[index.js]"]
  node_cert_routes["Certificate routes"]
  node_cert_controller["Certificate operations"]
  node_certificate_store[("Certificate records<br/>[Certificate.js]")]
  node_request_store[("Certificate requests")]
end

subgraph group_integrations["External services"]
  node_mongo[("MongoDB")]
  node_ipfs[("IPFS storage")]
  node_chain{{"Polygon blockchain"}}
end

node_student(("Student"))
node_institution(("Institution"))
node_verifier(("Verifier"))

node_app -->|"routes to"| node_student_dashboard
node_app -->|"routes to"| node_institution_dashboard
node_app -->|"routes to"| node_organization_dashboard
node_app -->|"routes to"| node_verify_page
node_student_dashboard -->|"renders"| node_student_wallet
node_student_dashboard -->|"renders"| node_student_certs
node_student_dashboard -->|"renders"| node_student_request
node_student_dashboard -->|"renders"| node_student_requests
node_student_dashboard -->|"renders"| node_student_share
node_institution_dashboard -->|"renders"| node_pending_requests
node_institution_dashboard -->|"renders"| node_issued_certs
node_student -.->|"uses"| node_student_dashboard
node_institution -.->|"uses"| node_institution_dashboard
node_verifier -.->|"uses"| node_organization_dashboard
node_auth_ui -.->|"submits to"| node_auth_routes
node_student_request -.->|"requests via"| node_cert_routes
node_pending_requests -.->|"handles via"| node_cert_routes
node_issued_certs -.->|"uses"| node_cert_routes
node_verify_page -.->|"verifies via"| node_cert_routes
node_api -->|"mounts"| node_auth_routes
node_api -->|"mounts"| node_cert_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_cert_routes -->|"dispatches"| node_cert_controller
node_auth_controller -->|"reads and writes"| node_identity_models
node_cert_controller -->|"reads and writes"| node_certificate_store
node_cert_controller -->|"reads and writes"| node_request_store
node_api -.->|"connects"| node_mongo
node_certificate_store -.->|"stores files"| node_ipfs
node_certificate_store -.->|"records proof"| node_chain

click node_app "https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/App.jsx"
click node_student_dashboard "https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/pages/Student_page/Student_dashboard.jsx"
click node_student_wallet "https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/components/student/StudentWallet_View.jsx"
click node_student_certs "https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/components/student/MyCertificates.jsx"
click node_student_request "https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/components/student/RequestCertificate.jsx"
click node_student_requests "https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/components/student/MyRequests.jsx"
click node_student_share "https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/components/student/ShareCertificate.jsx"
click node_institution_dashboard "https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/pages/Institution_page/InstitutionDashboardEnhanced.jsx"
click node_pending_requests "https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/components/institution/PendingRequests.jsx"
click node_issued_certs "https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/components/institution/IssuedCertificates.jsx"
click node_organization_dashboard "https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/pages/Organization_page/OrganizationDashboardEnhanced.jsx"
click node_verify_view "https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/components/organization/VerifyCertificate.jsx"
click node_verify_page "https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/pages/VerifyCertificatePage.jsx"
click node_auth_ui "https://github.com/sellamuthu2007/digibank/tree/main/frontend/src/auth"
click node_api "https://github.com/sellamuthu2007/digibank/blob/main/backend/index.js"
click node_auth_routes "https://github.com/sellamuthu2007/digibank/blob/main/backend/routes/AuthRoutes.js"
click node_auth_controller "https://github.com/sellamuthu2007/digibank/blob/main/backend/controllers/AuthController.js"
click node_identity_models "https://github.com/sellamuthu2007/digibank/tree/main/backend/models"
click node_cert_routes "https://github.com/sellamuthu2007/digibank/blob/main/backend/routes/CertificateRoutes.js"
click node_cert_controller "https://github.com/sellamuthu2007/digibank/blob/main/backend/controllers/CertificateController.js"
click node_certificate_store "https://github.com/sellamuthu2007/digibank/blob/main/backend/models/Certificate.js"
click node_request_store "https://github.com/sellamuthu2007/digibank/blob/main/backend/models/CertificateRequest.js"

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_student_dashboard,node_student_wallet,node_student_certs,node_student_request,node_student_requests,node_student_share,node_institution_dashboard,node_pending_requests,node_issued_certs,node_organization_dashboard,node_verify_view,node_verify_page,node_auth_ui toneBlue
class node_auth_routes,node_auth_controller,node_identity_models toneAmber
class node_api,node_cert_routes,node_cert_controller,node_certificate_store,node_request_store toneMint
class node_mongo,node_ipfs,node_chain toneRose
class node_student,node_institution,node_verifier toneIndigo
```

## Components

### Web application

- [Route application](https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Student dashboard](https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/pages/Student_page/Student_dashboard.jsx): `frontend/src/pages/Student_page/Student_dashboard.jsx`
- [Certificate wallet](https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/components/student/StudentWallet_View.jsx): `frontend/src/components/student/StudentWallet_View.jsx`
- [My certificates](https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/components/student/MyCertificates.jsx): `frontend/src/components/student/MyCertificates.jsx`
- [Request certificate](https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/components/student/RequestCertificate.jsx): `frontend/src/components/student/RequestCertificate.jsx`
- [Request tracking](https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/components/student/MyRequests.jsx): `frontend/src/components/student/MyRequests.jsx`
- [Share certificate](https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/components/student/ShareCertificate.jsx): `frontend/src/components/student/ShareCertificate.jsx`
- [Issuer dashboard](https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/pages/Institution_page/InstitutionDashboardEnhanced.jsx): `frontend/src/pages/Institution_page/InstitutionDashboardEnhanced.jsx`
- [Pending requests](https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/components/institution/PendingRequests.jsx): `frontend/src/components/institution/PendingRequests.jsx`
- [Issued certificates](https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/components/institution/IssuedCertificates.jsx): `frontend/src/components/institution/IssuedCertificates.jsx`
- [Verifier dashboard](https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/pages/Organization_page/OrganizationDashboardEnhanced.jsx): `frontend/src/pages/Organization_page/OrganizationDashboardEnhanced.jsx`
- [Certificate lookup](https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/components/organization/VerifyCertificate.jsx): `frontend/src/components/organization/VerifyCertificate.jsx`
- [Public verification](https://github.com/sellamuthu2007/digibank/blob/main/frontend/src/pages/VerifyCertificatePage.jsx): `frontend/src/pages/VerifyCertificatePage.jsx`
- [Role registration and login](https://github.com/sellamuthu2007/digibank/tree/main/frontend/src/auth): `frontend/src/auth`

### Identity and access

- [Identity routes](https://github.com/sellamuthu2007/digibank/blob/main/backend/routes/AuthRoutes.js): `backend/routes/AuthRoutes.js`
- [Identity controller](https://github.com/sellamuthu2007/digibank/blob/main/backend/controllers/AuthController.js): `backend/controllers/AuthController.js`
- [Account and OTP models](https://github.com/sellamuthu2007/digibank/tree/main/backend/models): `backend/models`

### Certificate lifecycle

- [Express API](https://github.com/sellamuthu2007/digibank/blob/main/backend/index.js): `backend/index.js`
- [Certificate routes](https://github.com/sellamuthu2007/digibank/blob/main/backend/routes/CertificateRoutes.js): `backend/routes/CertificateRoutes.js`
- [Certificate operations](https://github.com/sellamuthu2007/digibank/blob/main/backend/controllers/CertificateController.js): `backend/controllers/CertificateController.js`
- [Certificate records](https://github.com/sellamuthu2007/digibank/blob/main/backend/models/Certificate.js): `backend/models/Certificate.js`
- [Certificate requests](https://github.com/sellamuthu2007/digibank/blob/main/backend/models/CertificateRequest.js): `backend/models/CertificateRequest.js`

### External services

- **MongoDB**
- **IPFS storage**
- **Polygon blockchain**

### Other components

- **Student**
- **Institution**
- **Verifier**

## Connections

- Route application → Student dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Issuer dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Verifier dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Public verification: routes to (evidence: `frontend/src/App.jsx`)
- Student dashboard → Certificate wallet: renders (evidence: `frontend/src/pages/Student_page/Student_dashboard.jsx`)
- Student dashboard → My certificates: renders (evidence: `frontend/src/pages/Student_page/Student_dashboard.jsx`)
- Student dashboard → Request certificate: renders (evidence: `frontend/src/pages/Student_page/Student_dashboard.jsx`)
- Student dashboard → Request tracking: renders (evidence: `frontend/src/pages/Student_page/Student_dashboard.jsx`)
- Student dashboard → Share certificate: renders (evidence: `frontend/src/pages/Student_page/Student_dashboard.jsx`)
- Issuer dashboard → Pending requests: renders (evidence: `frontend/src/pages/Institution_page/InstitutionDashboardEnhanced.jsx`)
- Issuer dashboard → Issued certificates: renders (evidence: `frontend/src/pages/Institution_page/InstitutionDashboardEnhanced.jsx`)
- Student → Student dashboard: uses (evidence: `README.md`)
- Institution → Issuer dashboard: uses (evidence: `README.md`)
- Verifier → Verifier dashboard: uses (evidence: `README.md`)
- Role registration and login → Identity routes: submits to (evidence: `README.md`)
- Request certificate → Certificate routes: requests via (evidence: `README.md`)
- Pending requests → Certificate routes: handles via (evidence: `README.md`)
- Issued certificates → Certificate routes: uses (evidence: `README.md`)
- Public verification → Certificate routes: verifies via (evidence: `README.md`)
- Express API → Identity routes: mounts (evidence: `backend/index.js`)
- Express API → Certificate routes: mounts (evidence: `backend/index.js`)
- Identity routes → Identity controller: dispatches (evidence: `backend/routes/AuthRoutes.js`)
- Certificate routes → Certificate operations: dispatches (evidence: `backend/routes/CertificateRoutes.js`)
- Identity controller → Account and OTP models: reads and writes (evidence: `backend/controllers/AuthController.js`)
- Certificate operations → Certificate records: reads and writes (evidence: `backend/controllers/CertificateController.js`)
- Certificate operations → Certificate requests: reads and writes (evidence: `backend/controllers/CertificateController.js`)
- Express API → MongoDB: connects (evidence: `README.md`)
- Certificate records → IPFS storage: stores files (evidence: `README.md`)
- Certificate records → Polygon blockchain: records proof (evidence: `README.md`)
