Skip to main content

Back Office Runbook

Last reviewed: 2026-04-25
Maintained by: Engineering

Purpose​

apps/back-office is the web app for super_admin workflows (clients, issues, audit/compliance oversight, and system health monitoring).

Run Locally​

pnpm run dev:back-office

Expected URL:

  • http://localhost:3002

Prerequisite:

  • API should run on http://localhost:3000

Key Folders / Where Logic Lives​

  • Routes/pages: apps/back-office/app
  • UI components: apps/back-office/components
  • API wiring and shared types usage: apps/back-office/lib

System Health Notes​

  • Route: /system-health
  • Snapshot and alerts refresh automatically every 30 seconds
  • Uptime component shows Unknown when UPTIMEROBOT_API_KEY or monitor IDs are not configured

Minimum PR Checks​

pnpm run check:back-office
pnpm run lint:back-office

How to Debug Startup Failure​

  1. Confirm API is reachable:
  • http://localhost:3000/api/health
  1. Confirm app dependencies are installed:
pnpm install
  1. Restart app:
pnpm run dev:back-office
  1. If Next.js cache is stale, remove local build artifacts and restart:
rm -rf apps/back-office/.next