How mskcc/voyager-operation-dashboard works
Voyager is an operations dashboard for viewing Beagle pipeline runs, file counts, run-health summaries, and signing in. The React app routes users to protected home, runs, and files pages; those pages fetch Beagle data through a shared authenticated client, then render tables, charts, and summaries. A separate Django API exposes job records backed by Django models; the README documents PostgreSQL synchronization. The sampled code supports the frontend-to-Beagle calls and Django API wiring; it does not show those systems connected to each other.
Main entry points: App.js App Routing · Beagle.js Beagle Client · Home.js Home Dashboard · Runs.js Runs Browser
Components 19
Dashboard UI
- App Routing
voyager-operation-dashboard/src/App.js - Navigation
voyager-operation-dashboard/src/pages/navigation/Navigation.js - Route Guard
voyager-operation-dashboard/src/components/common/Protected.js - Login
voyager-operation-dashboard/src/pages/login/Login.js - Home Dashboard
voyager-operation-dashboard/src/pages/home/Home.js - Runs Browser
voyager-operation-dashboard/src/pages/runs/Runs.js - Files View
voyager-operation-dashboard/src/pages/files/Files.js
Beagle Integration
- Beagle Client
voyager-operation-dashboard/src/components/common/Beagle.js - Beagle Config
voyager-operation-dashboard/src/components/common/config.js - Beagle Service
Django Jobs API
- Jobs API
server/voyager_server/jobsdb/views.py - Job Serializer
server/voyager_server/jobsdb/serializers.py - Job Records
server/voyager_server/jobsdb/models.py - API Routes
server/voyager_server/voyager_server/urls.py
Dashboard Components
- Pie Chart
voyager-operation-dashboard/src/components/charts/PieChart.js - Error Rate
voyager-operation-dashboard/src/pages/home/ErrorRate.js - Scroll List
voyager-operation-dashboard/src/components/lists/ScrollList.js - Progress Loader
voyager-operation-dashboard/src/components/loaders/LinearIndeterminate.js
Other components
- Operator
Connections 25
- Operator → App Routing: opens dashboard
- App Routing → Navigation: renders
voyager-operation-dashboard/src/App.js - App Routing → Route Guard: guards routes
voyager-operation-dashboard/src/App.js - App Routing → Home Dashboard: routes to
voyager-operation-dashboard/src/App.js - App Routing → Runs Browser: routes to
voyager-operation-dashboard/src/App.js - App Routing → Files View: routes to
voyager-operation-dashboard/src/App.js - App Routing → Login: routes to
voyager-operation-dashboard/src/App.js - Route Guard → Login: redirects to
voyager-operation-dashboard/src/components/common/Protected.js - Login → Beagle Client: authenticates via
voyager-operation-dashboard/src/pages/login/Login.js - Login → Beagle Config: uses session keys
voyager-operation-dashboard/src/pages/login/Login.js - Home Dashboard → Beagle Client: fetches summaries
voyager-operation-dashboard/src/pages/home/Home.js - Home Dashboard → Pie Chart: renders charts
voyager-operation-dashboard/src/pages/home/Home.js - Home Dashboard → Error Rate: renders error rates
voyager-operation-dashboard/src/pages/home/Home.js - Home Dashboard → Scroll List: renders long runs
voyager-operation-dashboard/src/pages/home/Home.js - Runs Browser → Beagle Client: fetches runs
voyager-operation-dashboard/src/pages/runs/Runs.js - Runs Browser → Beagle Config: uses run definitions
voyager-operation-dashboard/src/pages/runs/Runs.js - Runs Browser → Progress Loader: shows loading state
voyager-operation-dashboard/src/pages/runs/Runs.js - Files View → Beagle Client: fetches file counts
voyager-operation-dashboard/src/pages/files/Files.js - Files View → Progress Loader: shows loading state
voyager-operation-dashboard/src/pages/files/Files.js - Beagle Client → Beagle Config: uses service settings
voyager-operation-dashboard/src/components/common/Beagle.js - Beagle Client → Beagle Service: sends API requests
voyager-operation-dashboard/src/components/common/Beagle.js - API Routes → Jobs API: routes requests
server/voyager_server/voyager_server/urls.py - Jobs API → Job Serializer: serializes records
server/voyager_server/jobsdb/views.py - Jobs API → Job Records: queries records
server/voyager_server/jobsdb/views.py - Job Serializer → Job Records: serializes model
server/voyager_server/jobsdb/serializers.py