🎓 Lumerion - Digital Learning Management System

An advanced AI-enhanced Learning Management System (LMS) built to deliver personalized digital education experiences through adaptive learning paths, collaborative learning spaces, and intelligent performance monitoring.

Features

AI-Powered Learning

• **Dynamic Roadmap Creation: AI-powered course and roadmap generation using LangChain and LangGraph
• **Customized Learning Experience: Personalized study plans based on learner interests, goals, and current skill levels
• **Automated Dependency Mapping: Smart prerequisite detection and optimized learning progression

Social Learning

• **Collaborative Study Groups: Interactive learning communities with shared objectives and progress tracking
• **Learner Connections: Add friends, view achievements, and stay connected with peers
• **Live Activity Stream: Instant updates on learning activities and study group progress

Progress Tracking

• Comprehensive Analytics: Detailed learning statistics and progress visualization
• Skill Assessments: Interactive quizzes and competency evaluations
• Achievement System: Gamified learning with badges and milestones
• Learning Streaks: Daily learning habit tracking and streak maintenance

Advanced Features

• Multi-format Content: Support for various learning materials and resources
• Real-time Notifications: Instant updates on important learning events
• Responsive Design: Seamless experience across desktop and mobile devices
• Dark Theme: Modern, eye-friendly interface design

Architecture

Lumerion/
├── backend/                 # Node.js/Express API server
│   ├── src/
│   │   ├── agents/         # AI agents (LangChain/LangGraph)
│   │   ├── controller/     # API route handlers
│   │   ├── drizzle/        # Database schema & migrations
│   │   ├── middleware/     # Authentication & validation
│   │   ├── routes/         # API route definitions
│   │   ├── schema/         # Data validation schemas
│   │   └── utils/          # Helper utilities
│   └── tests/              # Backend test suite
├── frontend/                # React SPA
│   ├── src/
│   │   ├── api/           # API client & hooks
│   │   ├── components/    # Reusable UI components
│   │   ├── hooks/         # Custom React hooks
│   │   ├── layouts/       # Page layouts
│   │   ├── pages/         # Application pages
│   │   └── utils/         # Frontend utilities
│   └── public/            # Static assets
├── docs/                   # Documentation
└── tests/                  # Integration tests

Quick Start

Prerequisites

• Node.js 18+ and npm
• PostgreSQL 15+
• Redis (optional, for caching)
• Git

Installation

1. Clone the repository

   git clone https://github.com/Karthick-1905/Lumerion.git
   cd Lumerion

2. Backend Setup

   cd backend
   
   # Install dependencies
   npm install
   
   # Set up environment variables
   cp .env.example .env
   # Edit .env with your database credentials and API keys
   
   # Run database migrations
   npm run db:migrate
   
   # Start development server
   npm run dev

3. Frontend Setup

   cd ../frontend
   
   # Install dependencies
   npm install
   
   # Start development server
   npm run dev

4. Access the Application

   • Frontend: http://localhost:5173
   • Backend API: http://localhost:8000
   • API Documentation: http://localhost:8000/api-docs

5. Optional: Add Mock Data

   cd backend
   npm run db:seed

   This populates your database with sample achievements, skills, and activity data for testing.

Environment Configuration

Backend (.env)

# Database
DATABASE_URL=postgresql://user:password@localhost:5432/Lumerion

# Redis (optional)
REDIS_URL=redis://localhost:6379

# JWT
JWT_SECRET=your-super-secret-jwt-key
JWT_EXPIRES_IN=7d

# Email (for notifications)
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=your-email@gmail.com
SMTP_PASS=your-app-password

# AI Services (optional)
GOOGLE_AI_API_KEY=your-google-ai-key
TAVILY_API_KEY=your-tavily-key

# Notion Integration (optional)
NOTION_API_KEY=your-notion-api-key
NOTION_MCP_URL=http://localhost:8787

Frontend (.env)

VITE_API_BASE_URL=http://localhost:8000

Development

Available Scripts

Backend

npm run dev          # Start development server with hot reload
npm run build        # Build for production
npm run start        # Start production server
npm run test         # Run test suite
npm run db:studio    # Open Drizzle Studio for database management
npm run db:migrate   # Run database migrations

Frontend

npm run dev          # Start development server
npm run build        # Build for production
npm run preview      # Preview production build

Testing

# Backend tests
cd backend
npm run test
npm run test:watch
npm run test:coverage

# Integration tests (if available)
cd ..
npm run test:integration

Database Management

# Generate migration
cd backend
npx drizzle-kit generate

# Push schema changes
npm run db:push

# View database in browser
npm run db:studio

Documentation

Comprehensive documentation is available in the docs/ directory:

• API Documentation - Complete API reference with examples
• Deployment Guide - Production deployment instructions
• Troubleshooting Guide - Common issues and solutions
• Architecture Overview - System architecture and design
• Roadmap - Product roadmap and feature planning
• Notion Integration - External integrations guide

API Documentation

The backend provides comprehensive API documentation via Swagger UI:

• URL: http://localhost:8000/api-docs
• Authentication: JWT Bearer token required for protected endpoints
• Format: OpenAPI 3.0 specification

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• LangChain & LangGraph: For powering our AI-driven learning features
• Drizzle ORM: For type-safe database operations
• React Query: For efficient data fetching and caching
• Tailwind CSS: For beautiful, responsive UI components
• Express.js: For robust API development