## Summary - introduce the Provider Connection Filament resource (list/create/edit) with DB-only controls, grouped action dropdowns, and badge-driven status/health rendering - wire up the provider foundation stack (migrations, models, policies, providers, operations, badges, and audits) plus the required spec docs/checklists - standardize Inventory Sync notifications so the job no longer writes its own DB rows; terminal notifications now flow exclusively through OperationRunCompleted while the start surface still shows the queued toast ## Testing - ./vendor/bin/sail php ./vendor/bin/pint --dirty - ./vendor/bin/sail artisan test tests/Unit/Badges/ProviderConnectionBadgesTest.php - ./vendor/bin/sail artisan test tests/Feature/ProviderConnections tests/Feature/Filament/ProviderConnectionsDbOnlyTest.php - ./vendor/bin/sail artisan test tests/Feature/Inventory/RunInventorySyncJobTest.php tests/Feature/Inventory/InventorySyncStartSurfaceTest.php Co-authored-by: Ahmed Darrazi <ahmeddarrazi@MacBookPro.fritz.box> Reviewed-on: #73
39 lines
1.6 KiB
Markdown
39 lines
1.6 KiB
Markdown
# Quickstart: Provider Foundation v1
|
||
|
||
**Branch**: `061-provider-foundation`
|
||
**Date**: 2026-01-24
|
||
**Spec**: `/Users/ahmeddarrazi/Documents/projects/TenantAtlas/specs/061-provider-foundation/spec.md`
|
||
|
||
## Local setup
|
||
|
||
1. Start the app stack:
|
||
- `./vendor/bin/sail up -d`
|
||
2. Install dependencies (if needed):
|
||
- `./vendor/bin/sail composer install`
|
||
3. Run migrations:
|
||
- `./vendor/bin/sail artisan migrate`
|
||
|
||
## Manual QA (once implemented)
|
||
|
||
1. Select a Suite Tenant in the admin UI.
|
||
2. Create a Microsoft Provider Connection:
|
||
- Enter `entra_tenant_id` (GUID) and `display_name`
|
||
- Mark it as the default connection (or ensure exactly one default exists)
|
||
3. Attach credentials (Owner/Manager only):
|
||
- Enter `client_id` + `client_secret`
|
||
- Verify secrets are never shown again after saving
|
||
4. Run “Check connection” (Owner/Manager/Operator):
|
||
- Verify an `OperationRun` is created and visible in Monitoring → Operations
|
||
- Verify failures show a stable reason code + short sanitized message (no tokens/secrets/emails)
|
||
5. Start inventory collection and compliance snapshot:
|
||
- Re-start the same operation while it’s running → returns the existing active run
|
||
- Start a different operation while a run is active for the same scope → blocked as “scope busy” with a link to the active run
|
||
6. Confirm DB-only render:
|
||
- Provider Connections and Operations pages should load/poll without triggering outbound provider calls.
|
||
|
||
## Test run (once implemented)
|
||
|
||
- Run targeted tests:
|
||
- `./vendor/bin/sail artisan test tests/Feature`
|
||
- `./vendor/bin/sail artisan test tests/Unit`
|