Public Engineering Reference

DriveDesk Core operations platform engineering reference

Inspect the architecture, open the live operations demo, then verify the API contract, SDK artifacts, release gates, observability, GitOps, OpenTofu plan evidence, Adapter Studio, Control Tower, and incident response trail.

Open Demo System Path Platform Tour Stack Brief Review Bundle Project Status API Handoff Connectors Onboarding Repair Replay Verification Matrix Capability Map Evidence Index

RuntimeAPI, worker, Postgres, Redis

PlatformControl Tower, adapters, proof

DeliveryCI, Helm, GitOps, gates

Operationsmetrics, alerts, incidents

DriveDesk Core public demo overview — Public demo UI backed by static synthetic data and the read-only `GET /demo/public` contract.

Start Here: System Snapshot

Use this page as the entrypoint, then follow the checked docs and commands when deeper proof is needed.

Runtime

FastAPI demo API, worker contract, Postgres-shaped repositories, Redis/outbox job model, and metrics endpoint.

Product core

Tenants, RBAC, audit log, outbox recovery, business records, workflow rules, tasks, and documents.

Integration hub

Adapter catalog, Adapter Studio, scopes, mapping preview, operation contracts, diagnostics, integration repair, reconciliation, and operator review.

Operations

Metrics, structured logs, alert routing, incident response, recovery drills, rollback, and SLO canary evidence.

Delivery

Docker Compose, Helm, GitOps, OpenTofu plan evidence, CI gates, Pages health, and public/private export gate.

Verification Flow

Follow the same path the release gate protects: system path, Business OS tour, architecture, demo, API contract, then operational evidence.

Review bundle

Run one checked command that verifies the public entrypoint, docs, evidence index, demo health, OpenAPI, SDK, observability, alert routing, and proof contract.

Open bundle

System path

Start with the compact route that ties the public root, demo, API, SDK, operations evidence, GitOps, OpenTofu, and evidence index together.

Open system path

Business OS tour

Trace business event -> workflow -> adapter -> incident -> proof across Control Tower, Adapter Studio, operations, and proof.

Open platform tour

Architecture

Start with the modular monolith, data boundary, adapter hub, and runtime shape.

Open system design

Live demo

Use the Overview, Workflow, Control Tower, Integrations, Operations, Incidents, Review, and Proof tabs with synthetic data.

Open demo

API and SDK

Check the read-only demo endpoint, OpenAPI schema, and generated clients.

Open API notes

Release evidence

Follow the gates for rollback, SLO canary, staged promotion, and drift handling.

Open evidence

Architecture Trace

The public hub is static and safe to inspect, but it mirrors the same product boundaries used by the backend: tenant scope, audit, outbox, adapter operations, runtime checks, and release evidence.

BrowserStatic GitHub Pages shell with synthetic fallback data.

Demo APIOptional read-only `GET /demo/public`, `GET /demo/connector-certification`, `GET /demo/provider-onboarding`, `GET /demo/integration-repair`, tenant-scoped `POST /tenants/{tenant_id}/integration-repairs/preview`, `GET /demo/connector-fixture-replay`, and `GET /demo/business-scenario-replay` contracts with OpenAPI coverage.

CoreTenants, RBAC, audit, outbox, workflow rules, integration jobs.

OpsPrometheus-style metrics, alert routing, incident response, recovery evidence.

Evidence Matrix

Each link below maps to a checked public-safe artifact, not a loose note.

Review bundle

One-command public review route with sanitized evidence and a contract checker.

Open bundle

Review Console

Readiness, gates, evidence, handoff, remaining work, and public/private boundary in one demo tab.

Open console contract

System path

Compact engineering route through the public root, demo, API, SDK, operations evidence, release safety, GitOps, OpenTofu, and evidence index.

Open path

Business OS tour

Shows the reviewer how business event -> workflow -> adapter -> incident -> proof moves through Control Tower and Adapter Studio.

Open tour

Project status

Current public-safe engineering state, validated surface, limits, and next work in one page.

Open status

Business Intake API Handoff

60-second backend/API route from intake facts to FastAPI preview, admin workbench, task/outbox handoff, OpenAPI/SDK, pytest, and CI.

Open handoff route

Capability map

Maps each backend, platform, integration, recovery, GitOps, and IaC capability to evidence and verifier commands.

Open map

Stack brief

Plain-language map of what each technology does, what is validated, what remains, and how the pieces fit together.

Open brief

Verification matrix

Maps engineering claims to artifacts, verifier commands, and pass signals.

Open matrix

Evidence index

Machine-readable map from capabilities to docs, evidence files, verifier commands, public URLs, and boundaries.

Open index

Connector certification

Provider-neutral path from profile and capability manifest to fixtures, runtime readiness, and release proof.

Open connector path

Provider onboarding

Provider profile, mapping preview, preflight checks, sandbox dry-run, approval, rollout, and reconciliation in one public-safe contract.

Open onboarding path

Integration repair

Runbook-backed retry, dead-letter, reconciliation mismatch, impact analysis, safe actions, approval, and postcheck evidence.

Open repair path

Fixture replay

Replayable synthetic connector fixtures for happy path, redaction, invalid payload, retry, dead-letter, and reconciliation behavior.

Open replay path

Observability

Public-safe metrics, structured logs, alert names, runbooks, and dashboard evidence.

Open observability

Dashboards

Grafana-style dashboard groups, Prometheus and Loki query examples, alert links, and redaction boundaries.

Open dashboards

Notification delivery

Outbox, worker, provider gate, retry, dead-letter, operator review, and observability for notification delivery.

Open notification delivery

Alert routing

Alertmanager-style routes, receivers, dedupe keys, escalation, silence contract, and runbook bindings.

Open alert routing

Incident response

Runbook-backed incident queue, owner assignment, mitigation actions, recovery timeline, and resolution evidence.

Open incidents

API and SDK

Read-only public demo API with generated Python, JavaScript, and TypeScript client artifacts.

Open API notes

Release safety

Backup/restore, rollback, SLO canary gate, staged promotion, and platform maturity evidence on synthetic data.

Open evidence

Platform maturity

Public-safe 70 percent DevOps/platform milestone tied to verified runtime, delivery, operations, security, and recovery evidence.

Open maturity evidence

Commercial readiness

Public-safe 80 percent milestone connecting product workbench, provider sandbox path, approval gates, API/SDK, operations, and remaining 100 percent gaps.

Open readiness evidence

Proof contract

Connects the demo Proof tab, API payload, OpenAPI schema, SDK artifacts, docs, and CI checks.

Open proof

Verification path

Start with the quickstart, then run the public smoke path. The same commands are used by CI and the public release gate.

bash scripts/ci_smoke_public.sh
bash scripts/check_public_pages_entrypoint.sh
bash scripts/check_public_system_review_path.sh
bash scripts/check_public_platform_tour.sh
bash scripts/check_public_reviewer_quickstart.sh
bash scripts/check_public_project_status.sh
bash scripts/check_public_technical_capability_map.sh
bash scripts/check_public_evidence_index.sh
bash scripts/check_public_review_console.sh
bash scripts/check_public_connector_certification.sh
bash scripts/check_public_observability_proof.sh
bash scripts/check_public_observability_dashboard.sh
bash scripts/check_public_notification_delivery.sh
bash scripts/check_public_alert_routing.sh
bash scripts/check_public_review_guide.sh
bash scripts/check_public_engineering_proof.sh
bash scripts/check_public_demo_api.sh