# BrainBattle

> BrainBattle is an AI-powered aptitude assessment, anti-cheating proctored testing, and college campus placement preparation platform. Designed for Gen Z students, universities, engineering colleges, and enterprise talent recruiters.

## Overview
BrainBattle provides gamified, proctored assessments across Quantitative Aptitude, Logical Reasoning, Verbal Ability, Technical Programming, Data Interpretation, and Domain Knowledge. It features real-time leaderboard rankings, AI-driven performance analytics, multi-tenant college placement drives, and anti-cheating proctoring controls.

## Key Capabilities
- **Adaptive Question Bank**: Curated categorized questions with multi-tier difficulty ratings (Easy, Medium, Hard), custom marking, negative marking, LaTeX formulas, and rich visual diagrams.
- **Enterprise Anti-Cheating & Proctoring**: Real-time app switch & tab-change tracking, 0ms hardware screenshot blackout, multi-touch gesture interception, iOS WebKit immersive lock, wall-clock time sync, and randomized option sequencing.
- **College & University Portals**: Multi-class & batch management, CSV/Excel bulk candidate roster onboarding, custom test blueprint creation, live candidate monitoring, and exportable ranking reports.
- **Student Exam Arena**: Mobile PWA standalone support, instant scorecards, category-wise performance spider charts, solutions & explanation keys, and statewide/nationwide leaderboard rankings.
- **Free Public Practice Tests**: Instant open demo tests for candidates practicing for campus placements, competitive exams, and IT recruitment drives.

## Primary Documentation & Links
- [Homepage](https://brainbattle.fortunecloudindia.com/): Official web application and landing page.
- [Free Practice Tests](https://brainbattle.fortunecloudindia.com/free-tests): Open access demo aptitude assessments.
- [Platform Features](https://brainbattle.fortunecloudindia.com/features): Comprehensive feature breakdown for candidates and institutions.
- [Why Aptitude Matters](https://brainbattle.fortunecloudindia.com/why-aptitude): Cognitive skill benchmarks for campus hiring.
- [For Students & Freshers](https://brainbattle.fortunecloudindia.com/for-students): Student test arena, progress tracking, and leaderboard.
- [For Colleges & Universities](https://brainbattle.fortunecloudindia.com/for-colleges): Institutional assessment suite, proctoring controls, and placement drive solutions.
- [Pricing Plans](https://brainbattle.fortunecloudindia.com/pricing): Institutional tiers and candidate subscriptions.
- [Contact Support](https://brainbattle.fortunecloudindia.com/contact): Inquiries, partnerships, and technical support.
- [Full LLM Knowledgebase](https://brainbattle.fortunecloudindia.com/llms-full.txt): Comprehensive deep-dive specification for LLMs and AI agents.

## Technical Details
- **Frontend Stack**: React 18, Vite, TailwindCSS, PWA Standalone Mode, Lucide Icons.
- **Backend Architecture**: Node.js, Express.js, Prisma ORM, PostgreSQL database, JWT Security, ExcelJS bulk parser.
- **Proctoring Engine**: WebKit safe area handling, Page Visibility API, bfcache popstate traps, DOM obfuscation during screen capture.