Product architecture

How MindfulScholars works

A guided tour through the system: from a student's morning check-in to real-time class insight for teachers and platform-wide analytics for admins.

Core user flow
Student check-in
Mood + note
Wellbeing engine
Signals + rules
Class dataset
Anonymised
Teacher insight
Snapshot + plan
School admin
Curriculum coverage
Presentation
· Role-aware dashboards
· Journal reader & check-in
· Mindfulness library player
· Shop & ordering
· Teacher Hub (protected resources)
Rules & engine
if streak < 3 && mood == "Worried"
  → suggest Breathing (2m)
if class_mood.negative > 30%
  → nudge Classroom Reset
if pageCompletion > 80%
  → unlock next journal chapter
Data model
School → Teacher → Class → Student
Student → CheckIns, JournalEntries
Content → Journals, Videos, Resources
Commerce → Orders, LineItems
Curriculum → Strand → LearningOutcome
System overview
Edge web app
SSR, cached routes
Rules engine
Deterministic + weights
Encrypted store
Per-school isolation
Notifications
Email · in-app · push
GDPR + DPIA
Child data by design
Commerce
PSD2, VAT, invoicing
Content CMS
Curriculum tagging
Wellbeing API
Aggregated only
Access matrix
CapabilityStudentTeacherSchool AdminPlatform Admin
View own journal
Class snapshot
Download resources
Manage teachers
Manage content
Place orders