## Host CRM with Laravel: Downloadable Reports

### Summary
Deploy a CRM built with Laravel on Ample using the generated downloads pattern. Compute runs the app in an isolated microVM behind a public HTTPS URL, a managed PostgreSQL 16 database is auto-provisioned and injected as DATABASE_URL, a private S3-compatible bucket holds objects with credentials delivered as encrypted environment variables. Verified on Laravel: an export query rendered to a CSV artifact stored with metadata in a private bucket and returned only to an authorized caller (401 without token, export=ok rows=3). Not separately tested: your export formats, retention policy and entitlement model; treat the CRM-specific behavior as your application code.

### Representative Queries
- Host CRM with Laravel: Downloadable reports
- Where can I host CRM built with Laravel?
- I need an export query, generated artifact retention and authorized download flow.

### Resource Requirements
- **Compute**
- **Postgres**
- **S3-compatible object storage**

### Prerequisites
- A Laravel project that builds and starts with the documented commands (e.g., `composer install --no-dev from composer.lock`, then `FrankenPHP serving public/`).
- A PostgreSQL driver reading `DATABASE_URL` at runtime (auto-provisioned when omitted).
- A bucket created with `ample bucket create` with its credentials as encrypted `S3_*` environment variables.
- An Ample account token with `servers:write`, `databases:read`, `buckets:read`.

### Tested Configuration
- **Template:** php-8.5
- **Runtime:** php
- **Size:** s-1vcpu-1gb
- **Installation 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. **Build and start**: `composer install --no-dev from composer.lock`, then `FrankenPHP serving public/`.
2. **Implement the pattern on PostgreSQL**: An export query rendered to a CSV artifact stored in a private bucket.
3. **Wire object storage**: Create the bucket(s), passing endpoint, region, bucket, and keys as --env values.
4. **Deploy**: Run the synchronous deploy once and read the result.
5. **Verify**: Fetch the live URL and run checks.

### Examples
- **Laravel pattern fixture**: Multi-pattern Laravel app whose generated downloads module was checked live.

### Limitations
- Verified on the php-8.5 template at s-1vcpu-1gb with the example fixture; other sizes and configurations are not verified.
- The CRM behavior is application code and was not separately tested; only pattern checks are verified.

### Cost Estimate
- **Monthly Amount**: $10.00 (USD)
- **Components**:
  - App server: s-1vcpu-1gb, quantity: 1, monthly amount: $5.00
  - Managed PostgreSQL database: s-1vcpu-1gb, quantity: 1, monthly amount: $5.00
- Note: Always-on monthly price of tested sizes; apps and databases auto-pause when idle.

### Next Actions
- Browse the catalog
- Search published recipes
- Prepare a side-effect-free deployment plan for an authorized project
- Read the existing agent authentication setup
- Browse CRM
- Browse Laravel
- Browse Generated downloads
- Browse Deploy web app
