How governai-techteam/research-atlas works
GovernAI Research Atlas turns a topic query into a board-ready research view: the frontend submits the topic, the backend gathers and ranks papers, repositories, and curated resources, extracts datasets and models, and returns an Atlas for dashboard and graph presentation. The README documents the major integrations and capabilities; sampled source confirms key orchestration and frontend calls. Some backend integrations are represented from documentation and the source index rather than inspected implementation excerpts.
Main entry points: atlas_service.py Atlas orchestration · AtlasDashboard.tsx Atlas dashboard · App.tsx App state flow · api_main.py FastAPI endpoints
Components 30
User experience
- App state flow
src/app/App.tsx - Topic entry
src/app/components/LandingPage.tsx - Loading view
src/app/components/LoadingScreen.tsx - Atlas API client
src/app/services/atlasApi.ts - Atlas dashboard
src/app/components/AtlasDashboard.tsx - Executive overview
src/app/components/OverviewSection.tsx - Paper cards
src/app/components/PaperCard.tsx - Repository cards
src/app/components/RepoCard.tsx - Resource cards
src/app/components/ResourceCard.tsx - Knowledge graph
src/app/components/KnowledgeGraph.tsx
API and orchestration
- FastAPI endpoints
api_main.py - Atlas orchestration
services/atlas_service.py - Atlas data schema
models/atlas_schema.py
Discovery and ranking
- Paper retrieval
services/paper_service.py - Paper ranking
services/ranking_service.py - Scoring utilities
services/scoring_service.py - Repository retrieval
services/github_service.py - Repository ranking
services/repo_ranking_service.py
Knowledge enrichment
- Governance resources
services/resource_service.py - Dataset and model extraction
services/extractor_service.py - Graph construction
services/graph_service.py - Vector search
services/search_service.py - Vector store
services/vector_store.py - Text embeddings
services/embedding_service.py
External sources
- OpenAlex
- GitHub Search
- ChromaDB
- Sentence Transformers
- Curated resource data
Other components
- Researcher
Connections 33
- Researcher → Topic entry: enters topic
- Topic entry → App state flow: submits topic
src/app/App.tsx - App state flow → Loading view: shows progress
src/app/App.tsx - App state flow → Atlas API client: requests Atlas
src/app/App.tsx - Atlas API client → FastAPI endpoints: posts topic
src/app/services/atlasApi.ts - FastAPI endpoints → Atlas orchestration: dispatches Atlas
api_main.py - Atlas orchestration → Paper retrieval: fetches papers
services/atlas_service.py - Paper retrieval → OpenAlex: queries works
services/paper_service.py - Atlas orchestration → Paper ranking: ranks papers
services/atlas_service.py - Paper ranking → Scoring utilities: uses scoring
services/ranking_service.py - Atlas orchestration → Repository retrieval: fetches repositories
services/atlas_service.py - Repository retrieval → GitHub Search: searches repositories
README.md - Atlas orchestration → Repository ranking: ranks repositories
services/atlas_service.py - Repository ranking → Text embeddings: embeds text
services/repo_ranking_service.py - Text embeddings → Sentence Transformers: generates vectors
services/embedding_service.py - Atlas orchestration → Governance resources: loads resources
services/atlas_service.py - Governance resources → Curated resource data: reads curated data
README.md - Atlas orchestration → Dataset and model extraction: extracts datasets and models
services/atlas_service.py - Atlas orchestration → Vector store: stores papers
services/atlas_service.py - Vector store → Text embeddings: creates embeddings
services/vector_store.py - Vector store → ChromaDB: persists vectors
README.md - Vector search → Vector store: searches vectors
services/search_service.py - Paper ranking → Vector search: uses semantic search
services/ranking_service.py - FastAPI endpoints → Graph construction: dispatches graph
api_main.py - Atlas orchestration → Atlas data schema: creates Atlas
services/atlas_service.py - FastAPI endpoints → Atlas data schema: returns Atlas data
- App state flow → Atlas dashboard: renders results
src/app/App.tsx - Atlas dashboard → Executive overview: renders overview
src/app/components/AtlasDashboard.tsx - Atlas dashboard → Paper cards: renders papers
src/app/components/AtlasDashboard.tsx - Atlas dashboard → Repository cards: renders repositories
src/app/components/AtlasDashboard.tsx - Atlas dashboard → Resource cards: renders resources
src/app/components/AtlasDashboard.tsx - Atlas dashboard → Atlas API client: builds graph data
src/app/components/AtlasDashboard.tsx - Atlas dashboard → Knowledge graph: renders graph
src/app/components/AtlasDashboard.tsx