# jakeschild9/aianalyzer architecture

> Architecture diagram of the GitHub repository jakeschild9/aianalyzer, 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/jakeschild9/aianalyzer
- Repository: https://github.com/jakeschild9/aianalyzer

## Overview

File AiAnalyzer is a JavaFX desktop application backed by Spring services and SQLite persistence. Its main workflow is local file discovery, queued scanning and processing, AI classification and malware checking, then storing file results for browsing and reporting. Separate capabilities include image analysis and duplicate detection, user preferences and theming, and metrics. The README documents the product capabilities; source-index references and excerpts support the specific service dependencies shown. Several UI and integration links remain unverified because their wiring was not sampled.

Main entry points: [`src/main/java/edu/missouristate/aianalyzer/service/database/FileProcessingService.java`](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/service/database/FileProcessingService.java) (File processing), [`src/main/java/edu/missouristate/aianalyzer/repository/database/FileRecordRepository.java`](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/repository/database/FileRecordRepository.java) (File repository), [`src/main/java/edu/missouristate/aianalyzer/service/ai/ProcessFileService.java`](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/service/ai/ProcessFileService.java) (AI file analysis), [`src/main/java/edu/missouristate/aianalyzer/ui/view/Home/DriveView.java`](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/ui/view/Home/DriveView.java) (Desktop views)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop experience"]
  node_app["Application startup"]
  node_file_discovery["File discovery"]
  node_desktop_views["Desktop views<br/>[DriveView.java]"]
  node_settings_view["Settings view<br/>[SettingsView.java]"]
  node_theme_service["Theme service<br/>[ThemeService.java]"]
end

subgraph group_processing["Scanning and analysis"]
  node_scan_queue["Scan queue<br/>[ScanQueueItem.java]"]
  node_file_processing["File processing"]
  node_file_interpretation["File interpretation"]
  node_ai_file["AI file analysis"]
  node_ai_image["AI image analysis"]
  node_virus_scan["Virus scanning"]
  node_duplicate_detection["Duplicate detection"]
  node_ai_query["AI query utility<br/>[AiQueryUtil.java]"]
  node_image_utilities["Image utilities<br/>[ReadImageUtil.java]"]
end

subgraph group_persistence["Persistence and settings"]
  node_file_records[("File records<br/>[FileRecord.java]")]
  node_file_repository["File repository"]
  node_queue_repository["Queue repository"]
  node_preferences["Preference service"]
  node_cloud_config["Cloud configuration"]
end

subgraph group_insights["Reports and insights"]
  node_metrics["Metrics service"]
  node_metrics_aggregation["Metrics aggregation"]
  node_metrics_view["Metrics view<br/>[MetricsView.java]"]
end

node_user(("Desktop user"))

node_user -.->|"uses"| node_desktop_views
node_app -.->|"launches"| node_desktop_views
node_desktop_views -.->|"browses files"| node_file_discovery
node_user -.->|"configures"| node_settings_view
node_settings_view -->|"sets cloud options"| node_cloud_config
node_cloud_config -->|"reads and writes"| node_preferences
node_preferences -->|"notifies preferences"| node_theme_service
node_user -.->|"requests scanning"| node_scan_queue
node_file_processing -->|"loads and updates"| node_queue_repository
node_file_processing -->|"reads and saves"| node_file_repository
node_file_processing -->|"analyzes files"| node_ai_file
node_file_processing -->|"scans for malware"| node_virus_scan
node_file_processing -->|"checks duplicates"| node_duplicate_detection
node_file_processing -->|"uses types"| node_file_interpretation
node_ai_file -->|"queries model"| node_ai_query
node_ai_image -->|"queries model"| node_ai_query
node_ai_image -->|"reads images"| node_image_utilities
node_ai_file -->|"uses types"| node_file_interpretation
node_duplicate_detection -->|"queries records"| node_file_repository
node_file_repository -->|"persists"| node_file_records
node_queue_repository -->|"persists"| node_scan_queue
node_metrics_aggregation -->|"aggregates records"| node_file_repository
node_metrics -.->|"reports metrics"| node_metrics_view
node_metrics_view -.->|"shows reports"| node_user

