Project 8 of ~34

📓 Academic Pressure Release — Architecture

Student wellness via Telegram. Deno + Supabase + Ollama. Mood tracking, study scheduling, escalation detection. Mac Mini for local AI.

🛠️ Tech Stack

ComponentTechnologyWhy
Telegram BotDeno + Telegram Bot APIPrimary interface — check-ins, stress toolkit, schedule sharing
BackendDeno 224/7 on Mac Mini
DatabaseSupabase (PostgreSQL)Student profiles, mood entries, study schedules, escalation logs
SchedulerUpstash QStashMorning check-ins, wind-down reminders, weekly report triggers
AIOllama (Mac Mini)Study schedule optimization, stress response selection, escalation detection
EmailResendWeekly parent reports
CrisisEscalation to human counselorWhen escalation detected, alert school's counselor via email/SMS

🗄️ Data Model

students
iduuid
telegram_chat_idvarchar(50)
timezonevarchar(50)
school_iduuid (FK, nullable)For school-wide accounts
parent_emailvarchar(255) (nullable)For weekly reports
consent_parent_reportsboolean
mood_entries
iduuid
student_iduuid (FK)
mood_scoreinteger (1–10)
contexttextWhat triggered the mood
created_attimestamp
escelation_flagbooleanAuto-set by AI if patterns detected
study_schedules
iduuid
student_iduuid (FK)
subjectvarchar(100)
exam_datedate
target_hoursinteger
daily_schedule_jsonjsonb[{time, subject, break_minutes}]

Requirements  |  All Projects  |  Presentation →