GuardIQ Robotics Command — Platform (Railway)

The production multi-tenant security-orchestration platform. This repo deploys to Railway (PostgreSQL + Node/TypeScript + WebSockets). The investor demo lives separately in the guardiq-command Val Town val.

Status: scaffold. Repo structure, schema, and build pipeline exist. The domain modules (HAL, event bus, orchestrator agents, RBAC, incident workflow) are being developed in phases. Everything is a simulator — no real hardware or GuardIQ connection is claimed.

apps/
  api/     Node + TypeScript backend (HTTP + WebSockets)
  web/     React + Vite + Tailwind frontend
db/        SQL migrations + seeded demo data
packages/  shared libs (types, HAL abstractions, event bus)
context/   Obsidian knowledge vault (open in Obsidian)
infra/     Dockerfiles, railway.toml

# needs: docker compose (or local Postgres), node 20+
export DATABASE_URL=postgres://guard:guard@localhost:5432/guardiq

docker compose up -d db          # start Postgres
cd apps/api && npm i && npm run migrate && npm run dev

cd apps/web && npm i && npm run dev   # separate terminal

1. Push this repo to GitHub.
2. Railway → New Project → Deploy from GitHub → select the repo.
3. Railway auto-detects infra/railway.toml (services: api, web, db).
4. For the db service, Railway Proves managed Postgres; set the api env DATABASE_URL to its connection string.
5. db plugin runs db/*.sql on start (or run npm run migrate in api).
6. Railway gives each service a .up.railway.app URL.

See context/notes/300-deployment.md for the full walkthrough.

Phase 0 standalone simulator → 1 investor demo → 2 camera → 3 trailer → 4 ground robot → 5 GuardIQ gateway → 6 multi-site → 7 humanoid → 8 autonomous ops.