How waats0n/bytebrief works
ByteBrief collects news, deduplicates and enriches it, persists articles, and serves digests and account features through a Django API to a React interface. The main user workflow is browsing or searching for a digest; scheduled collection and AI-assisted processing supply the article corpus. The graph includes documented capabilities and sampled call relationships. Several frontend pages and backend subsystems are represented by their exact paths but were not sampled, so uncertain links are omitted or marked unverified.
Main entry points: App.js App and routes · orchestrator.py Agent orchestrator · api.js API client · tasks.py Background tasks
Components 29
React experience
- App and routes
Frontend/src/App.js - Page layout
Frontend/src/components/layout/Layout.js - Navigation
Frontend/src/components/layout/Navigation.js - Digest sections
Frontend/src/components/sections/FeaturedNews.js - Article imagery
Frontend/src/components/common/ArticleImage.js - Brand seal
Frontend/src/components/common/BrandSeal.js - Search results
Frontend/src/pages/SearchPage.js - Article digest
Frontend/src/pages/ArticleDigestPage.js - Account settings
Frontend/src/pages/AccountSettings.js - Login
Frontend/src/pages/Login.js - FAQ
Frontend/src/pages/FAQPage.js - API client
Frontend/src/services/api.js - Authentication client
Frontend/src/services/authService.js - Icon map
Frontend/src/utils/iconMap.js
Django application
- API routing
backend/bytebrief_web/urls.py - API views
backend/news_brief/views.py - Scheduled collection
backend/news_brief/scheduler.py - Background tasks
backend/news_brief/tasks.py
News collection
- Agent orchestrator
backend/src/bytebrief/agent/orchestrator.py - News scrapers
backend/src/bytebrief/scrapers/factory.py - Keyword search scraper
backend/src/bytebrief/scrapers/google_search.py
Article processing
- Categorize and summarize
backend/src/bytebrief/agent/processor.py - Article comparer
backend/src/bytebrief/agent/comparer.py - Scraped article model
backend/src/bytebrief/core/models.py
Product data
- Users and news records
backend/news_brief/models.py
Other components
- Reader
- News publishers
- Google News RSS
- Email service
Connections 33
- Reader → App and routes: browses
Frontend/src/App.js - App and routes → Page layout: renders
Frontend/src/App.js - Page layout → Navigation: renders
Frontend/src/components/layout/Layout.js - App and routes → Digest sections: renders
Frontend/src/App.js - Digest sections → Article imagery: renders
Frontend/src/components/sections/FeaturedNews.js - Navigation → Brand seal: renders
Frontend/src/components/layout/Navigation.js - App and routes → API client: requests digest
Frontend/src/App.js - Search results → API client: requests results
Frontend/src/pages/SearchPage.js - Search results → Digest sections: renders results
Frontend/src/pages/SearchPage.js - App and routes → Article digest: routes to
Frontend/src/App.js - App and routes → Account settings: routes to
Frontend/src/App.js - App and routes → Login: routes to
Frontend/src/App.js - App and routes → FAQ: routes to
Frontend/src/App.js - Account settings → API client: uses
Frontend/src/pages/AccountSettings.js - Account settings → Authentication client: uses
Frontend/src/pages/AccountSettings.js - Login → Authentication client: authenticates via
- Authentication client → API client: uses base URL
Frontend/src/services/authService.js - API client → API views: HTTP requests
- API routing → API views: routes to
backend/bytebrief_web/urls.py - API views → Users and news records: reads and writes
backend/news_brief/views.py - Scheduled collection → Background tasks: schedules
- Background tasks → Users and news records: reads articles
backend/news_brief/tasks.py - Background tasks → Agent orchestrator: runs collection
backend/news_brief/tasks.py - Agent orchestrator → News scrapers: selects scrapers
backend/src/bytebrief/agent/orchestrator.py - Agent orchestrator → Keyword search scraper: supplements keyword results
backend/src/bytebrief/agent/orchestrator.py - News scrapers → News publishers: scrapes publishers
- Keyword search scraper → Google News RSS: fetches RSS
backend/src/bytebrief/scrapers/google_search.py - Agent orchestrator → Article comparer: deduplicates
backend/src/bytebrief/agent/orchestrator.py - Agent orchestrator → Categorize and summarize: processes articles
backend/src/bytebrief/agent/orchestrator.py - Categorize and summarize → Users and news records: persists articles
backend/src/bytebrief/agent/processor.py - Categorize and summarize → Scraped article model: processes
backend/src/bytebrief/agent/processor.py - Background tasks → Email service: sends digests
backend/news_brief/tasks.py - App and routes → Icon map: uses icons