EngineerOS is a unified, production-grade web platform engineered specifically for engineering students. It bridges academic curriculum, competitive coding (DSA), GATE examination preparation, AI learning assistance, proctored assessments, and senior/alumni mentorship into a coherent, high-performance operating system.
- Modular Monolith: 12 strictly isolated domain modules (
auth,users,dashboard,academics,coding,gate,ai-assistant,assessments,community,interviews,progress,notifications,admin). - Dual Process Runtime: Decoupled HTTP API node (
server.js) and BullMQ background worker (worker.js). - Offline / Zero-Key Portability: High-fidelity mock adapters for Judge0 sandboxed execution, Anthropic Claude LLM, and SES email dispatches enable full offline local development and test runs with zero external API keys.
- Pre-Aggregated Progress: Event-driven architecture pipes
activityEventsthrough BullMQ workers intoprogressSummaries, guaranteeing sub-30ms dashboard response times. - Server-Sent Events (SSE): Real-time token streaming for AI chat and submission execution without the stateful connection overhead of WebSockets.
Comprehensive design documents:
| Domain | Technology |
|---|---|
| Frontend | React 18, Vite, React Router, Tailwind CSS, TanStack Query, React Hook Form + Zod, Recharts, Monaco Editor |
| Backend | Node.js 20, Express (ES Modules), Mongoose, Zod, Pino, Helmet, CORS |
| Data & Cache | MongoDB 7.0 (Replica Set rs0 for transactions), Redis 7 (Queues, Cache, Limits) |
| Queue Worker | BullMQ |
| Code Sandbox | Judge0 API adapter + Built-in offline mock sandbox |
| AI Assistant | Anthropic Claude adapter + Built-in offline mock LLM |
| DevOps | Docker, Docker Compose, Nginx reverse proxy, GitHub Actions CI |
- Node.js >= 20.0.0
- npm >= 10.0.0
- Local MongoDB and Redis instances (or via Docker Compose:
docker compose up mongo redis judge0-stub -d)
# 1. Clone repository
git clone https://github.com/TusarGoswami/engineeeer_OS.git
cd engineer_os
# 2. Install monorepo dependencies
npm install
# 3. Configure environment files
cp server/.env.example server/.env
# 4. Seed database with realistic curriculum and problem sets
npm run seed
# 5. Start development servers (API, Worker, Client concurrently)
npm run devThe application will be accessible at:
- Client:
http://localhost:3000 - API Server:
http://localhost:5000 - Health Check:
http://localhost:5000/healthz
To run the complete production topology (Nginx, API, BullMQ Worker, MongoDB Replica Set, Redis, and Judge0 Stub):
docker compose up --build -dAccess the platform at http://localhost (via Nginx reverse proxy on port 80).
# Run linters across all workspaces
npm run lint
# Verify code formatting
npm run format:check
# Run backend unit and integration tests (in-memory MongoDB)
npm run test:server
# Run frontend unit and component tests
npm run test:client
# Production build validation
npm run buildengineeros/
├── client/ # React 18 + Vite frontend
│ ├── src/
│ │ ├── app/ # Router, Providers, Query Client
│ │ ├── components/ # Reusable UI kit (Buttons, Modals, Tables, etc.)
│ │ ├── features/ # Domain feature pages & components
│ │ ├── layouts/ # Dashboard and Public layouts
│ │ └── services/ # Axios client and API endpoints
├── server/ # Express API & BullMQ worker
│ ├── src/
│ │ ├── config/ # Zod env schema, MongoDB, Redis, Logger
│ │ ├── middleware/ # Auth, RBAC, Validation, Rate Limit, Error
│ │ ├── modules/ # 12 isolated domain modules
│ │ ├── integrations/ # Judge0, LLM, Storage, Email adapters + mocks
│ │ ├── jobs/ # BullMQ queues and worker consumers
│ │ ├── server.js # HTTP API entry point
│ │ └── worker.js # Background worker entry point
├── docs/ # Architecture, ADRs, Implementation Plans, Indexes
├── nginx/ # Nginx reverse proxy configuration
├── judge0-stub/ # Offline mock sandbox container
└── docker-compose.yml # Local orchestration
Designed and engineered by Tusar Goswami
- GitHub: @TusarGoswami
- Email: tusarg937@gmail.com
- Project Repository: https://github.com/TusarGoswami/engineeeer_OS