TenantAtlas/specs/059-unified-badges/quickstart.md

Quickstart — Unified Badge System (v1)

Prereqs

• Run everything via Sail.

Setup

• vendor/bin/sail up -d
• vendor/bin/sail composer install

Run tests (targeted)

Existing safety nets to keep green:

• vendor/bin/sail artisan test tests/Feature/Monitoring/OperationsDbOnlyTest.php
• vendor/bin/sail artisan test tests/Feature/Monitoring/OperationsTenantScopeTest.php

When the feature is implemented, add + run:

• Badge mapping tests (new).
• Status-like ad-hoc mapping guard test (new).

Manual QA (tenant-scoped)

• Operations/Monitoring: queued/running/completed + outcome badges are consistent and success is never warning.
• Drift findings: severity mapping is consistent (low=neutral, medium=warning, high=danger).
• Restore runs: all lifecycle statuses render consistently across list + detail.
• Dark mode: status-like badges remain readable; icons don’t appear disabled unless intentionally neutral.

Frontend assets

If UI changes don’t show:

• vendor/bin/sail npm run dev
• or vendor/bin/sail npm run build