# fizixblzz-creator/uptime-monitor- architecture

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

- Interactive diagram: https://gitdiagram.com/fizixblzz-creator/uptime-monitor-
- Repository: https://github.com/fizixblzz-creator/uptime-monitor-

## Overview

Uptime Watch is a small uptime-monitoring service with a dashboard and JSON API. Users manage monitors through HTTP; the service validates public URLs, schedules checks, records results, and exposes status summaries. The main internal layers are request handling, monitor/check logic, and persisted state. The excerpts show scheduler dispatch and API behavior, but omit persistence details and the dashboard implementation, so those relationships are not asserted as verified.

Main entry points: [`server.py`](https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/server.py) (Monitor state), [`public/index.html`](https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/public/index.html) (Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_http["HTTP service"]
  node_handler["HTTP handler<br/>[server.py]"]
  node_api["Monitor API<br/>[server.py]"]
  node_server["HTTP server<br/>[server.py]"]
end

subgraph group_monitoring["Monitoring"]
  node_create["Monitor creation<br/>[server.py]"]
  node_urlvalidation["URL validation<br/>[server.py]"]
  node_scheduler["Check scheduler<br/>[server.py]"]
  node_execution["Check execution<br/>[server.py]"]
  node_httpcheck["HTTP probe<br/>[server.py]"]
  node_summary["Status summaries<br/>[server.py]"]
end

subgraph group_state["Monitor state"]
  node_monitorstate[("Monitor state<br/>[server.py]")]
  node_persistence["File persistence<br/>[server.py]"]
end

subgraph group_interface["User interface"]
  node_dashboard["Dashboard<br/>[index.html]"]
end

node_user(("User"))
node_endpoint(("Monitored endpoint"))

node_user -->|"sends requests"| node_server
node_server -->|"dispatches"| node_handler
node_handler -->|"routes API"| node_api
node_api -->|"creates monitors"| node_create
node_create -->|"validates URL"| node_urlvalidation
node_create -->|"adds monitor"| node_monitorstate
node_scheduler -->|"dispatches checks"| node_execution
node_execution -->|"records results"| node_monitorstate
node_httpcheck -->|"requests status"| node_endpoint
node_api -->|"summarizes monitors"| node_summary
node_summary -->|"reads history"| node_monitorstate
node_monitorstate -.->|"saved and loaded"| node_persistence
node_handler -.->|"serves static"| node_dashboard

click node_handler "https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/server.py"
click node_api "https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/server.py"
click node_server "https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/server.py"
click node_create "https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/server.py"
click node_urlvalidation "https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/server.py"
click node_scheduler "https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/server.py"
click node_execution "https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/server.py"
click node_httpcheck "https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/server.py"
click node_summary "https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/server.py"
click node_monitorstate "https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/server.py"
click node_persistence "https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/server.py"
click node_dashboard "https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/public/index.html"

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_handler,node_api,node_server,node_user toneBlue
class node_create,node_urlvalidation,node_scheduler,node_execution,node_httpcheck,node_summary toneAmber
class node_monitorstate,node_persistence toneMint
class node_dashboard toneRose
class node_endpoint toneIndigo
```

## Components

### HTTP service

- [HTTP handler](https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/server.py): `server.py`
- [Monitor API](https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/server.py): `server.py`
- [HTTP server](https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/server.py): `server.py`

### Monitoring

- [Monitor creation](https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/server.py): `server.py`
- [URL validation](https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/server.py): `server.py`
- [Check scheduler](https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/server.py): `server.py`
- [Check execution](https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/server.py): `server.py`
- [HTTP probe](https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/server.py): `server.py`
- [Status summaries](https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/server.py): `server.py`

### Monitor state

- [Monitor state](https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/server.py): `server.py`
- [File persistence](https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/server.py): `server.py`

### User interface

- [Dashboard](https://github.com/fizixblzz-creator/uptime-monitor-/blob/main/public/index.html): `public/index.html`

### Other components

- **User**
- **Monitored endpoint**

## Connections

- User → HTTP server: sends requests (evidence: `server.py`)
- HTTP server → HTTP handler: dispatches (evidence: `server.py`)
- HTTP handler → Monitor API: routes API (evidence: `server.py`)
- Monitor API → Monitor creation: creates monitors (evidence: `server.py`)
- Monitor creation → URL validation: validates URL (evidence: `server.py`)
- Monitor creation → Monitor state: adds monitor (evidence: `server.py`)
- Check scheduler → Check execution: dispatches checks (evidence: `server.py`)
- Check execution → Monitor state: records results (evidence: `server.py`)
- HTTP probe → Monitored endpoint: requests status (evidence: `server.py`)
- Monitor API → Status summaries: summarizes monitors (evidence: `server.py`)
- Status summaries → Monitor state: reads history (evidence: `server.py`)
- Monitor state → File persistence: saved and loaded (evidence: `server.py`)
- HTTP handler → Dashboard: serves static
