## Tutoring centers: asset library using Laravel

A asset library blueprint for tutoring centers built with Laravel 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;
- **uploads** (id, owner_reference, object_key, content_type, size, uploaded_at): validated uploads linked to their owner.

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 Laravel: 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).

### Representative Queries
- Tutoring centers: asset library using Laravel
- Where can I host Tutoring centers: Asset library built with Laravel?
- I need a genuinely specialized asset library workflow covering course-group membership, session events and teaching materials.

### Resource Requirements
- **primitive:compute**
- **primitive:postgres**
- **primitive:s3-compatible-object-storage**

### Infrastructure Requirements
- **Compute**: Apps run in isolated x86_64 Firecracker microVMs that auto-pause when idle and wake on request; sizes are the priced VM sizes.
- **Postgres**: Managed PostgreSQL 16 runs in its own microVM.
- **S3-compatible object storage**: Buckets are S3-compatible with issued credentials.

### Prerequisites
- A Laravel project (composer install --no-dev from composer.lock, then FrankenPHP serving public/ (php-server with the index.php fallback) reading PORT on the php-8.5 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

### Workflow Steps
1. **Model the tutoring centers domain**: Create the tables course_groups, memberships, sessions, materials, uploads.
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.
6. **Verify**: Run the pattern self-test(s) from the example and your own acceptance checks for the tutoring centers workflow.

### Examples
- **Laravel pattern fixture**: Verified browser file uploads basis for this blueprint.

### Success Checks
- The app responds on its public URL.

### Limitations
- No health, financial, privacy or other compliance claim is made. Data about minors is sensitive.

### Cost Estimate
- Monthly Amount: $10.00 (USD)
- Components:
  - App server: s-1vcpu-1gb
  - Managed PostgreSQL database: s-1vcpu-1gb

### Evidence Summary
- Laravel pattern fixture deployed on Ample; the browser file uploads checks passed: 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.

### Next Actions
1. Browse the catalog index: `/v1/catalog`
2. Search published recipes by intent, stack and constraints: `/v1/catalog/search`