THE BLUEPRINT — HOW VIGIL RUNS

Two processes. One datastore. No Redis, no broker, no accidental complexity — the full rationale ships in ARCHITECTURE.md, readable before you buy.

NEXT.JS 16 · TYPESCRIPT STRICT · POSTGRES 18 · DRIZZLE · PG-BOSS · DOCKER 135 TESTS · CI · MULTI-STAGE IMAGES
TIER 01
CLIENTS
Team browser
Public visitors
TIER 02
TWO PROCESSES
WebNEXT.JS 16
server actions + RBAC guards
dashboards · status pages (ISR)
↳ Anthropic API — optional
WorkerNODE 20
cron tick — every minute
fan-out · dedup · drift correction
→ HTTP checks on your endpoints
TIER 03
ONE DATASTORE
PostgreSQL 18DRIZZLE ORM · PG-BOSS
application data + job queue in one database — no Redis, no message broker, one thing to back up
02  FIRST BOOT

One command. Ten minutes.

The compose file boots Postgres, runs migrations, starts the worker and serves the app. Bare-metal works too — Node 20.9+, two processes, one database.

SEE WHAT BOOTS
TERMINAL — FIRST BOOT~10 MIN
$ git clone git@vigil/vigil.git && cd vigil
$ docker compose up
postgres   ready — :5432
migrate    schema up to date
worker     cron tick — queue live
web        ready — http://localhost:3000
vigil is awake. watching begins now_
03  THE DATA MODEL

Everything hangs off the organization.

Tenancy is structural, not bolted on — every table is scoped to an org, and isolation is covered by tests.

organization
HAS
member
OWNS
monitors
│ PRODUCES
monitor_checks
OWNS
incidents
│ TIMELINE
incident_events
HAS
status_pages
│ SHOWS
status_page_monitors

MONITORS OPEN INCIDENTS AUTOMATICALLY ON REPEATED FAILURE

04  THE MATH

You already know what these weeks cost.

Conservative estimates for one senior engineer building the same subsystems to the same standard — typed, tested, documented, hardened.

SUBSYSTEM
WHAT IT ACTUALLY INVOLVES
TIME
Auth + RBAC
Sessions, orgs, invitations, role matrix, guard chain, tenancy isolation tests
3 WKS
Monitoring engine
Queue, scheduling fairness, dedup, drift, SSRF guards, state caching
3 WKS
Incident system
State machine, timelines, auto open/resolve, notifications
2 WKS
Status pages
Public read models, uptime aggregation, cache strategy, leak review
1.5 WKS
AI features
Prompting, guardrails, rate limits, graceful degradation
1 WK
Tests, CI, Docker
135 tests, pipelines, images, architecture docs, seed tooling
3 WKS
Total
at $8–12k / month fully-loaded senior cost
≈ 13–14 WKS

Thirteen weeks of engineering, already debugged.