# atb4k/cybersecurity-portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/atb4k/cybersecurity-portfolio
- Repository: https://github.com/atb4k/cybersecurity-portfolio

## Overview

This is a static cybersecurity portfolio presenting practical projects. Its visitor-facing purpose is to let readers discover security work and inspect project material; the tree shows two project areas, while the top-level README only states the portfolio’s broad subject. The sampled scanner implements a separate project workflow: validate an authorized scope, probe ports, optionally verify open results, and produce a JSON report. Project-page contents and site wiring were not sampled, so those relationships are shown only as unverified links where the tree suggests them.

Main entry points: [`projects/scapy-tcp-syn-scanner/src/scanner.py`](https://github.com/atb4k/cybersecurity-portfolio/blob/main/projects/scapy-tcp-syn-scanner/src/scanner.py) (CLI and orchestration), [`index.html`](https://github.com/atb4k/cybersecurity-portfolio/blob/main/index.html) (Portfolio home), [`projects-overview.html`](https://github.com/atb4k/cybersecurity-portfolio/blob/main/projects-overview.html) (Projects overview), [`projects/enterprise-network-security/README.md`](https://github.com/atb4k/cybersecurity-portfolio/blob/main/projects/enterprise-network-security/README.md) (Enterprise security)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portfolio["Portfolio site"]
  node_portfolio_home["Portfolio home<br/>[index.html]"]
  node_portfolio_content["Portfolio content<br/>[index.md]"]
  node_project_overview["Projects overview"]
end

subgraph group_projects["Project showcases"]
  node_enterprise_project["Enterprise security<br/>[README.md]"]
  node_scanner_project["Scanner showcase<br/>[README.md]"]
  node_scan_evidence["Scan evidence<br/>[RESULTS_SUMMARY.md]"]
  node_enterprise_evidence["Enterprise evidence"]
end

subgraph group_scanner["SYN scanner"]
  node_scanner_cli["CLI and orchestration<br/>[scanner.py]"]
  node_scope_validation["Scope validation<br/>[scanner.py]"]
  node_probe_classification["Probe and classify<br/>[scanner.py]"]
  node_open_verification["Open-port verification<br/>[scanner.py]"]
  node_report_generation["Report generation<br/>[scanner.py]"]
  node_json_output["JSON report output<br/>[scanner.py]"]
end

node_visitor(("Portfolio visitor"))

node_visitor -.->|"visits"| node_portfolio_home
node_portfolio_home -.->|"presents"| node_portfolio_content
node_portfolio_home -.->|"offers browsing"| node_project_overview
node_project_overview -.->|"links to"| node_enterprise_project
node_project_overview -.->|"links to"| node_scanner_project
node_scanner_project -.->|"documents results"| node_scan_evidence
node_enterprise_project -.->|"documents evidence"| node_enterprise_evidence
node_scanner_cli -->|"validates scope"| node_scope_validation
node_scanner_cli -->|"runs scan"| node_probe_classification
node_scanner_cli -->|"optionally verifies"| node_open_verification
node_scanner_cli -->|"builds report"| node_report_generation
node_scanner_cli -->|"saves report"| node_json_output

click node_portfolio_home "https://github.com/atb4k/cybersecurity-portfolio/blob/main/index.html"
click node_portfolio_content "https://github.com/atb4k/cybersecurity-portfolio/blob/main/index.md"
click node_project_overview "https://github.com/atb4k/cybersecurity-portfolio/blob/main/projects-overview.html"
click node_enterprise_project "https://github.com/atb4k/cybersecurity-portfolio/blob/main/projects/enterprise-network-security/README.md"
click node_scanner_project "https://github.com/atb4k/cybersecurity-portfolio/blob/main/projects/scapy-tcp-syn-scanner/README.md"
click node_scanner_cli "https://github.com/atb4k/cybersecurity-portfolio/blob/main/projects/scapy-tcp-syn-scanner/src/scanner.py"
click node_scope_validation "https://github.com/atb4k/cybersecurity-portfolio/blob/main/projects/scapy-tcp-syn-scanner/src/scanner.py"
click node_probe_classification "https://github.com/atb4k/cybersecurity-portfolio/blob/main/projects/scapy-tcp-syn-scanner/src/scanner.py"
click node_open_verification "https://github.com/atb4k/cybersecurity-portfolio/blob/main/projects/scapy-tcp-syn-scanner/src/scanner.py"
click node_report_generation "https://github.com/atb4k/cybersecurity-portfolio/blob/main/projects/scapy-tcp-syn-scanner/src/scanner.py"
click node_json_output "https://github.com/atb4k/cybersecurity-portfolio/blob/main/projects/scapy-tcp-syn-scanner/src/scanner.py"
click node_scan_evidence "https://github.com/atb4k/cybersecurity-portfolio/blob/main/projects/scapy-tcp-syn-scanner/evidence/docker-workbench/RESULTS_SUMMARY.md"
click node_enterprise_evidence "https://github.com/atb4k/cybersecurity-portfolio/tree/main/projects/enterprise-network-security/evidence"

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_home,node_portfolio_content,node_project_overview toneBlue
class node_enterprise_project,node_scanner_project,node_scan_evidence,node_enterprise_evidence toneAmber
class node_scanner_cli,node_scope_validation,node_probe_classification,node_open_verification,node_report_generation,node_json_output toneMint
class node_visitor toneIndigo
```

## Components

### Portfolio site

- [Portfolio home](https://github.com/atb4k/cybersecurity-portfolio/blob/main/index.html): `index.html`
- [Portfolio content](https://github.com/atb4k/cybersecurity-portfolio/blob/main/index.md): `index.md`
- [Projects overview](https://github.com/atb4k/cybersecurity-portfolio/blob/main/projects-overview.html): `projects-overview.html`

### Project showcases

- [Enterprise security](https://github.com/atb4k/cybersecurity-portfolio/blob/main/projects/enterprise-network-security/README.md): `projects/enterprise-network-security/README.md`
- [Scanner showcase](https://github.com/atb4k/cybersecurity-portfolio/blob/main/projects/scapy-tcp-syn-scanner/README.md): `projects/scapy-tcp-syn-scanner/README.md`
- [Scan evidence](https://github.com/atb4k/cybersecurity-portfolio/blob/main/projects/scapy-tcp-syn-scanner/evidence/docker-workbench/RESULTS_SUMMARY.md): `projects/scapy-tcp-syn-scanner/evidence/docker-workbench/RESULTS_SUMMARY.md`
- [Enterprise evidence](https://github.com/atb4k/cybersecurity-portfolio/tree/main/projects/enterprise-network-security/evidence): `projects/enterprise-network-security/evidence`

### SYN scanner

- [CLI and orchestration](https://github.com/atb4k/cybersecurity-portfolio/blob/main/projects/scapy-tcp-syn-scanner/src/scanner.py): `projects/scapy-tcp-syn-scanner/src/scanner.py`
- [Scope validation](https://github.com/atb4k/cybersecurity-portfolio/blob/main/projects/scapy-tcp-syn-scanner/src/scanner.py): `projects/scapy-tcp-syn-scanner/src/scanner.py`
- [Probe and classify](https://github.com/atb4k/cybersecurity-portfolio/blob/main/projects/scapy-tcp-syn-scanner/src/scanner.py): `projects/scapy-tcp-syn-scanner/src/scanner.py`
- [Open-port verification](https://github.com/atb4k/cybersecurity-portfolio/blob/main/projects/scapy-tcp-syn-scanner/src/scanner.py): `projects/scapy-tcp-syn-scanner/src/scanner.py`
- [Report generation](https://github.com/atb4k/cybersecurity-portfolio/blob/main/projects/scapy-tcp-syn-scanner/src/scanner.py): `projects/scapy-tcp-syn-scanner/src/scanner.py`
- [JSON report output](https://github.com/atb4k/cybersecurity-portfolio/blob/main/projects/scapy-tcp-syn-scanner/src/scanner.py): `projects/scapy-tcp-syn-scanner/src/scanner.py`

### Other components

- **Portfolio visitor**

## Connections

- Portfolio visitor → Portfolio home: visits
- Portfolio home → Portfolio content: presents
- Portfolio home → Projects overview: offers browsing
- Projects overview → Enterprise security: links to
- Projects overview → Scanner showcase: links to
- Scanner showcase → Scan evidence: documents results
- Enterprise security → Enterprise evidence: documents evidence
- CLI and orchestration → Scope validation: validates scope (evidence: `projects/scapy-tcp-syn-scanner/src/scanner.py`)
- CLI and orchestration → Probe and classify: runs scan (evidence: `projects/scapy-tcp-syn-scanner/src/scanner.py`)
- CLI and orchestration → Open-port verification: optionally verifies (evidence: `projects/scapy-tcp-syn-scanner/src/scanner.py`)
- CLI and orchestration → Report generation: builds report (evidence: `projects/scapy-tcp-syn-scanner/src/scanner.py`)
- CLI and orchestration → JSON report output: saves report (evidence: `projects/scapy-tcp-syn-scanner/src/scanner.py`)
