# Engineering Review Guide

This guide is the short verification path for DriveDesk Core. It points to the
running demo, executable checks, API contract, and public-safe evidence that
prove the current engineering surface.

## First Pass

| Step | What to inspect | Proof |
| --- | --- | --- |
| 0 | Public review bundle | `docs/public/PUBLIC_REVIEW_BUNDLE.md`, `bash scripts/run_public_review_bundle.sh` |
| 1 | System review path | `docs/public/SYSTEM_REVIEW_PATH.md` |
| 2 | Platform Tour | `docs/public/PLATFORM_TOUR.md` |
| 3 | Verification quickstart | `docs/public/REVIEWER_QUICKSTART.md` |
| 4 | Interview stack brief | `docs/public/INTERVIEW_STACK_BRIEF.md`, `bash scripts/check_public_interview_stack_brief.sh` |
| 5 | Verification matrix | `docs/public/PUBLIC_VERIFICATION_MATRIX.md` |
| 6 | Live demo Workflow, Control Tower, Integrations, Operations, Incidents, Review, and Proof tabs | `businessControlTower`, `adapterStudio`, `endToEndScenario`, `alertRouting`, `incidentResponse`, `reviewConsole`, and `engineeringProof` payloads |
| 7 | Root CI badge | `bash scripts/ci_smoke_public.sh` |
| 8 | Project status | `docs/public/PROJECT_STATUS.md` |
| 9 | Review Console | `docs/public/REVIEW_CONSOLE.md`, `bash scripts/check_public_review_console.sh` |
| 10 | Proof contract | `bash scripts/check_public_engineering_proof.sh` |
| 11 | API contract | `docs/openapi.json` and `GET /demo/public` |
| 12 | Capability map | `docs/public/TECHNICAL_CAPABILITY_MAP.md` |
| 13 | Evidence index | `docs/public/EVIDENCE_INDEX.md`, `docs/public/evidence/public-evidence-index.sanitized.json` |
| 14 | Observability proof | `docs/public/OBSERVABILITY_PROOF.md` |
| 15 | Observability dashboard | Operations tab and `docs/public/OBSERVABILITY_DASHBOARD.md` |
| 16 | Notification delivery | Operations tab, `GET /demo/notification-delivery`, `notificationDelivery`, and `docs/public/NOTIFICATION_DELIVERY.md` |
| 17 | Alert routing | Operations tab and `docs/public/ALERT_ROUTING_EVIDENCE.md` |
| 18 | Connector fixture replay | `docs/public/CONNECTOR_FIXTURE_REPLAY.md` and `bash scripts/check_public_connector_fixture_replay.sh` |
| 19 | Recovery and release safety | backup/restore, rollback, canary, staged promotion checks |
| 20 | Infrastructure story | Helm, GitOps, OpenTofu, drift, and sanitized runtime evidence |

## Review Commands

```bash
bash scripts/run_public_review_bundle.sh
bash scripts/check_public_review_bundle.sh
bash scripts/ci_smoke_public.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_interview_stack_brief.sh
bash scripts/check_public_verification_matrix.sh
bash scripts/check_public_review_guide.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_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_engineering_proof.sh
bash scripts/check_public_connector_fixture_replay.sh
bash scripts/check_public_demo_api.sh
bash scripts/check_public_demo_sdk.sh
bash scripts/check_public_backup_restore.sh
bash scripts/check_public_release_rollback.sh
bash scripts/check_public_slo_canary_gate.sh
bash scripts/check_public_staged_promotion.sh
bash scripts/check_public_gitops_layout.sh
bash scripts/check_public_opentofu_plan.sh
```

## Evidence Map

| Area | Evidence |
| --- | --- |
| Public review bundle | `docs/public/PUBLIC_REVIEW_BUNDLE.md`, `docs/public/evidence/public-review-bundle.sanitized.json` |
| System review path | `docs/public/SYSTEM_REVIEW_PATH.md` |
| Business OS tour | `docs/public/PLATFORM_TOUR.md` |
| Verification quickstart | `docs/public/REVIEWER_QUICKSTART.md` |
| Interview stack brief | `docs/public/INTERVIEW_STACK_BRIEF.md`, `docs/public/evidence/interview-stack-brief.sanitized.json` |
| Verification matrix | `docs/public/PUBLIC_VERIFICATION_MATRIX.md` |
| System design | `docs/public/SYSTEM_DESIGN.md` |
| Project status | `docs/public/PROJECT_STATUS.md` |
| Review Console | `docs/public/REVIEW_CONSOLE.md`, `docs/public/evidence/review-console.sanitized.json`, `GET /demo/public` `reviewConsole` |
| Public proof contract | `docs/public/ENGINEERING_PROOF.md` |
| Capability map | `docs/public/TECHNICAL_CAPABILITY_MAP.md` |
| Evidence index | `docs/public/EVIDENCE_INDEX.md`, `docs/public/evidence/public-evidence-index.sanitized.json` |
| Observability proof | `docs/public/OBSERVABILITY_PROOF.md` |
| Observability dashboard | `docs/public/OBSERVABILITY_DASHBOARD.md`, `docs/public/evidence/observability-dashboard.sanitized.json` |
| Notification delivery | `docs/public/NOTIFICATION_DELIVERY.md`, `docs/public/evidence/notification-delivery.sanitized.json`, `GET /demo/notification-delivery`, `notificationDelivery` |
| Alert routing | `docs/public/ALERT_ROUTING_EVIDENCE.md` |
| Incident response | `docs/public/INCIDENT_RESPONSE_DEMO.md` |
| Case study | `docs/public/ENGINEERING_CASE_STUDY.md` |
| Sanitized runtime evidence | `docs/public/SANITIZED_EVIDENCE.md` |
| Backup and restore | `docs/public/BACKUP_RESTORE_EVIDENCE.md` |
| Release safety | `docs/public/RELEASE_ROLLBACK_EVIDENCE.md`, `docs/public/SLO_CANARY_GATE_EVIDENCE.md`, `docs/public/STAGED_PROMOTION_EVIDENCE.md` |
| GitOps and IaC | `docs/public/GITOPS_DELIVERY.md`, `docs/public/OPENTOFU_PLAN_EVIDENCE.md`, `docs/public/INFRA_STATE_DRIFT_EVIDENCE.md` |
| API and SDK | `docs/public/API_BACKED_DEMO.md`, `docs/public/CLIENT_SDK.md`, `sdk/generated/public-demo/` |
| Connector fixture replay | `docs/public/CONNECTOR_FIXTURE_REPLAY.md`, `docs/public/evidence/connector-fixture-replay.sanitized.json`, `examples/connector-fixtures/replay-fixtures.sanitized.json` |

## Boundary

The public repository contains synthetic data and sanitized evidence only. It
does not contain production data, private runtime addresses, operational
credentials, raw logs, or private deployment state.