Wiki Index — By System

Find everything about one service in one place. Switch to type-based index for summaries / concepts / entities.

🗺️ Quick Reference — Ports & Domains

app.readingtester.com · port 3125 · /home/ubuntu/reader/

Page	What it covers
Reader App (entity)	Overview, stack, features, tech decisions
Student Flow	Child login → reading → session end
Reading & Telemetry	Reader features, telemetry pipeline, session model, device policy
FK Leveling	How text is leveled to child's FK grade
Shared Database	DB connection (shared-db, port 3316)

port 3110 · /home/ubuntu/telemetry/

Page	What it covers
Telemetry Service (entity)	Overview, event types, pipeline
Reading & Telemetry	Full event pipeline, session model, vocab tap flow, slow-page detection
API Contracts	REST endpoints including /api/session/end, /api/v1/telemetry/*
Core Tables	events, reading_sessions DDL

port 3120 · /home/ubuntu/learner-bot/

Page	What it covers
Learner Bot (entity)	Overview, 20 endpoints, nightly cycle
Bot Endpoints	Full endpoint reference
Memory Model	Memory types, vocab gaps, curriculum state
Nightly Cycle	04:00 UTC cron, retry logic, report generation
Reading & Telemetry	Telemetry→Bot data flow (vocab tap, session summary)
Notifications	Teacher digest + parent digest triggers

cm.readingtester.com · port 3121 · /home/ubuntu/cm/

Page	What it covers
Curriculum Mapper (entity)	Overview, territories, extraction pipeline
Extraction Workers	How curriculum is extracted (detached worker processes)
Lesson Book Pipeline	3-step book generation pipeline (map → general → personalise)
Platform Overview	CM's role in the invisible learning loop

adapt.readingtester.com · port 3119 · /home/ubuntu/adaptive-content/

Page	What it covers
Adaptive Engine (entity)	Overview, providers, caching
Content Engine	How adaptation works end-to-end
FK Leveling	Level-page endpoint, GPT-4o retry logic, cache keys
Data Flow	How CM → Adaptive Engine → Reader connects

teacher.readingtester.com · port 3116 · /home/ubuntu/teacher-portal/

Page	What it covers
Teacher Portal (entity)	Overview, authentication, class management
Teacher Flow	Registration → setup → class creation → student import
Teacher UI Rules	UI principles, progressive disclosure, what to hide
Roster Flows	Class creation, student import, parent link
Identity & Auth	Teacher login, invite flow, SSO via Account Center
Billing & Entitlement	Teacher license model, Stripe, capacity enforcement
Entitlement Model	checkEntitlement(), tiers, class-level enforcement

parents.readingtester.com · port 3118 · /home/ubuntu/parent-portal/

Page	What it covers
Parent Flow	Parent link flow, what parents can see
Roster Flows	Parent link (teacher-initiated invite only)
Identity & Auth	Parent account creation via invite
Notifications	Parent digest triggers

account.readingtester.com · port 3130 · /home/ubuntu/user-center/

Page	What it covers
Account Center (entity)	SSO hub, uc_session cookie, identity tables
Identity & Auth	Full flow contracts: teacher/parent/child login, password reset, PIN reset
User Signup Flows	8 authoritative signup flow contracts (9-part format)
Core Tables	users, email_verification_tokens, invites DDL

Within Teacher Portal + Account Center

Page	What it covers
Billing & Entitlement	Teacher license model (1 per teacher, 33 per class), Stripe, external entitlements
Entitlement Model	checkEntitlement(), tiers, atomic capacity enforcement
Meta-Authority	BILLING-02: 1 license per teacher, 33 students per class

Shared MySQL · /home/ubuntu/shared-db/

Page	What it covers
Core Tables	Full DDL: users, students, classes, class_memberships, teacher_licenses, reading_sessions, events
Entitlement Model	teacher_licenses, external_entitlements, checkEntitlement()
Shared Database	Docker setup, connection strings, migration rules
Data Model Summary	High-level schema overview

Page	What it covers
Service Map	All services, ports, inter-service communication rules
Data Flow	5 end-to-end data pipelines
Shared Database	MySQL Docker setup, all project connections
Platform Overview	Product vision, invisible learning loop, service roles
Project Registry	All live projects, ports, domains, status

Page	What it covers
GDPR Module	Data ownership, lawful basis, export/deletion flows, breach handling
Admin & Compliance	Admin APIs, audit log, impersonation, SOC2/ISO27001

Page	What it covers
API Contracts	All REST endpoints across services, error format, pagination rules
Acceptance Criteria	AC-01 through AC-13 in GIVEN/WHEN/THEN format
Build Checklist	Phase-by-phase build order

Page	What it covers
Meta-Authority	Source hygiene rules, confirmed decisions, open decisions register