How dhvani30/netra-platform works
NETRA turns social-platform observations into narrative, sentiment, trend, and network intelligence, then serves those results to an investigation dashboard. The principal path is platform collection into MongoDB, analytics and graph construction, FastAPI endpoints or live events, and React views. README capabilities also include mutation tracking, cross-platform correlation, alerts, privacy-safe demographics, network analysis, investigation, and coverage. Relationship evidence is limited to the README and indexed excerpts; uncertain subsystem wiring is omitted rather than inferred.
Main entry points: App.jsx React dashboard · main.py FastAPI service · pipeline.py Analytics pipeline · collectors Platform collectors
Components 28
Collection
- Platform collectors
backend/app/collectors - Raw post schema
backend/app/schema.py
Analysis
- Analytics pipeline
backend/app/pipeline.py - Sentiment analysis
backend/app/sentiment.py - Entity and text NLP
backend/app/nlp/infer.py - Privacy-safe profiles
backend/app/demographics/profiler.py - Narrative trends
backend/app/trends/engine.py - Narrative timelines
backend/app/timeline.py - Watchlists
backend/app/watchlist.py - Graph construction
backend/app/graph_builder.py
API and storage
- MongoDB
- Neo4j graph
- FastAPI service
backend/main.py - Live event stream
backend/app/core/live_events.py
Dashboard
- React dashboard
frontend/src/App.jsx - Live feed
frontend/src/components/LiveFeedView.jsx - Narrative tracker
frontend/src/components/NarrativeTracker.jsx - Cross-platform view
frontend/src/components/CrossPlatformView.jsx - Intelligence alerts
frontend/src/components/AlertsView.jsx - Demographics view
frontend/src/components/DemographicsView.jsx - Network intelligence
frontend/src/components/NetworkIntelligenceView.jsx - Interactive graph
frontend/src/components/NetworkGraph.jsx - Investigation view
frontend/src/components/InvestigationView.jsx - Provenance details
frontend/src/components/ProvenanceDrawer.jsx - Coverage and sources
frontend/src/components/CoverageView.jsx - Sentiment timeline
frontend/src/components/SentimentTimelineView.jsx
Other components
- Analyst
- Social platforms
Connections 31
- Social platforms → Platform collectors: provide posts
- Platform collectors → Raw post schema: normalize records
backend/app/collectors/meta_ingestor.py - Platform collectors → MongoDB: ingest posts
- Analytics pipeline → MongoDB: process posts
- Analytics pipeline → Sentiment analysis: analyze sentiment
- Analytics pipeline → Entity and text NLP: infer text signals
- MongoDB → Analytics pipeline: supply observations
- MongoDB → Narrative trends: supply post history
- MongoDB → Privacy-safe profiles: supply observations
- MongoDB → Graph construction: supply observations
- Graph construction → Neo4j graph: store relationships
- FastAPI service → MongoDB: query analytics
backend/main.py - FastAPI service → Neo4j graph: serve graph data
- FastAPI service → Live event stream: stream updates
backend/main.py - Analyst → React dashboard: investigate narratives
- React dashboard → FastAPI service: request intelligence
- React dashboard → Live feed: renders
frontend/src/App.jsx - React dashboard → Narrative tracker: renders
frontend/src/App.jsx - React dashboard → Cross-platform view: renders
frontend/src/App.jsx - React dashboard → Intelligence alerts: renders
frontend/src/App.jsx - React dashboard → Demographics view: renders
frontend/src/App.jsx - React dashboard → Network intelligence: renders
frontend/src/App.jsx - React dashboard → Interactive graph: renders
frontend/src/App.jsx - React dashboard → Investigation view: renders
frontend/src/App.jsx - Investigation view → Provenance details: shows evidence
- React dashboard → Coverage and sources: renders
frontend/src/App.jsx - React dashboard → Sentiment timeline: renders
frontend/src/App.jsx - Live feed → FastAPI service: fetches feed
frontend/src/components/LiveFeedView.jsx - Live event stream → Live feed: pushes events
- Narrative trends → FastAPI service: serve trend results
backend/main.py - Watchlists → FastAPI service: serve watchlist
backend/main.py