APEX AI-Driven School Platform

Complete full-stack application for AI-powered adaptive learning with dual AI tutor integration.

Architecture

• Backend: NestJS + Prisma + PostgreSQL + OpenAI + Google Gemini
• Frontend: Next.js 14 + TypeScript + Tailwind CSS + Zustand

Features

• JWT Authentication
• Dual AI-powered tutoring:
  • OpenAI adaptive tutor with cognitive load monitoring
  • Google Gemini tutor with structured responses
• Progressive curriculum unlocking
• Real-time mastery tracking
• Personalized learning paths
• Responsive UI with Tailwind CSS

Quick Start

Backend Setup

cd backend
npm install
cp .env.example .env
# Configure DATABASE_URL, JWT_SECRET, OPENAI_API_KEY, and GEMINI_API_KEY in .env
npx prisma generate
npx prisma db push
npm run prisma:seed
npm run start:dev

Backend runs on http://localhost:3000

Frontend Setup

cd frontend
npm install
cp .env.example .env.local
# Configure NEXT_PUBLIC_API_URL in .env.local
npm run dev

Frontend runs on http://localhost:3000

Demo Credentials

• Email: student@apex.com
• Password: password

Environment Variables

Backend (.env)

DATABASE_URL="postgresql://user:password@localhost:5432/apex_school"
JWT_SECRET="your-secret-key"
OPENAI_API_KEY="sk-your-openai-key"
GEMINI_API_KEY="your-gemini-key"
NODE_ENV="development"
PORT=3000

Frontend (.env.local)

NEXT_PUBLIC_API_URL=http://localhost:3000

API Documentation

See backend/API.md for complete API documentation.

Key Endpoints

Authentication:

• POST /api/auth/login
• POST /api/auth/register

Curriculum:

• GET /api/curriculum/:subject
• POST /api/curriculum/mastery

AI Tutors:

• POST /api/ai/chat (OpenAI)
• POST /api/ai-tutor (Gemini)

Health:

• GET /health

Testing Gemini Integration

Backend Test

curl -X GET http://localhost:3000/api/ai-tutor/test

Frontend Test

1. Login at http://localhost:3000/login
2. Navigate to Dashboard
3. Click "Start" on any lesson
4. Use the Gemini AI Tutor component in the lesson page

Project Structure

apex-school/
├── backend/          # NestJS API
│   ├── prisma/      # Database schema & seed
│   ├── src/
│   │   ├── ai/              # OpenAI tutor module
│   │   ├── ai-tutor/        # Gemini tutor module
│   │   ├── auth/            # Authentication
│   │   ├── curriculum/      # Curriculum management
│   │   ├── students/        # Student profiles
│   │   ├── health/          # Health checks
│   │   └── common/          # Shared utilities
│   └── test/        # E2E tests
└── frontend/        # Next.js app
    ├── app/         # App router pages
    ├── components/  # React components
    └── lib/         # Utilities

AI Tutor Comparison

Feature	OpenAI Tutor	Gemini Tutor
Location	Right sidebar chat	Lesson content area
Response Type	Conversational	Structured (answer/hints/next step)
Adaptation	Cognitive load aware	Context aware
Use Case	Quick questions	Detailed explanations

Deployment

See backend/DEPLOYMENT.md for production deployment guide.

License

UNLICENSED - Private educational platform