TenantAtlas/specs/096-ops-polish-assignment-dedupe-system-tracking/quickstart.md

Quickstart (096 Ops Polish Bundle)

This spec is background-operations only (no new routes/pages). Verification is via Pest tests and seed workflows.

Prereqs

• Start Sail: vendor/bin/sail up -d

Run targeted tests (recommended during implementation)

• Run a single spec-focused file (once created):

  • vendor/bin/sail artisan test --compact tests/Feature/OpsPolishBundleTest.php

• Or run by filter:

  • vendor/bin/sail artisan test --compact --filter=assignment
  • vendor/bin/sail artisan test --compact --filter=dedupe
  • vendor/bin/sail artisan test --compact --filter=reconcile

Verify seeding DX

• Reset + seed:

  • vendor/bin/sail artisan migrate:fresh --seed --no-interaction

• Expectation:

  • Seed completes without DB constraint errors.
  • Seeded tenant has external_id formatted as UUID v4.

Formatting

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

Strategic Health Audit (evidence-based checklist)

This repo does not have a single “audit” command. For Spec 096 we treat the audit as a small bundle of objective gates.

Gate 1 — Full suite

• vendor/bin/sail artisan test --compact

Gate 2 — PostgreSQL schema/constraints suite

• vendor/bin/sail composer test:pgsql

Gate 3 — Seed DX

• vendor/bin/sail artisan migrate:fresh --seed --no-interaction

Pass criteria: all 3 gates succeed.

Evidence links (tests)

• A (summary persistence): tests/Feature/Operations/AssignmentRunSummaryCountsTest.php
• B (dedupe + cooldown): tests/Feature/Operations/AssignmentJobDedupeTest.php
• C (reconcile tracking + overlap): tests/Feature/Operations/ReconcileAdapterRunsJobTrackingTest.php
• D (seed UUID + DX): tests/Feature/Seed/PoliciesSeederExternalIdTest.php