# aryankumarjha2006-oss/certificate-verification-system architecture

> Architecture diagram of the GitHub repository aryankumarjha2006-oss/certificate-verification-system, 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/aryankumarjha2006-oss/certificate-verification-system
- Repository: https://github.com/aryankumarjha2006-oss/certificate-verification-system

## Overview

CredChain’s main workflow issues credentials through an administrative interface, anchors document hashes on Ethereum, and supports public document verification without requiring a verifier wallet. Express provides authenticated lifecycle APIs and off-chain metadata, audit, analytics, and event synchronization; the React application also exposes institution, issuer, activity, and settings workflows. The README documents additional lifecycle guarantees, but the supplied tree has no Solidity source. Backend analytics and some frontend service interactions are represented at subsystem level where implementation details were not excerpted.

Main entry points: [`member-1-blockchain-core/frontend/src/App.jsx`](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/App.jsx) (Admin application), [`member-1-blockchain-core/frontend/src/services/blockchain.js`](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/services/blockchain.js) (Blockchain client), [`member-2-blockchain-application/server.js`](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/server.js) (API server), [`member-2-blockchain-application/src/controllers/certificateController.js`](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/src/controllers/certificateController.js) (Credential operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_users["Credential users"]
  node_issuer(("Issuer"))
  node_verifier(("Public verifier"))
  node_admin(("Administrator"))
end

subgraph group_frontend["Web interfaces"]
  node_app["Admin application<br/>[App.jsx]"]
  node_shell["Application shell<br/>[AppShell.jsx]"]
  node_credential_ui["Credential management<br/>[Certificates.jsx]"]
  node_verification_ui["Public verification"]
  node_institution_ui["Institutions and issuers<br/>[Institutions.jsx]"]
  node_analytics_ui["Analytics<br/>[Analytics.jsx]"]
  node_activity_ui["Blockchain activity"]
  node_dashboard_ui["Dashboard<br/>[Dashboard.jsx]"]
  node_verification_admin["Admin verification<br/>[Verification.jsx]"]
  node_settings_ui["Settings<br/>[Settings.jsx]"]
  node_pdf["PDF generation<br/>[pdfGenerator.js]"]
  node_frontend_chain["Blockchain client<br/>[blockchain.js]"]
end

subgraph group_backend["Application backend"]
  node_server["API server<br/>[server.js]"]
  node_certificate_api["Credential lifecycle API"]
  node_certificate_logic["Credential operations"]
  node_auth["Authentication<br/>[authMiddleware.js]"]
  node_auth_api["Authentication API<br/>[authRoutes.js]"]
  node_analytics_api["Analytics API"]
  node_audit_api["Audit API<br/>[auditController.js]"]
  node_audit_routes["Audit routes<br/>[auditRoutes.js]"]
  node_analytics_routes["Analytics routes<br/>[analyticsRoutes.js]"]
end

subgraph group_trust["Trust and records"]
  node_blockchain_config["Blockchain integration<br/>[blockchain.js]"]
  node_event_listener["Event synchronization<br/>[eventListener.js]"]
  node_hash_service["Document hashing<br/>[hashService.js]"]
  node_database[("SQLite records<br/>[database.js]")]
  node_ethereum{{"Ethereum contracts"}}
end

node_issuer -->|"issues credentials"| node_credential_ui
node_verifier -->|"submits document"| node_verification_ui
node_admin -->|"uses platform"| node_app
node_app -->|"renders routes"| node_shell
node_app -->|"routes to"| node_credential_ui
node_app -->|"routes to"| node_verification_ui
node_app -->|"routes to"| node_institution_ui
node_app -->|"routes to"| node_analytics_ui
node_app -->|"routes to"| node_activity_ui
node_app -->|"routes to"| node_dashboard_ui
node_app -->|"routes to"| node_verification_admin
node_app -->|"routes to"| node_settings_ui
node_credential_ui -->|"generates PDF"| node_pdf
node_credential_ui -->|"calls operations"| node_frontend_chain
node_verification_ui -->|"checks credentials"| node_frontend_chain
node_institution_ui -->|"manages institutions"| node_frontend_chain
node_analytics_ui -->|"loads data"| node_frontend_chain
node_activity_ui -->|"loads activity"| node_frontend_chain
node_dashboard_ui -->|"loads data"| node_frontend_chain
node_verification_admin -.->|"uses service"| node_frontend_chain
node_settings_ui -->|"uses service"| node_frontend_chain
node_frontend_chain -->|"calls contracts"| node_ethereum
node_frontend_chain -->|"fetches certificate data"| node_server
node_server -->|"mounts routes"| node_certificate_api
node_server -->|"mounts routes"| node_auth_api
node_server -->|"mounts routes"| node_analytics_routes
node_server -->|"mounts routes"| node_audit_routes
node_server -->|"initializes"| node_database
node_server -->|"connects"| node_blockchain_config
node_server -->|"starts synchronizer"| node_event_listener
node_certificate_api -->|"protects routes"| node_auth
node_certificate_api -->|"dispatches requests"| node_certificate_logic
node_audit_routes -->|"protects routes"| node_auth
node_audit_routes -->|"dispatches requests"| node_audit_api
node_analytics_routes -->|"protects routes"| node_auth
node_analytics_routes -->|"dispatches requests"| node_analytics_api
node_certificate_logic -->|"calls contract helpers"| node_blockchain_config
node_certificate_logic -->|"reads and writes"| node_database
node_certificate_logic -->|"records events"| node_event_listener
node_certificate_logic -->|"hashes documents"| node_hash_service
node_blockchain_config -->|"connects and signs"| node_ethereum
node_event_listener -->|"synchronizes events"| node_database
node_audit_api -->|"reads audit records"| node_database

click node_app "https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/App.jsx"
click node_shell "https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/components/layout/AppShell.jsx"
click node_credential_ui "https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/pages/Certificates.jsx"
click node_verification_ui "https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/pages/PublicVerification.jsx"
click node_institution_ui "https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/pages/Institutions.jsx"
click node_analytics_ui "https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/pages/Analytics.jsx"
click node_activity_ui "https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/pages/BlockchainActivityPage.jsx"
click node_dashboard_ui "https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/pages/Dashboard.jsx"
click node_verification_admin "https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/pages/Verification.jsx"
click node_settings_ui "https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/pages/Settings.jsx"
click node_pdf "https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/services/pdfGenerator.js"
click node_frontend_chain "https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/services/blockchain.js"
click node_server "https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/server.js"
click node_certificate_api "https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/src/routes/certificateRoutes.js"
click node_certificate_logic "https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/src/controllers/certificateController.js"
click node_auth "https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/src/middleware/authMiddleware.js"
click node_auth_api "https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/src/routes/authRoutes.js"
click node_analytics_api "https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/src/controllers/analyticsController.js"
click node_audit_api "https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/src/controllers/auditController.js"
click node_audit_routes "https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/src/routes/auditRoutes.js"
click node_analytics_routes "https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/src/routes/analyticsRoutes.js"
click node_blockchain_config "https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/src/config/blockchain.js"
click node_event_listener "https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/src/services/eventListener.js"
click node_hash_service "https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/src/services/hashService.js"
click node_database "https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/src/config/database.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_issuer,node_verifier,node_admin toneBlue
class node_app,node_shell,node_credential_ui,node_verification_ui,node_institution_ui,node_analytics_ui,node_activity_ui,node_dashboard_ui,node_verification_admin,node_settings_ui,node_pdf,node_frontend_chain toneAmber
class node_server,node_certificate_api,node_certificate_logic,node_auth,node_auth_api,node_analytics_api,node_audit_api,node_audit_routes,node_analytics_routes toneMint
class node_blockchain_config,node_event_listener,node_hash_service,node_database,node_ethereum toneRose
```

## Components

### Credential users

- **Issuer**
- **Public verifier**
- **Administrator**

### Web interfaces

- [Admin application](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/App.jsx): `member-1-blockchain-core/frontend/src/App.jsx`
- [Application shell](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/components/layout/AppShell.jsx): `member-1-blockchain-core/frontend/src/components/layout/AppShell.jsx`
- [Credential management](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/pages/Certificates.jsx): `member-1-blockchain-core/frontend/src/pages/Certificates.jsx`
- [Public verification](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/pages/PublicVerification.jsx): `member-1-blockchain-core/frontend/src/pages/PublicVerification.jsx`
- [Institutions and issuers](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/pages/Institutions.jsx): `member-1-blockchain-core/frontend/src/pages/Institutions.jsx`
- [Analytics](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/pages/Analytics.jsx): `member-1-blockchain-core/frontend/src/pages/Analytics.jsx`
- [Blockchain activity](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/pages/BlockchainActivityPage.jsx): `member-1-blockchain-core/frontend/src/pages/BlockchainActivityPage.jsx`
- [Dashboard](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/pages/Dashboard.jsx): `member-1-blockchain-core/frontend/src/pages/Dashboard.jsx`
- [Admin verification](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/pages/Verification.jsx): `member-1-blockchain-core/frontend/src/pages/Verification.jsx`
- [Settings](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/pages/Settings.jsx): `member-1-blockchain-core/frontend/src/pages/Settings.jsx`
- [PDF generation](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/services/pdfGenerator.js): `member-1-blockchain-core/frontend/src/services/pdfGenerator.js`
- [Blockchain client](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-1-blockchain-core/frontend/src/services/blockchain.js): `member-1-blockchain-core/frontend/src/services/blockchain.js`

### Application backend

- [API server](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/server.js): `member-2-blockchain-application/server.js`
- [Credential lifecycle API](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/src/routes/certificateRoutes.js): `member-2-blockchain-application/src/routes/certificateRoutes.js`
- [Credential operations](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/src/controllers/certificateController.js): `member-2-blockchain-application/src/controllers/certificateController.js`
- [Authentication](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/src/middleware/authMiddleware.js): `member-2-blockchain-application/src/middleware/authMiddleware.js`
- [Authentication API](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/src/routes/authRoutes.js): `member-2-blockchain-application/src/routes/authRoutes.js`
- [Analytics API](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/src/controllers/analyticsController.js): `member-2-blockchain-application/src/controllers/analyticsController.js`
- [Audit API](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/src/controllers/auditController.js): `member-2-blockchain-application/src/controllers/auditController.js`
- [Audit routes](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/src/routes/auditRoutes.js): `member-2-blockchain-application/src/routes/auditRoutes.js`
- [Analytics routes](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/src/routes/analyticsRoutes.js): `member-2-blockchain-application/src/routes/analyticsRoutes.js`

### Trust and records

- [Blockchain integration](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/src/config/blockchain.js): `member-2-blockchain-application/src/config/blockchain.js`
- [Event synchronization](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/src/services/eventListener.js): `member-2-blockchain-application/src/services/eventListener.js`
- [Document hashing](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/src/services/hashService.js): `member-2-blockchain-application/src/services/hashService.js`
- [SQLite records](https://github.com/aryankumarjha2006-oss/certificate-verification-system/blob/main/member-2-blockchain-application/src/config/database.js): `member-2-blockchain-application/src/config/database.js`
- **Ethereum contracts**

## Connections

- Issuer → Credential management: issues credentials
- Public verifier → Public verification: submits document
- Administrator → Admin application: uses platform (evidence: `member-1-blockchain-core/frontend/src/App.jsx`)
- Admin application → Application shell: renders routes (evidence: `member-1-blockchain-core/frontend/src/App.jsx`)
- Admin application → Credential management: routes to (evidence: `member-1-blockchain-core/frontend/src/App.jsx`)
- Admin application → Public verification: routes to (evidence: `member-1-blockchain-core/frontend/src/App.jsx`)
- Admin application → Institutions and issuers: routes to (evidence: `member-1-blockchain-core/frontend/src/App.jsx`)
- Admin application → Analytics: routes to (evidence: `member-1-blockchain-core/frontend/src/App.jsx`)
- Admin application → Blockchain activity: routes to (evidence: `member-1-blockchain-core/frontend/src/App.jsx`)
- Admin application → Dashboard: routes to (evidence: `member-1-blockchain-core/frontend/src/App.jsx`)
- Admin application → Admin verification: routes to (evidence: `member-1-blockchain-core/frontend/src/App.jsx`)
- Admin application → Settings: routes to (evidence: `member-1-blockchain-core/frontend/src/App.jsx`)
- Credential management → PDF generation: generates PDF (evidence: `member-1-blockchain-core/frontend/src/pages/Certificates.jsx`)
- Credential management → Blockchain client: calls operations (evidence: `member-1-blockchain-core/frontend/src/pages/Certificates.jsx`)
- Public verification → Blockchain client: checks credentials (evidence: `member-1-blockchain-core/frontend/src/pages/PublicVerification.jsx`)
- Institutions and issuers → Blockchain client: manages institutions (evidence: `member-1-blockchain-core/frontend/src/pages/Institutions.jsx`)
- Analytics → Blockchain client: loads data (evidence: `member-1-blockchain-core/frontend/src/pages/Analytics.jsx`)
- Blockchain activity → Blockchain client: loads activity (evidence: `member-1-blockchain-core/frontend/src/pages/BlockchainActivityPage.jsx`)
- Dashboard → Blockchain client: loads data (evidence: `member-1-blockchain-core/frontend/src/pages/Dashboard.jsx`)
- Admin verification → Blockchain client: uses service
- Settings → Blockchain client: uses service (evidence: `member-1-blockchain-core/frontend/src/pages/Settings.jsx`)
- Blockchain client → Ethereum contracts: calls contracts (evidence: `member-1-blockchain-core/frontend/src/services/blockchain.js`)
- Blockchain client → API server: fetches certificate data (evidence: `member-1-blockchain-core/frontend/src/services/blockchain.js`)
- API server → Credential lifecycle API: mounts routes (evidence: `member-2-blockchain-application/server.js`)
- API server → Authentication API: mounts routes (evidence: `member-2-blockchain-application/server.js`)
- API server → Analytics routes: mounts routes (evidence: `member-2-blockchain-application/server.js`)
- API server → Audit routes: mounts routes (evidence: `member-2-blockchain-application/server.js`)
- API server → SQLite records: initializes (evidence: `member-2-blockchain-application/server.js`)
- API server → Blockchain integration: connects (evidence: `member-2-blockchain-application/server.js`)
- API server → Event synchronization: starts synchronizer (evidence: `member-2-blockchain-application/server.js`)
- Credential lifecycle API → Authentication: protects routes (evidence: `member-2-blockchain-application/src/routes/certificateRoutes.js`)
- Credential lifecycle API → Credential operations: dispatches requests (evidence: `member-2-blockchain-application/src/routes/certificateRoutes.js`)
- Audit routes → Authentication: protects routes (evidence: `member-2-blockchain-application/src/routes/auditRoutes.js`)
- Audit routes → Audit API: dispatches requests (evidence: `member-2-blockchain-application/src/routes/auditRoutes.js`)
- Analytics routes → Authentication: protects routes (evidence: `member-2-blockchain-application/src/routes/analyticsRoutes.js`)
- Analytics routes → Analytics API: dispatches requests (evidence: `member-2-blockchain-application/src/routes/analyticsRoutes.js`)
- Credential operations → Blockchain integration: calls contract helpers (evidence: `member-2-blockchain-application/src/controllers/certificateController.js`)
- Credential operations → SQLite records: reads and writes (evidence: `member-2-blockchain-application/src/controllers/certificateController.js`)
- Credential operations → Event synchronization: records events (evidence: `member-2-blockchain-application/src/controllers/certificateController.js`)
- Credential operations → Document hashing: hashes documents (evidence: `member-2-blockchain-application/src/controllers/certificateController.js`)
- Blockchain integration → Ethereum contracts: connects and signs (evidence: `member-2-blockchain-application/src/config/blockchain.js`)
- Event synchronization → SQLite records: synchronizes events (evidence: `member-2-blockchain-application/src/services/eventListener.js`)
- Audit API → SQLite records: reads audit records (evidence: `member-2-blockchain-application/src/controllers/auditController.js`)
