## Tutoring centers: member portal using Django

A member portal blueprint for tutoring centers built with Django on Ample. Domain schema:

- **course_groups** (subject, level, start_at, end_at, capacity): tutoring groups;  
- **memberships** (course_group_id, student_reference, guardian_reference, role): students, guardians and tutors;  
- **sessions** (course_group_id, starts_at, tutor, attendance_count): session events;  
- **materials** (course_group_id, title, object_key, visibility): worksheets and answer keys;  
- **document_access** (document_id, principal_reference, role, granted_at): who may read which document.

Public information: subjects and levels, schedule and locations, tutor qualifications. Kept out of scope until handling is reviewed: minor students and guardian identity, progress reports. Data about minors is sensitive; only group schedules and materials are modeled here. Technical basis verified on Django: a role-to-document access model with negative tests (401 without identity, 403 for the wrong role) and a private-bucket round-trip for the allowed role (private=ok).

### Representative Queries
- Tutoring centers: member portal using Django
- Where can I host Tutoring centers: Member portal built with Django?
- I need a genuinely specialized member portal workflow covering course-group membership, session events and teaching materials.

### Resource Requirements
- **Compute**  
- **Postgres**  
- **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.

### 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 tutoring centers data classes may be handled at all; this blueprint models public information only

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

### Workflow Steps
1. **Model the tutoring centers domain**: Create the tables course_groups, memberships, sessions, materials, document_access. Tutoring groups lives in course_groups; keep the sensitive classes out of this schema.
2. **Workflow step 1**: Model groups, memberships and roles.
3. **Workflow step 2**: Authorize access to materials by membership and role (401, 403 negative tests).
4. **Workflow step 3**: Store materials in the private bucket and stream them through the app.
5. **Workflow step 4**: Deploy and verify the negative tests and an authorized download.
6. **Deploy**: Run the synchronous deploy once and read the result.
7. **Verify**: Run the pattern self-test(s) from the example (/p/private-document-library) and your own acceptance checks for the tutoring centers workflow.

### Limitations
- The technical basis was verified with the pattern fixture; the tutoring centers 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.
- Verified on the python-3.12 template at s-1vcpu-1gb; region, request-duration limits and other sizes are unknown or unverified.

### Cost Estimate
Monthly Amount: **$10.00**  
Basis: size prices from pricing.toml at build revision ...
- **App server**: s-1vcpu-1gb, $5.00
- **Managed PostgreSQL database**: s-1vcpu-1gb, $5.00

### Evidence Summary
- **Kind**: canary_run  
- **Observed At**: 2026-09-20T03:31:44Z  
- **Summary**: Django pattern fixture deployed on Ample; the private document library checks passed.

### Next Actions
1. **Browse the catalog index**  
2. **Search published recipes by intent, stack and constraints**  
3. **Prepare a side-effect-free deployment plan for an authorized project**  
4. **Read the existing agent authentication setup**  
5. **Browse Tutoring centers**  
6. **Browse Member portal**  
7. **Browse Django**  
8. **Browse Deploy web app**