ahmido
03127a670b
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
57 lines
1.7 KiB
Markdown
57 lines
1.7 KiB
Markdown
# 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`
|