ahmido 03127a670b Spec 096: Ops polish (assignment summaries + dedupe + reconcile tracking + seed DX) (#115 )

Implements Spec 096 ops polish bundle:

- Persist durable OperationRun.summary_counts for assignment fetch/restore (final attempt wins)
- Server-side dedupe for assignment jobs (15-minute cooldown + non-canonical skip)
- Track ReconcileAdapterRunsJob via workspace-scoped OperationRun + stable failure codes + overlap prevention
- Seed DX: ensure seeded tenants use UUID v4 external_id and seed satisfies workspace_id NOT NULL constraints

Verification (local / evidence-based):
- `vendor/bin/sail artisan test --compact tests/Feature/Operations/AssignmentRunSummaryCountsTest.php tests/Feature/Operations/AssignmentJobDedupeTest.php tests/Feature/Operations/ReconcileAdapterRunsJobTrackingTest.php tests/Feature/Seed/PoliciesSeederExternalIdTest.php`
- `vendor/bin/sail bin pint --dirty`

Spec artifacts included under `specs/096-ops-polish-assignment-dedupe-system-tracking/` (spec/plan/tasks/checklists).

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #115

2026-02-15 20:49:38 +00:00

1.7 KiB

Raw Blame History

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

1.7 KiB Raw Blame History