Skip to content

About

Fleet Operations Command Deck & Luxury Passenger Digital Twin platform for cruise ships. Built with React 19, TypeScript, Vite, Tailwind CSS 4, and Three.js.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Cruise Hospitality Technology Banner


βš“ CRUISE-WEB

Operations Command Deck & Luxury Passenger Digital Twin

An open enterprise frontend ecosystem engineered for luxury cruise fleets.
Unifying real-time fleet command telemetry, interactive 3D vessel digital twin, voyage global lifecycle orchestration, and a standalone mobile-first guest experience portal.


React 19 TypeScript Vite Tailwind CSS 4 Three.js Vitest TanStack Query License


🌟 Executive Summary & Dual-Portal Architecture

Cruise-web provides a unified single-page architecture with two strictly decoupled operational domains:

🚒 Fleet Operations Command Deck ✨ Luxury Guest Experience Portal
Target: Captain, Chief Purser, Tour Guides & Port Coordinators.

  • 3D Maritime Digital Twin: Interactive WebGL dot-matrix globe visualizing vessel position, navigation waypoints, and port stops.
  • Voyage Global Lifecycle Stepper: Phase transition coordinator enforcing strict operational gates from SCHEDULED to CLOSED.
  • Maritime Timezone Synchronizer: Ship clock and port timezone offset scheduler for international boundary crossings.
  • Shore Excursion Roster: Bus dispatching, capacity quotas, and real-time QR attendance check-in.
  • RFID / NFC Pool Inventory: Contactless passenger badge pairing, lost-card blacklisting, and security watchdog.
Target: Passengers, Families, VIP Guests (Mobile-First / Tablet).

  • Standalone Luxury Layout: Editorial neo-brutalist guest viewport isolated from internal administrative sidebars.
  • Digital Boarding Pass: High-contrast QR/Aztec pass with stateroom number, emergency muster station, and boarding group.
  • Real-Time Stateroom Folio: Live expense stream, itemized onboard dining charges, and instant dispute submission.
  • Daily Interactive Itinerary: Personal daily schedule, gala dinners, Broadway shows, and shore excursions.
  • Touch-Friendly E-Signature: Gesture-guarded canvas with touch-action: none for frictionless cabin charging.

πŸ›οΈ System Architecture & Data Topology

graph TD
    classDef client fill:#0B1F33,stroke:#C5A572,stroke-width:1.5px,color:#fff;
    classDef layout fill:#102A43,stroke:#397C80,stroke-width:2px,color:#fff;
    classDef module fill:#071727,stroke:#64B5F6,stroke-width:1.5px,color:#fff;
    classDef gateway fill:#1E293B,stroke:#F59E0B,stroke-width:2px,color:#fff;

    USER["πŸ‘¨β€βœˆοΈ Crew & Fleet Operators"]:::client
    GUEST["πŸ“± Luxury Cruise Passengers"]:::client

    subgraph Presentation ["Presentation Layer (React 19 + Vite)"]
        USER -->|Authenticated Route| MAIN_LAYOUT["🚒 MainLayout<br/>(Command Sidebar & Navigation)"]:::layout
        GUEST -->|Guest Session Route| GUEST_LAYOUT["✨ PassengerLayout<br/>(Luxury Mobile Stateroom Dock)"]:::layout

        MAIN_LAYOUT --> GLOBE["🌐 3D Maritime Globe (Three.js)"]:::module
        MAIN_LAYOUT --> VOYAGE["⏱️ Voyage Phase Control Center"]:::module
        MAIN_LAYOUT --> EXCURSION["🚌 Excursion & Attendance Dispatcher"]:::module
        MAIN_LAYOUT --> FLEET["βš“ Fleet & Deck Zone Management"]:::module

        GUEST_LAYOUT --> BOARDING["🎫 QR Boarding Pass & Muster"]:::module
        GUEST_LAYOUT --> FOLIO["πŸ’³ Real-Time Folio & Dispute Engine"]:::module
        GUEST_LAYOUT --> SCHEDULE["πŸ“… Personal Daily Schedule"]:::module
    end

    subgraph Integration ["Transport & State Gateway"]
        GLOBE & VOYAGE & EXCURSION & FLEET & BOARDING & FOLIO & SCHEDULE --> AXIOS["⚑ Axios HTTP Client + SSE Stream Handler"]:::gateway
    end

    subgraph Backend ["Enterprise Microservices Ecosystem"]
        AXIOS -->|REST API :8080| API["🏒 Cruise-api (Gateway & Services)"]:::gateway
        API <-->|Offline Delta Sync| POS["πŸ“± Cruise-pos (Android Edge Terminals)"]:::client
    end
Loading

πŸ—ΊοΈ Application Routes & Functional Matrix

