Repository navigation
Home
Mohammed Sahil edited this page Nov 21, 2026
·
4 revisions
Engineering architecture and systems reference for Odyssey — an asynchronous, high-throughput campus stationery requisition and document print pre-ordering platform built on React 19, Vite 8, Three.js WebGL Spatial Cursor, Express 5, and MongoDB.
flowchart TD
subgraph Client ["Client Presentation Layer (Vercel Edge • React 19)"]
UI["React 19 Application<br/>Vite 8 • Lenis Smooth Scroll"]
Cursor["Three.js Spatial Engine<br/>Route-Synced Dynamic Physics"]
Vectors["SVG Canvas Layer<br/>Locked-Geometry Vector Shrines"]
UI <--> Cursor
UI <--> Vectors
end
subgraph Gateway ["Application Gateway (Express 5 • Node.js 20)"]
Router["REST Router & Middleware<br/>Whitelisted CORS Validation"]
Shield["Rate Limiting & Security<br/>express-rate-limit • Sanitization"]
Uploads["Multer Disk Engine<br/>Buffer-Guarded Document Ingestion"]
Router --> Shield
Router --> Uploads
end
subgraph Persistence ["Persistence Layer"]
DB[("MongoDB Database<br/>Mongoose 8 Strict Schemas")]
end
UI -->|JSON REST Transport| Router
Shield --> DB
| Subsystem | Stack & Technical Implementation | Documentation |
|---|---|---|
| Frontend Architecture | React 19, Vite 8, React Router v7, Lenis smooth scrolling, locked geometry cards | Architecture |
| WebGL Spatial Engine | Three.js liquid metal chrome blob cursor, dynamic route-synced physics & viscosity | WebGL-Cursor |
| Payment Gateway | Gothic Grim Reaper altar, client-side dynamic UPI QR generation, vector stacking | Payment-Ritual |
| Print & Receipt System | Thermal paper sawtooth tear edge, Code 128 barcode engine, multi-page folio receipts | Thermal-Receipt |
| Security & Governance | Zero npm audit vulnerabilities, CodeQL AST static analysis, Dependabot, CI matrix | Security-Governance |
- Production URL: odyssey-official.vercel.app
-
API Health Telemetry:
/health(Real-time database connection status) -
CI / CD Pipelines: GitHub Actions (
.github/workflows/ci.yml&codeql.yml)
Odyssey Technical Documentation • Maintained by Mohammed Sahil • React 19, Vite 8, Three.js & Express 5.