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

Capability	Student	Teacher	School Admin	Platform Admin
View own journal	✓	✓	—	—
Class snapshot	—	✓	✓	✓
Download resources	—	✓	✓	✓
Manage teachers	—	—	✓	✓
Manage content	—	—	—	✓
Place orders	—	✓	✓	✓