How shankar-soni-2006/repopulse works
RepoPulse turns GitHub repository activity into stored engineering data, metrics, team views, pull-request insights, and AI analysis. Members sign in through GitHub, select repositories they can access, and view synchronized results through the frontend’s API-backed pages. The main data path is repository discovery and synchronization, followed by analytics or AI analysis. The graph includes the documented webhook and admin capabilities, but source excerpts for several controllers and route handlers were unavailable, so those connections are limited to relationships explicitly shown by the README or source index.
Main entry points: repositoryRepository.ts Repository records · supabase.ts Supabase database · authService.ts Authentication · discoveryService.ts Repository discovery
Components 21
Member application
- React application
frontend/src/App.tsx - Repository views
frontend/src/pages - Frontend API client
frontend/src/services/api.ts
API and identity
- Express server
backend/src/app.ts - Auth handlers
backend/src/controllers/authController.ts - Authentication
backend/src/services/auth/authService.ts - Session management
backend/src/services/auth/sessionService.ts - Repository API
backend/src/controllers/repositoryController.ts
GitHub data ingestion
- Webhook processing
backend/src/webhooks/webhookService.ts - Repository discovery
backend/src/services/github/discoveryService.ts - GitHub client
backend/src/services/github/githubService.ts - Activity ingestion
backend/src/services/sync/ingest.ts
Metrics and insights
- Engineering analytics
backend/src/services/analytics/analyticsService.ts - AI analysis
backend/src/services/ai/aiService.ts
Persistent state
- Supabase database
backend/src/config/supabase.ts - Repository records
backend/src/repositories/repositoryRepository.ts - Session records
backend/src/repositories/sessionRepository.ts - Pull request records
backend/src/repositories/pullRequestRepository.ts - Review records
backend/src/repositories/reviewRepository.ts - Webhook events
backend/src/repositories/webhookEventRepository.ts
Other components
- Member
Connections 27
- Member → React application: uses
README.md - React application → Repository views: routes to
frontend/src/App.tsx - Repository views → Frontend API client: requests data
- Frontend API client → Express server: calls API
README.md - Express server → Auth handlers: mounts auth routes
backend/src/app.ts - Auth handlers → Authentication: starts sign-in
backend/src/controllers/authController.ts - Auth handlers → Session management: destroys session
backend/src/controllers/authController.ts - Authentication → Session management: creates session
backend/src/services/auth/authService.ts - Authentication → Repository discovery: discovers repositories
backend/src/services/auth/authService.ts - Authentication → Repository records: reads installations
backend/src/services/auth/authService.ts - Express server → Repository API: mounts repository routes
backend/src/app.ts - Repository API → Repository discovery: runs discovery
backend/src/controllers/repositoryController.ts - Repository discovery → GitHub client: queries GitHub
backend/src/services/github/discoveryService.ts - Repository discovery → Repository records: stores repositories
backend/src/services/github/discoveryService.ts - GitHub client → Activity ingestion: supplies activity
backend/src/services/sync/ingest.ts - Activity ingestion → Pull request records: upserts pull requests
backend/src/services/sync/ingest.ts - Activity ingestion → Review records: upserts reviews
backend/src/services/sync/ingest.ts - Engineering analytics → Repository records: reads repositories
backend/src/services/analytics/analyticsService.ts - AI analysis → Engineering analytics: uses metrics
backend/src/services/ai/aiService.ts - AI analysis → Pull request records: reads pull requests
backend/src/services/ai/aiService.ts - Webhook processing → Repository records: looks up repository
backend/src/webhooks/webhookService.ts - Webhook processing → Webhook events: records delivery
backend/src/webhooks/webhookService.ts - Repository records → Supabase database: reads and writes
backend/src/repositories/repositoryRepository.ts - Session records → Supabase database: reads and writes
backend/src/repositories/sessionRepository.ts - Pull request records → Supabase database: reads and writes
backend/src/repositories/pullRequestRepository.ts - Review records → Supabase database: reads and writes
backend/src/repositories/reviewRepository.ts - Webhook events → Supabase database: reads and writes
backend/src/repositories/webhookEventRepository.ts