# tarun-suthar-04/project_pixault architecture

> Architecture diagram of the GitHub repository tarun-suthar-04/project_pixault, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tarun-suthar-04/project_pixault
- Repository: https://github.com/tarun-suthar-04/project_pixault

## Overview

Pixault is a JavaFX desktop vault whose main workflow is login and OTP verification, followed by a dashboard for hiding or extracting encrypted image messages, managing one-time shares, settings, and audit history. Authentication binds persisted sessions to a device; the steganography engine handles image payloads, while the share service manages expiring, consumable links. The graph preserves README capabilities and indexed module relationships; some UI wiring and the HTTP share protocol are unsampled, so unverified links are omitted.

Main entry points: [`src/main/java/com/pixault/auth/AuthController.java`](https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/auth/AuthController.java) (Authentication workflows), [`src/main/java/com/pixault/ui/DashboardController.java`](https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/ui/DashboardController.java) (Feature dashboard), [`src/main/java/com/pixault/database`](https://github.com/tarun-suthar-04/project_pixault/tree/main/src/main/java/com/pixault/database) (Database access), [`src/main/java/com/pixault/share/ShareService.java`](https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/share/ShareService.java) (One-time share service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop application"]
  node_main["JavaFX startup<br/>[Main.java]"]
  node_loginui["Login and verification"]
  node_dashboard["Feature dashboard"]
  node_authui["Registration and settings"]
  node_auditui["Audit history"]
end

subgraph group_identity["Identity and security"]
  node_auth["Authentication workflows"]
  node_fingerprint["Device fingerprint"]
  node_sessions["Session management"]
  node_otp["OTP and email<br/>[OTPService.java]"]
  node_email["Email delivery<br/>[EmailService.java]"]
  node_crypto["Cryptography utilities<br/>[CryptoUtils.java]"]
  node_hash["Hashing and signatures<br/>[HashUtils.java]"]
end

subgraph group_vault["Vault features"]
  node_hideui["Hide image message"]
  node_extractui["Extract image message"]
  node_stego["Encrypted steganography<br/>[StegoEngine.java]"]
  node_shareui["Share management"]
  node_shares["One-time share service<br/>[ShareService.java]"]
  node_sharehttp["Share HTTP access"]
end

subgraph group_storage["Persistence"]
  node_models["Vault domain models"]
  node_daos["Database access"]
end

node_user(("Vault user"))
node_mysql[("MySQL database")]

node_user -->|"uses"| node_loginui
node_main -->|"initializes"| node_mysql
node_main -->|"starts server"| node_sharehttp
node_user -.->|"uses"| node_dashboard
node_loginui -->|"authenticates"| node_auth
node_loginui -->|"opens"| node_dashboard
node_authui -->|"invokes"| node_auth
node_auth -->|"reads and writes"| node_daos
node_auth -->|"verifies codes"| node_otp
node_auth -->|"sends OTP"| node_email
node_auth -->|"checks device"| node_fingerprint
node_auth -->|"manages sessions"| node_sessions
node_email -.->|"delivers email"| node_user
node_email -->|"signs tokens"| node_hash
node_sessions -->|"persists sessions"| node_daos
node_sessions -->|"validates signatures"| node_hash
node_dashboard -->|"navigates"| node_hideui
node_dashboard -->|"navigates"| node_extractui
node_dashboard -->|"navigates"| node_shareui
node_dashboard -->|"navigates"| node_auditui
node_hideui -->|"embeds payload"| node_stego
node_extractui -->|"extracts payload"| node_stego
node_stego -->|"encrypts payload"| node_crypto
node_stego -->|"uses hashes"| node_hash
node_shareui -->|"manages links"| node_shares
node_shares -->|"stores share records"| node_daos
node_shares -->|"handles image payloads"| node_stego
node_shares -->|"checks device"| node_fingerprint
node_sharehttp -.->|"serves links"| node_shares
node_auditui -->|"loads audit history"| node_daos
node_daos -->|"queries"| node_mysql
node_daos -->|"maps records"| node_models

click node_main "https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/Main.java"
click node_loginui "https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/ui/LoginController.java"
click node_dashboard "https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/ui/DashboardController.java"
click node_authui "https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/ui/RegisterController.java"
click node_auditui "https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/ui/AuditLogController.java"
click node_auth "https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/auth/AuthController.java"
click node_fingerprint "https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/auth/DeviceFingerprint.java"
click node_sessions "https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/auth/SessionManager.java"
click node_otp "https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/security/OTPService.java"
click node_email "https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/security/EmailService.java"
click node_crypto "https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/security/CryptoUtils.java"
click node_hash "https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/security/HashUtils.java"
click node_hideui "https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/ui/HideDataController.java"
click node_extractui "https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/ui/ExtractDataController.java"
click node_stego "https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/stego/StegoEngine.java"
click node_shareui "https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/ui/ShareController.java"
click node_shares "https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/share/ShareService.java"
click node_sharehttp "https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/share/ShareHttpServer.java"
click node_models "https://github.com/tarun-suthar-04/project_pixault/tree/main/src/main/java/com/pixault/model"
click node_daos "https://github.com/tarun-suthar-04/project_pixault/tree/main/src/main/java/com/pixault/database"

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_loginui,node_dashboard,node_authui,node_auditui,node_user toneBlue
class node_auth,node_fingerprint,node_sessions,node_otp,node_email,node_crypto,node_hash,node_mysql toneAmber
class node_hideui,node_extractui,node_stego,node_shareui,node_shares,node_sharehttp toneMint
class node_models,node_daos toneRose
```

## Components

### Desktop application

- [JavaFX startup](https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/Main.java): `src/main/java/com/pixault/Main.java`
- [Login and verification](https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/ui/LoginController.java): `src/main/java/com/pixault/ui/LoginController.java`
- [Feature dashboard](https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/ui/DashboardController.java): `src/main/java/com/pixault/ui/DashboardController.java`
- [Registration and settings](https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/ui/RegisterController.java): `src/main/java/com/pixault/ui/RegisterController.java`
- [Audit history](https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/ui/AuditLogController.java): `src/main/java/com/pixault/ui/AuditLogController.java`

### Identity and security

- [Authentication workflows](https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/auth/AuthController.java): `src/main/java/com/pixault/auth/AuthController.java`
- [Device fingerprint](https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/auth/DeviceFingerprint.java): `src/main/java/com/pixault/auth/DeviceFingerprint.java`
- [Session management](https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/auth/SessionManager.java): `src/main/java/com/pixault/auth/SessionManager.java`
- [OTP and email](https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/security/OTPService.java): `src/main/java/com/pixault/security/OTPService.java`
- [Email delivery](https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/security/EmailService.java): `src/main/java/com/pixault/security/EmailService.java`
- [Cryptography utilities](https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/security/CryptoUtils.java): `src/main/java/com/pixault/security/CryptoUtils.java`
- [Hashing and signatures](https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/security/HashUtils.java): `src/main/java/com/pixault/security/HashUtils.java`

### Vault features

- [Hide image message](https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/ui/HideDataController.java): `src/main/java/com/pixault/ui/HideDataController.java`
- [Extract image message](https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/ui/ExtractDataController.java): `src/main/java/com/pixault/ui/ExtractDataController.java`
- [Encrypted steganography](https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/stego/StegoEngine.java): `src/main/java/com/pixault/stego/StegoEngine.java`
- [Share management](https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/ui/ShareController.java): `src/main/java/com/pixault/ui/ShareController.java`
- [One-time share service](https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/share/ShareService.java): `src/main/java/com/pixault/share/ShareService.java`
- [Share HTTP access](https://github.com/tarun-suthar-04/project_pixault/blob/main/src/main/java/com/pixault/share/ShareHttpServer.java): `src/main/java/com/pixault/share/ShareHttpServer.java`

### Persistence

- [Vault domain models](https://github.com/tarun-suthar-04/project_pixault/tree/main/src/main/java/com/pixault/model): `src/main/java/com/pixault/model`
- [Database access](https://github.com/tarun-suthar-04/project_pixault/tree/main/src/main/java/com/pixault/database): `src/main/java/com/pixault/database`

### Other components

- **Vault user**
- **MySQL database**

## Connections

- Vault user → Login and verification: uses
- JavaFX startup → MySQL database: initializes (evidence: `src/main/java/com/pixault/Main.java`)
- JavaFX startup → Share HTTP access: starts server (evidence: `src/main/java/com/pixault/Main.java`)
- Vault user → Feature dashboard: uses
- Login and verification → Authentication workflows: authenticates (evidence: `src/main/java/com/pixault/ui/LoginController.java`)
- Login and verification → Feature dashboard: opens (evidence: `src/main/java/com/pixault/ui/LoginController.java`)
- Registration and settings → Authentication workflows: invokes
- Authentication workflows → Database access: reads and writes (evidence: `src/main/java/com/pixault/auth/AuthController.java`)
- Authentication workflows → OTP and email: verifies codes (evidence: `src/main/java/com/pixault/auth/AuthController.java`)
- Authentication workflows → Email delivery: sends OTP (evidence: `src/main/java/com/pixault/auth/AuthController.java`)
- Authentication workflows → Device fingerprint: checks device (evidence: `src/main/java/com/pixault/auth/AuthController.java`)
- Authentication workflows → Session management: manages sessions (evidence: `src/main/java/com/pixault/auth/AuthController.java`)
- Email delivery → Vault user: delivers email
- Email delivery → Hashing and signatures: signs tokens (evidence: `src/main/java/com/pixault/security/EmailService.java`)
- Session management → Database access: persists sessions (evidence: `src/main/java/com/pixault/auth/SessionManager.java`)
- Session management → Hashing and signatures: validates signatures (evidence: `src/main/java/com/pixault/auth/SessionManager.java`)
- Feature dashboard → Hide image message: navigates (evidence: `src/main/java/com/pixault/ui/DashboardController.java`)
- Feature dashboard → Extract image message: navigates (evidence: `src/main/java/com/pixault/ui/DashboardController.java`)
- Feature dashboard → Share management: navigates (evidence: `src/main/java/com/pixault/ui/DashboardController.java`)
- Feature dashboard → Audit history: navigates (evidence: `src/main/java/com/pixault/ui/DashboardController.java`)
- Hide image message → Encrypted steganography: embeds payload (evidence: `src/main/java/com/pixault/ui/HideDataController.java`)
- Extract image message → Encrypted steganography: extracts payload (evidence: `src/main/java/com/pixault/ui/ExtractDataController.java`)
- Encrypted steganography → Cryptography utilities: encrypts payload (evidence: `src/main/java/com/pixault/stego/StegoEngine.java`)
- Encrypted steganography → Hashing and signatures: uses hashes (evidence: `src/main/java/com/pixault/stego/StegoEngine.java`)
- Share management → One-time share service: manages links (evidence: `src/main/java/com/pixault/ui/ShareController.java`)
- One-time share service → Database access: stores share records (evidence: `src/main/java/com/pixault/share/ShareService.java`)
- One-time share service → Encrypted steganography: handles image payloads (evidence: `src/main/java/com/pixault/share/ShareService.java`)
- One-time share service → Device fingerprint: checks device (evidence: `src/main/java/com/pixault/share/ShareService.java`)
- Share HTTP access → One-time share service: serves links (evidence: `src/main/java/com/pixault/share/ShareHttpServer.java`)
- Audit history → Database access: loads audit history (evidence: `src/main/java/com/pixault/ui/AuditLogController.java`)
- Database access → MySQL database: queries (evidence: `src/main/java/com/pixault/database/ShareDAO.java`)
- Database access → Vault domain models: maps records (evidence: `src/main/java/com/pixault/database/ShareDAO.java`)
