# madeinspace/ig-monitor architecture

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

- Interactive diagram: https://gitdiagram.com/madeinspace/ig-monitor
- Repository: https://github.com/madeinspace/ig-monitor

## Overview

This is a single-file monitor for claimable Victorian assignments on an IG dashboard. The operator starts it, the monitor opens a persistent Playwright browser, checks the dashboard for available assignments, detects new items, and presents or sends alerts. A separate setup script opens the dashboard for manual login and saves a text snapshot. The excerpts show browser setup, assignment parsing, and notification mechanisms, but omit parts of the polling loop; links across those omitted sections are therefore limited.

Main entry points: [`monitor.py`](https://github.com/madeinspace/ig-monitor/blob/main/monitor.py) (Monitor loop), [`setup.py`](https://github.com/madeinspace/ig-monitor/blob/main/setup.py) (Setup script)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_monitor["Assignment monitoring"]
  node_monitor_loop["Monitor loop<br/>[monitor.py]"]
  node_browser_session["Browser session<br/>[monitor.py]"]
  node_assignment_parser["Assignment parser<br/>[monitor.py]"]
  node_change_detection["Change detection<br/>[monitor.py]"]
end

subgraph group_alerts["Alerts and display"]
  node_terminal_output["Terminal output<br/>[monitor.py]"]
  node_notification_dispatch["Notification dispatch<br/>[monitor.py]"]
  node_telegram_sender["Telegram sender<br/>[monitor.py]"]
  node_email_sender["Email sender<br/>[monitor.py]"]
  node_desktop_notification["Desktop notification<br/>[monitor.py]"]
end

subgraph group_setup["Manual setup"]
  node_setup_script["Setup script<br/>[setup.py]"]
  node_snapshot_file["Dashboard snapshot<br/>[setup.py]"]
end

node_operator(("Operator"))
node_dashboard["IG dashboard"]
node_telegram_api["Telegram API"]
node_smtp_service["SMTP service"]

node_operator -->|"starts"| node_monitor_loop
node_monitor_loop -->|"launches"| node_browser_session
node_browser_session -->|"reads page"| node_assignment_parser
node_monitor_loop -->|"detects new IDs"| node_change_detection
node_monitor_loop -->|"prints status"| node_terminal_output
node_monitor_loop -->|"calls"| node_notification_dispatch
node_notification_dispatch -.->|"dispatches"| node_telegram_sender
node_telegram_sender -->|"posts alert"| node_telegram_api
node_notification_dispatch -.->|"dispatches"| node_email_sender
node_email_sender -->|"sends email"| node_smtp_service
node_notification_dispatch -.->|"notifies"| node_desktop_notification
node_operator -->|"runs"| node_setup_script
node_setup_script -->|"opens"| node_dashboard
node_setup_script -->|"writes text"| node_snapshot_file

click node_monitor_loop "https://github.com/madeinspace/ig-monitor/blob/main/monitor.py"
click node_browser_session "https://github.com/madeinspace/ig-monitor/blob/main/monitor.py"
click node_assignment_parser "https://github.com/madeinspace/ig-monitor/blob/main/monitor.py"
click node_change_detection "https://github.com/madeinspace/ig-monitor/blob/main/monitor.py"
click node_terminal_output "https://github.com/madeinspace/ig-monitor/blob/main/monitor.py"
click node_notification_dispatch "https://github.com/madeinspace/ig-monitor/blob/main/monitor.py"
click node_telegram_sender "https://github.com/madeinspace/ig-monitor/blob/main/monitor.py"
click node_email_sender "https://github.com/madeinspace/ig-monitor/blob/main/monitor.py"
click node_desktop_notification "https://github.com/madeinspace/ig-monitor/blob/main/monitor.py"
click node_setup_script "https://github.com/madeinspace/ig-monitor/blob/main/setup.py"
click node_snapshot_file "https://github.com/madeinspace/ig-monitor/blob/main/setup.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_monitor_loop,node_browser_session,node_assignment_parser,node_change_detection toneBlue
class node_terminal_output,node_notification_dispatch,node_telegram_sender,node_email_sender,node_desktop_notification toneAmber
class node_setup_script,node_snapshot_file,node_telegram_api toneMint
class node_operator,node_dashboard,node_smtp_service toneIndigo
```

## Components

### Assignment monitoring

- [Monitor loop](https://github.com/madeinspace/ig-monitor/blob/main/monitor.py): `monitor.py`
- [Browser session](https://github.com/madeinspace/ig-monitor/blob/main/monitor.py): `monitor.py`
- [Assignment parser](https://github.com/madeinspace/ig-monitor/blob/main/monitor.py): `monitor.py`
- [Change detection](https://github.com/madeinspace/ig-monitor/blob/main/monitor.py): `monitor.py`

### Alerts and display

- [Terminal output](https://github.com/madeinspace/ig-monitor/blob/main/monitor.py): `monitor.py`
- [Notification dispatch](https://github.com/madeinspace/ig-monitor/blob/main/monitor.py): `monitor.py`
- [Telegram sender](https://github.com/madeinspace/ig-monitor/blob/main/monitor.py): `monitor.py`
- [Email sender](https://github.com/madeinspace/ig-monitor/blob/main/monitor.py): `monitor.py`
- [Desktop notification](https://github.com/madeinspace/ig-monitor/blob/main/monitor.py): `monitor.py`

### Manual setup

- [Setup script](https://github.com/madeinspace/ig-monitor/blob/main/setup.py): `setup.py`
- [Dashboard snapshot](https://github.com/madeinspace/ig-monitor/blob/main/setup.py): `setup.py`

### Other components

- **Operator**
- **IG dashboard**
- **Telegram API**
- **SMTP service**

## Connections

- Operator → Monitor loop: starts
- Monitor loop → Browser session: launches (evidence: `monitor.py`)
- Browser session → Assignment parser: reads page (evidence: `monitor.py`)
- Monitor loop → Change detection: detects new IDs (evidence: `monitor.py`)
- Monitor loop → Terminal output: prints status (evidence: `monitor.py`)
- Monitor loop → Notification dispatch: calls (evidence: `monitor.py`)
- Notification dispatch → Telegram sender: dispatches (evidence: `monitor.py`)
- Telegram sender → Telegram API: posts alert (evidence: `monitor.py`)
- Notification dispatch → Email sender: dispatches (evidence: `monitor.py`)
- Email sender → SMTP service: sends email (evidence: `monitor.py`)
- Notification dispatch → Desktop notification: notifies (evidence: `monitor.py`)
- Operator → Setup script: runs
- Setup script → IG dashboard: opens (evidence: `setup.py`)
- Setup script → Dashboard snapshot: writes text (evidence: `setup.py`)
