TenantAtlas/specs/094-assignment-ops-observability-hardening/quickstart.md

Quickstart — 094 Assignment Operations Observability Hardening

Prerequisites

• Docker + Laravel Sail
• PHP/Composer dependencies installed (via Sail)

Setup

• Start services: ./vendor/bin/sail up -d
• Install PHP deps (if needed): ./vendor/bin/sail composer install
• Run migrations: ./vendor/bin/sail artisan migrate

Running tests (targeted)

Run the smallest set first, then widen:

• Feature tests added for this spec (once implemented):
  • ./vendor/bin/sail artisan test --compact tests/Feature/Operations
  • ./vendor/bin/sail artisan test --compact tests/Feature/Auth
  • ./vendor/bin/sail artisan test --compact tests/Feature/Rbac

Formatting

• Run Pint on touched files: ./vendor/bin/sail bin pint --dirty

Manual verification (admin)

• Trigger an assignment fetch and confirm a Monitoring → Operations entry appears.
• Trigger an assignment restore and confirm:
  • Monitoring shows a run with failure codes (if any) and counters.
  • Exactly one audit log entry is created for the restore execution.