ahmido/TenantAtlas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity
dev
TenantAtlas/specs/057-filament-v5-upgrade/data-model.md
ahmido 971105daa9 057-filament-v5-upgrade (#66) 
Summary: Upgrade Filament to v5 (Livewire v4), replace Filament v4-only plugins, add first-party JSON renderer, and harden Monitoring/Ops UX guardrails.
What I changed:
Composer: upgraded filament/filament → v5, removed pepperfm/filament-json and lara-zeus/torch-filament, added torchlight/engine.
Views: replaced JSON viewer with json-viewer.blade.php and updated snapshot display.
Tests: added DB-only + tenant-isolation guard tests under Monitoring and OpsUx, plus Filament smoke tests.
Specs: added/updated specs/057-filament-v5-upgrade/* (spec, tasks, plan, quickstart, research).
Formatting: ran Pint; ran full test suite (641 passed, 5 skipped).
Validation:
Ran ./vendor/bin/sail artisan test (full suite) — all tests passed.
Ran ./vendor/bin/sail pint --dirty — formatting applied.
Ran npm run build locally (Vite) — assets generated.
Notes / Rollback:
Rollback: revert composer.json/composer.lock and build assets; documented in quickstart.md.
One pending app migration was noted during validation; ensure migrations are applied in staging before deploy.
Reviewers: @frontend, @backend (adjust as needed)
Spec links:
spec.md
tasks.md
quickstart.md

Co-authored-by: Ahmed Darrazi <ahmeddarrazi@adsmac.local>
Reviewed-on: #66
2026-01-20 21:19:27 +00:00

1.3 KiB
Raw Permalink Blame History

Data Model: Admin UI Stack Upgrade (Filament v5 + Livewire v4)

This feature is a framework/UI dependency upgrade. No new domain entities are introduced.

Existing Entities (Referenced)

Tenant

  • Purpose: tenant-scopes all UI data access.
  • Key fields (existing): id, tenant identity metadata.
  • Relationships: Tenant → many OperationRun.

OperationRun

  • Purpose: canonical Monitoring → Operations record per constitution.
  • Key fields (existing, inferred from usage):
    • tenant_id
    • type, status, outcome
    • initiator_name
    • created_at, started_at, completed_at
    • JSONB: run context/failures/summary (per repo context)
  • Relationships:
    • belongsTo Tenant.

Schema / Migration Expectations

Decision: No database schema changes intended

  • Rationale:
    • Filament/Livewire upgrade does not require domain schema changes.
    • Spec allows migrations only if strictly required by dependencies; current plan avoids introducing such requirements.

Guardrails (if a migration becomes necessary)

  • Must be reversible with a safe down().
  • Must be non-destructive (no data loss; avoid drops unless explicitly planned).
  • Must be called out in release notes.

Validation Rules / State Transitions

  • No new validation rules.
  • No new state machines.
  • Existing OperationRun status/outcome conventions remain unchanged.