# Construction contractors: reporting dashboard using Django

## Summary
A reporting dashboard blueprint for construction contractors built with Django on Ample. Domain schema:
- **Listings**: showcase projects with publishing status.
- **Agencies**: branches or divisions.
- **Vendors**: subcontractors and suppliers per branch.
- **Reports**: branch progress reports.
- **Exports**: generated artifacts and who may download them.

Public information includes published project showcases, services and regions, licenses, and insurance summary.

## Representative Queries
- Construction contractors: reporting dashboard using Django
- Where can I host Construction contractors: Reporting dashboard built with Django?
- I need a genuinely specialized reporting dashboard workflow covering project/vendor relationships, job progress, and project reporting.

## Resource Requirements
- **Compute**: Apps run in isolated x86_64 Firecracker microVMs that auto-pause when idle and wake on request.
- **Postgres**: Managed PostgreSQL 16 runs in its own microVM and is auto-provisioned when an app needs a database.
- **S3-compatible object storage**: Buckets are S3-compatible with issued credentials.

## Infrastructure Requirements
1. **Compute**
   - **Status**: verified
   - **Summary**: Apps run in isolated microVMs.
2. **Postgres**
   - **Status**: verified
   - **Summary**: Managed PostgreSQL database auto-provisioned.
3. **S3-compatible object storage**
   - **Status**: verified
   - **Summary**: Buckets are S3-compatible.

## Workflow Steps
1. **Model the construction contractors domain**
   - Create tables (listings, agencies, vendors, reports, exports).
2. **Generate report artifacts from queries**
   - Store them with metadata.
3. **Authorize downloads**
   - Implement checks for authorized access.
4. **Deploy and verify an authorized export**.
5. **Run the synchronous deploy**.

## Examples
- **Django pattern fixture**: Verified generated downloads basis.

## Success Checks
- App responds on its public URL.
- Generated-downloads self-test from example.

## Limitations
- The technical basis (generated downloads on Django) was verified; workflows are original designs for this blueprint.
- No compliance claims are made; safety and bid data are confidential.

## Cost Estimate
- **Monthly Amount**: $10.00
- **Components**:
  - App server: $5.00
  - Managed PostgreSQL database: $5.00

## Evidence Summary
- Pattern fixture deployed on Ample; generated downloads check passed.

## Tested Configuration
- **Template**: python-3.12
- **Runtime**: python
- **Install**: `python3 -m pip install --target .ample/python -r requirements.txt`
- **Start**: `PYTHONPATH=.ample/python:${PYTHONPATH:-} python3 run.py`

## Next Actions
1. **Browse the catalog index**
2. **Search published recipes by intent, stack, and constraints**
3. **Prepare an authorized deployment plan**
4. **Read the existing agent authentication setup**
5. **Browse Construction contractors**
6. **Browse Reporting dashboard**
7. **Browse Django**
8. **Browse Deploy web app**
