# dent-ist/accession architecture

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

- Interactive diagram: https://gitdiagram.com/dent-ist/accession
- Repository: https://github.com/dent-ist/accession

## Overview

Accession is a Windows desktop eDiscovery inventory tool. Users create or open a matter inventory, register media, scan its folders and files, then review dashboard and file records, save searches, copy evidence, and export reports. The WPF host presents a Blazor web UI; presentation workflows connect screens to inventory services, which persist results in a per-matter SQLite file. The README documents the main capabilities; sampled source and the SOURCE INDEX support only some internal links, so unsampled relationships are not inferred.

Main entry points: [`src/Accession.Presentation/ViewModels`](https://github.com/dent-ist/accession/tree/main/src/Accession.Presentation/ViewModels) (Screen view models), [`src/Accession.Data/Scanning/ScanCoordinator.cs`](https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Scanning/ScanCoordinator.cs) (Scan coordinator), [`src/Accession.Data/Export/ExportService.cs`](https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Export/ExportService.cs) (Excel export), [`src/Accession.Data/Browsing/FileBrowserQueries.cs`](https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Browsing/FileBrowserQueries.cs) (File browsing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop interface"]
  node_app["WPF host<br/>[App.xaml.cs]"]
  node_webui["Blazor web UI<br/>[Accession.UI]"]
end

subgraph group_workflows["User workflows"]
  node_screenmodels["Screen view models<br/>[ViewModels]"]
  node_inventoryworkflow["Inventory workflows"]
  node_scanhost["Scan host<br/>[ScanHost.cs]"]
  node_copyworkflow["Copy workflow<br/>[CopyWorkflow.cs]"]
  node_exportworkflow["Export workflow<br/>[ExportWorkflow.cs]"]
  node_savedsearchworkflow["Saved-search workflow"]
end

subgraph group_inventory["Inventory data"]
  node_session["Inventory session"]
  node_sessionopen["Inventory open"]
  node_locking["Edit locking"]
  node_sqlite[("SQLite inventory")]
  node_media["Media management<br/>[MediaService.cs]"]
end

subgraph group_scanning["Media scanning"]
  node_scan["Scan coordinator<br/>[ScanCoordinator.cs]"]
  node_enumerate["Folder and file listing"]
  node_hash["File hashing<br/>[HashingPhase.cs]"]
  node_scanwrite["Scan persistence<br/>[ScanDbWriter.cs]"]
end

subgraph group_reporting["Review and output"]
  node_dashboard["Dashboard queries"]
  node_filebrowse["File browsing"]
  node_savedsearch["Saved searches"]
  node_audit["Audit log<br/>[AuditService.cs]"]
  node_copy["Evidence copying<br/>[CopyService.cs]"]
  node_export["Excel export<br/>[ExportService.cs]"]
end

node_operator(("eDiscovery user"))

node_operator -->|"starts"| node_app
node_app -->|"hosts"| node_webui
node_webui -.->|"drives screens"| node_screenmodels
node_screenmodels -.->|"requests inventory"| node_inventoryworkflow
node_inventoryworkflow -->|"opens inventory"| node_sessionopen
node_sessionopen -->|"creates session"| node_session
node_session -->|"opens database"| node_sqlite
node_sessionopen -->|"acquires lock"| node_locking
node_inventoryworkflow -.->|"manages media"| node_media
node_screenmodels -.->|"controls scan"| node_scanhost
node_scanhost -.->|"runs scan"| node_scan
node_scan -->|"lists contents"| node_enumerate
node_scan -->|"hashes files"| node_hash
node_scan -.->|"records results"| node_scanwrite
node_scanwrite -.->|"writes records"| node_sqlite
node_screenmodels -->|"requests summaries"| node_dashboard
node_screenmodels -->|"browses files"| node_filebrowse
node_savedsearchworkflow -->|"manages searches"| node_savedsearch
node_savedsearch -->|"filters matches"| node_filebrowse
node_copyworkflow -->|"copies evidence"| node_copy
node_copy -->|"selects files"| node_filebrowse
node_exportworkflow -->|"exports reports"| node_export
node_export -->|"exports file view"| node_filebrowse
node_export -->|"exports summaries"| node_dashboard
node_copy -->|"records activity"| node_audit
node_export -->|"records export"| node_audit
node_audit -->|"writes audit rows"| node_sqlite

click node_app "https://github.com/dent-ist/accession/blob/main/src/Accession.App/App.xaml.cs"
click node_webui "https://github.com/dent-ist/accession/tree/main/src/Accession.UI"
click node_screenmodels "https://github.com/dent-ist/accession/tree/main/src/Accession.Presentation/ViewModels"
click node_inventoryworkflow "https://github.com/dent-ist/accession/blob/main/src/Accession.Presentation/Services/InventoryWorkflows.cs"
click node_scanhost "https://github.com/dent-ist/accession/blob/main/src/Accession.Presentation/Services/ScanHost.cs"
click node_copyworkflow "https://github.com/dent-ist/accession/blob/main/src/Accession.Presentation/Services/CopyWorkflow.cs"
click node_exportworkflow "https://github.com/dent-ist/accession/blob/main/src/Accession.Presentation/Services/ExportWorkflow.cs"
click node_savedsearchworkflow "https://github.com/dent-ist/accession/blob/main/src/Accession.Presentation/Services/SavedSearchWorkflow.cs"
click node_session "https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Sessions/InventorySession.cs"
click node_sessionopen "https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Sessions/InventoryOpenService.cs"
click node_locking "https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Locking/InventoryLockService.cs"
click node_sqlite "https://github.com/dent-ist/accession/blob/main/src/Accession.Data/InventoryDatabase.cs"
click node_media "https://github.com/dent-ist/accession/blob/main/src/Accession.Data/MediaManagement/MediaService.cs"
click node_scan "https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Scanning/ScanCoordinator.cs"
click node_enumerate "https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Scanning/EnumerationPhase.cs"
click node_hash "https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Scanning/HashingPhase.cs"
click node_scanwrite "https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Scanning/ScanDbWriter.cs"
click node_dashboard "https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Queries/DashboardQueries.cs"
click node_filebrowse "https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Browsing/FileBrowserQueries.cs"
click node_savedsearch "https://github.com/dent-ist/accession/blob/main/src/Accession.Data/SavedSearches/SavedSearchService.cs"
click node_audit "https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Audit/AuditService.cs"
click node_copy "https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Copying/CopyService.cs"
click node_export "https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Export/ExportService.cs"

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_webui,node_operator toneBlue
class node_screenmodels,node_inventoryworkflow,node_scanhost,node_copyworkflow,node_exportworkflow,node_savedsearchworkflow toneAmber
class node_session,node_sessionopen,node_locking,node_sqlite,node_media toneMint
class node_scan,node_enumerate,node_hash,node_scanwrite toneRose
class node_dashboard,node_filebrowse,node_savedsearch,node_audit,node_copy,node_export toneIndigo
```

## Components

### Desktop interface

- [WPF host](https://github.com/dent-ist/accession/blob/main/src/Accession.App/App.xaml.cs): `src/Accession.App/App.xaml.cs`
- [Blazor web UI](https://github.com/dent-ist/accession/tree/main/src/Accession.UI): `src/Accession.UI`

### User workflows

- [Screen view models](https://github.com/dent-ist/accession/tree/main/src/Accession.Presentation/ViewModels): `src/Accession.Presentation/ViewModels`
- [Inventory workflows](https://github.com/dent-ist/accession/blob/main/src/Accession.Presentation/Services/InventoryWorkflows.cs): `src/Accession.Presentation/Services/InventoryWorkflows.cs`
- [Scan host](https://github.com/dent-ist/accession/blob/main/src/Accession.Presentation/Services/ScanHost.cs): `src/Accession.Presentation/Services/ScanHost.cs`
- [Copy workflow](https://github.com/dent-ist/accession/blob/main/src/Accession.Presentation/Services/CopyWorkflow.cs): `src/Accession.Presentation/Services/CopyWorkflow.cs`
- [Export workflow](https://github.com/dent-ist/accession/blob/main/src/Accession.Presentation/Services/ExportWorkflow.cs): `src/Accession.Presentation/Services/ExportWorkflow.cs`
- [Saved-search workflow](https://github.com/dent-ist/accession/blob/main/src/Accession.Presentation/Services/SavedSearchWorkflow.cs): `src/Accession.Presentation/Services/SavedSearchWorkflow.cs`

### Inventory data

- [Inventory session](https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Sessions/InventorySession.cs): `src/Accession.Data/Sessions/InventorySession.cs`
- [Inventory open](https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Sessions/InventoryOpenService.cs): `src/Accession.Data/Sessions/InventoryOpenService.cs`
- [Edit locking](https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Locking/InventoryLockService.cs): `src/Accession.Data/Locking/InventoryLockService.cs`
- [SQLite inventory](https://github.com/dent-ist/accession/blob/main/src/Accession.Data/InventoryDatabase.cs): `src/Accession.Data/InventoryDatabase.cs`
- [Media management](https://github.com/dent-ist/accession/blob/main/src/Accession.Data/MediaManagement/MediaService.cs): `src/Accession.Data/MediaManagement/MediaService.cs`

### Media scanning

- [Scan coordinator](https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Scanning/ScanCoordinator.cs): `src/Accession.Data/Scanning/ScanCoordinator.cs`
- [Folder and file listing](https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Scanning/EnumerationPhase.cs): `src/Accession.Data/Scanning/EnumerationPhase.cs`
- [File hashing](https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Scanning/HashingPhase.cs): `src/Accession.Data/Scanning/HashingPhase.cs`
- [Scan persistence](https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Scanning/ScanDbWriter.cs): `src/Accession.Data/Scanning/ScanDbWriter.cs`

### Review and output

- [Dashboard queries](https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Queries/DashboardQueries.cs): `src/Accession.Data/Queries/DashboardQueries.cs`
- [File browsing](https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Browsing/FileBrowserQueries.cs): `src/Accession.Data/Browsing/FileBrowserQueries.cs`
- [Saved searches](https://github.com/dent-ist/accession/blob/main/src/Accession.Data/SavedSearches/SavedSearchService.cs): `src/Accession.Data/SavedSearches/SavedSearchService.cs`
- [Audit log](https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Audit/AuditService.cs): `src/Accession.Data/Audit/AuditService.cs`
- [Evidence copying](https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Copying/CopyService.cs): `src/Accession.Data/Copying/CopyService.cs`
- [Excel export](https://github.com/dent-ist/accession/blob/main/src/Accession.Data/Export/ExportService.cs): `src/Accession.Data/Export/ExportService.cs`

### Other components

- **eDiscovery user**

## Connections

- eDiscovery user → WPF host: starts (evidence: `README.md`)
- WPF host → Blazor web UI: hosts (evidence: `README.md`)
- Blazor web UI → Screen view models: drives screens
- Screen view models → Inventory workflows: requests inventory
- Inventory workflows → Inventory open: opens inventory (evidence: `src/Accession.App/App.xaml.cs`)
- Inventory open → Inventory session: creates session (evidence: `src/Accession.Data/Sessions/InventoryOpenService.cs`)
- Inventory session → SQLite inventory: opens database (evidence: `src/Accession.Data/Sessions/InventorySession.cs`)
- Inventory open → Edit locking: acquires lock (evidence: `src/Accession.Data/Sessions/InventoryOpenService.cs`)
- Inventory workflows → Media management: manages media
- Screen view models → Scan host: controls scan
- Scan host → Scan coordinator: runs scan
- Scan coordinator → Folder and file listing: lists contents (evidence: `README.md`)
- Scan coordinator → File hashing: hashes files (evidence: `README.md`)
- Scan coordinator → Scan persistence: records results
- Scan persistence → SQLite inventory: writes records
- Screen view models → Dashboard queries: requests summaries (evidence: `README.md`)
- Screen view models → File browsing: browses files (evidence: `README.md`)
- Saved-search workflow → Saved searches: manages searches
- Saved searches → File browsing: filters matches (evidence: `src/Accession.Data/SavedSearches/SavedSearchService.cs`)
- Copy workflow → Evidence copying: copies evidence (evidence: `README.md`)
- Evidence copying → File browsing: selects files (evidence: `src/Accession.Data/Copying/CopyService.cs`)
- Export workflow → Excel export: exports reports (evidence: `README.md`)
- Excel export → File browsing: exports file view (evidence: `src/Accession.Data/Export/ExportService.cs`)
- Excel export → Dashboard queries: exports summaries (evidence: `src/Accession.Data/Export/ExportService.cs`)
- Evidence copying → Audit log: records activity (evidence: `src/Accession.Data/Copying/CopyService.cs`)
- Excel export → Audit log: records export (evidence: `src/Accession.Data/Export/ExportService.cs`)
- Audit log → SQLite inventory: writes audit rows (evidence: `src/Accession.Data/Audit/AuditService.cs`)
