## Construction contractors: reporting dashboard using Next.js

### Summary
A reporting dashboard blueprint for construction contractors built with Next.js on Ample. Domain schema:
- **Listings**: reference, project_type, location, publishing_status, agency_id.
- **Agencies**: name, license_number, service_region.
- **Vendors**: name, trade, agency_id, prequalified.
- **Reports**: agency_id, period, object_key, generated_at.
- **Exports**: id, definition, object_key, row_count, generated_at, authorized_role.

Public information includes published project showcases, services and regions, licenses and insurance summary. Confidential data like site safety incidents, bid pricing, and client contracts are excluded from this model.

### Technical Requirements
- **Framework**: Next.js
- **Workload**: Reporting dashboard
- **Industry**: Construction contractors
- **Resource Requirements**: primitive:compute, primitive:postgres, primitive:s3-compatible-object-storage

### Infrastructure Requirements
1. **Compute**: Apps run in isolated x86_64 Firecracker microVMs that auto-pause when idle.
2. **PostgreSQL**: Managed PostgreSQL 16 runs in its own microVM.
3. **S3-compatible Object Storage**: Buckets are S3-compatible with issued credentials.

### Prerequisites
- A Next.js project setup with a PostgreSQL driver reading DATABASE_URL.
- Bucket credentials from `ample bucket create` passed as encrypted S3_* environment variables.
- Review of construction contractors data classes.

### Workflow Steps
1. **Model the construction contractors domain**: Create the necessary tables, ensuring sensitive classes remain out of scope.
2. **Scoped to agency**: Model report definitions.
3. **Generate artifacts**: Produce and store report artifacts with metadata.
4. **Authorize downloads**: Ensure unauthorized access results in a 401 status.
5. **Deploy**: Execute deployment commands with the required environment variables.
6. **Verify**: Conduct pattern self-tests and acceptance checks.

### Cost Estimate
- **Currency**: USD
- **Monthly Amount**: 10.0
- **Components**: 
  - App server (s-1vcpu-1gb): $5.0 per month.
  - Managed PostgreSQL database (s-1vcpu-1gb): $5.0 per month.

### Limitations
- No compliance claims made; only published showcases modeled.
- Verified on specific setups; region and other limits unknown.

### Next Actions
- Browse the catalog index.
- Search published recipes.
- Prepare deployment plans.
- Read existing authentication setup.

### Examples
- **Next.js pattern fixture**: Verified generated downloads as a basis for this blueprint.