page:blueprints:tutoring centers:member portal:django

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