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

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