MAHDI®

Project 01Completed

Study Buddy

"AI Socratic Tutor & Learning Platform for K-12 Students"

RoleFull Stack Engineer
ClientGlobal Client
Timeline2 Months
CategoryPlatforms & CMS
1 / 2
Study Buddy screenshot 1
// System Architecture

The Engineering & Product Vision

Detailed breakdown of technical execution, engineering trade-offs, and high-stakes user requirements delivered in this project.

Study Buddy is a learning platform for school students, built around a Socratic AI tutor that guides students toward answers instead of handing them over. I built the complete backend (a versioned NestJS REST API with 19 documented endpoint groups, Swagger docs and a unified response envelope) and the Next.js admin dashboard. Students pick a grade level, browse subjects and topics, chat with the tutor, take server-graded adaptive quizzes and build daily study streaks. Because many users are minors, sign-up detects age from date of birth and triggers a five-clause parental consent flow by email before access is unlocked. Free and Pro tiers are enforced server-side (daily AI question quotas, Pro-only custom subjects and notes) with Stripe Checkout, webhooks and a sandbox fallback. Admins manage the curriculum hierarchy, quizzes, users, consent compliance, subscriptions and revenue, and tune the AI at runtime (model, temperature, safety level, system prompts) with per-request token and cost logs. The mobile app (iOS & Android) was built by a teammate on top of this API.

// Key Capabilities

Engineered Capabilities & Milestones

FEATURE #01

Socratic AI tutor with streaming and JSON chat modes and per-user daily quotas

FEATURE #02

Automatic minor detection with a 5-clause parental consent workflow

FEATURE #03

Server-side quiz generation and grading with anti-cheat answer hiding

FEATURE #04

Daily streaks, study sessions and progress analytics

FEATURE #05

Free vs Pro tier gating with Stripe Checkout, webhooks and sandbox fallback

FEATURE #06

Admin control of AI model, temperature, safety level and system prompts

FEATURE #07

AI usage logs with token counts, latency and estimated cost

FEATURE #08

Curriculum CMS (levels, subjects, topics, resources) and revenue dashboards

// Technology Stack

Technologies & Tools Deployed

NestJSBackend Architecture
Next.jsFrontend Engineering
PostgreSQLDatabases & Storage
// INITIATE COLLABORATION

HAVE A PROJECT
IN MIND?

Available for select full-stack development, software engineering, and contract work. Let's engineer something extraordinary together.