docs: sync OpenSpec archives and propose foundation parity
Archive completed public-site and production-provider changes into main specs, remove duplicate active changes, and add complete-foundation-parity so Phase 0 staging and remaining foundation gaps block Phase 2 cleanly. Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
@@ -0,0 +1,44 @@
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: Cloudflare R2 is available as dedicated filesystem disk
|
||||
|
||||
The system SHALL provide an `r2` filesystem disk using Laravel's S3-compatible driver pointed at Cloudflare R2 (SPEC §6.4, §9.1, §15.4). Configuration MUST use explicit `R2_*` environment variables: `R2_ACCESS_KEY_ID`, `R2_SECRET_ACCESS_KEY`, `R2_BUCKET`, `R2_ENDPOINT`, and `R2_URL`.
|
||||
|
||||
#### Scenario: R2 disk is defined in filesystem config
|
||||
|
||||
- **WHEN** the application boots
|
||||
- **THEN** `config('filesystems.disks.r2')` MUST exist
|
||||
- **AND** the disk driver MUST be `s3`
|
||||
- **AND** credentials MUST resolve from `R2_ACCESS_KEY_ID` and `R2_SECRET_ACCESS_KEY`
|
||||
|
||||
#### Scenario: R2 endpoint uses path-style addressing
|
||||
|
||||
- **WHEN** the `r2` disk is configured
|
||||
- **THEN** `use_path_style_endpoint` MUST be `true`
|
||||
- **AND** `endpoint` MUST resolve from `R2_ENDPOINT`
|
||||
|
||||
#### Scenario: Public URLs use custom domain
|
||||
|
||||
- **WHEN** a file is stored on the `r2` disk with public visibility
|
||||
- **THEN** generated URLs MUST use `R2_URL` as base
|
||||
- **AND** MUST NOT require signed URLs for browser-facing media
|
||||
|
||||
### Requirement: Production default filesystem disk is R2
|
||||
|
||||
Production deployments MUST set `FILESYSTEM_DISK=r2` so application code using the default disk stores files on R2.
|
||||
|
||||
#### Scenario: Default disk resolves to R2 in production
|
||||
|
||||
- **WHEN** `FILESYSTEM_DISK=r2` is set
|
||||
- **THEN** `config('filesystems.default')` MUST be `r2`
|
||||
|
||||
#### Scenario: Local development keeps local disk
|
||||
|
||||
- **WHEN** `FILESYSTEM_DISK` is unset or set to `local`/`public` in development
|
||||
- **THEN** the default disk MUST NOT require R2 credentials to boot
|
||||
|
||||
#### Scenario: Tests do not call R2
|
||||
|
||||
- **WHEN** the test suite runs
|
||||
- **THEN** tests MUST use `Storage::fake('r2')` or local fakes
|
||||
- **AND** no live HTTP request to Cloudflare R2 MUST occur during CI
|
||||
Reference in New Issue
Block a user