# ponei/journaltrace architecture

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

## Overview

JournalTrace is a Windows desktop application for browsing NTFS USN Journal records. The main workflow selects a volume, scans its journal, resolves file identifiers, and displays changes in a grid or directory tree, with per-entry detail views. The graph also includes localization and the information/about UI. Relationships are limited to calls shown in excerpts, SOURCE INDEX references, or README documentation; several UI and native implementation details were not sampled.

Main entry points: [`JournalTrace/View/FormMain.cs`](https://github.com/ponei/journaltrace/blob/master/JournalTrace/View/FormMain.cs) (Main Window), [`JournalTrace/Entry/EntryManager.cs`](https://github.com/ponei/journaltrace/blob/master/JournalTrace/Entry/EntryManager.cs) (Entry Manager), [`JournalTrace/Program.cs`](https://github.com/ponei/journaltrace/blob/master/JournalTrace/Program.cs) (Application Startup), [`JournalTrace/View/Layout/GridLayout.cs`](https://github.com/ponei/journaltrace/blob/master/JournalTrace/View/Layout/GridLayout.cs) (Grid View)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop UI"]
  node_entrypoint["Application Startup<br/>[Program.cs]"]
  node_main["Main Window<br/>[FormMain.cs]"]
  node_drive["Volume Picker<br/>[FormDrive.cs]"]
  node_grid["Grid View<br/>[GridLayout.cs]"]
  node_tree["Directory Tree<br/>[TreeLayout.cs]"]
  node_layoutcontract["Layout Contract<br/>[ILayout.cs]"]
  node_detail["Entry Details<br/>[FormEntryInfo.cs]"]
  node_about["About Window<br/>[FormInfo.cs]"]
  node_social["Social Links<br/>[UserSocialMedia.cs]"]
end

subgraph group_scan["Journal Scan"]
  node_manager["Entry Manager<br/>[EntryManager.cs]"]
  node_record["Journal Record<br/>[USNEntry.cs]"]
  node_collection["Record Collections<br/>[USNCollection.cs]"]
  node_identifier["Resolved Identifier"]
end

subgraph group_native["NTFS Access"]
  node_journal["USN Journal Reader<br/>[NtfsUsnJournal.cs]"]
  node_fileid["File ID Resolver<br/>[FileID.cs]"]
  node_win32["Win32 API<br/>[Win32Api.cs]"]
end

subgraph group_support["UI Support"]
  node_language["Localization Manager<br/>[LanguageManager.cs]"]
  node_localizable["Localized Controls"]
  node_context["Context Menu Helper"]
end

node_user(("User"))
node_windows[("Windows NTFS")]

node_user -->|"starts app"| node_entrypoint
node_entrypoint -->|"runs window"| node_main
node_entrypoint -->|"initializes"| node_language
node_entrypoint -->|"initializes"| node_context
node_user -.->|"uses UI"| node_main
node_main -->|"starts scan"| node_manager
node_main -->|"opens picker"| node_drive
node_drive -->|"selects volume"| node_main
node_main -->|"selects layout"| node_grid
node_main -->|"selects layout"| node_tree
node_main -->|"uses interface"| node_layoutcontract
node_grid -->|"implements"| node_layoutcontract
node_tree -->|"implements"| node_layoutcontract
node_grid -->|"reads entries"| node_manager
node_tree -->|"builds tree"| node_manager
node_main -->|"opens details"| node_detail
node_main -->|"opens info"| node_about
node_about -->|"creates links"| node_social
node_manager -->|"reads journal"| node_journal
node_manager -->|"uses API types"| node_win32
node_manager -->|"creates records"| node_record
node_manager -->|"groups records"| node_collection
node_manager -->|"resolves references"| node_identifier
node_identifier -->|"resolves path"| node_fileid
node_journal -->|"uses API"| node_win32
node_journal -.->|"queries journal"| node_windows
node_fileid -.->|"opens by ID"| node_windows
node_grid -->|"shows menu"| node_context
node_tree -->|"shows menu"| node_context
node_detail -->|"reads entry data"| node_manager
node_detail -->|"resolves current file"| node_identifier
node_language -->|"tracks controls"| node_localizable
node_main -->|"updates language"| node_language
node_context -->|"reads selected record"| node_manager

click node_entrypoint "https://github.com/ponei/journaltrace/blob/master/JournalTrace/Program.cs"
click node_main "https://github.com/ponei/journaltrace/blob/master/JournalTrace/View/FormMain.cs"
click node_drive "https://github.com/ponei/journaltrace/blob/master/JournalTrace/View/FormDrive.cs"
click node_grid "https://github.com/ponei/journaltrace/blob/master/JournalTrace/View/Layout/GridLayout.cs"
click node_tree "https://github.com/ponei/journaltrace/blob/master/JournalTrace/View/Layout/TreeLayout.cs"
click node_layoutcontract "https://github.com/ponei/journaltrace/blob/master/JournalTrace/View/Layout/ILayout.cs"
click node_detail "https://github.com/ponei/journaltrace/blob/master/JournalTrace/View/FormEntryInfo.cs"
click node_about "https://github.com/ponei/journaltrace/blob/master/JournalTrace/View/Info/FormInfo.cs"
click node_social "https://github.com/ponei/journaltrace/blob/master/JournalTrace/View/Info/UserSocialMedia.cs"
click node_manager "https://github.com/ponei/journaltrace/blob/master/JournalTrace/Entry/EntryManager.cs"
click node_record "https://github.com/ponei/journaltrace/blob/master/JournalTrace/Entry/USNEntry.cs"
click node_collection "https://github.com/ponei/journaltrace/blob/master/JournalTrace/Entry/USNCollection.cs"
click node_identifier "https://github.com/ponei/journaltrace/blob/master/JournalTrace/Entry/ResolvableIdentifier.cs"
click node_journal "https://github.com/ponei/journaltrace/blob/master/JournalTrace/Native/NtfsUsnJournal.cs"
click node_fileid "https://github.com/ponei/journaltrace/blob/master/JournalTrace/Native/FileID.cs"
click node_win32 "https://github.com/ponei/journaltrace/blob/master/JournalTrace/Native/Win32Api.cs"
click node_language "https://github.com/ponei/journaltrace/blob/master/JournalTrace/Language/LanguageManager.cs"
click node_localizable "https://github.com/ponei/journaltrace/blob/master/JournalTrace/Language/LocalizableControl.cs"
click node_context "https://github.com/ponei/journaltrace/blob/master/JournalTrace/View/Util/ContextMenuHelper.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_entrypoint,node_main,node_drive,node_grid,node_tree,node_layoutcontract,node_detail,node_about,node_social,node_user toneBlue
class node_manager,node_record,node_collection,node_identifier,node_windows toneAmber
class node_journal,node_fileid,node_win32 toneMint
class node_language,node_localizable,node_context toneRose
```

## Components

### Desktop UI

- [Application Startup](https://github.com/ponei/journaltrace/blob/master/JournalTrace/Program.cs): `JournalTrace/Program.cs`
- [Main Window](https://github.com/ponei/journaltrace/blob/master/JournalTrace/View/FormMain.cs): `JournalTrace/View/FormMain.cs`
- [Volume Picker](https://github.com/ponei/journaltrace/blob/master/JournalTrace/View/FormDrive.cs): `JournalTrace/View/FormDrive.cs`
- [Grid View](https://github.com/ponei/journaltrace/blob/master/JournalTrace/View/Layout/GridLayout.cs): `JournalTrace/View/Layout/GridLayout.cs`
- [Directory Tree](https://github.com/ponei/journaltrace/blob/master/JournalTrace/View/Layout/TreeLayout.cs): `JournalTrace/View/Layout/TreeLayout.cs`
- [Layout Contract](https://github.com/ponei/journaltrace/blob/master/JournalTrace/View/Layout/ILayout.cs): `JournalTrace/View/Layout/ILayout.cs`
- [Entry Details](https://github.com/ponei/journaltrace/blob/master/JournalTrace/View/FormEntryInfo.cs): `JournalTrace/View/FormEntryInfo.cs`
- [About Window](https://github.com/ponei/journaltrace/blob/master/JournalTrace/View/Info/FormInfo.cs): `JournalTrace/View/Info/FormInfo.cs`
- [Social Links](https://github.com/ponei/journaltrace/blob/master/JournalTrace/View/Info/UserSocialMedia.cs): `JournalTrace/View/Info/UserSocialMedia.cs`

### Journal Scan

- [Entry Manager](https://github.com/ponei/journaltrace/blob/master/JournalTrace/Entry/EntryManager.cs): `JournalTrace/Entry/EntryManager.cs`
- [Journal Record](https://github.com/ponei/journaltrace/blob/master/JournalTrace/Entry/USNEntry.cs): `JournalTrace/Entry/USNEntry.cs`
- [Record Collections](https://github.com/ponei/journaltrace/blob/master/JournalTrace/Entry/USNCollection.cs): `JournalTrace/Entry/USNCollection.cs`
- [Resolved Identifier](https://github.com/ponei/journaltrace/blob/master/JournalTrace/Entry/ResolvableIdentifier.cs): `JournalTrace/Entry/ResolvableIdentifier.cs`

### NTFS Access

- [USN Journal Reader](https://github.com/ponei/journaltrace/blob/master/JournalTrace/Native/NtfsUsnJournal.cs): `JournalTrace/Native/NtfsUsnJournal.cs`
- [File ID Resolver](https://github.com/ponei/journaltrace/blob/master/JournalTrace/Native/FileID.cs): `JournalTrace/Native/FileID.cs`
- [Win32 API](https://github.com/ponei/journaltrace/blob/master/JournalTrace/Native/Win32Api.cs): `JournalTrace/Native/Win32Api.cs`

### UI Support

- [Localization Manager](https://github.com/ponei/journaltrace/blob/master/JournalTrace/Language/LanguageManager.cs): `JournalTrace/Language/LanguageManager.cs`
- [Localized Controls](https://github.com/ponei/journaltrace/blob/master/JournalTrace/Language/LocalizableControl.cs): `JournalTrace/Language/LocalizableControl.cs`
- [Context Menu Helper](https://github.com/ponei/journaltrace/blob/master/JournalTrace/View/Util/ContextMenuHelper.cs): `JournalTrace/View/Util/ContextMenuHelper.cs`

### Other components

- **User**
- **Windows NTFS**

## Connections

- User → Application Startup: starts app (evidence: `JournalTrace/Program.cs`)
- Application Startup → Main Window: runs window (evidence: `JournalTrace/Program.cs`)
- Application Startup → Localization Manager: initializes (evidence: `JournalTrace/Program.cs`)
- Application Startup → Context Menu Helper: initializes (evidence: `JournalTrace/Program.cs`)
- User → Main Window: uses UI
- Main Window → Entry Manager: starts scan (evidence: `JournalTrace/View/FormMain.cs`)
- Main Window → Volume Picker: opens picker (evidence: `JournalTrace/View/FormMain.cs`)
- Volume Picker → Main Window: selects volume (evidence: `JournalTrace/View/FormDrive.cs`)
- Main Window → Grid View: selects layout (evidence: `JournalTrace/View/FormMain.cs`)
- Main Window → Directory Tree: selects layout (evidence: `JournalTrace/View/FormMain.cs`)
- Main Window → Layout Contract: uses interface (evidence: `JournalTrace/View/FormMain.cs`)
- Grid View → Layout Contract: implements (evidence: `JournalTrace/View/Layout/ILayout.cs`)
- Directory Tree → Layout Contract: implements (evidence: `JournalTrace/View/Layout/ILayout.cs`)
- Grid View → Entry Manager: reads entries (evidence: `JournalTrace/View/Layout/GridLayout.cs`)
- Directory Tree → Entry Manager: builds tree (evidence: `JournalTrace/View/Layout/TreeLayout.cs`)
- Main Window → Entry Details: opens details (evidence: `JournalTrace/View/FormMain.cs`)
- Main Window → About Window: opens info (evidence: `JournalTrace/View/FormMain.cs`)
- About Window → Social Links: creates links (evidence: `JournalTrace/View/Info/FormInfo.cs`)
- Entry Manager → USN Journal Reader: reads journal (evidence: `JournalTrace/Entry/EntryManager.cs`)
- Entry Manager → Win32 API: uses API types (evidence: `JournalTrace/Entry/EntryManager.cs`)
- Entry Manager → Journal Record: creates records (evidence: `JournalTrace/Entry/EntryManager.cs`)
- Entry Manager → Record Collections: groups records (evidence: `JournalTrace/Entry/EntryManager.cs`)
- Entry Manager → Resolved Identifier: resolves references (evidence: `JournalTrace/Entry/EntryManager.cs`)
- Resolved Identifier → File ID Resolver: resolves path (evidence: `JournalTrace/Entry/ResolvableIdentifier.cs`)
- USN Journal Reader → Win32 API: uses API (evidence: `JournalTrace/Native/NtfsUsnJournal.cs`)
- USN Journal Reader → Windows NTFS: queries journal
- File ID Resolver → Windows NTFS: opens by ID
- Grid View → Context Menu Helper: shows menu (evidence: `JournalTrace/View/Layout/GridLayout.cs`)
- Directory Tree → Context Menu Helper: shows menu (evidence: `JournalTrace/View/Layout/TreeLayout.cs`)
- Entry Details → Entry Manager: reads entry data (evidence: `JournalTrace/View/FormEntryInfo.cs`)
- Entry Details → Resolved Identifier: resolves current file (evidence: `JournalTrace/View/FormEntryInfo.cs`)
- Localization Manager → Localized Controls: tracks controls (evidence: `JournalTrace/Language/LanguageManager.cs`)
- Main Window → Localization Manager: updates language (evidence: `JournalTrace/View/FormMain.cs`)
- Context Menu Helper → Entry Manager: reads selected record (evidence: `JournalTrace/View/Util/ContextMenuHelper.cs`)
