How vasavi-suniganti/yuki works
POLARIS is a polar-science repository and outreach portal. Users explore expeditions, datasets, publications, maps, and learning resources; authenticated researchers submit material, reviewers process it, and media staff prepare public-facing stories. The backend provides AI analysis, metadata and dataset processing, review workflow, and a public data API, with Firebase-backed identity and records plus demo fallbacks. The graph preserves README-documented feature areas even where their implementation was not sampled; those broader connections are marked as unverified where source evidence is unavailable.
Main entry points: App.tsx Page router · api.ts Product API routes · auth.tsx Identity and roles · ResearcherDashboard.tsx Researcher workspace
Components 34
Public Discovery
- Page router
client/src/App.tsx - Science discovery
client/src/pages/Explore.tsx - Expedition records
client/src/pages/Expeditions.tsx - Research library
client/src/pages/Research.tsx
Research Tools
- Dataset explorer
client/src/pages/Datasets.tsx - Maps and time
client/src/pages/MapTimeGraph.tsx - AI research tools
client/src/pages/AI.tsx - Grounded AI engine
server/src/services/ai.ts - Evidence retrieval
server/src/services/retrieval.ts - Dataset parser
server/src/services/datasetParser.ts
Curation and Review
- Researcher workspace
client/src/pages/ResearcherDashboard.tsx - Reviewer workspace
client/src/pages/ReviewerDashboard.tsx - Media studio
client/src/pages/MediaManagerDashboard.tsx - Admin workspace
client/src/pages/AdminDashboard.tsx - Media features
client/src/lib/signatureFeatures.ts - Metadata extraction
server/src/services/metadataExtractor.ts - Review state machine
server/src/services/reviewWorkflow.ts
Platform Services
- Identity and roles
client/src/lib/auth.tsx - Firebase client
client/src/lib/firebase.ts - API client
client/src/lib/api.ts - Typed data service
client/src/services/dataService.ts - Demo records
client/src/data/demo.ts - API server
server/src/index.ts - Product API routes
server/src/routes/api.ts - Open data API
server/src/routes/openApi.ts - Request authorization
server/src/middleware/auth.ts - Firebase Admin
server/src/services/firebase.ts - Firestore
- Firebase Authentication
Education
- Learning hub
client/src/pages/EducationVirtual.tsx - Quiz engine
client/src/components/AdvancedQuizEngine.tsx - Learning content
client/src/data/learningContent.ts - Student progress
client/src/lib/studentLearning.ts
Other components
- Portal visitor
Connections 43
- Portal visitor → Page router: opens portal
client/src/App.tsx - Page router → Science discovery: routes to
client/src/App.tsx - Page router → Expedition records: routes to
client/src/App.tsx - Page router → Dataset explorer: routes to
client/src/App.tsx - Page router → Maps and time: routes to
client/src/App.tsx - Page router → Research library: routes to
client/src/App.tsx - Page router → AI research tools: routes to
client/src/App.tsx - Page router → Researcher workspace: guards route
client/src/App.tsx - Page router → Reviewer workspace: guards route
client/src/App.tsx - Page router → Media studio: guards route
client/src/App.tsx - Page router → Admin workspace: guards route
client/src/App.tsx - Page router → Learning hub: routes to
client/src/App.tsx - Researcher workspace → Identity and roles: uses identity
client/src/pages/ResearcherDashboard.tsx - Reviewer workspace → Identity and roles: uses identity
client/src/pages/ReviewerDashboard.tsx - Media studio → Identity and roles: uses identity
client/src/pages/MediaManagerDashboard.tsx - Identity and roles → Firebase client: uses Firebase
client/src/lib/auth.tsx - Firebase client → Firebase Authentication: authenticates with
- Identity and roles → Firestore: reads user profiles
- Researcher workspace → API client: calls API
client/src/pages/ResearcherDashboard.tsx - Reviewer workspace → API client: calls API
client/src/pages/ReviewerDashboard.tsx - Typed data service → Firebase client: uses Firebase
client/src/services/dataService.ts - Typed data service → API client: uses API client
client/src/services/dataService.ts - Researcher workspace → Demo records: uses fallback data
client/src/pages/ResearcherDashboard.tsx - Media studio → Media features: saves story
client/src/pages/MediaManagerDashboard.tsx - Learning hub → Quiz engine: offers quizzes
- Quiz engine → Learning content: uses questions
client/src/components/AdvancedQuizEngine.tsx - Quiz engine → Student progress: records progress
client/src/components/AdvancedQuizEngine.tsx - API server → Product API routes: mounts routes
server/src/index.ts - API server → Open data API: mounts routes
server/src/index.ts - Product API routes → Request authorization: uses middleware
server/src/routes/api.ts - Request authorization → Firebase Admin: verifies identity
server/src/middleware/auth.ts - Product API routes → Grounded AI engine: dispatches AI
server/src/routes/api.ts - Grounded AI engine → Evidence retrieval: retrieves evidence
server/src/services/ai.ts - Product API routes → Dataset parser: parses datasets
server/src/routes/api.ts - Product API routes → Metadata extraction: extracts metadata
server/src/routes/api.ts - Product API routes → Review state machine: creates reviews
server/src/routes/api.ts - Review state machine → Firebase Admin: reads and writes
server/src/services/reviewWorkflow.ts - Request authorization → Firestore: loads user roles
server/src/middleware/auth.ts - Open data API → Firebase Admin: reads records
server/src/routes/openApi.ts - Firebase Admin → Firestore: accesses database
- API client → API server: sends requests
- AI research tools → Product API routes: requests AI features
- Dataset explorer → Product API routes: requests processing