## Creator businesses: documentation site using Laravel

### Summary
A documentation site blueprint for creator businesses built with Laravel on Ample. 
- **Domain schema:** 
  - **customer_workspaces** (name, membership_tier, joined_at): member accounts or communities; 
  - **content_items** (title, tier_required, object_key, published_at, version): versioned content releases; 
  - **customer_assets** (workspace_id, title, object_key, visibility): downloads granted to a member; 
  - **releases** (content_item_id, version, notes): release notes per version; 
  - **state_transitions** (record_type, from_state, to_state): the allowed state machine.
- **Public information:** free content and previews, membership tiers, creator profile. 
- **Kept out of scope until handling is reviewed:** member identity and payment status, private community posts.
- **Technical basis verified on Laravel:** a workspace-scoped table, an explicit state machine (draft to review to published) that rejects invalid transitions, and a cross-workspace read that returns nothing (transitions=true isolation=true).

### Representative Queries
- Creator businesses: documentation site using Laravel
- Where can I host Creator businesses: Documentation site built with Laravel?
- I need a genuinely specialized documentation site workflow covering sponsor/client workspaces, publication guides and content assets.

### Resource Requirements
- **primitive:compute**
- **primitive:postgres**
- **primitive:cdn**

### Infrastructure Requirements
1. **Compute:** Apps run in isolated x86_64 Firecracker microVMs that auto-pause when idle and wake on request; sizes are the priced VM sizes.
2. **Postgres:** Managed PostgreSQL 16 runs in its own microVM and is auto-provisioned when an app needs a database and no DATABASE_URL is supplied.
3. **CDN:** The CDN host serves objects from published buckets. It does not front app compute and is not a cache or key-value store.

### Prerequisites
- A Laravel project (composer install --no-dev from composer.lock, then FrankenPHP serving public/ (php-server with the index.php fallback) reading PORT on the php-8.5 template)
- A PostgreSQL driver reading DATABASE_URL (auto-provisioned when omitted)
- Bucket credentials from `ample bucket create` passed as encrypted S3_* environment variables and a published bucket for public assets (CDN_*)
- A review of which creator businesses data classes may be handled at all; this blueprint models public information only.

### Tested Configuration
- **Template:** php-8.5
- **Runtime:** php
- **Size:** s-1vcpu-1gb
- **Install Command:** composer install --no-dev --prefer-dist --no-interaction --no-progress --optimize-autoloader
- **Start Command:** frankenphp php-server --listen :$PORT --root public

### Workflow Steps
1. **Model the creator businesses domain**: Create the tables customer_workspaces, content_items, customer_assets, releases, state_transitions. Member accounts or communities lives in customer_workspaces; keep the sensitive classes (member identity and payment status, private community posts) out of this schema.
2. **Publish assets for released versions to the CDN bucket**.
3. **Serve only published versions publicly**.
4. **Deploy and verify the version list and a published page**.
5. **Deploy:** Run the synchronous deploy once and read the result. Re-running with no change is a no-op. 
   - **Command:** ample deploy . --name  --public --env S3_ENDPOINT=... --env S3_REGION=... --env S3_BUCKET=... --env S3_ACCESS_KEY_ID=... --env S3_SECRET_ACCESS_KEY=... --env CDN_PUBLIC_URL=...
6. **Verify:** Run the pattern self-test(s) from the example (/p/relational-records) and your own acceptance checks for the creator businesses workflow. 
   - **Command:** ample logs  --kind build

### Examples
1. **Laravel pattern fixture:** Verified relational records basis for this blueprint.
   - **Source Reference:** tests/deploy-canaries/laravel-patterns

### Success Checks
1. **App responds on its public URL:** 
   - **Kind:** http_get 
   - **Path:** / 
   - **Expect:** ample canary laravel patterns
2. **Relational-records self-test from the example:** 
   - **Kind:** http_get 
   - **Path:** /p/relational-records 
   - **Expect:** see the pattern fixture checks.

### Limitations
- The technical basis (relational records on Laravel) was verified with the pattern fixture; the creator businesses schema and workflow are an original design for this blueprint and were not executed as a separate application.
- No health, financial, privacy or other compliance claim is made. Member payment status comes from your payment provider; it is not modeled here and no PCI claim is made.
- Public content and synthetic examples only until actual data-handling requirements have been reviewed.
- Verified on the php-8.5 template at s-1vcpu-1gb; region, request-duration limits and other sizes are unknown or unverified.
- Managed PostgreSQL 16 only; extensions, connection limits and backup or restore procedures are not verified.

### Cost Estimate
- **Currency:** USD
- **Monthly Amount:** $10.0 
- **Note:** Always-on monthly price of the tested sizes; apps and databases auto-pause when idle. Buckets are allocation-priced per quota and not included.
  - **Components:** 
    1. **App server:** 
       - **Size:** s-1vcpu-1gb 
       - **Quantity:** 1.0 
       - **Monthly Amount:** $5.0 
    2. **Managed PostgreSQL database:** 
       - **Size:** s-1vcpu-1gb 
       - **Quantity:** 1.0 
       - **Monthly Amount:** $5.0

### Evidence Summary
- **Kind:** canary_run 
- **Summary:** Laravel pattern fixture deployed on Ample (composer install --no-dev from composer.lock, then FrankenPHP serving public/ (php-server with the index.php fallback) reading PORT on the php-8.5 template); the relational records checks passed: a workspace-scoped table, an explicit state machine (draft to review to published) that rejects invalid transitions, and a cross-workspace read that returns nothing (transitions=true isolation=true). The blueprint's Creator businesses schema and workflow below build on that verified basis and were not separately executed.
- **Observed At:** 2026-09-20T20:36:21Z
- **Implementation Revision:** 118ad1c6d7d23d4c2ce069254bab9ec9d37cd57b-dirty (CLI 118ad1c)
- **Expires At:** 2027-03-19T20:36:21Z
- **Scope:** 
  - **Checks: /p/relational-records** 
  - **Pattern:** pattern:relational-records 
  - **Template:** php-8.5

### Last Verified At
2026-09-20T20:36:21Z