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

55 lines
1.2 KiB
Markdown

# 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