# yash1648/ssdcve architecture

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

- Interactive diagram: https://gitdiagram.com/yash1648/ssdcve
- Repository: https://github.com/yash1648/ssdcve

## Overview

This backend supports a credential lifecycle: users authenticate, issuers register and issue credentials, holders receive credentials and manage disclosure, and verifiers check credentials and review verification history. Issuance and verification also use content storage and blockchain anchoring; batch verification is a separate route. The graph includes administration and security components visible in the source tree, but their internal connections are not shown. Evidence is limited to the supplied excerpts and SOURCE INDEX; links for unsampled internals are omitted.

Main entry points: [`backend/src/main/java/com/ssdcve/service/IssuerService.java`](https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/IssuerService.java) (Issuance), [`backend/src/main/java/com/ssdcve/service/HolderService.java`](https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/HolderService.java) (Holder wallet), [`backend/src/main/java/com/ssdcve/controller/VerifierController.java`](https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/controller/VerifierController.java) (Verifier API), [`backend/src/main/java/com/ssdcve/service/VerificationService.java`](https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/VerificationService.java) (Credential checks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity &amp; access"]
  node_auth_api["Auth API"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_jwt["JWT utility<br/>[JwtUtil.java]"]
  node_security["Security filters"]
  node_admin["Administration"]
  node_admin_service["Admin service<br/>[AdminService.java]"]
end

subgraph group_credential["Credential lifecycle"]
  node_issuer_api["Issuer API"]
  node_issuer_service["Issuance<br/>[IssuerService.java]"]
  node_holder_api["Holder API"]
  node_holder_service["Holder wallet<br/>[HolderService.java]"]
  node_revocation["Revocation"]
  node_pdf["Certificate PDF"]
end

subgraph group_verification["Verification"]
  node_verifier_api["Verifier API"]
  node_verification["Credential checks"]
  node_batch["Batch checks"]
  node_history["Verification history"]
end

subgraph group_platform["Persistence &amp; integrations"]
  node_database[("Repositories")]
  node_ipfs["IPFS storage<br/>[IpfsService.java]"]
  node_anchor["Blockchain anchor"]
end

node_user(("User"))
node_issuer(("Issuer"))
node_holder(("Holder"))
node_verifier(("Verifier"))
node_external_ipfs["IPFS"]
node_blockchain["Blockchain"]

node_user -->|"registers or logs in"| node_auth_api
node_auth_api -->|"delegates"| node_auth
node_auth -->|"reads and writes"| node_database
node_auth -->|"generates tokens"| node_jwt
node_issuer -->|"issues credentials"| node_issuer_api
node_issuer_api -->|"delegates"| node_issuer_service
node_issuer_service -->|"persists records"| node_database
node_issuer_service -->|"uses revocation"| node_revocation
node_issuer_service -->|"stores content"| node_ipfs
node_issuer_service -->|"anchors credential"| node_anchor
node_ipfs -.->|"stores content"| node_external_ipfs
node_anchor -.->|"writes anchor"| node_blockchain
node_holder -->|"manages credentials"| node_holder_api
node_holder_api -->|"delegates"| node_holder_service
node_holder_service -->|"reads and writes"| node_database
node_holder_service -->|"retrieves content"| node_ipfs
node_holder_service -->|"uses PDF service"| node_pdf
node_verifier -->|"submits credentials"| node_verifier_api
node_verifier_api -->|"requests checks"| node_verification
node_verifier_api -->|"validates batch files"| node_batch
node_batch -->|"verifies items"| node_verification
node_verifier_api -->|"records result"| node_history
node_verification -->|"reads credential data"| node_database
node_verification -->|"retrieves content"| node_ipfs
node_batch -->|"uses history service"| node_history

click node_auth_api "https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/controller/AuthController.java"
click node_auth "https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/AuthService.java"
click node_jwt "https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/JwtUtil.java"
click node_security "https://github.com/yash1648/ssdcve/tree/main/backend/src/main/java/com/ssdcve/security"
click node_admin "https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/controller/AdminController.java"
click node_admin_service "https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/AdminService.java"
click node_issuer_api "https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/controller/IssuerController.java"
click node_issuer_service "https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/IssuerService.java"
click node_holder_api "https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/controller/HolderController.java"
click node_holder_service "https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/HolderService.java"
click node_revocation "https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/RevocationService.java"
click node_pdf "https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/CertificatePdfService.java"
click node_verifier_api "https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/controller/VerifierController.java"
click node_verification "https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/VerificationService.java"
click node_batch "https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/BatchVerificationService.java"
click node_history "https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/VerificationHistoryService.java"
click node_database "https://github.com/yash1648/ssdcve/tree/main/backend/src/main/java/com/ssdcve/repository"
click node_ipfs "https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/IpfsService.java"
click node_anchor "https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/BlockchainAnchorService.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_api,node_auth,node_jwt,node_security,node_admin,node_admin_service,node_user toneBlue
class node_issuer_api,node_issuer_service,node_holder_api,node_holder_service,node_revocation,node_pdf toneAmber
class node_verifier_api,node_verification,node_batch,node_history toneMint
class node_database,node_ipfs,node_anchor toneRose
class node_issuer,node_holder,node_verifier,node_external_ipfs,node_blockchain toneIndigo
```

## Components

### Identity & access

- [Auth API](https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/controller/AuthController.java): `backend/src/main/java/com/ssdcve/controller/AuthController.java`
- [Authentication](https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/AuthService.java): `backend/src/main/java/com/ssdcve/service/AuthService.java`
- [JWT utility](https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/JwtUtil.java): `backend/src/main/java/com/ssdcve/service/JwtUtil.java`
- [Security filters](https://github.com/yash1648/ssdcve/tree/main/backend/src/main/java/com/ssdcve/security): `backend/src/main/java/com/ssdcve/security`
- [Administration](https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/controller/AdminController.java): `backend/src/main/java/com/ssdcve/controller/AdminController.java`
- [Admin service](https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/AdminService.java): `backend/src/main/java/com/ssdcve/service/AdminService.java`

### Credential lifecycle

- [Issuer API](https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/controller/IssuerController.java): `backend/src/main/java/com/ssdcve/controller/IssuerController.java`
- [Issuance](https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/IssuerService.java): `backend/src/main/java/com/ssdcve/service/IssuerService.java`
- [Holder API](https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/controller/HolderController.java): `backend/src/main/java/com/ssdcve/controller/HolderController.java`
- [Holder wallet](https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/HolderService.java): `backend/src/main/java/com/ssdcve/service/HolderService.java`
- [Revocation](https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/RevocationService.java): `backend/src/main/java/com/ssdcve/service/RevocationService.java`
- [Certificate PDF](https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/CertificatePdfService.java): `backend/src/main/java/com/ssdcve/service/CertificatePdfService.java`

### Verification

- [Verifier API](https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/controller/VerifierController.java): `backend/src/main/java/com/ssdcve/controller/VerifierController.java`
- [Credential checks](https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/VerificationService.java): `backend/src/main/java/com/ssdcve/service/VerificationService.java`
- [Batch checks](https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/BatchVerificationService.java): `backend/src/main/java/com/ssdcve/service/BatchVerificationService.java`
- [Verification history](https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/VerificationHistoryService.java): `backend/src/main/java/com/ssdcve/service/VerificationHistoryService.java`

### Persistence & integrations

- [Repositories](https://github.com/yash1648/ssdcve/tree/main/backend/src/main/java/com/ssdcve/repository): `backend/src/main/java/com/ssdcve/repository`
- [IPFS storage](https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/IpfsService.java): `backend/src/main/java/com/ssdcve/service/IpfsService.java`
- [Blockchain anchor](https://github.com/yash1648/ssdcve/blob/main/backend/src/main/java/com/ssdcve/service/BlockchainAnchorService.java): `backend/src/main/java/com/ssdcve/service/BlockchainAnchorService.java`

### Other components

- **User**
- **Issuer**
- **Holder**
- **Verifier**
- **IPFS**
- **Blockchain**

## Connections

- User → Auth API: registers or logs in (evidence: `backend/src/main/java/com/ssdcve/controller/AuthController.java`)
- Auth API → Authentication: delegates (evidence: `backend/src/main/java/com/ssdcve/controller/AuthController.java`)
- Authentication → Repositories: reads and writes (evidence: `backend/src/main/java/com/ssdcve/service/AuthService.java`)
- Authentication → JWT utility: generates tokens (evidence: `backend/src/main/java/com/ssdcve/service/AuthService.java`)
- Issuer → Issuer API: issues credentials (evidence: `backend/src/main/java/com/ssdcve/controller/IssuerController.java`)
- Issuer API → Issuance: delegates (evidence: `backend/src/main/java/com/ssdcve/controller/IssuerController.java`)
- Issuance → Repositories: persists records (evidence: `backend/src/main/java/com/ssdcve/service/IssuerService.java`)
- Issuance → Revocation: uses revocation (evidence: `backend/src/main/java/com/ssdcve/service/IssuerService.java`)
- Issuance → IPFS storage: stores content (evidence: `backend/src/main/java/com/ssdcve/service/IssuerService.java`)
- Issuance → Blockchain anchor: anchors credential (evidence: `backend/src/main/java/com/ssdcve/service/IssuerService.java`)
- IPFS storage → IPFS: stores content
- Blockchain anchor → Blockchain: writes anchor
- Holder → Holder API: manages credentials (evidence: `backend/src/main/java/com/ssdcve/controller/HolderController.java`)
- Holder API → Holder wallet: delegates (evidence: `backend/src/main/java/com/ssdcve/controller/HolderController.java`)
- Holder wallet → Repositories: reads and writes (evidence: `backend/src/main/java/com/ssdcve/service/HolderService.java`)
- Holder wallet → IPFS storage: retrieves content (evidence: `backend/src/main/java/com/ssdcve/service/HolderService.java`)
- Holder wallet → Certificate PDF: uses PDF service (evidence: `backend/src/main/java/com/ssdcve/service/HolderService.java`)
- Verifier → Verifier API: submits credentials (evidence: `backend/src/main/java/com/ssdcve/controller/VerifierController.java`)
- Verifier API → Credential checks: requests checks (evidence: `backend/src/main/java/com/ssdcve/controller/VerifierController.java`)
- Verifier API → Batch checks: validates batch files (evidence: `backend/src/main/java/com/ssdcve/controller/VerifierController.java`)
- Batch checks → Credential checks: verifies items (evidence: `backend/src/main/java/com/ssdcve/service/BatchVerificationService.java`)
- Verifier API → Verification history: records result (evidence: `backend/src/main/java/com/ssdcve/controller/VerifierController.java`)
- Credential checks → Repositories: reads credential data (evidence: `backend/src/main/java/com/ssdcve/service/VerificationService.java`)
- Credential checks → IPFS storage: retrieves content (evidence: `backend/src/main/java/com/ssdcve/service/VerificationService.java`)
- Batch checks → Verification history: uses history service (evidence: `backend/src/main/java/com/ssdcve/service/BatchVerificationService.java`)
