# phiraphat29/uptime-monitor architecture

> Architecture diagram of the GitHub repository phiraphat29/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/phiraphat29/uptime-monitor
- Repository: https://github.com/phiraphat29/uptime-monitor

## Overview

This is a full-stack uptime monitor: users manage monitored URLs in a Next.js dashboard; the Go API stores monitor configuration, while a background worker checks targets, records results, and sends Discord alerts on state changes. Dashboard views include recent uptime history and latency charts, plus a controllable mock target for demonstrations. The README documents UI capabilities and API routes; source excerpts show the main calls and persistence/checking behavior. Some component-level frontend wiring is documented rather than shown in excerpts.

Main entry points: [`backend/handlers/monitor_handler.go`](https://github.com/phiraphat29/uptime-monitor/blob/main/backend/handlers/monitor_handler.go) (Monitor Handlers), [`backend/worker/checker.go`](https://github.com/phiraphat29/uptime-monitor/blob/main/backend/worker/checker.go) (Health Checker), [`frontend/src/app/page.tsx`](https://github.com/phiraphat29/uptime-monitor/blob/main/frontend/src/app/page.tsx) (Dashboard), [`backend/config/database.go`](https://github.com/phiraphat29/uptime-monitor/blob/main/backend/config/database.go) (Database Connection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Dashboard"]
  node_dashboard["Dashboard<br/>[page.tsx]"]
  node_monitor_form["Monitor Form"]
  node_monitor_card["Monitor Card<br/>[MonitorCard.tsx]"]
  node_uptime_bar["Uptime Bar<br/>[UptimeBar.tsx]"]
  node_latency_chart["Latency Chart<br/>[LatencyChart.tsx]"]
  node_navbar["Demo Controls<br/>[Navbar.tsx]"]
  node_api_client["API Client<br/>[api.ts]"]
end

subgraph group_api["Backend API"]
  node_server["HTTP Server<br/>[main.go]"]
  node_handlers["Monitor Handlers<br/>[monitor_handler.go]"]
  node_mock_target["Mock Target<br/>[monitor_handler.go]"]
end

subgraph group_monitoring["Monitoring"]
  node_worker["Health Checker<br/>[checker.go]"]
end

subgraph group_persistence["Persistence"]
  node_db_config["Database Connection<br/>[database.go]"]
  node_data_model["Monitor Records<br/>[monitor.go]"]
end

node_user(("Operator"))
node_target(("Monitored Target"))
node_discord(("Discord Webhook"))
node_postgres[("PostgreSQL")]

node_user -->|"uses"| node_dashboard
node_dashboard -->|"requests data"| node_api_client
node_dashboard -->|"opens"| node_monitor_form
node_dashboard -->|"renders"| node_monitor_card
node_monitor_card -->|"shows history"| node_uptime_bar
node_monitor_card -->|"shows latency"| node_latency_chart
node_dashboard -->|"offers controls"| node_navbar
node_monitor_form -->|"tests webhook"| node_api_client
node_api_client -->|"calls REST API"| node_handlers
node_server -->|"routes requests"| node_handlers
node_server -->|"connects database"| node_db_config
node_server -->|"starts worker"| node_worker
node_handlers -->|"reads and writes"| node_db_config
node_handlers -->|"uses records"| node_data_model
node_handlers -->|"starts checks"| node_worker
node_handlers -->|"serves demo"| node_mock_target
node_worker -->|"queries and saves"| node_db_config
node_worker -->|"records results"| node_data_model
node_worker -->|"checks URL"| node_target
node_worker -->|"sends alerts"| node_discord
node_db_config -->|"migrates schema"| node_data_model
node_db_config -->|"connects"| node_postgres
node_target -.->|"demo endpoint"| node_mock_target

click node_dashboard "https://github.com/phiraphat29/uptime-monitor/blob/main/frontend/src/app/page.tsx"
click node_monitor_form "https://github.com/phiraphat29/uptime-monitor/blob/main/frontend/src/components/AddMonitorModal.tsx"
click node_monitor_card "https://github.com/phiraphat29/uptime-monitor/blob/main/frontend/src/components/MonitorCard.tsx"
click node_uptime_bar "https://github.com/phiraphat29/uptime-monitor/blob/main/frontend/src/components/UptimeBar.tsx"
click node_latency_chart "https://github.com/phiraphat29/uptime-monitor/blob/main/frontend/src/components/LatencyChart.tsx"
click node_navbar "https://github.com/phiraphat29/uptime-monitor/blob/main/frontend/src/components/Navbar.tsx"
click node_api_client "https://github.com/phiraphat29/uptime-monitor/blob/main/frontend/src/lib/api.ts"
click node_server "https://github.com/phiraphat29/uptime-monitor/blob/main/backend/main.go"
click node_handlers "https://github.com/phiraphat29/uptime-monitor/blob/main/backend/handlers/monitor_handler.go"
click node_mock_target "https://github.com/phiraphat29/uptime-monitor/blob/main/backend/handlers/monitor_handler.go"
click node_worker "https://github.com/phiraphat29/uptime-monitor/blob/main/backend/worker/checker.go"
click node_db_config "https://github.com/phiraphat29/uptime-monitor/blob/main/backend/config/database.go"
click node_data_model "https://github.com/phiraphat29/uptime-monitor/blob/main/backend/models/monitor.go"

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_dashboard,node_monitor_form,node_monitor_card,node_uptime_bar,node_latency_chart,node_navbar,node_api_client toneBlue
class node_server,node_handlers,node_mock_target,node_postgres toneAmber
class node_worker,node_discord toneMint
class node_db_config,node_data_model toneRose
class node_user,node_target toneIndigo
```

## Components

### Dashboard

- [Dashboard](https://github.com/phiraphat29/uptime-monitor/blob/main/frontend/src/app/page.tsx): `frontend/src/app/page.tsx`
- [Monitor Form](https://github.com/phiraphat29/uptime-monitor/blob/main/frontend/src/components/AddMonitorModal.tsx): `frontend/src/components/AddMonitorModal.tsx`
- [Monitor Card](https://github.com/phiraphat29/uptime-monitor/blob/main/frontend/src/components/MonitorCard.tsx): `frontend/src/components/MonitorCard.tsx`
- [Uptime Bar](https://github.com/phiraphat29/uptime-monitor/blob/main/frontend/src/components/UptimeBar.tsx): `frontend/src/components/UptimeBar.tsx`
- [Latency Chart](https://github.com/phiraphat29/uptime-monitor/blob/main/frontend/src/components/LatencyChart.tsx): `frontend/src/components/LatencyChart.tsx`
- [Demo Controls](https://github.com/phiraphat29/uptime-monitor/blob/main/frontend/src/components/Navbar.tsx): `frontend/src/components/Navbar.tsx`
- [API Client](https://github.com/phiraphat29/uptime-monitor/blob/main/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`

### Backend API

- [HTTP Server](https://github.com/phiraphat29/uptime-monitor/blob/main/backend/main.go): `backend/main.go`
- [Monitor Handlers](https://github.com/phiraphat29/uptime-monitor/blob/main/backend/handlers/monitor_handler.go): `backend/handlers/monitor_handler.go`
- [Mock Target](https://github.com/phiraphat29/uptime-monitor/blob/main/backend/handlers/monitor_handler.go): `backend/handlers/monitor_handler.go`

### Monitoring

- [Health Checker](https://github.com/phiraphat29/uptime-monitor/blob/main/backend/worker/checker.go): `backend/worker/checker.go`

### Persistence

- [Database Connection](https://github.com/phiraphat29/uptime-monitor/blob/main/backend/config/database.go): `backend/config/database.go`
- [Monitor Records](https://github.com/phiraphat29/uptime-monitor/blob/main/backend/models/monitor.go): `backend/models/monitor.go`

### Other components

- **Operator**
- **Monitored Target**
- **Discord Webhook**
- **PostgreSQL**

## Connections

- Operator → Dashboard: uses (evidence: `README.md`)
- Dashboard → API Client: requests data (evidence: `frontend/src/app/page.tsx`)
- Dashboard → Monitor Form: opens (evidence: `frontend/src/app/page.tsx`)
- Dashboard → Monitor Card: renders (evidence: `frontend/src/app/page.tsx`)
- Monitor Card → Uptime Bar: shows history (evidence: `README.md`)
- Monitor Card → Latency Chart: shows latency (evidence: `README.md`)
- Dashboard → Demo Controls: offers controls (evidence: `README.md`)
- Monitor Form → API Client: tests webhook (evidence: `frontend/src/components/AddMonitorModal.tsx`)
- API Client → Monitor Handlers: calls REST API (evidence: `frontend/src/lib/api.ts`)
- HTTP Server → Monitor Handlers: routes requests (evidence: `backend/main.go`)
- HTTP Server → Database Connection: connects database (evidence: `backend/main.go`)
- HTTP Server → Health Checker: starts worker (evidence: `backend/main.go`)
- Monitor Handlers → Database Connection: reads and writes (evidence: `backend/handlers/monitor_handler.go`)
- Monitor Handlers → Monitor Records: uses records (evidence: `backend/handlers/monitor_handler.go`)
- Monitor Handlers → Health Checker: starts checks (evidence: `backend/handlers/monitor_handler.go`)
- Monitor Handlers → Mock Target: serves demo (evidence: `backend/handlers/monitor_handler.go`)
- Health Checker → Database Connection: queries and saves (evidence: `backend/worker/checker.go`)
- Health Checker → Monitor Records: records results (evidence: `backend/worker/checker.go`)
- Health Checker → Monitored Target: checks URL (evidence: `backend/worker/checker.go`)
- Health Checker → Discord Webhook: sends alerts (evidence: `backend/worker/checker.go`)
- Database Connection → Monitor Records: migrates schema (evidence: `backend/config/database.go`)
- Database Connection → PostgreSQL: connects (evidence: `backend/config/database.go`)
- Monitored Target → Mock Target: demo endpoint
