TenantAtlas/specs/073-unified-managed-tenant-onboarding-wizard/contracts/http.openapi.yaml
ahmido 8e34b6084f 073-unified-managed-tenant-onboarding-wizard (#90)
Kontext / Ziel
Diese PR liefert den einzigen kanonischen Onboarding-Entry unter /admin/onboarding (workspace-first, tenantless bis zur Aktivierung) und ergänzt einen tenantless OperationRun-Viewer unter /admin/operations/{run} mit membership→404 Semantik.

Was ist enthalten?
Single entry point: /admin/onboarding ist der einzige Einstieg; Legacy Entry Points liefern echte 404 (keine Redirects).
Wizard v1 (Enterprise): idempotentes Identifizieren eines Managed Tenants (per Entra Tenant ID), resumable Session-Flow.
Provider Connection Step: Auswahl oder Erstellung, Secrets werden nie erneut gerendert / nicht in Session-State persistiert.
Verification als OperationRun: async/queued, DB-only Rendering im Wizard (keine Graph-Calls beim Rendern).
Tenantless Run Viewing: /admin/operations/{run} funktioniert ohne ausgewählten Workspace/Tenant, aber bleibt über Workspace-Mitgliedschaft autorisiert (non-member → 404).
RBAC-UX Semantik: non-member → 404, member ohne Capability → UI disabled + tooltip, server-side Action → 403.
Auditability: Aktivierung/Overrides sind auditierbar, stable action IDs, keine Secrets.
Tech / Version-Safety
Filament v5 / Livewire v4.0+ kompatibel.
Laravel 11+: Panel Provider Registrierung in providers.php (unverändert).
Tests / Format
vendor/bin/sail bin pint --dirty
Full suite: vendor/bin/sail artisan test --no-ansi → 984 passed, 5 skipped (exit 0)
Ops / Deployment Notes
Keine zusätzlichen Services vorausgesetzt.
Falls Assets registriert wurden: Deployment weiterhin mit php artisan filament:assets (wie üblich im Projekt).

Co-authored-by: Ahmed Darrazi <ahmeddarrazi@adsmac.fritz.box>
Co-authored-by: Ahmed Darrazi <ahmeddarrazi@MacBookPro.fritz.box>
Reviewed-on: #90
2026-02-04 23:30:55 +00:00

63 lines
1.8 KiB
YAML

openapi: 3.1.0
info:
title: TenantPilot — Managed Tenant Onboarding (073)
version: 0.1.0
description: |
Onboarding wizard + tenantless operation run viewer routes.
These are UI endpoints (Filament/Livewire), documented here for contract clarity.
servers:
- url: https://example.invalid
paths:
/admin/onboarding:
get:
summary: Managed tenant onboarding wizard (canonical entry point)
responses:
'200':
description: Renders onboarding wizard page in the current workspace context.
'302':
description: Redirects to workspace chooser when no workspace is selected.
'403':
description: Workspace member missing onboarding capability.
'404':
description: Workspace not found or user is not a member (deny-as-not-found).
/admin/operations/{run}:
get:
summary: Tenantless operation run viewer
parameters:
- name: run
in: path
required: true
schema:
type: integer
responses:
'200':
description: Renders operation run details.
'404':
description: Run not found or actor is not a member of the run workspace (deny-as-not-found).
/admin/register-tenant:
get:
summary: Legacy tenant registration entry point
deprecated: true
responses:
'404':
description: Must be removed / behave as not found (FR-001).
/admin/new:
get:
summary: Legacy onboarding entry point
deprecated: true
responses:
'404':
description: Must not exist and must behave as not found (FR-004).
/admin/managed-tenants/onboarding:
get:
summary: Legacy onboarding entry point
deprecated: true
responses:
'404':
description: Must not exist and must behave as not found (FR-004).