# Tutoring centers: event registration using Next.js

## Summary
A event registration blueprint for tutoring centers built with Next.js 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
- **events** (seq, record_type, record_id, kind, at): application-owned history written in the same transaction.

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 Next.js: an optimistic version check and an event row written in the same transaction, a stale update rejected, and a history query over the application-owned events (history=2 conflict=rejected).

## Representative Queries
- Tutoring centers: event registration using Next.js
- Where can I host Tutoring centers: Event registration built with Next.js?
- I need a genuinely specialized event registration 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 and is auto-provisioned when an app needs a database and no DATABASE_URL is supplied.

### 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 Next.js project (next build then next start -H 0.0.0.0 -p $PORT on the node-22 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, events. Tutoring groups live in course_groups; keep the sensitive classes (minor students and guardian identity, progress reports) out of this schema.
2. **Model sessions with capacity and registrations with status**
3. **Register transactionally with a capacity check and an event per registration**
4. **Reject stale concurrent updates**
5. **Deploy and verify history and conflict handling**
6. **Deploy**: Run the synchronous deploy once and read the result. Re-running with no change is a no-op.
7. **Verify**: Run the pattern self-test(s) from the example (/p/transactional-workflows) and your own acceptance checks for the tutoring centers workflow.

## Success Checks
- App responds on its public URL
- Transactional-workflows self-test from the example

## Limitations
- Data about minors is sensitive; only group schedules and materials are modeled here.
- Verified on the node-22 template at s-1vcpu-1gb; region, request-duration limits and other sizes are unknown or unverified.

## Cost Estimate
- **Currency**: USD
- **Monthly Amount**: 10.0
- **Basis**: Size prices from pricing.toml at build revision 1ac5595375130d45290090e82ed0f554ccd45405-dirty.

### Components
- **App Server**: size s-1vcpu-1gb, quantity 1.0, monthly amount 5.0
- **Managed PostgreSQL Database**: size s-1vcpu-1gb, quantity 1.0, monthly amount 5.0

## Next Actions
- **Browse the catalog index**
- **Search published recipes by intent, stack and constraints**
- **Prepare a deployment plan for an authorized project**
- **Read the existing agent authentication setup**
- **Browse Tutoring centers**
- **Browse Event registration**
- **Browse Next.js**
- **Browse Deploy web app**