TenantAtlas/specs/056-remove-legacy-bulkops/quickstart.md

Quickstart: Feature 056 — Remove Legacy BulkOperationRun

Prerequisites

• Local dev via Laravel Sail
• Database migrations up to date

Common commands (Sail-first)

• Boot: ./vendor/bin/sail up -d
• Run migrations: ./vendor/bin/sail artisan migrate
• Run targeted tests: ./vendor/bin/sail artisan test tests/Feature
• Format (required): ./vendor/bin/pint --dirty

What to build (high level)

• Replace all legacy bulk-run usage with the canonical OperationRun run model.
• Ensure all bulk actions are enqueue-only and visible in Monitoring → Operations.
• Enforce per-target scope concurrency limit (config-driven, default=1).
• Enforce bulk idempotency via deterministic fingerprinting.
• Remove legacy BulkOperationRun stack (model/service/table/UI).
• Add guardrails/tests to prevent reintroduction.

Where to look first

• Legacy stack:

  • app/Models/BulkOperationRun.php
  • app/Services/BulkOperationService.php
  • database/migrations/*bulk_operation_runs*

• Canonical run stack:

  • app/Models/OperationRun.php
  • app/Services/OperationRunService.php
  • app/Support/OperationCatalog.php
  • app/Support/OpsUx/OperationSummaryKeys.php

• Locking patterns to reuse:

  • app/Services/Inventory/InventoryConcurrencyLimiter.php
  • app/Services/Inventory/InventorySyncService.php