# rakeshvankadara-netizen/file-integrity-monitor architecture

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

- Interactive diagram: https://gitdiagram.com/rakeshvankadara-netizen/file-integrity-monitor
- Repository: https://github.com/rakeshvankadara-netizen/file-integrity-monitor

## Overview

A Tkinter desktop app lets a user choose a folder, count its files, create or load a SHA-256 baseline, and check for modified, added, or deleted files. Results and status appear in the GUI, while baseline data and integrity events are persisted locally. Reset, log viewing, and About are additional GUI actions. The runtime is implemented in one file; the graph reflects that source and the README, without assuming details beyond them.

Main entry points: [`file_integrity_monitor.py`](https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py) (Tkinter GUI), [`baseline.json`](https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/baseline.json) (Baseline JSON), [`integrity_log.txt`](https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/integrity_log.txt) (Integrity log)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gui["Desktop interface"]
  node_gui["Tkinter GUI"]
  node_results["Status and results"]
  node_reset["Reset action"]
  node_about["About action"]
  node_log_view["Log viewing"]
end

subgraph group_monitor["Integrity monitoring"]
  node_folder["Folder selection"]
  node_count["File counting"]
  node_hash["SHA-256 hashing"]
  node_baseline["Baseline creation"]
  node_load["Baseline loading"]
  node_compare["Integrity comparison"]
  node_detect["Change detection"]
end

subgraph group_persistence["Local persistence"]
  node_baseline_store[("Baseline JSON<br/>[baseline.json]")]
  node_logging["Integrity logging"]
  node_log_store[("Integrity log<br/>[integrity_log.txt]")]
end

node_user(("User"))

node_user -->|"uses"| node_gui
node_gui -->|"dispatches"| node_folder
node_folder -->|"counts files"| node_count
node_gui -->|"dispatches"| node_baseline
node_baseline -->|"hashes files"| node_hash
node_baseline -->|"writes"| node_baseline_store
node_gui -->|"dispatches"| node_load
node_load -->|"reads"| node_baseline_store
node_gui -->|"dispatches"| node_compare
node_compare -->|"reads"| node_baseline_store
node_compare -->|"hashes current files"| node_hash
node_compare -->|"compares sets"| node_detect
node_compare -->|"records outcome"| node_logging
node_detect -->|"formats changes"| node_results
node_compare -->|"updates status"| node_results
node_logging -->|"appends"| node_log_store
node_gui -->|"dispatches"| node_reset
node_reset -->|"clears display"| node_results
node_gui -->|"dispatches"| node_log_view
node_log_view -->|"opens"| node_log_store
node_gui -->|"dispatches"| node_about

click node_gui "https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py"
click node_folder "https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py"
click node_count "https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py"
click node_hash "https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py"
click node_baseline "https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py"
click node_load "https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py"
click node_compare "https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py"
click node_detect "https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py"
click node_results "https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py"
click node_reset "https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py"
click node_about "https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py"
click node_baseline_store "https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/baseline.json"
click node_logging "https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py"
click node_log_store "https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/integrity_log.txt"
click node_log_view "https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py"

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_gui,node_results,node_reset,node_about,node_log_view,node_user toneBlue
class node_folder,node_count,node_hash,node_baseline,node_load,node_compare,node_detect toneAmber
class node_baseline_store,node_logging,node_log_store toneMint
```

## Components

### Desktop interface

- [Tkinter GUI](https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py): `file_integrity_monitor.py`
- [Status and results](https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py): `file_integrity_monitor.py`
- [Reset action](https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py): `file_integrity_monitor.py`
- [About action](https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py): `file_integrity_monitor.py`
- [Log viewing](https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py): `file_integrity_monitor.py`

### Integrity monitoring

- [Folder selection](https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py): `file_integrity_monitor.py`
- [File counting](https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py): `file_integrity_monitor.py`
- [SHA-256 hashing](https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py): `file_integrity_monitor.py`
- [Baseline creation](https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py): `file_integrity_monitor.py`
- [Baseline loading](https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py): `file_integrity_monitor.py`
- [Integrity comparison](https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py): `file_integrity_monitor.py`
- [Change detection](https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py): `file_integrity_monitor.py`

### Local persistence

- [Baseline JSON](https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/baseline.json): `baseline.json`
- [Integrity logging](https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/file_integrity_monitor.py): `file_integrity_monitor.py`
- [Integrity log](https://github.com/rakeshvankadara-netizen/file-integrity-monitor/blob/main/integrity_log.txt): `integrity_log.txt`

### Other components

- **User**

## Connections

- User → Tkinter GUI: uses (evidence: `file_integrity_monitor.py`)
- Tkinter GUI → Folder selection: dispatches (evidence: `file_integrity_monitor.py`)
- Folder selection → File counting: counts files (evidence: `file_integrity_monitor.py`)
- Tkinter GUI → Baseline creation: dispatches (evidence: `file_integrity_monitor.py`)
- Baseline creation → SHA-256 hashing: hashes files (evidence: `file_integrity_monitor.py`)
- Baseline creation → Baseline JSON: writes (evidence: `file_integrity_monitor.py`)
- Tkinter GUI → Baseline loading: dispatches (evidence: `file_integrity_monitor.py`)
- Baseline loading → Baseline JSON: reads (evidence: `file_integrity_monitor.py`)
- Tkinter GUI → Integrity comparison: dispatches (evidence: `file_integrity_monitor.py`)
- Integrity comparison → Baseline JSON: reads (evidence: `file_integrity_monitor.py`)
- Integrity comparison → SHA-256 hashing: hashes current files (evidence: `file_integrity_monitor.py`)
- Integrity comparison → Change detection: compares sets (evidence: `file_integrity_monitor.py`)
- Integrity comparison → Integrity logging: records outcome (evidence: `file_integrity_monitor.py`)
- Change detection → Status and results: formats changes (evidence: `file_integrity_monitor.py`)
- Integrity comparison → Status and results: updates status (evidence: `file_integrity_monitor.py`)
- Integrity logging → Integrity log: appends (evidence: `file_integrity_monitor.py`)
- Tkinter GUI → Reset action: dispatches (evidence: `file_integrity_monitor.py`)
- Reset action → Status and results: clears display (evidence: `file_integrity_monitor.py`)
- Tkinter GUI → Log viewing: dispatches (evidence: `file_integrity_monitor.py`)
- Log viewing → Integrity log: opens (evidence: `file_integrity_monitor.py`)
- Tkinter GUI → About action: dispatches (evidence: `file_integrity_monitor.py`)
