# tanvirr007/quarry-app architecture

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

- Interactive diagram: https://gitdiagram.com/tanvirr007/quarry-app
- Repository: https://github.com/tanvirr007/quarry-app

## Overview

Quarry is an offline Android storage analyzer and cleanup utility. The main user workflow is to scan storage volumes, persist discovered file data, and explore storage or review cleanup candidates before managing files and Trash. The graph also preserves documented capabilities for app analysis, treemaps, thumbnails, security, preferences, and background scans. Several UI implementations were not sampled; their feature nodes use exact paths from the tree, and unverified connections are dashed with no evidence path.

Main entry points: [`app/src/main/java/app/quarry/tanvir/info/domain/scanner/ScanRepository.kt`](https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/scanner/ScanRepository.kt) (Scan orchestration), [`app/src/main/java/app/quarry/tanvir/info/ui/explore`](https://github.com/tanvirr007/quarry-app/tree/main/app/src/main/java/app/quarry/tanvir/info/ui/explore) (File explorer), [`app/src/main/java/app/quarry/tanvir/info/ui/cleanup`](https://github.com/tanvirr007/quarry-app/tree/main/app/src/main/java/app/quarry/tanvir/info/ui/cleanup) (Cleanup hub), [`app/src/main/java/app/quarry/tanvir/info/domain/file/FileOperationsManager.kt`](https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/file/FileOperationsManager.kt) (File operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["User experience"]
  node_app["Quarry app<br/>[MainActivity.kt]"]
  node_home["Storage dashboard"]
  node_explore["File explorer"]
  node_cleanup_ui["Cleanup hub"]
  node_settings["Settings and volumes"]
  node_app_analysis_ui["Installed app analysis"]
end

subgraph group_scan["Scanning and storage"]
  node_preferences[("User preferences")]
  node_volume_manager["Volume discovery"]
  node_scan_repo["Scan orchestration<br/>[ScanRepository.kt]"]
  node_scanner["Filesystem scanner"]
  node_scan_worker["Background scan worker<br/>[ScanWorker.kt]"]
  node_file_store[("Scanned file records<br/>[FileEntity.kt]")]
  node_database[("Room database<br/>[QuarryDatabase.kt]")]
end

subgraph group_analysis["Analysis and discovery"]
  node_storage_analysis["Storage analysis<br/>[StorageAnalyzer.kt]"]
  node_treemap["Treemap layout<br/>[TreemapEngine.kt]"]
  node_search["Search matching<br/>[SearchMatcher.kt]"]
  node_cleanup_engine["Cleanup candidates"]
  node_duplicates["Duplicate detection"]
  node_app_manager["Installed app inventory<br/>[AppManager.kt]"]
  node_thumbnails["Offline thumbnails<br/>[ThumbnailLoader.kt]"]
  node_security["Biometric security"]
end

subgraph group_actions["File actions"]
  node_file_ops["File operations"]
  node_trash["Trash management<br/>[TrashManager.kt]"]
end

node_user(("Device user"))

node_user -->|"opens"| node_app
node_scan_repo -->|"runs scan"| node_scanner
node_scan_repo -->|"reads scan settings"| node_preferences
node_scan_repo -->|"queries and stores"| node_database
node_scanner -->|"creates records"| node_file_store
node_database -->|"maps entities"| node_file_store
node_scan_worker -->|"starts scans"| node_scan_repo
node_cleanup_engine -->|"detects duplicates"| node_duplicates
node_file_ops -->|"delegates trash actions"| node_trash
node_file_ops -->|"updates file records"| node_scan_repo
node_app_manager -.->|"provides app data"| node_app_analysis_ui
node_user -.->|"reviews storage"| node_home
node_user -.->|"browses files"| node_explore
node_user -.->|"reviews cleanup"| node_cleanup_ui
node_user -.->|"configures app"| node_settings
node_volume_manager -.->|"supplies volumes"| node_scan_repo
node_scan_repo -.->|"supplies scan data"| node_storage_analysis
node_file_store -.->|"provides file data"| node_treemap
node_explore -.->|"filters results"| node_search
node_cleanup_ui -.->|"requests candidates"| node_cleanup_engine
node_explore -.->|"loads previews"| node_thumbnails
node_explore -.->|"requires authentication"| node_security
node_cleanup_ui -.->|"acts on files"| node_file_ops

click node_app "https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/MainActivity.kt"
click node_home "https://github.com/tanvirr007/quarry-app/tree/main/app/src/main/java/app/quarry/tanvir/info/ui/home"
click node_explore "https://github.com/tanvirr007/quarry-app/tree/main/app/src/main/java/app/quarry/tanvir/info/ui/explore"
click node_cleanup_ui "https://github.com/tanvirr007/quarry-app/tree/main/app/src/main/java/app/quarry/tanvir/info/ui/cleanup"
click node_settings "https://github.com/tanvirr007/quarry-app/tree/main/app/src/main/java/app/quarry/tanvir/info/ui/settings"
click node_app_analysis_ui "https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/ui/home/AppManagerBottomSheet.kt"
click node_preferences "https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/data/preferences/UserPreferencesRepository.kt"
click node_volume_manager "https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/volume/StorageVolumeManager.kt"
click node_scan_repo "https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/scanner/ScanRepository.kt"
click node_scanner "https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/data/filesystem/FastStorageScanner.kt"
click node_scan_worker "https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/worker/ScanWorker.kt"
click node_file_store "https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/data/database/FileEntity.kt"
click node_database "https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/data/database/QuarryDatabase.kt"
click node_storage_analysis "https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/analyzer/StorageAnalyzer.kt"
click node_treemap "https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/treemap/TreemapEngine.kt"
click node_search "https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/model/SearchMatcher.kt"
click node_cleanup_engine "https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/cleanup/DefaultCleanupEngine.kt"
click node_duplicates "https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/duplicates/FastDuplicateDetector.kt"
click node_app_manager "https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/app/AppManager.kt"
click node_thumbnails "https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/media/ThumbnailLoader.kt"
click node_security "https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/security/BiometricSecurityManager.kt"
click node_file_ops "https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/file/FileOperationsManager.kt"
click node_trash "https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/file/TrashManager.kt"

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_home,node_explore,node_cleanup_ui,node_settings,node_app_analysis_ui,node_user toneBlue
class node_preferences,node_volume_manager,node_scan_repo,node_scanner,node_scan_worker,node_file_store,node_database toneAmber
class node_storage_analysis,node_treemap,node_search,node_cleanup_engine,node_duplicates,node_app_manager,node_thumbnails,node_security toneMint
class node_file_ops,node_trash toneRose
```

## Components

### User experience

- [Quarry app](https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/MainActivity.kt): `app/src/main/java/app/quarry/tanvir/info/MainActivity.kt`
- [Storage dashboard](https://github.com/tanvirr007/quarry-app/tree/main/app/src/main/java/app/quarry/tanvir/info/ui/home): `app/src/main/java/app/quarry/tanvir/info/ui/home`
- [File explorer](https://github.com/tanvirr007/quarry-app/tree/main/app/src/main/java/app/quarry/tanvir/info/ui/explore): `app/src/main/java/app/quarry/tanvir/info/ui/explore`
- [Cleanup hub](https://github.com/tanvirr007/quarry-app/tree/main/app/src/main/java/app/quarry/tanvir/info/ui/cleanup): `app/src/main/java/app/quarry/tanvir/info/ui/cleanup`
- [Settings and volumes](https://github.com/tanvirr007/quarry-app/tree/main/app/src/main/java/app/quarry/tanvir/info/ui/settings): `app/src/main/java/app/quarry/tanvir/info/ui/settings`
- [Installed app analysis](https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/ui/home/AppManagerBottomSheet.kt): `app/src/main/java/app/quarry/tanvir/info/ui/home/AppManagerBottomSheet.kt`

### Scanning and storage

- [User preferences](https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/data/preferences/UserPreferencesRepository.kt): `app/src/main/java/app/quarry/tanvir/info/data/preferences/UserPreferencesRepository.kt`
- [Volume discovery](https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/volume/StorageVolumeManager.kt): `app/src/main/java/app/quarry/tanvir/info/domain/volume/StorageVolumeManager.kt`
- [Scan orchestration](https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/scanner/ScanRepository.kt): `app/src/main/java/app/quarry/tanvir/info/domain/scanner/ScanRepository.kt`
- [Filesystem scanner](https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/data/filesystem/FastStorageScanner.kt): `app/src/main/java/app/quarry/tanvir/info/data/filesystem/FastStorageScanner.kt`
- [Background scan worker](https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/worker/ScanWorker.kt): `app/src/main/java/app/quarry/tanvir/info/worker/ScanWorker.kt`
- [Scanned file records](https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/data/database/FileEntity.kt): `app/src/main/java/app/quarry/tanvir/info/data/database/FileEntity.kt`
- [Room database](https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/data/database/QuarryDatabase.kt): `app/src/main/java/app/quarry/tanvir/info/data/database/QuarryDatabase.kt`

### Analysis and discovery

- [Storage analysis](https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/analyzer/StorageAnalyzer.kt): `app/src/main/java/app/quarry/tanvir/info/domain/analyzer/StorageAnalyzer.kt`
- [Treemap layout](https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/treemap/TreemapEngine.kt): `app/src/main/java/app/quarry/tanvir/info/domain/treemap/TreemapEngine.kt`
- [Search matching](https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/model/SearchMatcher.kt): `app/src/main/java/app/quarry/tanvir/info/domain/model/SearchMatcher.kt`
- [Cleanup candidates](https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/cleanup/DefaultCleanupEngine.kt): `app/src/main/java/app/quarry/tanvir/info/domain/cleanup/DefaultCleanupEngine.kt`
- [Duplicate detection](https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/duplicates/FastDuplicateDetector.kt): `app/src/main/java/app/quarry/tanvir/info/domain/duplicates/FastDuplicateDetector.kt`
- [Installed app inventory](https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/app/AppManager.kt): `app/src/main/java/app/quarry/tanvir/info/domain/app/AppManager.kt`
- [Offline thumbnails](https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/media/ThumbnailLoader.kt): `app/src/main/java/app/quarry/tanvir/info/domain/media/ThumbnailLoader.kt`
- [Biometric security](https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/security/BiometricSecurityManager.kt): `app/src/main/java/app/quarry/tanvir/info/domain/security/BiometricSecurityManager.kt`

### File actions

- [File operations](https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/file/FileOperationsManager.kt): `app/src/main/java/app/quarry/tanvir/info/domain/file/FileOperationsManager.kt`
- [Trash management](https://github.com/tanvirr007/quarry-app/blob/main/app/src/main/java/app/quarry/tanvir/info/domain/file/TrashManager.kt): `app/src/main/java/app/quarry/tanvir/info/domain/file/TrashManager.kt`

### Other components

- **Device user**

## Connections

- Device user → Quarry app: opens (evidence: `README.md`)
- Scan orchestration → Filesystem scanner: runs scan (evidence: `app/src/main/java/app/quarry/tanvir/info/domain/scanner/ScanRepository.kt`)
- Scan orchestration → User preferences: reads scan settings (evidence: `app/src/main/java/app/quarry/tanvir/info/domain/scanner/ScanRepository.kt`)
- Scan orchestration → Room database: queries and stores (evidence: `app/src/main/java/app/quarry/tanvir/info/domain/scanner/ScanRepository.kt`)
- Filesystem scanner → Scanned file records: creates records (evidence: `app/src/main/java/app/quarry/tanvir/info/data/filesystem/FastStorageScanner.kt`)
- Room database → Scanned file records: maps entities (evidence: `app/src/main/java/app/quarry/tanvir/info/data/database/QuarryDatabase.kt`)
- Background scan worker → Scan orchestration: starts scans (evidence: `app/src/main/java/app/quarry/tanvir/info/worker/ScanWorker.kt`)
- Cleanup candidates → Duplicate detection: detects duplicates (evidence: `app/src/main/java/app/quarry/tanvir/info/domain/cleanup/DefaultCleanupEngine.kt`)
- File operations → Trash management: delegates trash actions (evidence: `app/src/main/java/app/quarry/tanvir/info/domain/file/FileOperationsManager.kt`)
- File operations → Scan orchestration: updates file records (evidence: `app/src/main/java/app/quarry/tanvir/info/domain/file/FileOperationsManager.kt`)
- Installed app inventory → Installed app analysis: provides app data
- Device user → Storage dashboard: reviews storage
- Device user → File explorer: browses files
- Device user → Cleanup hub: reviews cleanup
- Device user → Settings and volumes: configures app
- Volume discovery → Scan orchestration: supplies volumes
- Scan orchestration → Storage analysis: supplies scan data
- Scanned file records → Treemap layout: provides file data (evidence: `app/src/main/java/app/quarry/tanvir/info/domain/treemap/TreemapEngine.kt`)
- File explorer → Search matching: filters results (evidence: `app/src/main/java/app/quarry/tanvir/info/ui/explore/ExploreViewModel.kt`)
- Cleanup hub → Cleanup candidates: requests candidates
- File explorer → Offline thumbnails: loads previews
- File explorer → Biometric security: requires authentication (evidence: `app/src/main/java/app/quarry/tanvir/info/ui/explore/ExploreViewModel.kt`)
- Cleanup hub → File operations: acts on files
