# Professional Training: Asset Library Using Django

## Summary
A asset library blueprint for professional training built with Django on Ample. Domain schema:
- **course_groups** (certification, cohort, start_at, end_at): certification cohorts;
- **memberships** (course_group_id, participant_email, employer, role): participants and trainers;
- **sessions** (course_group_id, starts_at, module, location_or_link): training sessions;
- **materials** (course_group_id, module, object_key, visibility): course materials and exam guides;
- **uploads** (id, owner_reference, object_key, content_type, size, uploaded_at): validated uploads linked to their owner.

Public information: certification catalog, cohort dates, trainer credentials. Kept out of scope until handling is reviewed: exam results, employer billing, participant identity. Exam results and certifications are personal records; only cohort logistics and materials are modeled. Technical basis verified on Django: content-type and size validation that rejects disallowed files, an object written to a private bucket and a row linking the record to the object key (reject=ok upload=ok linked=ok).

## Framework
- **Framework**: Django
- **Workload**: Asset library
- **Industry**: Professional training
- **Release Status**: published
- **Support Status**: verified
- **Execution Status**: ready

## 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 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. **S3-compatible object storage**: Buckets are S3-compatible with issued credentials; PutObject and GetObject are verified by canary. Other S3 operations are not verified.

## Prerequisites
- A Django project (pip install into .ample/python from requirements.txt, then waitress serving project.wsgi from run.py reading PORT on the python-3.12 template)
- A PostgreSQL driver reading DATABASE_URL (auto-provisioned when omitted)
- Bucket credentials from `ample bucket create` passed as encrypted S3_* environment variables
- A review of which professional training data classes may be handled at all; this blueprint models public information only

## Workflow Steps
1. **Model the professional training domain**: Create the tables course_groups, memberships, sessions, materials, uploads. Certification cohorts live in course_groups; keep the sensitive classes (exam results, employer billing, participant identity) out of this schema.
2. **Model assets linked to their owning group or workspace.**
3. **Validate uploads and store them in the private bucket; link each object to its row.**
4. **Authorize downloads by membership.**
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 --start "python3 run.py" --env S3_ENDPOINT=... --env S3_REGION=... --env S3_BUCKET=... --env S3_ACCESS_KEY_ID=... --env S3_SECRET_ACCESS_KEY=...`
6. **Verify**: Run the pattern self-test(s) from the example (/p/browser-file-uploads) and your own acceptance checks for the professional training workflow.

Command: `ample logs --kind build`

## Limitations
- The technical basis (browser file uploads on Django) was verified with the pattern fixture; the professional training 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. Exam results and certifications are personal records; only cohort logistics and materials are modeled.

## Cost Estimate
- **Currency**: USD
- **Monthly Amount**: 10.0
- **Basis**: size prices from pricing.toml (loaded by the API) at build revision 1ac5595375130d45290090e82ed0f554ccd45405-dirty
- **Components**:
   - App server (size: s-1vcpu-1gb): $5.0/month
   - Managed PostgreSQL database (size: s-1vcpu-1gb): $5.0/month

## Success Checks
1. App responds on its public URL
   - Kind: http_get
   - Path: /
   - Expect: ample canary django patterns
2. Browser-file-uploads self-test from the example.
   - Kind: http_get
   - Path: /p/browser-file-uploads
   - Expect: see the pattern fixture checks

## Evidence Summary
-  **Kind**: canary_run
   **Summary**: Django pattern fixture deployed on Ample. The browser file uploads checks passed: content-type and size validation that rejects disallowed files.
   **Observed At**: 2026-09-20T03:31:44Z
   **Implementation Revision**: 03b6402b1b3e19178985f08ea4033804521d85d4-dirty (CLI b75e104)
   **Expires At**: 2027-03-19T03:31:44Z