# dsk-dev-ai/api-monitor-saas architecture

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

- Interactive diagram: https://gitdiagram.com/dsk-dev-ai/api-monitor-saas
- Repository: https://github.com/dsk-dev-ai/api-monitor-saas

## Overview

API Monitor SaaS combines a Next.js dashboard, Express API, and scheduled monitoring worker over PostgreSQL. Users authenticate, configure monitors, and view status and analytics; the worker probes active monitors, records results, detects changes, and produces alerts. The README also documents public status pages and backend-only billing. Edges reflect sampled call sites, SOURCE INDEX references, or README statements; several frontend-to-API and unsampled feature details are documented rather than verified in excerpts.

Main entry points: [`backend/src/config/database.ts`](https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/backend/src/config/database.ts) (PostgreSQL), [`backend/src/server.ts`](https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/backend/src/server.ts) (HTTP server), [`frontend/src/lib/api-client.ts`](https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/frontend/src/lib/api-client.ts) (API client), [`worker/src/index.ts`](https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/worker/src/index.ts) (Check scheduler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Dashboard"]
  node_dashboard["Dashboard pages<br/>[page.tsx]"]
  node_monitor_ui["Monitor workflow<br/>[monitor-wizard.tsx]"]
  node_analytics_ui["Analytics pages<br/>[page.tsx]"]
  node_public_ui["Public status view<br/>[page.tsx]"]
  node_api_client["API client<br/>[api-client.ts]"]
end

subgraph group_api["Express API"]
  node_api_server["HTTP server<br/>[server.ts]"]
  node_auth_routes["Authentication<br/>[auth.ts]"]
  node_auth_middleware["Credential middleware<br/>[auth.ts]"]
  node_monitor_routes["Monitor management<br/>[monitors.ts]"]
  node_analytics_routes["Analytics<br/>[analytics.ts]"]
  node_alerts_routes["Alert history<br/>[alerts.ts]"]
  node_status_routes["Status pages<br/>[statusPages.ts]"]
  node_billing_routes["Billing<br/>[billing.ts]"]
end

subgraph group_worker["Monitoring Worker"]
  node_worker_scheduler["Check scheduler<br/>[index.ts]"]
  node_probe_executor["HTTP probe<br/>[executor.ts]"]
  node_ssrf_policy["SSRF protection<br/>[ssrf-policy.ts]"]
  node_response_limit["Response limits<br/>[response-limit.ts]"]
  node_email_alerts["Email alerts<br/>[alert-service.ts]"]
end

subgraph group_state["Data and Integrations"]
  node_database[("PostgreSQL<br/>[database.ts]")]
  node_supabase["Supabase Auth"]
  node_resend["Resend"]
  node_stripe["Stripe"]
end

node_user(("User"))
node_monitored_service(("Monitored endpoint"))

node_user -->|"uses"| node_dashboard
node_dashboard -.->|"requests data"| node_api_client
node_monitor_ui -.->|"submits monitors"| node_api_client
node_analytics_ui -.->|"requests analytics"| node_api_client
node_public_ui -.->|"requests status"| node_api_client
node_api_client -->|"calls API"| node_api_server
node_api_server -->|"mounts routes"| node_auth_routes
node_api_server -->|"mounts routes"| node_monitor_routes
node_api_server -->|"mounts routes"| node_analytics_routes
node_api_server -->|"mounts routes"| node_billing_routes
node_api_server -->|"mounts routes"| node_status_routes
node_api_server -->|"mounts routes"| node_alerts_routes
node_auth_routes -->|"authenticates users"| node_supabase
node_auth_routes -->|"updates accounts"| node_database
node_auth_middleware -->|"loads account"| node_database
node_monitor_routes -->|"manages monitors"| node_database
node_analytics_routes -->|"reads metrics"| node_database
node_alerts_routes -->|"reads alerts"| node_database
node_status_routes -->|"reads status"| node_database
node_billing_routes -->|"manages billing records"| node_database
node_billing_routes -.->|"billing integration"| node_stripe
node_worker_scheduler -->|"loads monitors, stores checks"| node_database
node_worker_scheduler -->|"runs probes"| node_probe_executor
node_probe_executor -->|"sends HTTP probe"| node_monitored_service
node_probe_executor -->|"validates destinations"| node_ssrf_policy
node_probe_executor -->|"enforces response cap"| node_response_limit
node_worker_scheduler -->|"sends on status change"| node_email_alerts
node_email_alerts -->|"sends email"| node_resend
node_worker_scheduler -->|"writes alert records"| node_database

click node_dashboard "https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/frontend/src/app/(dashboard)/dashboard/page.tsx"
click node_monitor_ui "https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/frontend/src/components/monitors/wizard/monitor-wizard.tsx"
click node_analytics_ui "https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/frontend/src/app/(dashboard)/analytics/page.tsx"
click node_public_ui "https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/frontend/src/app/(public)/status/%5Bslug%5D/page.tsx"
click node_api_client "https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/frontend/src/lib/api-client.ts"
click node_api_server "https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/backend/src/server.ts"
click node_auth_routes "https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/backend/src/routes/auth.ts"
click node_auth_middleware "https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/backend/src/middleware/auth.ts"
click node_monitor_routes "https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/backend/src/routes/monitors.ts"
click node_analytics_routes "https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/backend/src/routes/analytics.ts"
click node_alerts_routes "https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/backend/src/routes/alerts.ts"
click node_status_routes "https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/backend/src/routes/statusPages.ts"
click node_billing_routes "https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/backend/src/routes/billing.ts"
click node_worker_scheduler "https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/worker/src/index.ts"
click node_probe_executor "https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/worker/src/services/executor.ts"
click node_ssrf_policy "https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/worker/src/security/ssrf-policy.ts"
click node_response_limit "https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/worker/src/config/response-limit.ts"
click node_email_alerts "https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/worker/src/services/alert-service.ts"
click node_database "https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/backend/src/config/database.ts"

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_ui,node_analytics_ui,node_public_ui,node_api_client,node_user toneBlue
class node_api_server,node_auth_routes,node_auth_middleware,node_monitor_routes,node_analytics_routes,node_alerts_routes,node_status_routes,node_billing_routes toneAmber
class node_worker_scheduler,node_probe_executor,node_ssrf_policy,node_response_limit,node_email_alerts toneMint
class node_database,node_supabase,node_resend,node_stripe toneRose
class node_monitored_service toneIndigo
```

## Components

### Dashboard

- [Dashboard pages](https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/frontend/src/app/(dashboard)/dashboard/page.tsx): `frontend/src/app/(dashboard)/dashboard/page.tsx`
- [Monitor workflow](https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/frontend/src/components/monitors/wizard/monitor-wizard.tsx): `frontend/src/components/monitors/wizard/monitor-wizard.tsx`
- [Analytics pages](https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/frontend/src/app/(dashboard)/analytics/page.tsx): `frontend/src/app/(dashboard)/analytics/page.tsx`
- [Public status view](https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/frontend/src/app/(public)/status/%5Bslug%5D/page.tsx): `frontend/src/app/(public)/status/[slug]/page.tsx`
- [API client](https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/frontend/src/lib/api-client.ts): `frontend/src/lib/api-client.ts`

### Express API

- [HTTP server](https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/backend/src/server.ts): `backend/src/server.ts`
- [Authentication](https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/backend/src/routes/auth.ts): `backend/src/routes/auth.ts`
- [Credential middleware](https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/backend/src/middleware/auth.ts): `backend/src/middleware/auth.ts`
- [Monitor management](https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/backend/src/routes/monitors.ts): `backend/src/routes/monitors.ts`
- [Analytics](https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/backend/src/routes/analytics.ts): `backend/src/routes/analytics.ts`
- [Alert history](https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/backend/src/routes/alerts.ts): `backend/src/routes/alerts.ts`
- [Status pages](https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/backend/src/routes/statusPages.ts): `backend/src/routes/statusPages.ts`
- [Billing](https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/backend/src/routes/billing.ts): `backend/src/routes/billing.ts`

### Monitoring Worker

- [Check scheduler](https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/worker/src/index.ts): `worker/src/index.ts`
- [HTTP probe](https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/worker/src/services/executor.ts): `worker/src/services/executor.ts`
- [SSRF protection](https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/worker/src/security/ssrf-policy.ts): `worker/src/security/ssrf-policy.ts`
- [Response limits](https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/worker/src/config/response-limit.ts): `worker/src/config/response-limit.ts`
- [Email alerts](https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/worker/src/services/alert-service.ts): `worker/src/services/alert-service.ts`

### Data and Integrations

- [PostgreSQL](https://github.com/dsk-dev-ai/api-monitor-saas/blob/main/backend/src/config/database.ts): `backend/src/config/database.ts`
- **Supabase Auth**
- **Resend**
- **Stripe**

### Other components

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

## Connections

- User → Dashboard pages: uses (evidence: `README.md`)
- Dashboard pages → API client: requests data
- Monitor workflow → API client: submits monitors
- Analytics pages → API client: requests analytics
- Public status view → API client: requests status
- API client → HTTP server: calls API (evidence: `README.md`)
- HTTP server → Authentication: mounts routes (evidence: `backend/src/server.ts`)
- HTTP server → Monitor management: mounts routes (evidence: `backend/src/server.ts`)
- HTTP server → Analytics: mounts routes (evidence: `backend/src/server.ts`)
- HTTP server → Billing: mounts routes (evidence: `backend/src/server.ts`)
- HTTP server → Status pages: mounts routes (evidence: `backend/src/server.ts`)
- HTTP server → Alert history: mounts routes (evidence: `backend/src/server.ts`)
- Authentication → Supabase Auth: authenticates users (evidence: `backend/src/routes/auth.ts`)
- Authentication → PostgreSQL: updates accounts (evidence: `backend/src/routes/auth.ts`)
- Credential middleware → PostgreSQL: loads account (evidence: `backend/src/middleware/auth.ts`)
- Monitor management → PostgreSQL: manages monitors (evidence: `backend/src/routes/monitors.ts`)
- Analytics → PostgreSQL: reads metrics (evidence: `backend/src/routes/analytics.ts`)
- Alert history → PostgreSQL: reads alerts (evidence: `backend/src/routes/alerts.ts`)
- Status pages → PostgreSQL: reads status (evidence: `backend/src/routes/statusPages.ts`)
- Billing → PostgreSQL: manages billing records (evidence: `backend/src/routes/billing.ts`)
- Billing → Stripe: billing integration (evidence: `README.md`)
- Check scheduler → PostgreSQL: loads monitors, stores checks (evidence: `worker/src/index.ts`)
- Check scheduler → HTTP probe: runs probes (evidence: `worker/src/index.ts`)
- HTTP probe → Monitored endpoint: sends HTTP probe (evidence: `README.md`)
- HTTP probe → SSRF protection: validates destinations (evidence: `worker/src/services/executor.ts`)
- HTTP probe → Response limits: enforces response cap (evidence: `worker/src/services/executor.ts`)
- Check scheduler → Email alerts: sends on status change (evidence: `worker/src/index.ts`)
- Email alerts → Resend: sends email (evidence: `worker/src/services/alert-service.ts`)
- Check scheduler → PostgreSQL: writes alert records (evidence: `worker/src/index.ts`)