Route Viewport / Persona Module & Core Features State & Persistence
/ Crew / Desktop Fleet Operations Dashboard: Live maritime radar, 3D interactive vessel globe, fleet occupancy KPI, and port weather. TanStack Query + SSE
/voyage Crew / Desktop Voyage Lifecycle Control Center: Global state machine stepper (EMBARKATION $\rightarrow$ AT_SEA $\rightarrow$ PORT_VISIT $\rightarrow$ DEBARKING), port timezone coordinator. REST API + State Machine
/ships Crew / Desktop Fleet Specification Management: Hull dimensions, beam, draft, passenger/crew ratios, and deck cabin inventories. Modal Form + Validation
/admin/cruise-area-policies Crew / Desktop Maritime Area & Cancellation Policies: Regional cruise zones, dynamic cancellation penalties, and weather advisories. REST API + Policy Engine
/itinerary Crew / Desktop Voyage Itinerary & Timeline: Chronological ports of call, docking/undocking timetables, and audit history comparison. Timeline Drag & Audit Log
/excursions Crew / Desktop Shore Excursion Catalog & Dispatch: Partner tour directory, bus allocation, pricing, and all-aboard deadlines. Filtered Roster + Quotas
/excursion-attendance Crew / Tablet Excursion Roster Check-in: Real-time QR scanner and RFID tap attendance verification for departing buses. Camera Viewfinder + Sync
/passengers Crew / Desktop Passenger Identity & Card Pool: Cabin assignments, blank RFID card batch ingestion, and lost-badge blacklisting. Search & Batch Actions
/pos Crew / Tablet Web Cashless POS & Folio Tender: Stateroom checkout, digital e-signature pad with gesture lock, and receipt printing. Touch-Safe Canvas Pad
/passenger-home Guest / Mobile Luxury Guest Hub: Personalized cabin welcome, onboard credit (OBC) balance pill, and vessel weather widget. Standalone Luxury Theme
/boarding-pass Guest / Mobile Digital Boarding Pass: High-contrast offline QR pass with muster station designation and boarding group badge. SVG Barcode Renderer
/my-schedule Guest / Mobile Personal Itinerary: Booked excursions, spa appointments, and theater reservations with countdown alerts. Reactive Schedule Grid
/passenger/folio Guest / Mobile Real-Time Stateroom Folio: Itemized transaction ledger, instant dispute filing, and split-cabin preview. Folio Stream + E-Receipts

🎨 Luxury Maritime & Soft Editorial Design System

The visual identity is custom-crafted to reflect the prestige of international superyachts and luxury ocean liners:

Color Token Hex Value Swatch Design Role & Application
Primary Ocean Navy #102A43 #102A43 Command headers, primary action buttons, strong brand typography.
Deep Maritime Abyss #0B1F33 #0B1F33 3D Canvas backdrop, modal overlays, high-contrast dark accents.
Champagne Gold #C5A572 #C5A572 Luxury badges, status rings, interactive icons, active navigation indicators.
Maritime Telemetry Teal #397C80 #397C80 Active voyage phases, GPS indicators, onboard safety sensors, live status.
Soft Editorial Sand #F7F4ED #F7F4ED Warm tactile card backgrounds, secondary containers, paper-like luxury surfaces.
Crisp Travertine Border #E5E0D7 #E5E0D7 Subtle, razor-sharp structural divider borders (1px solid).

πŸ› οΈ Developer Quick Start & Tooling

Prerequisites

  • Node.js: v22.x or later
  • npm: v10.x or later

Installation & Launch

# 1. Clone repository and navigate to directory
git clone https://github.com/Cruise-JavaCLass/Cruise-web.git
cd Cruise-web

# 2. Install dependencies cleanly
npm install

# 3. Start local development server with Hot Module Replacement
npm run dev

The application will initialize at http://localhost:3000 with immediate proxying to Backend Gateway at http://localhost:8080.

Production Build & Preview

# Typecheck and compile optimized production bundle into /dist
npm run build

# Preview production build locally
npm run preview

πŸ§ͺ Testing Suite & Quality Assurance

The codebase enforces strict unit, integration, and component testing via Vitest and React Testing Library:

Command Target Description
npm test All Suites Headless single-pass test execution with standard exit codes.
npm run test:watch Interactive Hot-reloading test runner for ongoing feature development.
npm run test:coverage V8 Coverage Generates statement, branch, and function coverage reports at ./coverage.
npm run test:ui Browser UI Launches interactive visual test explorer in browser.
npm run test:ci CI Pipeline High-verbosity reporting with strict failure thresholds for GitHub Actions.
# Run targeted tests for a specific operational module
npx vitest run src/components/voyage/VoyageLifecycle.test.tsx
npx vitest run src/pages/PassengersPage.test.tsx

πŸš€ Git Strategy & CI/CD Pipeline

Development strictly adheres to GitHub Flow and Conventional Commits:

  • Feature Branches: feature/<JIRA-KEY>-<short-description>
  • Bugfix Branches: bugfix/<JIRA-KEY>-<short-description>
  • Commit Specification: [<JIRA-KEY>] <type>(<scope>): <imperative summary>
  • Continuous Integration: Every PR automatically triggers GitHub Actions running:
    1. Oxlint static AST analysis & syntax validation.
    2. TypeScript strict compiler verification (tsc --noEmit).
    3. Vitest unit and integration test suite with coverage thresholds.
    4. Vite production bundle build verification.


Cruise Hospitality Technology β€’ Engineered for Luxury Maritime Operations
Cruise Management System Β© 2026. Distributed under the MIT License.

About

Fleet Operations Command Deck & Luxury Passenger Digital Twin platform for cruise ships. Built with React 19, TypeScript, Vite, Tailwind CSS 4, and Three.js.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages