change-summary-faculty-classroom
What is changing — Faculty classrooms, fees & in-class learning
Status: Design package for the next Elm Street education milestone.
Baseline (already in product): Elm Street campus strip, four day-gated buildings, 5 APU dual-tender day entry, left-edge name strip, lights beside buildings, proximity payment panel.
This package: Rename buildings to faculties, unlock post-gate proximity verbs, faculty interior classrooms, learning-path enrollment (annual school fees), and in-class lesson cards with authored Senior High content in the repo.
1. One-line delta
After a learner buys a faculty day gate, they can enter the faculty classroom (P), choose a learning path and pay annual school fees (A), and start class (C) — then walk lesson cards and press A to read course content.
2. What stays the same
| Locked / kept | Notes |
|---|---|
| Elm Street above Oak Lane, buffer from column streets, no world-bounds expand | Unchanged |
| Day gate: 5 APU (or APW$) per faculty per UTC day | Still required before interior / class verbs |
| Dual-tender wallet + scanner ledger patterns | Extended to a new fee product |
| Four buildings on the campus strip (v1) | Renamed / remapped; not expanded to eight in this milestone |
| Maple Ave arcade economy | Untouched |
3. What changes
3.1 Naming & identity
| Before (shipped ids / labels) | After |
|---|---|
| Educational “centers” | Faculties |
foundations-hall · Foundations |
faculty-art · Faculty of Art |
curriculum-tower · Curriculum |
faculty-science · Faculty of Science |
assessment-atelier · Assessment |
faculty-medicine · Faculty of Medicine |
classroom-studio · Classroom |
faculty-education · Faculty of Education |
Faculty objectives (locked):
- Art — languages, history, philosophy, visual arts
- Science — mathematics, physics, chemistry, biology, computer science
- Medicine — clinical training, nursing, medical research
- Education — teacher training and pedagogical studies
Audience for authored courses: Senior High (≈ grades 10–12 / ages 15–18).
3.2 Proximity verbs (overworld, after day gate)
| Key | Without day gate | With active day gate |
|---|---|---|
| (proximity) | Day-entry payment prompt | Legend + floating prompt for P / A / C |
| P | — | Enter faculty interior (classroom world) |
| A | — | Choose learning path → annual school-fees payment |
| C | — | Start class (requires enrolled path with active fees) |
Without a day gate, behavior stays: prompt to buy 5 APU day entry for that faculty.
3.3 New economic product — annual school fees
| Attribute | Rule |
|---|---|
| Product | Learning-path school fees (enrollment) |
| Duration | One year from purchase timestamp (or UTC year policy — see PRD §Fees) |
| Price band | APW$ 450–900 (dual tender: APU or APW$ at live rate) |
| Pricing basis | Complexity tier of the learning path (not the faculty day gate) |
| Scope | One { facultyId, pathId } enrollment |
| Prerequisite | Active day gate for that faculty to open the path chooser from proximity; fees themselves are annual and persist across days |
3.4 Faculty interior
Each faculty gets an internal classroom world (enclosed stage, parallel to house / amenity / game stages):
- Looks like a classroom (boards, desks, section rails)
- Sections showcase the curriculum (path cards / boards)
- Learner can inspect paths and select one (
Aflow) - After fees + Start class (
C), the room populates lesson cards - Near a card,
Areveals course content (read / learn UI)
3.5 Content packaging
Course outlines and lesson bodies live in the repo (file tree, not DB yet), organized by faculty → path → lessons, so they can later migrate to a CMS/DB without rewriting the player UX.
Canonical tree (implementation target):
packages/play-ui/src/education/content/faculties/
art/
science/
medicine/
education/
Each faculty folder holds path folders with outline.md + lessons/*.md and a typed catalog index.
4. Document map (this package)
| Document | Role |
|---|---|
| README | Index + status |
| Change summary | This file — delta vs shipped |
| PRD | Product requirements & acceptance |
| Architecture | Systems, stages, data, money flows |
| Engineering | Schemas, RPCs, UI, TDD, phases, migration |
| Content pack | Faculty course outlines & lessons in-repo |
Historical campus design (still useful for street/ambience): elm-street-educational-arena.md. Prefer this package for faculties, interiors, fees, and class cards.
5. Explicit non-goals (this milestone)
- Expanding from 4 → 8 faculties
- Mastery marks ledger / public scanner vanity (may stay later)
- Multiplayer co-taught interiors
- Moving content into a database (folder layout must make that migration obvious)
- Changing day-gate price (stays 5 APU)
- Arcade / parking / house systems except shared stage/proximity patterns
6. Acceptance snapshot
Done when:
- Faculties are renamed and labeled on Elm Street.
- Day gate still required; after payment, P / A / C prompts appear.
- P opens that faculty’s classroom interior.
- A opens path selection → complexity-priced annual fees (450–900 APW$ dual tender).
- C starts class only with active enrollment.
- Class mode shows lesson cards; proximity
Areveals authored content. - All four faculties ship Senior High outlines + lesson content under the content tree.