# trucoded/sih_ps_63 architecture

> Architecture diagram of the GitHub repository trucoded/sih_ps_63, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/trucoded/sih_ps_63
- Repository: https://github.com/trucoded/sih_ps_63

## Overview

PolarConnect is a polar-science discovery and outreach portal for public visitors, researchers, and curators. Its user-facing workflow spans station and expedition discovery, FAIR catalogue search, grounded question answering, and science communication; a separate curator path ingests and reviews assets under access and embargo policies. The API routes these capabilities to domain services and a seeded in-memory store. The README documents broader capabilities and integrations; unsampled UI-to-API connections are omitted unless shown in excerpts.

Main entry points: [`apps/web/src/App.tsx`](https://github.com/trucoded/sih_ps_63/blob/main/apps/web/src/App.tsx) (Portal App), [`apps/api/src/index.ts`](https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/index.ts) (API Router), [`apps/api/src/services/store.ts`](https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/services/store.ts) (Domain Store), [`apps/api/src/services/llmService.ts`](https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/services/llmService.ts) (LLM Services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Discovery Client"]
  node_app["Portal App<br/>[App.tsx]"]
  node_station_ui["Station HUD"]
  node_voyage_ui["Voyage Timeline<br/>[VoyageTimeline.tsx]"]
  node_catalogue_ui["Scientific Catalogue"]
end

subgraph group_outreach["Science Outreach"]
  node_assistant_ui["Polar AI Assistant"]
  node_studio_ui["Content Studio<br/>[ContentStudio.tsx]"]
  node_education_ui["Education Hub"]
end

subgraph group_curation["Curation Governance"]
  node_provenance_ui["Provenance Viewer"]
  node_ingest_ui["Ingest Wizard"]
  node_review_ui["Curator Queue"]
  node_audit_ui["Audit Viewer<br/>[AuditLogViewer.tsx]"]
end

subgraph group_api["API Capabilities"]
  node_api_router["API Router<br/>[index.ts]"]
  node_station_route["Station Route<br/>[stations.ts]"]
  node_expedition_route["Expedition Route<br/>[expeditions.ts]"]
  node_asset_route["Asset Route<br/>[assets.ts]"]
  node_rag_route["RAG Route<br/>[rag.ts]"]
  node_content_route["Draft Route<br/>[contentDrafts.ts]"]
  node_education_route["Education Route<br/>[education.ts]"]
  node_provenance_route["Provenance Route<br/>[provenance.ts]"]
  node_audit_route["Audit Route<br/>[audit.ts]"]
end

subgraph group_core["Knowledge Core"]
  node_rag_engine["RAG Retrieval<br/>[ragEngine.ts]"]
  node_llm["LLM Services<br/>[llmService.ts]"]
  node_store[("Domain Store<br/>[store.ts]")]
  node_seed["Seed Corpus<br/>[seed-data.json]"]
end

node_visitor(("Portal Users"))
node_llm_providers(("LLM Providers"))
node_authorities(("NCPOR / NPDC"))

node_visitor -->|"uses"| node_app
node_app -->|"renders"| node_station_ui
node_app -->|"renders"| node_voyage_ui
node_app -->|"renders"| node_catalogue_ui
node_app -->|"renders"| node_assistant_ui
node_app -->|"renders"| node_studio_ui
node_app -->|"renders"| node_education_ui
node_app -->|"renders"| node_provenance_ui
node_app -->|"renders"| node_ingest_ui
node_app -->|"renders"| node_review_ui
node_app -->|"renders"| node_audit_ui
node_app -.->|"requests API"| node_api_router
node_ingest_ui -->|"uploads asset"| node_asset_route
node_api_router -->|"registers"| node_station_route
node_api_router -->|"registers"| node_expedition_route
node_api_router -->|"registers"| node_asset_route
node_api_router -->|"registers"| node_rag_route
node_api_router -->|"registers"| node_content_route
node_api_router -->|"registers"| node_education_route
node_api_router -->|"registers"| node_provenance_route
node_api_router -->|"registers"| node_audit_route
node_rag_route -->|"retrieves"| node_rag_engine
node_rag_route -->|"synthesizes"| node_llm
node_content_route -->|"generates drafts"| node_llm
node_content_route -->|"reads and writes"| node_store
node_rag_engine -->|"retrieves assets"| node_store
node_rag_engine -->|"loads corpus"| node_seed
node_store -->|"loads records"| node_seed
node_llm -->|"reads context"| node_store
node_llm -->|"calls providers"| node_llm_providers
node_station_route -->|"reads telemetry"| node_store
node_expedition_route -->|"reads expeditions"| node_store
node_asset_route -->|"manages assets"| node_store
node_education_route -->|"generates learning"| node_llm
node_provenance_route -->|"reads lineage"| node_store
node_provenance_route -->|"uses synthesis"| node_llm
node_audit_route -->|"reads audit log"| node_store
node_store -.->|"links authoritative records"| node_authorities

click node_app "https://github.com/trucoded/sih_ps_63/blob/main/apps/web/src/App.tsx"
click node_station_ui "https://github.com/trucoded/sih_ps_63/blob/main/apps/web/src/components/StationCommandHUD.tsx"
click node_voyage_ui "https://github.com/trucoded/sih_ps_63/blob/main/apps/web/src/components/VoyageTimeline.tsx"
click node_catalogue_ui "https://github.com/trucoded/sih_ps_63/blob/main/apps/web/src/components/ScientificCatalogue.tsx"
click node_assistant_ui "https://github.com/trucoded/sih_ps_63/blob/main/apps/web/src/components/PolarAiAssistant.tsx"
click node_studio_ui "https://github.com/trucoded/sih_ps_63/blob/main/apps/web/src/components/ContentStudio.tsx"
click node_education_ui "https://github.com/trucoded/sih_ps_63/blob/main/apps/web/src/components/SmartEducationHub.tsx"
click node_provenance_ui "https://github.com/trucoded/sih_ps_63/blob/main/apps/web/src/components/ProvGraphViewer.tsx"
click node_ingest_ui "https://github.com/trucoded/sih_ps_63/blob/main/apps/web/src/components/IngestPipelineWizard.tsx"
click node_review_ui "https://github.com/trucoded/sih_ps_63/blob/main/apps/web/src/components/CuratorReviewQueue.tsx"
click node_audit_ui "https://github.com/trucoded/sih_ps_63/blob/main/apps/web/src/components/AuditLogViewer.tsx"
click node_api_router "https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/index.ts"
click node_station_route "https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/routes/stations.ts"
click node_expedition_route "https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/routes/expeditions.ts"
click node_asset_route "https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/routes/assets.ts"
click node_rag_route "https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/routes/rag.ts"
click node_content_route "https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/routes/contentDrafts.ts"
click node_education_route "https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/routes/education.ts"
click node_provenance_route "https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/routes/provenance.ts"
click node_audit_route "https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/routes/audit.ts"
click node_rag_engine "https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/services/ragEngine.ts"
click node_llm "https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/services/llmService.ts"
click node_store "https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/services/store.ts"
click node_seed "https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/data/seed-data.json"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_station_ui,node_voyage_ui,node_catalogue_ui,node_visitor toneBlue
class node_assistant_ui,node_studio_ui,node_education_ui toneAmber
class node_provenance_ui,node_ingest_ui,node_review_ui,node_audit_ui toneMint
class node_api_router,node_station_route,node_expedition_route,node_asset_route,node_rag_route,node_content_route,node_education_route,node_provenance_route,node_audit_route toneRose
class node_rag_engine,node_llm,node_store,node_seed,node_llm_providers,node_authorities toneIndigo
```

## Components

### Discovery Client

- [Portal App](https://github.com/trucoded/sih_ps_63/blob/main/apps/web/src/App.tsx): `apps/web/src/App.tsx`
- [Station HUD](https://github.com/trucoded/sih_ps_63/blob/main/apps/web/src/components/StationCommandHUD.tsx): `apps/web/src/components/StationCommandHUD.tsx`
- [Voyage Timeline](https://github.com/trucoded/sih_ps_63/blob/main/apps/web/src/components/VoyageTimeline.tsx): `apps/web/src/components/VoyageTimeline.tsx`
- [Scientific Catalogue](https://github.com/trucoded/sih_ps_63/blob/main/apps/web/src/components/ScientificCatalogue.tsx): `apps/web/src/components/ScientificCatalogue.tsx`

### Science Outreach

- [Polar AI Assistant](https://github.com/trucoded/sih_ps_63/blob/main/apps/web/src/components/PolarAiAssistant.tsx): `apps/web/src/components/PolarAiAssistant.tsx`
- [Content Studio](https://github.com/trucoded/sih_ps_63/blob/main/apps/web/src/components/ContentStudio.tsx): `apps/web/src/components/ContentStudio.tsx`
- [Education Hub](https://github.com/trucoded/sih_ps_63/blob/main/apps/web/src/components/SmartEducationHub.tsx): `apps/web/src/components/SmartEducationHub.tsx`

### Curation Governance

- [Provenance Viewer](https://github.com/trucoded/sih_ps_63/blob/main/apps/web/src/components/ProvGraphViewer.tsx): `apps/web/src/components/ProvGraphViewer.tsx`
- [Ingest Wizard](https://github.com/trucoded/sih_ps_63/blob/main/apps/web/src/components/IngestPipelineWizard.tsx): `apps/web/src/components/IngestPipelineWizard.tsx`
- [Curator Queue](https://github.com/trucoded/sih_ps_63/blob/main/apps/web/src/components/CuratorReviewQueue.tsx): `apps/web/src/components/CuratorReviewQueue.tsx`
- [Audit Viewer](https://github.com/trucoded/sih_ps_63/blob/main/apps/web/src/components/AuditLogViewer.tsx): `apps/web/src/components/AuditLogViewer.tsx`

### API Capabilities

- [API Router](https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/index.ts): `apps/api/src/index.ts`
- [Station Route](https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/routes/stations.ts): `apps/api/src/routes/stations.ts`
- [Expedition Route](https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/routes/expeditions.ts): `apps/api/src/routes/expeditions.ts`
- [Asset Route](https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/routes/assets.ts): `apps/api/src/routes/assets.ts`
- [RAG Route](https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/routes/rag.ts): `apps/api/src/routes/rag.ts`
- [Draft Route](https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/routes/contentDrafts.ts): `apps/api/src/routes/contentDrafts.ts`
- [Education Route](https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/routes/education.ts): `apps/api/src/routes/education.ts`
- [Provenance Route](https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/routes/provenance.ts): `apps/api/src/routes/provenance.ts`
- [Audit Route](https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/routes/audit.ts): `apps/api/src/routes/audit.ts`

### Knowledge Core

- [RAG Retrieval](https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/services/ragEngine.ts): `apps/api/src/services/ragEngine.ts`
- [LLM Services](https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/services/llmService.ts): `apps/api/src/services/llmService.ts`
- [Domain Store](https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/services/store.ts): `apps/api/src/services/store.ts`
- [Seed Corpus](https://github.com/trucoded/sih_ps_63/blob/main/apps/api/src/data/seed-data.json): `apps/api/src/data/seed-data.json`

### Other components

- **Portal Users**
- **LLM Providers**
- **NCPOR / NPDC**

## Connections

- Portal Users → Portal App: uses (evidence: `README.md`)
- Portal App → Station HUD: renders (evidence: `apps/web/src/App.tsx`)
- Portal App → Voyage Timeline: renders (evidence: `apps/web/src/App.tsx`)
- Portal App → Scientific Catalogue: renders (evidence: `apps/web/src/App.tsx`)
- Portal App → Polar AI Assistant: renders (evidence: `apps/web/src/App.tsx`)
- Portal App → Content Studio: renders (evidence: `apps/web/src/App.tsx`)
- Portal App → Education Hub: renders (evidence: `apps/web/src/App.tsx`)
- Portal App → Provenance Viewer: renders (evidence: `apps/web/src/App.tsx`)
- Portal App → Ingest Wizard: renders (evidence: `apps/web/src/App.tsx`)
- Portal App → Curator Queue: renders (evidence: `apps/web/src/App.tsx`)
- Portal App → Audit Viewer: renders (evidence: `apps/web/src/App.tsx`)
- Portal App → API Router: requests API
- Ingest Wizard → Asset Route: uploads asset (evidence: `apps/web/src/components/IngestPipelineWizard.tsx`)
- API Router → Station Route: registers (evidence: `apps/api/src/index.ts`)
- API Router → Expedition Route: registers (evidence: `apps/api/src/index.ts`)
- API Router → Asset Route: registers (evidence: `apps/api/src/index.ts`)
- API Router → RAG Route: registers (evidence: `apps/api/src/index.ts`)
- API Router → Draft Route: registers (evidence: `apps/api/src/index.ts`)
- API Router → Education Route: registers (evidence: `apps/api/src/index.ts`)
- API Router → Provenance Route: registers (evidence: `apps/api/src/index.ts`)
- API Router → Audit Route: registers (evidence: `apps/api/src/index.ts`)
- RAG Route → RAG Retrieval: retrieves (evidence: `apps/api/src/routes/rag.ts`)
- RAG Route → LLM Services: synthesizes (evidence: `apps/api/src/routes/rag.ts`)
- Draft Route → LLM Services: generates drafts (evidence: `apps/api/src/routes/contentDrafts.ts`)
- Draft Route → Domain Store: reads and writes (evidence: `apps/api/src/routes/contentDrafts.ts`)
- RAG Retrieval → Domain Store: retrieves assets (evidence: `apps/api/src/services/ragEngine.ts`)
- RAG Retrieval → Seed Corpus: loads corpus (evidence: `apps/api/src/services/ragEngine.ts`)
- Domain Store → Seed Corpus: loads records (evidence: `apps/api/src/services/store.ts`)
- LLM Services → Domain Store: reads context (evidence: `apps/api/src/services/llmService.ts`)
- LLM Services → LLM Providers: calls providers (evidence: `apps/api/src/services/llmService.ts`)
- Station Route → Domain Store: reads telemetry (evidence: `apps/api/src/routes/stations.ts`)
- Expedition Route → Domain Store: reads expeditions (evidence: `apps/api/src/routes/expeditions.ts`)
- Asset Route → Domain Store: manages assets (evidence: `apps/api/src/routes/assets.ts`)
- Education Route → LLM Services: generates learning (evidence: `apps/api/src/routes/education.ts`)
- Provenance Route → Domain Store: reads lineage (evidence: `apps/api/src/routes/provenance.ts`)
- Provenance Route → LLM Services: uses synthesis (evidence: `apps/api/src/routes/provenance.ts`)
- Audit Route → Domain Store: reads audit log (evidence: `apps/api/src/routes/audit.ts`)
- Domain Store → NCPOR / NPDC: links authoritative records (evidence: `README.md`)