click node_app "https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/AiAnalyzerApplication.java"
click node_file_discovery "https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/ui/service/FileSystemService.java"
click node_desktop_views "https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/ui/view/Home/DriveView.java"
click node_settings_view "https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/ui/view/Settings/SettingsView.java"
click node_theme_service "https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/ui/service/ThemeService.java"
click node_scan_queue "https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/model/database/ScanQueueItem.java"
click node_file_processing "https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/service/database/FileProcessingService.java"
click node_file_interpretation "https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/model/FileInterpretation.java"
click node_ai_file "https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/service/ai/ProcessFileService.java"
click node_ai_image "https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/service/ai/ProcessImageService.java"
click node_virus_scan "https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/service/ai/ScanForVirusService.java"
click node_duplicate_detection "https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/service/photos/FindDuplicatesService.java"
click node_ai_query "https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/utility/ai/AiQueryUtil.java"
click node_image_utilities "https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/utility/ai/ReadImageUtil.java"
click node_file_records "https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/model/database/FileRecord.java"
click node_file_repository "https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/repository/database/FileRecordRepository.java"
click node_queue_repository "https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/repository/database/ScanQueueItemRepository.java"
click node_preferences "https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/service/database/PreferenceService.java"
click node_cloud_config "https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/service/CloudConfigService.java"
click node_metrics "https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/service/metrics/MetricsService.java"
click node_metrics_aggregation "https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/service/metrics/MetricsAggregationService.java"
click node_metrics_view "https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/ui/view/Metrics/MetricsView.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_app,node_file_discovery,node_desktop_views,node_settings_view,node_theme_service,node_user toneBlue
class node_scan_queue,node_file_processing,node_file_interpretation,node_ai_file,node_ai_image,node_virus_scan,node_duplicate_detection,node_ai_query,node_image_utilities toneAmber
class node_file_records,node_file_repository,node_queue_repository,node_preferences,node_cloud_config toneMint
class node_metrics,node_metrics_aggregation,node_metrics_view toneRose
```

## Components

### Desktop experience

- [Application startup](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/AiAnalyzerApplication.java): `src/main/java/edu/missouristate/aianalyzer/AiAnalyzerApplication.java`
- [File discovery](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/ui/service/FileSystemService.java): `src/main/java/edu/missouristate/aianalyzer/ui/service/FileSystemService.java`
- [Desktop views](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/ui/view/Home/DriveView.java): `src/main/java/edu/missouristate/aianalyzer/ui/view/Home/DriveView.java`
- [Settings view](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/ui/view/Settings/SettingsView.java): `src/main/java/edu/missouristate/aianalyzer/ui/view/Settings/SettingsView.java`
- [Theme service](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/ui/service/ThemeService.java): `src/main/java/edu/missouristate/aianalyzer/ui/service/ThemeService.java`

### Scanning and analysis

- [Scan queue](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/model/database/ScanQueueItem.java): `src/main/java/edu/missouristate/aianalyzer/model/database/ScanQueueItem.java`
- [File processing](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/service/database/FileProcessingService.java): `src/main/java/edu/missouristate/aianalyzer/service/database/FileProcessingService.java`
- [File interpretation](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/model/FileInterpretation.java): `src/main/java/edu/missouristate/aianalyzer/model/FileInterpretation.java`
- [AI file analysis](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/service/ai/ProcessFileService.java): `src/main/java/edu/missouristate/aianalyzer/service/ai/ProcessFileService.java`
- [AI image analysis](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/service/ai/ProcessImageService.java): `src/main/java/edu/missouristate/aianalyzer/service/ai/ProcessImageService.java`
- [Virus scanning](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/service/ai/ScanForVirusService.java): `src/main/java/edu/missouristate/aianalyzer/service/ai/ScanForVirusService.java`
- [Duplicate detection](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/service/photos/FindDuplicatesService.java): `src/main/java/edu/missouristate/aianalyzer/service/photos/FindDuplicatesService.java`
- [AI query utility](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/utility/ai/AiQueryUtil.java): `src/main/java/edu/missouristate/aianalyzer/utility/ai/AiQueryUtil.java`
- [Image utilities](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/utility/ai/ReadImageUtil.java): `src/main/java/edu/missouristate/aianalyzer/utility/ai/ReadImageUtil.java`

### Persistence and settings

- [File records](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/model/database/FileRecord.java): `src/main/java/edu/missouristate/aianalyzer/model/database/FileRecord.java`
- [File repository](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/repository/database/FileRecordRepository.java): `src/main/java/edu/missouristate/aianalyzer/repository/database/FileRecordRepository.java`
- [Queue repository](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/repository/database/ScanQueueItemRepository.java): `src/main/java/edu/missouristate/aianalyzer/repository/database/ScanQueueItemRepository.java`
- [Preference service](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/service/database/PreferenceService.java): `src/main/java/edu/missouristate/aianalyzer/service/database/PreferenceService.java`
- [Cloud configuration](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/service/CloudConfigService.java): `src/main/java/edu/missouristate/aianalyzer/service/CloudConfigService.java`

### Reports and insights

- [Metrics service](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/service/metrics/MetricsService.java): `src/main/java/edu/missouristate/aianalyzer/service/metrics/MetricsService.java`
- [Metrics aggregation](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/service/metrics/MetricsAggregationService.java): `src/main/java/edu/missouristate/aianalyzer/service/metrics/MetricsAggregationService.java`
- [Metrics view](https://github.com/jakeschild9/aianalyzer/blob/main/src/main/java/edu/missouristate/aianalyzer/ui/view/Metrics/MetricsView.java): `src/main/java/edu/missouristate/aianalyzer/ui/view/Metrics/MetricsView.java`

### Other components

- **Desktop user**

## Connections

- Desktop user → Desktop views: uses
- Application startup → Desktop views: launches
- Desktop views → File discovery: browses files
- Desktop user → Settings view: configures
- Settings view → Cloud configuration: sets cloud options (evidence: `src/main/java/edu/missouristate/aianalyzer/service/CloudConfigService.java`)
- Cloud configuration → Preference service: reads and writes (evidence: `src/main/java/edu/missouristate/aianalyzer/service/CloudConfigService.java`)
- Preference service → Theme service: notifies preferences (evidence: `src/main/java/edu/missouristate/aianalyzer/ui/service/ThemeService.java`)
- Desktop user → Scan queue: requests scanning
- File processing → Queue repository: loads and updates (evidence: `src/main/java/edu/missouristate/aianalyzer/service/database/FileProcessingService.java`)
- File processing → File repository: reads and saves (evidence: `src/main/java/edu/missouristate/aianalyzer/service/database/FileProcessingService.java`)
- File processing → AI file analysis: analyzes files (evidence: `src/main/java/edu/missouristate/aianalyzer/service/database/FileProcessingService.java`)
- File processing → Virus scanning: scans for malware (evidence: `src/main/java/edu/missouristate/aianalyzer/service/database/FileProcessingService.java`)
- File processing → Duplicate detection: checks duplicates (evidence: `src/main/java/edu/missouristate/aianalyzer/service/database/FileProcessingService.java`)
- File processing → File interpretation: uses types (evidence: `src/main/java/edu/missouristate/aianalyzer/service/database/FileProcessingService.java`)
- AI file analysis → AI query utility: queries model (evidence: `src/main/java/edu/missouristate/aianalyzer/service/ai/ProcessFileService.java`)
- AI image analysis → AI query utility: queries model (evidence: `src/main/java/edu/missouristate/aianalyzer/service/ai/ProcessImageService.java`)
- AI image analysis → Image utilities: reads images (evidence: `src/main/java/edu/missouristate/aianalyzer/service/ai/ProcessImageService.java`)
- AI file analysis → File interpretation: uses types (evidence: `src/main/java/edu/missouristate/aianalyzer/service/ai/ProcessFileService.java`)
- Duplicate detection → File repository: queries records (evidence: `src/main/java/edu/missouristate/aianalyzer/service/photos/FindDuplicatesService.java`)
- File repository → File records: persists (evidence: `src/main/java/edu/missouristate/aianalyzer/repository/database/FileRecordRepository.java`)
- Queue repository → Scan queue: persists (evidence: `src/main/java/edu/missouristate/aianalyzer/repository/database/ScanQueueItemRepository.java`)
- Metrics aggregation → File repository: aggregates records (evidence: `src/main/java/edu/missouristate/aianalyzer/service/metrics/MetricsAggregationService.java`)
- Metrics service → Metrics view: reports metrics
- Metrics view → Desktop user: shows reports
