Empowering competitive exam aspirants with real-time test simulations, adaptive marking, and deep performance intelligence.
MockBazaar is an enterprise-grade examination and learning platform engineered specifically for competitive exam preparation (SSC CGL/CHSL, UPSC CSE, State PSCs, Banking, Railways, and more). It delivers exam-accurate testing environments, instant scorecards, spaced repetition revision, and administrative oversight.
Competitive examinations test not just knowledge, but time allocation, accuracy under pressure, and strategic question selection. MockBazaar bridges the preparation-to-performance gap through three core pillars:
-
Exam-Fidelity Simulation
Simulates real computer-based test (CBT) interfaces with multi-section timers, negative marking models, and standardized question navigation palettes. -
Actionable Diagnostic Analytics
Provides beyond-the-scorecard intelligence: topic-level proficiency, time-per-question metrics, accuracy vs. speed trade-offs, and weakness radars. -
Curated & Governed Content Operations
Enables educators and content teams to manage thousands of questions, structured blueprints, and bulk CSV ingestions with built-in validation.
- Practice Under Real Conditions: Full-length mocks, sectional speed drills, and customized topic-wise practice sets.
- Instant Result Evaluation: Accurate computation of raw marks, negative deductions, category cutoffs, and percentile rankings.
- Targeted Revision: Automated spaced-repetition revision queue focusing on weak topics and past test mistakes.
- Bookmarks & Solutions: Detailed question explanations, formula derivations, and bookmarked questions library.
- Question Studio: Authoring single-choice, multiple-choice, numerical, and assertion-reasoning questions with LaTeX/rich explanations.
- Exam Blueprints: Definition of exam sectional distributions, positive/negative marks per question, and sectional time budgets.
- Bulk CSV Ingestion: High-throughput question uploads with row-by-row pre-validation and syntax error reporting.
- Mission Control Operations: Real-time KPI dashboards (MRR, active aspirants, mock completions, question bank health).
- 18-Collection Resource Explorer: Schema-introspected management across People, Content, Practice, Billing, and System settings.
- Immutable Audit Trail: Append-only audit logging recording every administrative change with JSON diffs and sensitive field masking.
- Platform Integrity Guardrails: Concurrency conflict prevention (
ETag/If-Match), referential integrity checks, and emergency user session revocation.
MockBazaar operates as three decoupled, purpose-built applications communicating through a central API gateway:
┌──────────────────────────┐
│ Browser Client │
└─────────────┬────────────┘
│
┌────────────────────────────┼────────────────────────────┐
│ :3001 │ :3002 │ :3000
▼ ▼ ▼
┌──────────────────────┐ ┌──────────────────────┐ ┌──────────────────────┐
│ Student Application │ │ Super Admin Room │ │ Central API Gateway │
│ (frontend/) │ │ (superadmin/) │ │ (backend/) │
│ React 18 + Vite SPA │ │ React 18 + Vite SPA │ │ Node.js Express REST │
└──────────┬───────────┘ └──────────┬───────────┘ └──────────┬───────────┘
│ │ │
└────────────────────────────┴────────────────────────────┤
▼
┌──────────────────────┐
│ MongoDB 7 Database │
│ (mockbazaar) │
└──────────────────────┘
| Application | Port | Directory | Target Audience & Purpose |
|---|---|---|---|
| Student Web App | 3001 |
frontend/ |
Aspirant portal for mock test taking, results, review, and analytics. |
| Super Admin Room | 3002 |
superadmin/ |
Platform owner console for governance, billing, audit, and registry. |
| API Gateway | 3000 |
backend/ |
Central REST API handling auth, scoring, validation, and database operations. |
- Multi-Exam Support: Configurable schemas for SSC, UPSC, Banking, and State PSC formats.
- Adaptive Marking Engine: Hierarchical marking rules (Question level overrides Mock level overrides Exam defaults).
- Idempotent Test Submissions: Cryptographic idempotency keys prevent duplicate scoring or double-submission anomalies.
- Optimistic Concurrency: Eliminates blind write collisions across content editors using
ETagvalidation. - Formula Injection Defense: Automatic CSV export sanitization blocks spreadsheet formula injection vulnerabilities (
=,+,-,@). - Postman Single Source of Truth: Comprehensive workspace (
postman/) covering every route, sample payload, and automated token tests.
For implementation details, API specifications, and architectural diagrams, refer to the documentation in docs/:
- 🏛️ System Architecture (
docs/architecture.md) — High-level architecture, inter-app communication, and deployment topology. - ⚙️ Backend API & Services (
docs/backend.md) — Node.js/Express service architecture, 26 domain modules, RBAC, and error standards. - 💻 Student Frontend Portal (
docs/frontend.md) — React examination player, timers, test states, scorecards, and UI design. - 🛡️ Super Admin Control Room (
docs/superadmin.md) — Standalone owner console, 18 registered collections, safety guardrails, and audit ledger. - 🤖 AI Tools & Feature Specification (
docs/AI_TOOLS_SPECIFICATION.md) — Schemas, endpoints, question bank identity, and auto-curation contracts for AI paper setters and autonomous tools. - 📮 Postman Workspace Guide (
postman/README.md) — Postman collection, automated environment variables, and testing scripts.
MockBazaar is proprietary software. All rights reserved.