Implements Spec 110 Ops‑UX Enforcement and applies the repo‑wide “enterprise” standard for operation start + dedup surfaces. Key points - Start surfaces: only ephemeral queued toast (no DB notifications for started/queued/running). - Dedup paths: canonical “already queued” toast. - Progress refresh: dispatch run-enqueued browser event so the global widget updates immediately. - Completion: exactly-once terminal DB notification on completion (per Ops‑UX contract). Tests & formatting - Full suite: 1738 passed, 8 skipped (8477 assertions). - Pint: `vendor/bin/sail bin pint --dirty --format agent` (pass). Notable change - Removed legacy `RunStatusChangedNotification` (replaced by the terminal-only completion notification policy). Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #134
4.1 KiB
TenantAtlas Development Guidelines
Auto-generated from all feature plans. Last updated: 2025-12-22
Active Technologies
-
PHP 8.4.15 + Laravel 12, Filament v4, Livewire v3 (feat/005-bulk-operations)
-
PostgreSQL (app), SQLite in-memory (tests) (feat/005-bulk-operations)
-
PostgreSQL (Sail locally) (feat/032-backup-scheduling-mvp)
-
PHP 8.4.x + Laravel 12, Filament v4, Livewire v3 (feat/042-inventory-dependencies-graph)
-
PostgreSQL (JSONB) (feat/042-inventory-dependencies-graph)
-
PHP 8.4.x (Laravel 12) + Laravel 12, Filament v4, Livewire v3 (feat/047-inventory-foundations-nodes)
-
PostgreSQL (JSONB for
InventoryItem.meta_jsonb) (feat/047-inventory-foundations-nodes) -
PostgreSQL (JSONB in
operation_runs.context,operation_runs.summary_counts) (056-remove-legacy-bulkops) -
PHP 8.4.15 (Laravel 12.47.0) + Filament v5.0.0, Livewire v4.0.1 (058-tenant-ui-polish)
-
PHP 8.4 (per repo guidelines) + Laravel 12, Filament v5, Livewire v4 (067-rbac-troubleshooting)
-
PostgreSQL (via Laravel Sail) (067-rbac-troubleshooting)
-
PHP 8.4.x (Composer constraint:
^8.2) + Laravel 12, Filament 5, Livewire 4+, Pest 4, Sail 1.x (073-unified-managed-tenant-onboarding-wizard) -
PostgreSQL (Sail) + SQLite in tests where applicable (073-unified-managed-tenant-onboarding-wizard)
-
PHP 8.4 (Laravel 12) + Filament v5, Livewire v4, Filament Infolists (schema-based) (078-operations-tenantless-canonical)
-
PostgreSQL (no new migrations — read-only model changes) (078-operations-tenantless-canonical)
-
PHP 8.4.15 (Laravel 12) + Filament v5, Livewire v4, Tailwind v4 (080-workspace-managed-tenant-admin)
-
PostgreSQL (via Sail) (080-workspace-managed-tenant-admin)
-
PHP 8.4.15 + Laravel 12, Filament v5, Livewire v4, Socialite v5 (081-provider-connection-cutover)
-
PHP 8.4.x + Laravel 12, Filament v5, Livewire v4 (082-action-surface-contract)
-
PHP 8.4 (Laravel 12) + Filament v5 (Livewire v4), Queue/Jobs (Laravel), Microsoft Graph via
GraphClientInterface(084-verification-surfaces-unification) -
PostgreSQL (JSONB-backed
OperationRun.context) (084-verification-surfaces-unification) -
PHP 8.4.15 (Laravel 12) + Filament v5, Livewire v4, Pest v4, Tailwind CSS v4, Laravel Sail (085-tenant-operate-hub)
-
PostgreSQL (primary) + session (workspace context + last-tenant memory) (085-tenant-operate-hub)
-
PHP 8.4 (Laravel 12) + Filament v5, Livewire v4, Laravel Sail, Tailwind CSS v4 (085-tenant-operate-hub)
-
PostgreSQL (Sail), SQLite in tests (087-legacy-runs-removal)
-
PHP 8.4.x + Laravel 12, Filament v5, Livewire v4, Microsoft Graph integration via
GraphClientInterface(095-graph-contracts-registry-completeness) -
PHP 8.4.15 (Laravel 12) + Filament v5, Livewire v4, Laravel Queue, Laravel Notifications (100-alert-target-test-actions)
-
PostgreSQL (Sail locally); SQLite is used in some tests (101-golden-master-baseline-governance-v1)
-
PHP 8.4 (Laravel 12) + Filament v5, Livewire v4,
OperateHubShellsupport class (103-ia-scope-filter-semantics) -
PostgreSQL — no schema changes (103-ia-scope-filter-semantics)
-
PHP 8.4 (Laravel 12) + Filament v5, Livewire v4, Pest v4 (104-provider-permission-posture)
-
PostgreSQL (via Sail), JSONB for stored report payloads and finding evidence (104-provider-permission-posture)
-
PHP 8.4 / Laravel 12 + Filament v5, Livewire v4, Tailwind CSS v4 (107-workspace-chooser)
-
PostgreSQL (existing tables:
workspaces,workspace_memberships,users,audit_logs) (107-workspace-chooser) -
PHP 8.4 (Laravel 12) + Filament v5, Livewire v4, Laravel Framework v12 (109-review-pack-export)
-
PostgreSQL (jsonb columns for summary/options), local filesystem (
exportsdisk) for ZIP artifacts (109-review-pack-export) -
PHP 8.4.15 (feat/005-bulk-operations)
Project Structure
src/
tests/
Commands
Add commands for PHP 8.4.15
Code Style
PHP 8.4.15: Follow standard conventions
Recent Changes
- 110-ops-ux-enforcement: Added PHP 8.4.x + Laravel 12, Filament v5, Livewire v4
- 109-review-pack-export: Added PHP 8.4 (Laravel 12) + Filament v5, Livewire v4, Laravel Framework v12
- 109-review-pack-export: Added [if applicable, e.g., PostgreSQL, CoreData, files or N/A]