Skip to main content

EduPulse Technical Architecture

🎯 The Winning Formula​

Node.js (Developer Velocity) + Go (Reliability) + Python (AI Capabilities)

📊 Technology Stack Overview​

LayerTechnologyVersionPurpose
FrontendNext.js15.xSSR, React Server Components
FrontendTypeScript5.7.xType safety
FrontendTailwind CSS3.xStyling
Frontendshadcn/uiLatestUI components
Backend (Primary)Node.js22 LTSCRUD services
Backend (Primary)NestJS10.xFramework
Backend (High-Perf)Go1.22+Concurrent services
Backend (AI)Python3.12.xAI/ML services
Backend (AI)FastAPI0.115+API framework
DatabasePostgreSQL16.xPrimary database
CacheRedis7.4.xCaching, queues
Vector DBQdrantLatestAI embeddings
StorageAWS S3-Documents
AI ProviderClaude APILatestAI features

🏗️ Service Architecture​

📋 Service Distribution by Language​

Node.js/TypeScript (NestJS) - 60% of codebase​

Best for: CRUD-heavy, UI-backed services, rapid development

ServiceEPICsResponsibility
Auth ServiceEPIC-2Cognito integration, JWT, sessions
SIS ModuleEPIC-3Student CRUD, guardians, documents
Admission PortalEPIC-3Public portal, AI chatbot UI
Fee ManagementEPIC-4Invoices, payment tracking
HR ModuleEPIC-5Staff management, payroll
Asset ManagementEPIC-10Inventory, lab booking
Wellness PortalEPIC-11Health records, counseling
Alumni BridgeEPIC-13Alumni network, events

Golang - 25% of codebase​

Best for: High-concurrency, reliability-critical, real-time

ServiceEPICsResponsibility
Attendance EngineEPIC-3, 5Biometric sync, bulk processing
Finance EngineEPIC-4Double-entry ledger, transactions
Notification DispatcherAllSMS, email, push (100K+/day)
Real-time SyncAllWebSocket connections
Transport TrackerEPIC-12GPS processing, geofencing
Event SourcingAllAudit trail, compliance

Python (FastAPI) - 15% of codebase​

Best for: AI/ML, Claude integration, data processing

ServiceEPICsResponsibility
AI OrchestratorEPIC-6LangChain, prompt management
Board Exam PredictorEPIC-8ML pipeline, predictions
AI TutorEPIC-9RAG, conversation, tutoring
Doubt SnapEPIC-9OCR, image analysis
Question AnalyzerEPIC-7PDF extraction, classification
Assessment EngineEPIC-7Adaptive testing, analytics

🔗 EPIC to Service Mapping​

EPICPrimary LanguageServices
EPIC-1: InfrastructureIaC (CDK)All foundational
EPIC-2: Identity & DPDPANode.jsAuth, Encryption, Audit
EPIC-3: Smart SISNode.js + PythonSIS, Admission Chatbot
EPIC-4: Fee ManagementNode.js + GoFee API, Finance Engine
EPIC-5: HR ManagementNode.js + GoHR API, Attendance Engine
EPIC-6: AI AssistantPythonAI Orchestrator
EPIC-7: AssessmentNode.js + PythonAssessment API, Analyzer
EPIC-8: Exam PredictorPythonPredictor Service
EPIC-9: AI TutorPythonTutor, Doubt Snap
EPIC-10: AssetsNode.jsAsset Management
EPIC-11: WellnessNode.jsWellness Portal
EPIC-12: TransportGoTracker, Geofencing
EPIC-13: AlumniNode.jsAlumni Network

🔄 Inter-Service Communication​

Synchronous (REST/gRPC)​

  • User-facing APIs (low latency)
  • Auth validation
  • Real-time data fetches

Asynchronous (Message Queue)​

  • Notifications (SMS, Email, Push)
  • Bulk operations
  • AI processing (non-blocking)
  • Event sourcing

📈 Scaling Strategy​

PhaseUsersArchitecture
Phase 10-10KMonorepo, shared DB
Phase 210K-100KService split, read replicas
Phase 3100K-500KFull microservices, sharding
Phase 4500K+Multi-region, CQRS