TenantAtlas/specs/097-settings-foundation/quickstart.md
ahmido e241e27853 Settings foundation: workspace controls (#119)
Implements the Settings foundation workspace controls.

Includes:
- Settings foundation UI/controls scoped to workspace context
- Related onboarding/consent flow adjustments as included in branch history

Testing:
- `vendor/bin/sail artisan test --compact --no-ansi --filter=SettingsFoundation`

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #119
2026-02-16 01:11:24 +00:00

1.2 KiB

Quickstart — Settings Foundation (097)

Prerequisites

  • Docker running
  • Laravel Sail available (vendor/bin/sail)

Local setup

  • Start containers:

    • vendor/bin/sail up -d
  • Install dependencies (if needed):

    • vendor/bin/sail composer install
    • vendor/bin/sail npm install

Migrate

  • Run migrations:
    • vendor/bin/sail artisan migrate

Format

  • Format changed files:
    • vendor/bin/sail bin pint --dirty

Tests

Run the smallest relevant set first:

  • Settings Foundation feature tests:

    • vendor/bin/sail artisan test --compact tests/Feature/SettingsFoundation
  • Settings Foundation unit tests:

    • vendor/bin/sail artisan test --compact tests/Unit/SettingsFoundation

Optionally run the full suite:

  • vendor/bin/sail artisan test --compact

Manual verification checklist (after implementation)

  • As workspace manager:

    • Open workspace Settings page
    • Update backup.retention_keep_last_default
    • Confirm success notification and audit entry
    • Reset to system default (confirmation required)
  • As workspace operator/readonly:

    • Open Settings page (view-only)
    • Verify Save/Reset cannot be executed (server-side 403 on mutation)
  • As non-member:

    • Directly visiting the Settings route returns 404