How sk-sathyavada-008/eventscout_mobilefirst works
EventScout discovers technical events, curates them into personalized recommendations, and delivers them through a web app, browser extension, and notifications. The graph follows the documented collection-to-ranking workflow and includes source discovery and approval, user-facing access, and alert delivery. Some subsystem connections are based on the README rather than sampled implementation; uncertain wiring is omitted.
Main entry points: scraper_service.py Scraper Service · notification_service.py Notification Service · main.py FastAPI · llm_service.py Source Discovery
Components 23
Source Discovery
- Source Discovery
eventscout/services/llm_service.py - Source Registry
eventscout/database/source_db.py
Collection Pipeline
- Scraper Service
eventscout/services/scraper_service.py - Source Collectors
eventscout/collectors - Event Normalizer
eventscout/processors/normalizer.py - Event Deduplicator
eventscout/processors/deduplicator.py - Technical Filter
eventscout/filters/technical_filter.py - Personalized Ranking
eventscout/services/ranking_service.py - Pipeline Scheduler
eventscout/scheduler.py
API and Data
- FastAPI
api/main.py - Authentication
api/routers/auth.py - Event Store
eventscout/database/mongodb.py - User Store
eventscout/database/user_db.py
User Experience
- Next.js App
frontend/src/app - Chrome Extension
extension
Notifications
- Notification Service
eventscout/services/notification_service.py - Email Digests
eventscout/services/email_service.py - Notification Store
eventscout/database/notification_db.py
Other components
- Event Platforms
- Gemini AI
- Source Admin
- Developer
- SMTP Service
Connections 26
- Event Platforms → Source Discovery: provides pages
- Source Discovery → Gemini AI: analyzes pages
- Source Discovery → Source Registry: submits recipes
- Source Admin → Source Registry: approves sources
- Pipeline Scheduler → Scraper Service: runs pipeline
- Scraper Service → Source Registry: reads enabled sources
- Scraper Service → Source Collectors: dispatches collection
- Source Collectors → Event Platforms: fetches events
- Scraper Service → Event Normalizer: normalizes events
- Scraper Service → Event Deduplicator: deduplicates events
- Scraper Service → Technical Filter: filters events
- Scraper Service → Personalized Ranking: ranks events
- Scraper Service → Event Store: stores events
- Developer → Next.js App: uses app
- Next.js App → FastAPI: requests data
- Chrome Extension → FastAPI: saves events
- FastAPI → Event Store: queries and writes
- FastAPI → Authentication: routes authentication
- Authentication → User Store: reads and writes users
- FastAPI → User Store: reads user data
- Pipeline Scheduler → Notification Service: triggers alerts
- Notification Service → Event Store: reads events
- Notification Service → User Store: reads preferences
- Notification Service → Notification Store: checks alert history
- Notification Service → Email Digests: sends digests
- Email Digests → SMTP Service: delivers email