How abakarkosso/internship-radar works
Internship Radar polls public job boards, keeps Canadian student roles, extracts eligibility details, and reconciles postings in PostgreSQL. Users browse a searchable feed and can filter it using a profile stored only in their browser; the API also supplies feed statistics. The graph follows documented ingestion and feed flows and preserves the board parsers, eligibility rules, and accuracy display. Some parser and configuration links rely on SOURCE INDEX references or README documentation rather than inspected implementation excerpts.
Main entry points: IngestionService.java Scheduled ingestion · SourceConfig.java Source configuration · App.tsx Feed and profile UI · PostingController.java Postings API
Components 24
Collection and parsing
- Source configuration
backend/src/main/java/dev/abakarkosso/radar/source/SourceConfig.java - Source registry
backend/src/main/java/dev/abakarkosso/radar/source/SourceRegistry.java - HTTP board source
backend/src/main/java/dev/abakarkosso/radar/source/HttpBoardSource.java - Source contract
backend/src/main/java/dev/abakarkosso/radar/source/PostingSource.java - Greenhouse parser
backend/src/main/java/dev/abakarkosso/radar/source/GreenhouseParser.java - Ashby parser
backend/src/main/java/dev/abakarkosso/radar/source/AshbyParser.java - Lever parser
backend/src/main/java/dev/abakarkosso/radar/source/LeverParser.java - HTML text helper
backend/src/main/java/dev/abakarkosso/radar/source/Html.java - Raw posting
backend/src/main/java/dev/abakarkosso/radar/source/RawPosting.java
Eligibility and ingestion
- Scheduled ingestion
backend/src/main/java/dev/abakarkosso/radar/ingest/IngestionService.java - Canada student filter
backend/src/main/java/dev/abakarkosso/radar/ingest/InternshipFilter.java - Eligibility extractor
backend/src/main/java/dev/abakarkosso/radar/eligibility/EligibilityExtractor.java - Eligibility rules
backend/src/main/java/dev/abakarkosso/radar/eligibility/Eligibility.java
Posting API and storage
- Posting record
backend/src/main/java/dev/abakarkosso/radar/posting/Posting.java - Posting repository
backend/src/main/java/dev/abakarkosso/radar/posting/PostingRepository.java - PostgreSQL
- Postings API
backend/src/main/java/dev/abakarkosso/radar/posting/PostingController.java - Feed response
backend/src/main/java/dev/abakarkosso/radar/posting/FeedPage.java
Browser experience
- Feed and profile UI
frontend/src/App.tsx - Postings API client
frontend/src/lib/postings.ts - Browser profile
frontend/src/lib/profile.ts - Rule accuracy data
frontend/src/generated/accuracy.json
Other components
- Public job boards
- Internship seeker
Connections 31
- Source configuration → Source registry: configures
backend/src/main/java/dev/abakarkosso/radar/source/SourceConfig.java - Source configuration → HTTP board source: creates
backend/src/main/java/dev/abakarkosso/radar/source/SourceConfig.java - Source configuration → Greenhouse parser: registers
backend/src/main/java/dev/abakarkosso/radar/source/SourceConfig.java - Source configuration → Ashby parser: registers
backend/src/main/java/dev/abakarkosso/radar/source/SourceConfig.java - Source configuration → Lever parser: registers
backend/src/main/java/dev/abakarkosso/radar/source/SourceConfig.java - HTTP board source → Public job boards: fetches
README.md - HTTP board source → Source contract: implements
backend/src/main/java/dev/abakarkosso/radar/source/HttpBoardSource.java - Greenhouse parser → Raw posting: parses into
backend/src/main/java/dev/abakarkosso/radar/source/GreenhouseParser.java - Ashby parser → Raw posting: parses into
backend/src/main/java/dev/abakarkosso/radar/source/AshbyParser.java - Lever parser → Raw posting: parses into
backend/src/main/java/dev/abakarkosso/radar/source/LeverParser.java - Lever parser → HTML text helper: converts HTML
backend/src/main/java/dev/abakarkosso/radar/source/LeverParser.java - Greenhouse parser → HTML text helper: uses
backend/src/main/java/dev/abakarkosso/radar/source/GreenhouseParser.java - Ashby parser → HTML text helper: uses
backend/src/main/java/dev/abakarkosso/radar/source/AshbyParser.java - Scheduled ingestion → Source registry: gets sources
backend/src/main/java/dev/abakarkosso/radar/ingest/IngestionService.java - Scheduled ingestion → Source contract: fetches
backend/src/main/java/dev/abakarkosso/radar/ingest/IngestionService.java - Scheduled ingestion → Canada student filter: filters postings
backend/src/main/java/dev/abakarkosso/radar/ingest/IngestionService.java - Canada student filter → Raw posting: checks
backend/src/main/java/dev/abakarkosso/radar/ingest/InternshipFilter.java - Scheduled ingestion → Eligibility extractor: extracts rules
backend/src/main/java/dev/abakarkosso/radar/ingest/IngestionService.java - Eligibility extractor → Eligibility rules: produces
backend/src/main/java/dev/abakarkosso/radar/eligibility/EligibilityExtractor.java - Scheduled ingestion → Posting record: refreshes records
backend/src/main/java/dev/abakarkosso/radar/ingest/IngestionService.java - Scheduled ingestion → Posting repository: reconciles postings
backend/src/main/java/dev/abakarkosso/radar/ingest/IngestionService.java - Posting record → Eligibility rules: stores fields from
backend/src/main/java/dev/abakarkosso/radar/posting/Posting.java - Posting repository → PostgreSQL: reads and writes
README.md - Postings API → Posting repository: queries
backend/src/main/java/dev/abakarkosso/radar/posting/PostingController.java - Postings API → Feed response: returns
backend/src/main/java/dev/abakarkosso/radar/posting/PostingController.java - Internship seeker → Feed and profile UI: browses
README.md - Feed and profile UI → Browser profile: loads and saves profile
frontend/src/App.tsx - Feed and profile UI → Postings API client: requests feed and stats
frontend/src/App.tsx - Postings API client → Postings API: calls API
README.md - Postings API → PostgreSQL: serves posting data
README.md - Feed and profile UI → Rule accuracy data: displays accuracy
frontend/src/App.tsx