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`
|