# sudheer-infosec/sudheer-portfolio-website architecture

> Architecture diagram of the GitHub repository sudheer-infosec/sudheer-portfolio-website, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sudheer-infosec/sudheer-portfolio-website
- Repository: https://github.com/sudheer-infosec/sudheer-portfolio-website

## Overview

This repository is a personal cybersecurity portfolio containing a static portfolio site and a collection of labs, toolkits, and evidence-management projects. Visitors browse the portfolio and its project summaries; within CustodyGuard, investigators authenticate, manage cases, upload and verify evidence, and review audit activity. The graph highlights that workflow and the sampled forensic-evidence pipeline, alongside major README-described projects. Some project internals are unsampled, so their capabilities are represented without inferred implementation links.

Main entry points: [`Company-Related-Projects/CustodyGuard/demccs/frontend/src/pages/CaseDetail.js`](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/frontend/src/pages/CaseDetail.js) (Case management), [`Company-Related-Projects/CustodyGuard/demccs/backend/main.py`](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/backend/main.py) (API application), [`Company-Related-Projects/CustodyGuard/demccs/backend/database.py`](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/backend/database.py) (Database access), [`Company-Related-Projects/CustodyGuard/demccs/backend/routers/auth.py`](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/backend/routers/auth.py) (Authentication routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portfolio["Portfolio Site"]
  node_portfolio_site["Portfolio website<br/>[app.js]"]
  node_portfolio_page["Portfolio page<br/>[index.html]"]
end

subgraph group_custody["CustodyGuard"]
  node_custody_ui["CustodyGuard UI<br/>[App.js]"]
  node_auth_ui["Login and session<br/>[AuthContext.js]"]
  node_api_client["API client<br/>[api.js]"]
  node_case_ui["Case management<br/>[CaseDetail.js]"]
  node_case_api["Case routes<br/>[cases.py]"]
  node_evidence_api["Evidence routes<br/>[evidence.py]"]
  node_audit_api["Audit routes<br/>[audit.py]"]
  node_auth_api["Authentication routes<br/>[auth.py]"]
  node_auth_utils["Token and password logic<br/>[auth_utils.py]"]
  node_db_access["Database access<br/>[database.py]"]
  node_db[("Custody database<br/>[demccs.db]")]
  node_api_app["API application<br/>[main.py]"]
end

subgraph group_forensic["Forensic Platform"]
  node_ingest["Evidence ingestion<br/>[evidence_ingest.py]"]
  node_hashing["SHA-256 calculation<br/>[hash_utils.py]"]
  node_integrity["Integrity verification"]
  node_access["Evidence access<br/>[evidence_access.py]"]
  node_custody_log["Custody logging<br/>[custody_log.py]"]
  node_evidence_store["Evidence storage<br/>[evidence_store.py]"]
  node_reporting["Forensic reporting<br/>[forensic_report.py]"]
end

subgraph group_labs["Security Labs"]
  node_wazuh_lab["Wazuh detection lab<br/>[README.md]"]
  node_zeus_lab["Zeus malware hunt<br/>[README.md]"]
  node_cowrie_lab["Cowrie honeypot lab<br/>[README.md]"]
end

subgraph group_toolkit["Investigation Toolkit"]
  node_digital_toolkit["Digital evidence toolkit<br/>[README.md]"]
  node_intel_toolkit["Cyber intelligence toolkit<br/>[README.md]"]
end

node_visitor(("Portfolio visitor"))
node_investigator(("Investigator"))

node_visitor -->|"browses"| node_portfolio_site
node_portfolio_site -.->|"renders"| node_portfolio_page
node_investigator -.->|"uses"| node_custody_ui
node_custody_ui -->|"provides session"| node_auth_ui
node_auth_ui -->|"calls"| node_api_client
node_case_ui -->|"calls"| node_api_client
node_case_ui -->|"requests cases"| node_case_api
node_case_ui -->|"uploads and lists"| node_evidence_api
node_case_ui -->|"requests logs"| node_audit_api
node_api_app -->|"registers routes"| node_auth_api
node_api_app -->|"registers routes"| node_case_api
node_api_app -->|"registers routes"| node_evidence_api
node_api_app -->|"registers routes"| node_audit_api
node_auth_api -->|"uses"| node_auth_utils
node_auth_api -->|"opens sessions"| node_db_access
node_case_api -->|"opens sessions"| node_db_access
node_evidence_api -->|"opens sessions"| node_db_access
node_db_access -.->|"connects"| node_db
node_ingest -->|"calculates hash"| node_hashing

click node_portfolio_site "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/js/app.js"
click node_portfolio_page "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/index.html"
click node_custody_ui "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/frontend/src/App.js"
click node_auth_ui "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/frontend/src/context/AuthContext.js"
click node_api_client "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/frontend/src/utils/api.js"
click node_case_ui "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/frontend/src/pages/CaseDetail.js"
click node_case_api "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/backend/routers/cases.py"
click node_evidence_api "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/backend/routers/evidence.py"
click node_audit_api "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/backend/routers/audit.py"
click node_auth_api "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/backend/routers/auth.py"
click node_auth_utils "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/backend/auth_utils.py"
click node_db_access "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/backend/database.py"
click node_db "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/backend/demccs.db"
click node_api_app "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/backend/main.py"
click node_ingest "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/forensic-evidence-platform/core/evidence_ingest.py"
click node_hashing "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/forensic-evidence-platform/crypto/hash_utils.py"
click node_integrity "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/forensic-evidence-platform/core/integrity_verify.py"
click node_access "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/forensic-evidence-platform/core/evidence_access.py"
click node_custody_log "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/forensic-evidence-platform/custody/custody_log.py"
click node_evidence_store "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/forensic-evidence-platform/storage/evidence_store.py"
click node_reporting "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/forensic-evidence-platform/reports/forensic_report.py"
click node_wazuh_lab "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/wazuh-soc-detection-lab/README.md"
click node_zeus_lab "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Cybersecurity-SOC/Zeus-Malware-Hunt-Lab/README.md"
click node_cowrie_lab "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Cowrie-Honeypot-Lab/README.md"
click node_digital_toolkit "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Cyber-Crime-Digital-Forensics/Digital-Evidence-Toolkit/README.md"
click node_intel_toolkit "https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Cybersecurity-SOC/Cyber-Intelligence-Toolkit/README.md"

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_portfolio_site,node_portfolio_page toneBlue
class node_custody_ui,node_auth_ui,node_api_client,node_case_ui,node_case_api,node_evidence_api,node_audit_api,node_auth_api,node_auth_utils,node_db_access,node_db,node_api_app toneAmber
class node_ingest,node_hashing,node_integrity,node_access,node_custody_log,node_evidence_store,node_reporting toneMint
class node_wazuh_lab,node_zeus_lab,node_cowrie_lab toneRose
class node_digital_toolkit,node_intel_toolkit,node_visitor,node_investigator toneIndigo
```

## Components

### Portfolio Site

- [Portfolio website](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/js/app.js): `js/app.js`
- [Portfolio page](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/index.html): `index.html`

### CustodyGuard

- [CustodyGuard UI](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/frontend/src/App.js): `Company-Related-Projects/CustodyGuard/demccs/frontend/src/App.js`
- [Login and session](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/frontend/src/context/AuthContext.js): `Company-Related-Projects/CustodyGuard/demccs/frontend/src/context/AuthContext.js`
- [API client](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/frontend/src/utils/api.js): `Company-Related-Projects/CustodyGuard/demccs/frontend/src/utils/api.js`
- [Case management](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/frontend/src/pages/CaseDetail.js): `Company-Related-Projects/CustodyGuard/demccs/frontend/src/pages/CaseDetail.js`
- [Case routes](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/backend/routers/cases.py): `Company-Related-Projects/CustodyGuard/demccs/backend/routers/cases.py`
- [Evidence routes](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/backend/routers/evidence.py): `Company-Related-Projects/CustodyGuard/demccs/backend/routers/evidence.py`
- [Audit routes](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/backend/routers/audit.py): `Company-Related-Projects/CustodyGuard/demccs/backend/routers/audit.py`
- [Authentication routes](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/backend/routers/auth.py): `Company-Related-Projects/CustodyGuard/demccs/backend/routers/auth.py`
- [Token and password logic](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/backend/auth_utils.py): `Company-Related-Projects/CustodyGuard/demccs/backend/auth_utils.py`
- [Database access](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/backend/database.py): `Company-Related-Projects/CustodyGuard/demccs/backend/database.py`
- [Custody database](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/backend/demccs.db): `Company-Related-Projects/CustodyGuard/demccs/backend/demccs.db`
- [API application](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/CustodyGuard/demccs/backend/main.py): `Company-Related-Projects/CustodyGuard/demccs/backend/main.py`

### Forensic Platform

- [Evidence ingestion](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/forensic-evidence-platform/core/evidence_ingest.py): `Company-Related-Projects/forensic-evidence-platform/core/evidence_ingest.py`
- [SHA-256 calculation](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/forensic-evidence-platform/crypto/hash_utils.py): `Company-Related-Projects/forensic-evidence-platform/crypto/hash_utils.py`
- [Integrity verification](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/forensic-evidence-platform/core/integrity_verify.py): `Company-Related-Projects/forensic-evidence-platform/core/integrity_verify.py`
- [Evidence access](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/forensic-evidence-platform/core/evidence_access.py): `Company-Related-Projects/forensic-evidence-platform/core/evidence_access.py`
- [Custody logging](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/forensic-evidence-platform/custody/custody_log.py): `Company-Related-Projects/forensic-evidence-platform/custody/custody_log.py`
- [Evidence storage](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/forensic-evidence-platform/storage/evidence_store.py): `Company-Related-Projects/forensic-evidence-platform/storage/evidence_store.py`
- [Forensic reporting](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Company-Related-Projects/forensic-evidence-platform/reports/forensic_report.py): `Company-Related-Projects/forensic-evidence-platform/reports/forensic_report.py`

### Security Labs

- [Wazuh detection lab](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/wazuh-soc-detection-lab/README.md): `wazuh-soc-detection-lab/README.md`
- [Zeus malware hunt](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Cybersecurity-SOC/Zeus-Malware-Hunt-Lab/README.md): `Cybersecurity-SOC/Zeus-Malware-Hunt-Lab/README.md`
- [Cowrie honeypot lab](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Cowrie-Honeypot-Lab/README.md): `Cowrie-Honeypot-Lab/README.md`

### Investigation Toolkit

- [Digital evidence toolkit](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Cyber-Crime-Digital-Forensics/Digital-Evidence-Toolkit/README.md): `Cyber-Crime-Digital-Forensics/Digital-Evidence-Toolkit/README.md`
- [Cyber intelligence toolkit](https://github.com/sudheer-infosec/sudheer-portfolio-website/blob/main/Cybersecurity-SOC/Cyber-Intelligence-Toolkit/README.md): `Cybersecurity-SOC/Cyber-Intelligence-Toolkit/README.md`

### Other components

- **Portfolio visitor**
- **Investigator**

## Connections

- Portfolio visitor → Portfolio website: browses (evidence: `README.md`)
- Portfolio website → Portfolio page: renders
- Investigator → CustodyGuard UI: uses
- CustodyGuard UI → Login and session: provides session (evidence: `Company-Related-Projects/CustodyGuard/demccs/frontend/src/App.js`)
- Login and session → API client: calls (evidence: `Company-Related-Projects/CustodyGuard/demccs/frontend/src/context/AuthContext.js`)
- Case management → API client: calls (evidence: `Company-Related-Projects/CustodyGuard/demccs/frontend/src/pages/CaseDetail.js`)
- Case management → Case routes: requests cases (evidence: `Company-Related-Projects/CustodyGuard/demccs/frontend/src/pages/CaseDetail.js`)
- Case management → Evidence routes: uploads and lists (evidence: `Company-Related-Projects/CustodyGuard/demccs/frontend/src/pages/CaseDetail.js`)
- Case management → Audit routes: requests logs (evidence: `Company-Related-Projects/CustodyGuard/demccs/frontend/src/pages/CaseDetail.js`)
- API application → Authentication routes: registers routes (evidence: `Company-Related-Projects/CustodyGuard/demccs/backend/main.py`)
- API application → Case routes: registers routes (evidence: `Company-Related-Projects/CustodyGuard/demccs/backend/main.py`)
- API application → Evidence routes: registers routes (evidence: `Company-Related-Projects/CustodyGuard/demccs/backend/main.py`)
- API application → Audit routes: registers routes (evidence: `Company-Related-Projects/CustodyGuard/demccs/backend/main.py`)
- Authentication routes → Token and password logic: uses (evidence: `Company-Related-Projects/CustodyGuard/demccs/backend/routers/auth.py`)
- Authentication routes → Database access: opens sessions (evidence: `Company-Related-Projects/CustodyGuard/demccs/backend/routers/auth.py`)
- Case routes → Database access: opens sessions (evidence: `Company-Related-Projects/CustodyGuard/demccs/backend/routers/cases.py`)
- Evidence routes → Database access: opens sessions (evidence: `Company-Related-Projects/CustodyGuard/demccs/backend/routers/evidence.py`)
- Database access → Custody database: connects
- Evidence ingestion → SHA-256 calculation: calculates hash (evidence: `Company-Related-Projects/forensic-evidence-platform/core/evidence_ingest.py`)
