# falloutfanaticc/java-project architecture

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

- Interactive diagram: https://gitdiagram.com/falloutfanaticc/java-project
- Repository: https://github.com/falloutfanaticc/java-project

## Overview

Cyber Defense Analyzer is a local defensive log-analysis application with CLI and optional desktop entry points. Both ingest and validate CSV events, apply deterministic threat rules, then format prioritized, filterable reports; the CLI saves automatically, while the GUI displays results and lets users choose when to save. The graph follows the orchestration visible in the excerpts and README. It does not infer additional connections from unsampled files or treat the sample dataset as the only possible input.

Main entry points: [`src/main/java/cyberdefense/Main.java`](https://github.com/falloutfanaticc/java-project/blob/main/src/main/java/cyberdefense/Main.java) (CLI Coordinator), [`src/main/java/cyberdefense/SecurityReport.java`](https://github.com/falloutfanaticc/java-project/blob/main/src/main/java/cyberdefense/SecurityReport.java) (Report Formatter), [`src/main/java/cyberdefense/CyberDefenseGui.java`](https://github.com/falloutfanaticc/java-project/blob/main/src/main/java/cyberdefense/CyberDefenseGui.java) (Desktop GUI), [`src/main/java/cyberdefense/LogReader.java`](https://github.com/falloutfanaticc/java-project/blob/main/src/main/java/cyberdefense/LogReader.java) (CSV Reader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User Interfaces"]
  node_cli["CLI Coordinator<br/>[Main.java]"]
  node_gui["Desktop GUI"]
end

subgraph group_ingestion["Log Ingestion"]
  node_sample["Sample CSV<br/>[sample_events.csv]"]
  node_reader["CSV Reader<br/>[LogReader.java]"]
  node_event["Validated Event<br/>[LogEvent.java]"]
end

subgraph group_analysis["Threat Analysis"]
  node_analyzer["Rule Analyzer"]
  node_alert["Prioritized Alerts"]
end

subgraph group_reporting["Reporting"]
  node_report["Report Formatter"]
  node_reportfile["Saved Report"]
end

node_user(("Analyst"))

node_user -->|"runs"| node_cli
node_user -->|"opens"| node_gui
node_cli -->|"loads CSV"| node_reader
node_gui -->|"loads CSV"| node_reader
node_reader -->|"reads default"| node_sample
node_reader -->|"creates"| node_event
node_reader -->|"returns events"| node_cli
node_cli -->|"analyzes events"| node_analyzer
node_gui -->|"analyzes events"| node_analyzer
node_analyzer -->|"evaluates"| node_event
node_analyzer -->|"produces"| node_alert
node_analyzer -->|"returns alerts"| node_cli
node_cli -->|"renders report"| node_report
node_gui -->|"renders report"| node_report
node_report -->|"formats events"| node_event
node_report -->|"filters alerts"| node_alert
node_cli -->|"saves report"| node_report
node_gui -->|"saves report"| node_report
node_report -->|"writes text"| node_reportfile

click node_cli "https://github.com/falloutfanaticc/java-project/blob/main/src/main/java/cyberdefense/Main.java"
click node_gui "https://github.com/falloutfanaticc/java-project/blob/main/src/main/java/cyberdefense/CyberDefenseGui.java"
click node_sample "https://github.com/falloutfanaticc/java-project/blob/main/data/sample_events.csv"
click node_reader "https://github.com/falloutfanaticc/java-project/blob/main/src/main/java/cyberdefense/LogReader.java"
click node_event "https://github.com/falloutfanaticc/java-project/blob/main/src/main/java/cyberdefense/LogEvent.java"
click node_analyzer "https://github.com/falloutfanaticc/java-project/blob/main/src/main/java/cyberdefense/ThreatAnalyzer.java"
click node_alert "https://github.com/falloutfanaticc/java-project/blob/main/src/main/java/cyberdefense/ThreatAnalyzer.java"
click node_report "https://github.com/falloutfanaticc/java-project/blob/main/src/main/java/cyberdefense/SecurityReport.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_cli,node_gui toneBlue
class node_sample,node_reader,node_event toneAmber
class node_analyzer,node_alert toneMint
class node_report,node_reportfile toneRose
class node_user toneIndigo
```

## Components

### User Interfaces

- [CLI Coordinator](https://github.com/falloutfanaticc/java-project/blob/main/src/main/java/cyberdefense/Main.java): `src/main/java/cyberdefense/Main.java`
- [Desktop GUI](https://github.com/falloutfanaticc/java-project/blob/main/src/main/java/cyberdefense/CyberDefenseGui.java): `src/main/java/cyberdefense/CyberDefenseGui.java`

### Log Ingestion

- [Sample CSV](https://github.com/falloutfanaticc/java-project/blob/main/data/sample_events.csv): `data/sample_events.csv`
- [CSV Reader](https://github.com/falloutfanaticc/java-project/blob/main/src/main/java/cyberdefense/LogReader.java): `src/main/java/cyberdefense/LogReader.java`
- [Validated Event](https://github.com/falloutfanaticc/java-project/blob/main/src/main/java/cyberdefense/LogEvent.java): `src/main/java/cyberdefense/LogEvent.java`

### Threat Analysis

- [Rule Analyzer](https://github.com/falloutfanaticc/java-project/blob/main/src/main/java/cyberdefense/ThreatAnalyzer.java): `src/main/java/cyberdefense/ThreatAnalyzer.java`
- [Prioritized Alerts](https://github.com/falloutfanaticc/java-project/blob/main/src/main/java/cyberdefense/ThreatAnalyzer.java): `src/main/java/cyberdefense/ThreatAnalyzer.java`

### Reporting

- [Report Formatter](https://github.com/falloutfanaticc/java-project/blob/main/src/main/java/cyberdefense/SecurityReport.java): `src/main/java/cyberdefense/SecurityReport.java`
- **Saved Report**

### Other components

- **Analyst**

## Connections

- Analyst → CLI Coordinator: runs (evidence: `README.md`)
- Analyst → Desktop GUI: opens (evidence: `README.md`)
- CLI Coordinator → CSV Reader: loads CSV (evidence: `src/main/java/cyberdefense/Main.java`)
- Desktop GUI → CSV Reader: loads CSV (evidence: `src/main/java/cyberdefense/CyberDefenseGui.java`)
- CSV Reader → Sample CSV: reads default (evidence: `README.md`)
- CSV Reader → Validated Event: creates (evidence: `src/main/java/cyberdefense/LogReader.java`)
- CSV Reader → CLI Coordinator: returns events (evidence: `src/main/java/cyberdefense/Main.java`)
- CLI Coordinator → Rule Analyzer: analyzes events (evidence: `src/main/java/cyberdefense/Main.java`)
- Desktop GUI → Rule Analyzer: analyzes events (evidence: `src/main/java/cyberdefense/CyberDefenseGui.java`)
- Rule Analyzer → Validated Event: evaluates (evidence: `src/main/java/cyberdefense/ThreatAnalyzer.java`)
- Rule Analyzer → Prioritized Alerts: produces (evidence: `src/main/java/cyberdefense/ThreatAnalyzer.java`)
- Rule Analyzer → CLI Coordinator: returns alerts (evidence: `src/main/java/cyberdefense/Main.java`)
- CLI Coordinator → Report Formatter: renders report (evidence: `src/main/java/cyberdefense/Main.java`)
- Desktop GUI → Report Formatter: renders report (evidence: `src/main/java/cyberdefense/CyberDefenseGui.java`)
- Report Formatter → Validated Event: formats events (evidence: `src/main/java/cyberdefense/SecurityReport.java`)
- Report Formatter → Prioritized Alerts: filters alerts (evidence: `src/main/java/cyberdefense/SecurityReport.java`)
- CLI Coordinator → Report Formatter: saves report (evidence: `src/main/java/cyberdefense/Main.java`)
- Desktop GUI → Report Formatter: saves report (evidence: `src/main/java/cyberdefense/CyberDefenseGui.java`)
- Report Formatter → Saved Report: writes text (evidence: `src/main/java/cyberdefense/SecurityReport.java`)
