An AI-powered educational chatbot platform designed for ALL academic subjects, featuring secure teacher authentication and enabling educators to conduct dynamic assessments and interactive learning sessions with 20-30 students simultaneously.
- Secure Authentication: Account creation, login system, and protected dashboard access
- Universal Subject Support: Create sessions for any academic discipline (Math, Science, History, English, etc.)
- Session Management: 10-session limit per teacher with organized dashboard
- Real-time Monitoring: Live participant tracking and session statistics
- Assessment Scoring: Automated understanding score calculations based on chat interactions
- Report Generation: Individual student reports (.md) and consolidated CSV exports
- Analytics Dashboard: Performance metrics and learning insights
- Simple Join Process: No authentication required - just name and session code
- Interactive Chat: Real-time conversation with AI tutor across any subject
- Progressive Difficulty: Automatic scaling from Basic → Scenario → Advanced levels
- Academic Integrity: Copy/paste prevention to maintain assessment validity
- Mobile Responsive: Works seamlessly across all devices
- Universal Subject Support: Context-aware responses for any academic discipline
- Bloom's Taxonomy Integration: Progressive question difficulty based on educational best practices
- Memory & Context: Maintains conversation history across sessions for learning continuity
- Subject-Appropriate Content: Real-world examples tailored to the specific topic and grade level
- Adaptive Learning: Difficulty adjustment based on student engagement and understanding
- Enhanced Reliability: Robust error handling and optimized chat functionality
- Navigate to teacher dashboard
- Fill in topic, grade level, and learning objectives
5. Generate session code and share with students
- Visit student interface
- Enter name and 6-digit session code
- Start chatting with AI tutor
- Progress through difficulty levels automatically
- Complete session and view results dashboard
- Generate individual student assessments (.md files)
- Export consolidated class data (CSV format)
- Download analytics for gradebook integration
- LMS integration (Canvas, Google Classroom, Schoology)
- Mobile applications (iOS/Android)
- Advanced AI features (sentiment analysis, learning paths)
- Multi-language support
- Real-time WebSocket communications
✅ Phase 1 Complete - Core Platform
- Session creation and management
- Real-time chat with AI integration
- Student participation tracking
✅ Phase 2 Complete - Assessment & Reporting
- Advanced scoring algorithms
- Individual and group report generation
- Comprehensive analytics dashboard
- Session time tracking and management
✅ Phase 3 Complete - Authentication & Multi-Subject Platform
- Secure teacher authentication with account management
- Universal subject support for all academic disciplines
- 10-session limit per teacher with management system
- Copy/paste prevention for academic integrity
- Subject-agnostic architecture and interface
✅ Phase 4 Complete - Enhanced Chat Reliability & Intelligence
- Resolved critical chat functionality issues and error handling
- Implemented Bloom's Taxonomy for educational question progression
- Added conversation memory and context management
- Optimized API performance and response reliability
- Enhanced pedagogical framework for all academic subjects
- Frontend: Next.js 14, TypeScript, Tailwind CSS, shadcn/ui
- Backend: Next.js API Routes, PostgreSQL, Prisma ORM
- Authentication: NextAuth.js with credential provider and bcryptjs
- AI Integration: AbacusAI API (GPT-4.1-mini compatible)
- Deployment: Cloud-ready (Vercel, AWS, Azure compatible)
- Concurrent Users: 20-30 students per session
- Response Times: < 2 seconds for chat interactions
- Scalability: Horizontal scaling with stateless design
- Database: Optimized PostgreSQL with proper indexing
- Pre-Assessment: Baseline knowledge evaluation
- Formative Check: Quick understanding verification
- Review Session: Concept reinforcement
- Unit Assessment: Comprehensive topic evaluation
- Final Review: Cumulative knowledge assessment
- Vocabulary Understanding (applicable to all subjects)
- Concept Application (mathematical, scientific, literary, historical, etc.)
- Critical Thinking (analysis and evaluation across disciplines)
- Problem Solving (STEM, social studies, language arts)
- Case Study Analysis (real-world applications in any subject)
- Subject Connections (interdisciplinary learning)
- Node.js 18+
- PostgreSQL 12+
- AbacusAI API key
# Clone the repository
git clone https://github.com/benny2744/QuizChat.git
cd QuizChat
# Install dependencies
yarn install
# Set up environment variables
cp .env.example .env.local
# Edit .env.local with your database URL and API keys
# Set up database
yarn prisma generate
yarn prisma db push
# Run development server
yarn devDATABASE_URL="postgresql://username:password@localhost:5432/quizchat"
ABACUSAI_API_KEY="your_api_key_here"
NEXTAUTH_URL="http://localhost:3000"
NEXTAUTH_SECRET="your_secret_key_here"app/
├── (routes)/
│ ├── page.tsx # Landing page
│ ├── teacher/ # Teacher dashboard
│ └── student/ # Student interface
├── api/
│ ├── chat/ # Chat API endpoints
│ ├── sessions/ # Session management
│ └── assessments/ # Assessment scoring
├── components/
│ ├── ui/ # shadcn/ui components
│ └── [feature-components] # Custom components
├── lib/
│ ├── types.ts # TypeScript definitions
│ ├── assessment-scoring.ts # Scoring algorithms
│ └── file-generation.ts # Report generation
└── docs/
├── PRD.md # Product Requirements
├── ARCHITECTURE.md # System Architecture
├── TECH_SPEC.md # Technical Specifications
└── CHANGELOG.md # Version History
Comprehensive documentation is available in the /docs directory:
- Product Requirements Document - Feature specifications and requirements
- Architecture Document - System design and technical architecture
- Technical Specifications - Implementation details and API documentation
- Changelog - Version history and feature updates
This project is currently maintained as an educational platform. For questions or suggestions, please refer to the documentation or create an issue.
This project is developed for educational purposes. Please refer to the license file for usage terms.
For technical support or questions about the platform:
- Review the comprehensive documentation in
/docs - Check the changelog for recent updates
- Refer to the technical specifications for implementation details
Built with ❤️ for educators and students
QuizChat - Making learning interactive, engaging, and measurable