TenantAtlas/specs/097-settings-foundation/quickstart.md

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