How manishcooks/packetjourney works
PacketJourney accepts a hostname in its React interface, runs a server-side traceroute, enriches discovered hops with geographic data, and streams hop details back over WebSockets. Once tracing finishes, the interface requests separate map and graph views, which render the cached route. The graph preserves both visualization branches and the HTTP/WebSocket routing layers. Relationships are shown where excerpts or the README support them; unsampled configuration and implementation details are not inferred.
Main entry points: consumers.py Traceroute Consumer · App.tsx Traceroute UI · views.py Visualization Views · main.tsx React Entry
Components 14
Frontend
- React Entry
frontend/src/main.tsx - Traceroute UI
frontend/src/App.tsx
Backend Routing
- ASGI Dispatcher
backend/traceviz/asgi.py - WebSocket Routes
backend/mainapp/routing.py - HTTP Routes
backend/mainapp/urls.py
Traceroute Processing
- Traceroute Consumer
backend/mainapp/consumers.py - Traceroute Process
- IP Geolocation
backend/mainapp/locations.py - Route Cache
Route Visualizations
- Visualization Views
backend/mainapp/views.py - Map Renderer
backend/mainapp/map.py - Graph Renderer
backend/mainapp/graph.py
Other components
- User
- ipapi Service
Connections 17
- User → React Entry: opens app
frontend/src/main.tsx - React Entry → Traceroute UI: renders
frontend/src/main.tsx - Traceroute UI → ASGI Dispatcher: opens WebSocket
frontend/src/App.tsx - ASGI Dispatcher → WebSocket Routes: routes WebSockets
backend/traceviz/asgi.py - WebSocket Routes → Traceroute Consumer: dispatches to
backend/mainapp/routing.py - Traceroute UI → Traceroute Consumer: sends hostname
frontend/src/App.tsx - Traceroute Consumer → Traceroute Process: runs command
backend/mainapp/consumers.py - Traceroute Consumer → IP Geolocation: looks up hops
backend/mainapp/consumers.py - IP Geolocation → ipapi Service: requests location
backend/mainapp/locations.py - Traceroute Consumer → Traceroute UI: streams hop data
backend/mainapp/consumers.py - Traceroute Consumer → Route Cache: writes route
backend/mainapp/consumers.py - Traceroute UI → HTTP Routes: requests views
frontend/src/App.tsx - HTTP Routes → Visualization Views: dispatches to
backend/mainapp/urls.py - Visualization Views → Route Cache: reads route
backend/mainapp/views.py - Visualization Views → Map Renderer: renders map
backend/mainapp/views.py - Visualization Views → Graph Renderer: renders graph
backend/mainapp/views.py - Visualization Views → Traceroute UI: serves iframe views
frontend/src/App.tsx