# prashantjaybhaye/sih26149-aegis architecture

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

- Interactive diagram: https://gitdiagram.com/prashantjaybhaye/sih26149-aegis
- Repository: https://github.com/prashantjaybhaye/sih26149-aegis

## Overview

AEGIS is a desktop digital-forensics platform combining storage sanitization, selective file shredding, raw-sector recovery, and audit records. Users enter through the GUI or CLI, select a device or recovery task, and receive wiped media or recovered evidence with reporting and audit capabilities. The graph reflects documented module references and README capabilities; several detailed UI and CLI action paths are not fully shown in the excerpts, so those interactions are not expanded beyond evidenced links.

Main entry points: [`src/main/java/com/aegis/ui/AegisApp.java`](https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/ui/AegisApp.java) (Forensics dashboard), [`src/main/java/com/aegis/carver/FileCarver.java`](https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/carver/FileCarver.java) (Raw-sector carver), [`src/main/java/com/aegis/audit/ReportGenerator.java`](https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/audit/ReportGenerator.java) (PDF certificates), [`src/main/java/com/aegis/eraser/DriveEraser.java`](https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/eraser/DriveEraser.java) (Drive eraser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_main["CLI entry<br/>[Main.java]"]
  node_gui["Desktop launcher<br/>[GuiLauncher.java]"]
  node_app["Forensics dashboard<br/>[AegisApp.java]"]
  node_dialogs["Safety dialogs<br/>[AegisDialogs.java]"]
  node_components["UI components"]
  node_resize["Window resizing<br/>[ResizeHelper.java]"]
end

subgraph group_sanitize["Sanitization"]
  node_detector["Storage detection"]
  node_drive["Drive eraser<br/>[DriveEraser.java]"]
  node_fileeraser["File and slack eraser<br/>[FileEraser.java]"]
end

subgraph group_recovery["Forensic recovery"]
  node_carver["Raw-sector carver<br/>[FileCarver.java]"]
  node_signatures["File signatures<br/>[FileSignature.java]"]
  node_carved["Recovered evidence model<br/>[CarvedFile.java]"]
end

subgraph group_audit["Audit and evidence"]
  node_report["PDF certificates"]
  node_blockchain[("Audit ledger")]
end

subgraph group_foundation["Shared foundations"]
  node_device["Device model<br/>[StorageDevice.java]"]
  node_standard["Wipe standards"]
  node_entropy["Entropy calculator"]
  node_hash["SHA-256 utility<br/>[HashUtil.java]"]
  node_format["Formatting utility<br/>[FormatUtil.java]"]
end

node_user(("Investigator"))

node_user -->|"starts CLI"| node_main
node_user -->|"starts GUI"| node_gui
node_main -->|"launches"| node_gui
node_gui -->|"launches"| node_app
node_app -->|"uses"| node_dialogs
node_app -->|"uses"| node_components
node_app -->|"uses"| node_resize
node_app -->|"requests devices"| node_detector
node_detector -->|"creates devices"| node_device
node_app -->|"invokes wiping"| node_drive
node_app -->|"invokes shredding"| node_fileeraser
node_drive -->|"reads device metadata"| node_device
node_drive -->|"uses wipe profile"| node_standard
node_drive -->|"delegates file wiping"| node_fileeraser
node_fileeraser -->|"uses wipe profile"| node_standard
node_app -->|"invokes recovery"| node_carver
node_carver -->|"matches signatures"| node_signatures
node_carver -->|"records recovered files"| node_carved
node_carver -->|"calculates entropy"| node_entropy
node_carver -->|"hashes evidence"| node_hash
node_app -->|"requests certificates"| node_report
node_app -->|"records operations"| node_blockchain
node_main -->|"generates certificate"| node_report
node_report -->|"reports evidence"| node_carved
node_report -->|"reports device"| node_device
node_report -->|"reports standard"| node_standard
node_blockchain -->|"hashes ledger"| node_hash
node_blockchain -->|"formats ledger data"| node_format
node_carved -->|"formats size"| node_format
node_device -->|"formats capacity"| node_format

click node_main "https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/Main.java"
click node_gui "https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/ui/GuiLauncher.java"
click node_app "https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/ui/AegisApp.java"
click node_dialogs "https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/ui/AegisDialogs.java"
click node_components "https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/ui/AegisUiComponents.java"
click node_resize "https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/ui/ResizeHelper.java"
click node_detector "https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/nativeio/StorageDetector.java"
click node_device "https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/model/StorageDevice.java"
click node_standard "https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/model/SanitizationStandard.java"
click node_drive "https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/eraser/DriveEraser.java"
click node_fileeraser "https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/eraser/FileEraser.java"
click node_carver "https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/carver/FileCarver.java"
click node_signatures "https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/carver/FileSignature.java"
click node_carved "https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/model/CarvedFile.java"
click node_entropy "https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/util/EntropyCalculator.java"
click node_hash "https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/util/HashUtil.java"
click node_format "https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/util/FormatUtil.java"
click node_report "https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/audit/ReportGenerator.java"
click node_blockchain "https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/blockchain/AuditBlockchain.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_main,node_gui,node_app,node_dialogs,node_components,node_resize toneBlue
class node_detector,node_drive,node_fileeraser toneAmber
class node_carver,node_signatures,node_carved toneMint
class node_report,node_blockchain toneRose
class node_device,node_standard,node_entropy,node_hash,node_format,node_user toneIndigo
```

## Components

### Application entry

- [CLI entry](https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/Main.java): `src/main/java/com/aegis/Main.java`
- [Desktop launcher](https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/ui/GuiLauncher.java): `src/main/java/com/aegis/ui/GuiLauncher.java`
- [Forensics dashboard](https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/ui/AegisApp.java): `src/main/java/com/aegis/ui/AegisApp.java`
- [Safety dialogs](https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/ui/AegisDialogs.java): `src/main/java/com/aegis/ui/AegisDialogs.java`
- [UI components](https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/ui/AegisUiComponents.java): `src/main/java/com/aegis/ui/AegisUiComponents.java`
- [Window resizing](https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/ui/ResizeHelper.java): `src/main/java/com/aegis/ui/ResizeHelper.java`

### Sanitization

- [Storage detection](https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/nativeio/StorageDetector.java): `src/main/java/com/aegis/nativeio/StorageDetector.java`
- [Drive eraser](https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/eraser/DriveEraser.java): `src/main/java/com/aegis/eraser/DriveEraser.java`
- [File and slack eraser](https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/eraser/FileEraser.java): `src/main/java/com/aegis/eraser/FileEraser.java`

### Forensic recovery

- [Raw-sector carver](https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/carver/FileCarver.java): `src/main/java/com/aegis/carver/FileCarver.java`
- [File signatures](https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/carver/FileSignature.java): `src/main/java/com/aegis/carver/FileSignature.java`
- [Recovered evidence model](https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/model/CarvedFile.java): `src/main/java/com/aegis/model/CarvedFile.java`

### Audit and evidence

- [PDF certificates](https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/audit/ReportGenerator.java): `src/main/java/com/aegis/audit/ReportGenerator.java`
- [Audit ledger](https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/blockchain/AuditBlockchain.java): `src/main/java/com/aegis/blockchain/AuditBlockchain.java`

### Shared foundations

- [Device model](https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/model/StorageDevice.java): `src/main/java/com/aegis/model/StorageDevice.java`
- [Wipe standards](https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/model/SanitizationStandard.java): `src/main/java/com/aegis/model/SanitizationStandard.java`
- [Entropy calculator](https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/util/EntropyCalculator.java): `src/main/java/com/aegis/util/EntropyCalculator.java`
- [SHA-256 utility](https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/util/HashUtil.java): `src/main/java/com/aegis/util/HashUtil.java`
- [Formatting utility](https://github.com/prashantjaybhaye/sih26149-aegis/blob/main/src/main/java/com/aegis/util/FormatUtil.java): `src/main/java/com/aegis/util/FormatUtil.java`

### Other components

- **Investigator**

## Connections

- Investigator → CLI entry: starts CLI (evidence: `README.md`)
- Investigator → Desktop launcher: starts GUI (evidence: `README.md`)
- CLI entry → Desktop launcher: launches (evidence: `src/main/java/com/aegis/Main.java`)
- Desktop launcher → Forensics dashboard: launches (evidence: `src/main/java/com/aegis/ui/GuiLauncher.java`)
- Forensics dashboard → Safety dialogs: uses (evidence: `src/main/java/com/aegis/ui/AegisApp.java`)
- Forensics dashboard → UI components: uses (evidence: `src/main/java/com/aegis/ui/AegisApp.java`)
- Forensics dashboard → Window resizing: uses (evidence: `src/main/java/com/aegis/ui/AegisApp.java`)
- Forensics dashboard → Storage detection: requests devices (evidence: `src/main/java/com/aegis/ui/AegisApp.java`)
- Storage detection → Device model: creates devices (evidence: `src/main/java/com/aegis/nativeio/StorageDetector.java`)
- Forensics dashboard → Drive eraser: invokes wiping (evidence: `src/main/java/com/aegis/ui/AegisApp.java`)
- Forensics dashboard → File and slack eraser: invokes shredding (evidence: `src/main/java/com/aegis/ui/AegisApp.java`)
- Drive eraser → Device model: reads device metadata (evidence: `src/main/java/com/aegis/eraser/DriveEraser.java`)
- Drive eraser → Wipe standards: uses wipe profile (evidence: `src/main/java/com/aegis/eraser/DriveEraser.java`)
- Drive eraser → File and slack eraser: delegates file wiping (evidence: `src/main/java/com/aegis/eraser/DriveEraser.java`)
- File and slack eraser → Wipe standards: uses wipe profile (evidence: `src/main/java/com/aegis/eraser/FileEraser.java`)
- Forensics dashboard → Raw-sector carver: invokes recovery (evidence: `src/main/java/com/aegis/ui/AegisApp.java`)
- Raw-sector carver → File signatures: matches signatures (evidence: `src/main/java/com/aegis/carver/FileCarver.java`)
- Raw-sector carver → Recovered evidence model: records recovered files (evidence: `src/main/java/com/aegis/carver/FileCarver.java`)
- Raw-sector carver → Entropy calculator: calculates entropy (evidence: `src/main/java/com/aegis/carver/FileCarver.java`)
- Raw-sector carver → SHA-256 utility: hashes evidence (evidence: `src/main/java/com/aegis/carver/FileCarver.java`)
- Forensics dashboard → PDF certificates: requests certificates (evidence: `src/main/java/com/aegis/ui/AegisApp.java`)
- Forensics dashboard → Audit ledger: records operations (evidence: `src/main/java/com/aegis/ui/AegisApp.java`)
- CLI entry → PDF certificates: generates certificate (evidence: `src/main/java/com/aegis/Main.java`)
- PDF certificates → Recovered evidence model: reports evidence (evidence: `src/main/java/com/aegis/audit/ReportGenerator.java`)
- PDF certificates → Device model: reports device (evidence: `src/main/java/com/aegis/audit/ReportGenerator.java`)
- PDF certificates → Wipe standards: reports standard (evidence: `src/main/java/com/aegis/audit/ReportGenerator.java`)
- Audit ledger → SHA-256 utility: hashes ledger (evidence: `src/main/java/com/aegis/blockchain/AuditBlockchain.java`)
- Audit ledger → Formatting utility: formats ledger data (evidence: `src/main/java/com/aegis/blockchain/AuditBlockchain.java`)
- Recovered evidence model → Formatting utility: formats size (evidence: `src/main/java/com/aegis/model/CarvedFile.java`)
- Device model → Formatting utility: formats capacity (evidence: `src/main/java/com/aegis/model/StorageDevice.java`)
