ahmido/TenantAtlas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity
dev
TenantAtlas/specs/073-unified-managed-tenant-onboarding-wizard/quickstart.md
ahmido b6343d5c3a feat: unified managed tenant onboarding wizard (#88) 
Implements workspace-scoped managed tenant onboarding wizard (Filament v5 / Livewire v4) with strict RBAC (404/403 semantics), resumable sessions, provider connection selection/creation, verification OperationRun, and optional bootstrap. Removes legacy onboarding entrypoints and adds Pest coverage + spec artifacts (073).

## Summary
<!-- Kurz: Was ändert sich und warum? -->

## Spec-Driven Development (SDD)
- [ ] Es gibt eine Spec unter `specs/<NNN>-<feature>/`
- [ ] Enthaltene Dateien: `plan.md`, `tasks.md`, `spec.md`
- [ ] Spec beschreibt Verhalten/Acceptance Criteria (nicht nur Implementation)
- [ ] Wenn sich Anforderungen während der Umsetzung geändert haben: Spec/Plan/Tasks wurden aktualisiert

## Implementation
- [ ] Implementierung entspricht der Spec
- [ ] Edge cases / Fehlerfälle berücksichtigt
- [ ] Keine unbeabsichtigten Änderungen außerhalb des Scopes

## Tests
- [ ] Tests ergänzt/aktualisiert (Pest/PHPUnit)
- [ ] Relevante Tests lokal ausgeführt (`./vendor/bin/sail artisan test` oder `php artisan test`)

## Migration / Config / Ops (falls relevant)
- [ ] Migration(en) enthalten und getestet
- [ ] Rollback bedacht (rückwärts kompatibel, sichere Migration)
- [ ] Neue Env Vars dokumentiert (`.env.example` / Doku)
- [ ] Queue/cron/storage Auswirkungen geprüft

## UI (Filament/Livewire) (falls relevant)
- [ ] UI-Flows geprüft
- [ ] Screenshots/Notizen hinzugefügt

## Notes
<!-- Links, Screenshots, Follow-ups, offene Punkte -->

Co-authored-by: Ahmed Darrazi <ahmeddarrazi@adsmac.fritz.box>
Reviewed-on: #88
2026-02-03 17:30:15 +00:00

1.1 KiB
Raw Permalink Blame History

Quickstart — Unified Managed Tenant Onboarding Wizard (073)

Local setup

  • Start containers: vendor/bin/sail up -d
  • Install deps (if needed): vendor/bin/sail composer install and vendor/bin/sail npm install
  • Run migrations: vendor/bin/sail artisan migrate
  • Run frontend build/dev:
    • vendor/bin/sail npm run dev (watch)
    • or vendor/bin/sail npm run build

Using the wizard (expected flow)

  1. Sign in to /admin.
  2. Choose a workspace at /admin/choose-workspace.
  3. Open /admin/w/{workspace}/managed-tenants.
  4. Start onboarding at /admin/w/{workspace}/managed-tenants/onboarding.
  5. Complete Identify → Connection → Verify (queued) → optional Bootstrap.

Notes:

  • The onboarding UI must render DB-only; Graph calls occur only in queued work.
  • Verification is tracked as an OperationRun (module health_check).

Tests

Run targeted tests (expected file name when implemented):

  • vendor/bin/sail artisan test --compact tests/Feature/ManagedTenantOnboardingWizardTest.php

Deploy / Ops

If Filament assets are used/registered, deployment must include:

  • php artisan filament:assets