# matiasmurto/fatigavisual architecture

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

- Interactive diagram: https://gitdiagram.com/matiasmurto/fatigavisual
- Repository: https://github.com/matiasmurto/fatigavisual

## Overview

FatigaOcular is a desktop eye-fatigue monitor. A user controls the app, which processes camera frames, detects facial landmarks, calculates eye aspect ratio (EAR), and counts blinks; the interface also exposes calibration, user selection, and blink statistics. The sampled source shows database encryption and statistics access, but not the complete camera loop, alert behavior, or all persistence calls. Those unverified relationships are omitted rather than inferred.

Main entry points: [`main.py`](https://github.com/matiasmurto/fatigavisual/blob/master/main.py) (Control interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop application"]
  node_ui["Control interface<br/>[main.py]"]
  node_stats["Statistics view<br/>[main.py]"]
end

subgraph group_vision["Vision and calibration"]
  node_frames["Frame adjustment<br/>[main.py]"]
  node_landmarks["Face landmarks<br/>[main.py]"]
  node_ear["EAR calculation<br/>[main.py]"]
  node_blink["Blink detection<br/>[main.py]"]
  node_calibration["Calibration<br/>[main.py]"]
end

subgraph group_records["Users and records"]
  node_users["User management<br/>[main.py]"]
  node_database[("SQLite records<br/>[main.py]")]
  node_encryption["Data encryption<br/>[main.py]"]
end

node_user(("User"))

node_user -->|"controls"| node_ui
node_ui -.->|"processes frames"| node_frames
node_frames -->|"submits image"| node_landmarks
node_landmarks -->|"provides landmarks"| node_ear
node_ear -->|"provides EAR"| node_blink
node_ui -->|"hosts controls"| node_calibration
node_ui -->|"selects users"| node_users
node_users -->|"adds users"| node_database
node_ui -.->|"opens view"| node_stats
node_stats -->|"loads statistics"| node_database
node_database -->|"uses encryption"| node_encryption

click node_ui "https://github.com/matiasmurto/fatigavisual/blob/master/main.py"
click node_stats "https://github.com/matiasmurto/fatigavisual/blob/master/main.py"
click node_frames "https://github.com/matiasmurto/fatigavisual/blob/master/main.py"
click node_landmarks "https://github.com/matiasmurto/fatigavisual/blob/master/main.py"
click node_ear "https://github.com/matiasmurto/fatigavisual/blob/master/main.py"
click node_blink "https://github.com/matiasmurto/fatigavisual/blob/master/main.py"
click node_calibration "https://github.com/matiasmurto/fatigavisual/blob/master/main.py"
click node_users "https://github.com/matiasmurto/fatigavisual/blob/master/main.py"
click node_database "https://github.com/matiasmurto/fatigavisual/blob/master/main.py"
click node_encryption "https://github.com/matiasmurto/fatigavisual/blob/master/main.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_ui,node_stats,node_user toneBlue
class node_frames,node_landmarks,node_ear,node_blink,node_calibration toneAmber
class node_users,node_database,node_encryption toneMint
```

## Components

### Desktop application

- [Control interface](https://github.com/matiasmurto/fatigavisual/blob/master/main.py): `main.py`
- [Statistics view](https://github.com/matiasmurto/fatigavisual/blob/master/main.py): `main.py`

### Vision and calibration

- [Frame adjustment](https://github.com/matiasmurto/fatigavisual/blob/master/main.py): `main.py`
- [Face landmarks](https://github.com/matiasmurto/fatigavisual/blob/master/main.py): `main.py`
- [EAR calculation](https://github.com/matiasmurto/fatigavisual/blob/master/main.py): `main.py`
- [Blink detection](https://github.com/matiasmurto/fatigavisual/blob/master/main.py): `main.py`
- [Calibration](https://github.com/matiasmurto/fatigavisual/blob/master/main.py): `main.py`

### Users and records

- [User management](https://github.com/matiasmurto/fatigavisual/blob/master/main.py): `main.py`
- [SQLite records](https://github.com/matiasmurto/fatigavisual/blob/master/main.py): `main.py`
- [Data encryption](https://github.com/matiasmurto/fatigavisual/blob/master/main.py): `main.py`

### Other components

- **User**

## Connections

- User → Control interface: controls
- Control interface → Frame adjustment: processes frames (evidence: `main.py`)
- Frame adjustment → Face landmarks: submits image (evidence: `main.py`)
- Face landmarks → EAR calculation: provides landmarks (evidence: `main.py`)
- EAR calculation → Blink detection: provides EAR (evidence: `main.py`)
- Control interface → Calibration: hosts controls (evidence: `main.py`)
- Control interface → User management: selects users (evidence: `main.py`)
- User management → SQLite records: adds users (evidence: `main.py`)
- Control interface → Statistics view: opens view (evidence: `main.py`)
- Statistics view → SQLite records: loads statistics (evidence: `main.py`)
- SQLite records → Data encryption: uses encryption (evidence: `main.py`)
