JupiterEye — Real-Time Jovian 3D Observatory Platform

JupiterEye is a scientifically accurate, real-time 3D observatory and telemetry monitoring platform focused on Jupiter and its Galilean moons (Io, Europa, Ganymede, Callisto).

🚀 Quickstart & Deployment

1. Run Locally with Node.js

npm install
npm run dev

Open http://localhost:3000 in your browser.

2. Production Build

npm run build
npm start

3. Deploy with Docker Compose (VPS / Cloud)

docker-compose up -d --build

This boots both the JupiterEye Core Fullstack container and the Nginx Reverse Proxy Gateway.

---

🛰️ Architecture & Ephemeris Engine

• Frontend: React 19, TypeScript, Three.js WebGL Engine, Tailwind CSS
• Backend: Express Standalone Server, High-precision Keplerian Orbital Solver, WebSocket Live Streamer
• Database: Atomic JSON/SQLite Data Persistence (/data/jupiter_eye_db.json)
• Real-Time WebSockets:
  • /ws/live: Continuous 3D Cartesian coordinates & velocity streaming
  • /ws/events: Astronomical event notifications (Eclipses, Transits, Conjunctions)
  • /ws/telemetry: Hardware diagnostics & JPL ephemeris health

---

🔑 Authentication Credentials

Default Operator Accounts pre-seeded for immediate VPS access:

Clearance Level	Username	Password
Administrator	admin	astronomy2026
Astronomer	observer	astronomy2026

---

📡 REST API Reference

• GET /api/jupiter - Heliocentric & Geocentric Jovian coordinates
• GET /api/moons - Real-time Galilean moon Cartesian states & light delay
• GET /api/orbits - 128-point Keplerian orbital ellipse paths
• GET /api/events - Timeline of eclipses, occultations, and Laplace resonance syncs
• GET /api/metrics - Server telemetry & data source status
• GET /api/export/zip - Instant source code zip bundle download