event
ticket.lifecycle.v2
Service desk platform · version 2.1.0 · linked ticket tkt-wifi
ticketId: string requiredcorrelationId: string requiredpriority: enum requiredriskFlags: string[] optional
AI service desk demoLive operations workspace
Production map
Hosted demo today, production path tomorrow
The Netlify demo stays deterministic and free, while each panel shows the concrete boundary that would move into cloud infrastructure, queues, observability, and data contracts.
Demo mode0 credsSeeded state, no paid cloud services
Async jobs7pg-boss job contracts mapped
Contract surfaces3Events, webhooks, and AI runs
Deploy checks4Unit, typecheck, build, e2e
Demo mode vs local/prod mode
What is simulated on Netlify and what changes when infrastructure is enabled.
| Boundary | Hosted demo | Local/prod path |
|---|---|---|
| Data store | Seeded TypeScript state + cookie replay | Postgres, pgvector, Drizzle migrations, backups |
| Jobs | Static contract simulator | pg-boss workers with retry, DLQ, and idempotency |
| Events | Kafka/Redpanda-shaped envelopes on screen | Redpanda or MSK topics with schema compatibility checks |
| Search | Deterministic in-memory selectors | OpenSearch lexical/vector hybrid retrieval |
| Graph | Relationship panel in knowledge route | Neo4j or Postgres graph projection for investigations |
| Observability | Demo trace view in Watchtower | OpenTelemetry exporter path to managed tracing |
Serverless AWS path
- Edge entryNetlify or CloudFront routes React Router requests and keeps intake fast.
- Async queueSQS or EventBridge receives ticket lifecycle and AI action events.
- WorkersLambda runs triage, document extraction, retrieval, and webhook delivery.
- PersistenceRDS Postgres keeps tickets, ai_runs, audit events, and pgvector knowledge chunks.
- SearchOpenSearch indexes playbooks, tickets, uploaded documents, and AI run metadata.
CI/CD and test gates
- Pull requestTypeScript, unit tests, route smoke tests, schema diff check
- Preview deploySeeded demo data, no paid credentials, deterministic session replay
- Release gatePlaywright smoke suite, AI fixture regression pack, accessibility snapshot
- Production deployMigrations first, workers after schema, canary webhook endpoints
IaC and container boundary
- Terraform ownsVPC, RDS, queues/topics, OpenSearch, secrets, IAM, alarms
- App deploy ownsReact Router bundle, worker image, env-specific feature flags
- Kubernetes optionRun web, worker, and replay services as separate deployments with HPA
- SecretsWebhook HMAC keys rotate by version and are never exposed in payloads
Data contracts make the demo reviewable.
event
ai.action.v1
AI Watchtower · version 1.4.0 · linked ticket tkt-cctv
aiRunId: string requiredpromptVersion: string requiredconfidence: number requiredapprovalStatus: enum required
webhook
webhook.delivery.v1
Integrations · version 1.0.0 · linked ticket tkt-invoice
eventId: string requiredtimestamp: iso8601 requiredsignature: hmac-sha256 requireddeliveryAttempt: number required
React Router appKept as an explicit boundary so a reviewer can map demo behavior to production infrastructure.
Postgres + pgvectorKept as an explicit boundary so a reviewer can map demo behavior to production infrastructure.
Queue workersKept as an explicit boundary so a reviewer can map demo behavior to production infrastructure.
Events/webhooksKept as an explicit boundary so a reviewer can map demo behavior to production infrastructure.