# kai0sama28/dae-6-month-project-files architecture

> Architecture diagram of the GitHub repository kai0sama28/dae-6-month-project-files, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kai0sama28/dae-6-month-project-files
- Repository: https://github.com/kai0sama28/dae-6-month-project-files

## Overview

This repository is a professional portfolio and project workspace; its main visitor workflow is browsing the portfolio’s landing page, background, projects, and contact information. A substantial featured project is the AI-agentic SOC investigation engine, which brings together Wazuh alerts and identity/endpoint evidence. Sampled code supports evidence gathering and the API integrations, but not the engine’s complete alert-to-verdict orchestration or persistence wiring, so those links are omitted. The wider workspace also contains coursework and project artifacts, which are not runtime components.

Main entry points: [`docs/index.md`](https://github.com/kai0sama28/dae-6-month-project-files/blob/main/docs/index.md) (Landing page), [`ai-agentic-soc/investigation/evidence.py`](https://github.com/kai0sama28/dae-6-month-project-files/blob/main/ai-agentic-soc/investigation/evidence.py) (Evidence gathering), [`docs/projects.md`](https://github.com/kai0sama28/dae-6-month-project-files/blob/main/docs/projects.md) (Projects), [`ai-agentic-soc/apis/clients.py`](https://github.com/kai0sama28/dae-6-month-project-files/blob/main/ai-agentic-soc/apis/clients.py) (Identity client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portfolio["Portfolio Site"]
  node_landing["Landing page<br/>[index.md]"]
  node_about["About<br/>[about.md]"]
  node_projects["Projects<br/>[projects.md]"]
  node_contact["Contact<br/>[contact.md]"]
  node_soc_project["SOC triage project"]
end

subgraph group_investigation["SOC Investigation"]
  node_alert_model["Alert model<br/>[alert.py]"]
  node_evidence["Evidence gathering<br/>[evidence.py]"]
end

subgraph group_integrations["Telemetry Integrations"]
  node_wazuh_client["Wazuh client<br/>[client.py]"]
  node_identity_client["Identity client<br/>[clients.py]"]
  node_identity_api["Identity API<br/>[app.py]"]
  node_identity_store[("Identity data<br/>[db.py]")]
  node_edr_client["EDR client<br/>[clients.py]"]
  node_edr_api["EDR API<br/>[app.py]"]
  node_edr_store[("EDR data<br/>[db.py]")]
end

subgraph group_state["Investigation State"]
  node_investigation_store[("Investigation records<br/>[engine.py]")]
end

node_visitor(("Portfolio visitor"))
node_wazuh{{"Wazuh API"}}

node_visitor -->|"opens"| node_landing
node_landing -->|"links to"| node_about
node_landing -->|"links to"| node_projects
node_landing -->|"links to"| node_contact
node_projects -->|"showcases"| node_soc_project
node_wazuh_client -->|"queries alerts"| node_wazuh
node_evidence -->|"queries identity"| node_identity_client
node_evidence -->|"queries endpoint"| node_edr_client
node_identity_client -->|"requests data"| node_identity_api
node_identity_api -->|"reads and writes"| node_identity_store
node_edr_client -->|"requests telemetry"| node_edr_api
node_edr_api -->|"reads data"| node_edr_store

click node_landing "https://github.com/kai0sama28/dae-6-month-project-files/blob/main/docs/index.md"
click node_about "https://github.com/kai0sama28/dae-6-month-project-files/blob/main/docs/about.md"
click node_projects "https://github.com/kai0sama28/dae-6-month-project-files/blob/main/docs/projects.md"
click node_contact "https://github.com/kai0sama28/dae-6-month-project-files/blob/main/docs/contact.md"
click node_soc_project "https://github.com/kai0sama28/dae-6-month-project-files/tree/main/Semester2/Project%20Ideas%20Security%20Analyst"
click node_alert_model "https://github.com/kai0sama28/dae-6-month-project-files/blob/main/ai-agentic-soc/schemas/alert.py"
click node_evidence "https://github.com/kai0sama28/dae-6-month-project-files/blob/main/ai-agentic-soc/investigation/evidence.py"
click node_wazuh_client "https://github.com/kai0sama28/dae-6-month-project-files/blob/main/ai-agentic-soc/siem/client.py"
click node_identity_client "https://github.com/kai0sama28/dae-6-month-project-files/blob/main/ai-agentic-soc/apis/clients.py"
click node_identity_api "https://github.com/kai0sama28/dae-6-month-project-files/blob/main/ai-agentic-soc/apis/identity/app.py"
click node_identity_store "https://github.com/kai0sama28/dae-6-month-project-files/blob/main/ai-agentic-soc/apis/identity/db.py"
click node_edr_client "https://github.com/kai0sama28/dae-6-month-project-files/blob/main/ai-agentic-soc/apis/clients.py"
click node_edr_api "https://github.com/kai0sama28/dae-6-month-project-files/blob/main/ai-agentic-soc/apis/edr/app.py"
click node_edr_store "https://github.com/kai0sama28/dae-6-month-project-files/blob/main/ai-agentic-soc/apis/edr/db.py"
click node_investigation_store "https://github.com/kai0sama28/dae-6-month-project-files/blob/main/ai-agentic-soc/database/engine.py"

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_landing,node_about,node_projects,node_contact,node_soc_project toneBlue
class node_alert_model,node_evidence toneAmber
class node_wazuh_client,node_identity_client,node_identity_api,node_identity_store,node_edr_client,node_edr_api,node_edr_store,node_wazuh toneMint
class node_investigation_store toneRose
class node_visitor toneIndigo
```

## Components

### Portfolio Site

- [Landing page](https://github.com/kai0sama28/dae-6-month-project-files/blob/main/docs/index.md): `docs/index.md`
- [About](https://github.com/kai0sama28/dae-6-month-project-files/blob/main/docs/about.md): `docs/about.md`
- [Projects](https://github.com/kai0sama28/dae-6-month-project-files/blob/main/docs/projects.md): `docs/projects.md`
- [Contact](https://github.com/kai0sama28/dae-6-month-project-files/blob/main/docs/contact.md): `docs/contact.md`
- [SOC triage project](https://github.com/kai0sama28/dae-6-month-project-files/tree/main/Semester2/Project%20Ideas%20Security%20Analyst): `Semester2/Project Ideas Security Analyst`

### SOC Investigation

- [Alert model](https://github.com/kai0sama28/dae-6-month-project-files/blob/main/ai-agentic-soc/schemas/alert.py): `ai-agentic-soc/schemas/alert.py`
- [Evidence gathering](https://github.com/kai0sama28/dae-6-month-project-files/blob/main/ai-agentic-soc/investigation/evidence.py): `ai-agentic-soc/investigation/evidence.py`

### Telemetry Integrations

- [Wazuh client](https://github.com/kai0sama28/dae-6-month-project-files/blob/main/ai-agentic-soc/siem/client.py): `ai-agentic-soc/siem/client.py`
- [Identity client](https://github.com/kai0sama28/dae-6-month-project-files/blob/main/ai-agentic-soc/apis/clients.py): `ai-agentic-soc/apis/clients.py`
- [Identity API](https://github.com/kai0sama28/dae-6-month-project-files/blob/main/ai-agentic-soc/apis/identity/app.py): `ai-agentic-soc/apis/identity/app.py`
- [Identity data](https://github.com/kai0sama28/dae-6-month-project-files/blob/main/ai-agentic-soc/apis/identity/db.py): `ai-agentic-soc/apis/identity/db.py`
- [EDR client](https://github.com/kai0sama28/dae-6-month-project-files/blob/main/ai-agentic-soc/apis/clients.py): `ai-agentic-soc/apis/clients.py`
- [EDR API](https://github.com/kai0sama28/dae-6-month-project-files/blob/main/ai-agentic-soc/apis/edr/app.py): `ai-agentic-soc/apis/edr/app.py`
- [EDR data](https://github.com/kai0sama28/dae-6-month-project-files/blob/main/ai-agentic-soc/apis/edr/db.py): `ai-agentic-soc/apis/edr/db.py`

### Investigation State

- [Investigation records](https://github.com/kai0sama28/dae-6-month-project-files/blob/main/ai-agentic-soc/database/engine.py): `ai-agentic-soc/database/engine.py`

### Other components

- **Portfolio visitor**
- **Wazuh API**

## Connections

- Portfolio visitor → Landing page: opens
- Landing page → About: links to
- Landing page → Projects: links to
- Landing page → Contact: links to
- Projects → SOC triage project: showcases
- Wazuh client → Wazuh API: queries alerts
- Evidence gathering → Identity client: queries identity
- Evidence gathering → EDR client: queries endpoint
- Identity client → Identity API: requests data
- Identity API → Identity data: reads and writes
- EDR client → EDR API: requests telemetry
- EDR API → EDR data: reads data