How siddharth-g06/idai works
IDAI is a civic accountability dashboard: manifesto promises are extracted and categorized, compared with news evidence, verified, and scored; voters then explore results by party, year, and category in a bilingual web app. The documented pipeline and sampled frontend show the main workflow. Backend API internals and several UI areas were not excerpted, so those connections rely on README statements or are omitted where evidence is insufficient.
Main entry points: App.jsx Route Application · Home.jsx Summary Dashboard · PartyPage.jsx Party Promise View · data Computed JSON Data
Components 26
Evidence Pipeline
- Promise Extraction
backend/manifesto_parser.py - News Ingestion
backend/news_fetcher.py - Semantic Matching
backend/matcher.py - Match Verification
backend/llm_verifier.py - Date-Aware Scoring
backend/scorer.py - Pipeline Runner
backend/run_pipeline.py
Data Service
- Computed JSON Data
backend/data - FastAPI Service
backend/main.py - Health Keepalive
backend/keepalive.py
Dashboard
- Route Application
frontend/src/App.jsx - Summary Dashboard
frontend/src/pages/Home.jsx - Party Promise View
frontend/src/pages/PartyPage.jsx - Party Comparison
frontend/src/pages/Compare.jsx - About Page
frontend/src/pages/About.jsx - API Client
frontend/src/api/client.js - Data Hooks
frontend/src/hooks
Interface Components
- Promise Card
frontend/src/components/PromiseCard.jsx - Score Ring
frontend/src/components/ScoreRing.jsx - Navigation
frontend/src/components/BottomNav.jsx - Empty State
frontend/src/components/EmptyState.jsx - Error State
frontend/src/components/ErrorState.jsx - Language Context
frontend/src/i18n/LanguageContext.jsx - Design System
frontend/src/styles/design-system.js
Other components
- Voters
- Manifesto PDFs
- News Sources
Connections 32
- Manifesto PDFs → Promise Extraction: provides PDFs
README.md - Pipeline Runner → Promise Extraction: runs parsing
backend/run_pipeline.py - Pipeline Runner → News Ingestion: runs fetching
backend/run_pipeline.py - Pipeline Runner → Semantic Matching: runs matching
backend/run_pipeline.py - Pipeline Runner → Date-Aware Scoring: runs scoring
backend/run_pipeline.py - Promise Extraction → Computed JSON Data: writes promises
README.md - News Sources → News Ingestion: supplies articles
README.md - News Ingestion → Computed JSON Data: stores articles
README.md - Computed JSON Data → Semantic Matching: provides inputs
README.md - Semantic Matching → Match Verification: verifies matches
README.md - Semantic Matching → Date-Aware Scoring: provides matches
README.md - Date-Aware Scoring → Computed JSON Data: writes scores
README.md - Computed JSON Data → FastAPI Service: serves JSON
README.md - Health Keepalive → FastAPI Service: pings health
README.md - Route Application → Summary Dashboard: routes to
frontend/src/App.jsx - Route Application → Party Promise View: routes to
frontend/src/App.jsx - Route Application → Party Comparison: routes to
frontend/src/App.jsx - Route Application → About Page: routes to
frontend/src/App.jsx - Summary Dashboard → Data Hooks: loads summaries
frontend/src/pages/Home.jsx - Party Promise View → Data Hooks: loads promises
frontend/src/pages/PartyPage.jsx - Data Hooks → API Client: calls endpoints
frontend/src/hooks/usePromises.js - API Client → FastAPI Service: requests data
README.md - Party Promise View → Promise Card: renders promises
frontend/src/pages/PartyPage.jsx - Summary Dashboard → Score Ring: renders scores
frontend/src/pages/Home.jsx - Party Comparison → API Client: loads comparison
frontend/src/pages/Compare.jsx - Summary Dashboard → Navigation: renders navigation
frontend/src/pages/Home.jsx - Party Promise View → Navigation: renders navigation
frontend/src/pages/PartyPage.jsx - Summary Dashboard → Empty State: shows empty state
frontend/src/pages/Home.jsx - Party Promise View → Error State: shows errors
frontend/src/pages/PartyPage.jsx - Route Application → Language Context: provides language
frontend/src/main.jsx - Language Context → Voters: enables bilingual UI
README.md - Promise Card → Design System: uses styles
frontend/src/components/PromiseCard.jsx