Skip to content
Mohammed Sahil edited this page Nov 21, 2026 · 4 revisions

Odyssey Technical Documentation

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.


1. System Overview

flowchart TD
    subgraph Client ["Client Presentation Layer (Vercel Edge • React 19)"]
        UI["React 19 Application<br/>Vite 8 &bull; 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 &bull; Node.js 20)"]
        Router["REST Router & Middleware<br/>Whitelisted CORS Validation"]
        Shield["Rate Limiting & Security<br/>express-rate-limit &bull; 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
Loading

2. Core Technical Pillars

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

3. Production Deployments & Telemetry

  • 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)

Clone this wiki locally