# abakarkosso/internship-radar architecture

> Architecture diagram of the GitHub repository abakarkosso/internship-radar, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/abakarkosso/internship-radar
- Repository: https://github.com/abakarkosso/internship-radar

## Overview

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: [`backend/src/main/java/dev/abakarkosso/radar/ingest/IngestionService.java`](https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/ingest/IngestionService.java) (Scheduled ingestion), [`backend/src/main/java/dev/abakarkosso/radar/source/SourceConfig.java`](https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/source/SourceConfig.java) (Source configuration), [`frontend/src/App.tsx`](https://github.com/abakarkosso/internship-radar/blob/main/frontend/src/App.tsx) (Feed and profile UI), [`backend/src/main/java/dev/abakarkosso/radar/posting/PostingController.java`](https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/posting/PostingController.java) (Postings API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_collection["Collection and parsing"]
  node_source_config["Source configuration<br/>[SourceConfig.java]"]
  node_source_registry["Source registry"]
  node_http_source["HTTP board source"]
  node_posting_source["Source contract<br/>[PostingSource.java]"]
  node_greenhouse_parser["Greenhouse parser"]
  node_ashby_parser["Ashby parser<br/>[AshbyParser.java]"]
  node_lever_parser["Lever parser<br/>[LeverParser.java]"]
  node_html_helper["HTML text helper<br/>[Html.java]"]
  node_raw_posting["Raw posting<br/>[RawPosting.java]"]
end

subgraph group_enrichment["Eligibility and ingestion"]
  node_ingestion["Scheduled ingestion"]
  node_internship_filter["Canada student filter"]
  node_eligibility_extractor["Eligibility extractor"]
  node_eligibility_model["Eligibility rules<br/>[Eligibility.java]"]
end

subgraph group_serving["Posting API and storage"]
  node_posting_entity["Posting record<br/>[Posting.java]"]
  node_posting_repository["Posting repository"]
  node_database[("PostgreSQL")]
  node_posting_controller["Postings API"]
  node_feed_page["Feed response<br/>[FeedPage.java]"]
end

subgraph group_experience["Browser experience"]
  node_app["Feed and profile UI<br/>[App.tsx]"]
  node_postings_client["Postings API client<br/>[postings.ts]"]
  node_profile_helpers["Browser profile<br/>[profile.ts]"]
  node_accuracy_report["Rule accuracy data<br/>[accuracy.json]"]
end

node_job_boards(("Public job boards"))
node_browser_user(("Internship seeker"))

node_source_config -->|"configures"| node_source_registry
node_source_config -->|"creates"| node_http_source
node_source_config -->|"registers"| node_greenhouse_parser
node_source_config -->|"registers"| node_ashby_parser
node_source_config -->|"registers"| node_lever_parser
node_http_source -->|"fetches"| node_job_boards
node_http_source -->|"implements"| node_posting_source
node_greenhouse_parser -->|"parses into"| node_raw_posting
node_ashby_parser -->|"parses into"| node_raw_posting
node_lever_parser -->|"parses into"| node_raw_posting
node_lever_parser -->|"converts HTML"| node_html_helper
node_greenhouse_parser -->|"uses"| node_html_helper
node_ashby_parser -->|"uses"| node_html_helper
node_ingestion -->|"gets sources"| node_source_registry
node_ingestion -->|"fetches"| node_posting_source
node_ingestion -->|"filters postings"| node_internship_filter
node_internship_filter -->|"checks"| node_raw_posting
node_ingestion -->|"extracts rules"| node_eligibility_extractor
node_eligibility_extractor -->|"produces"| node_eligibility_model
node_ingestion -->|"refreshes records"| node_posting_entity
node_ingestion -->|"reconciles postings"| node_posting_repository
node_posting_entity -->|"stores fields from"| node_eligibility_model
node_posting_repository -->|"reads and writes"| node_database
node_posting_controller -->|"queries"| node_posting_repository
node_posting_controller -->|"returns"| node_feed_page
node_browser_user -->|"browses"| node_app
node_app -->|"loads and saves profile"| node_profile_helpers
node_app -->|"requests feed and stats"| node_postings_client
node_postings_client -->|"calls API"| node_posting_controller
node_posting_controller -->|"serves posting data"| node_database
node_app -->|"displays accuracy"| node_accuracy_report

click node_source_config "https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/source/SourceConfig.java"
click node_source_registry "https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/source/SourceRegistry.java"
click node_http_source "https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/source/HttpBoardSource.java"
click node_posting_source "https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/source/PostingSource.java"
click node_greenhouse_parser "https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/source/GreenhouseParser.java"
click node_ashby_parser "https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/source/AshbyParser.java"
click node_lever_parser "https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/source/LeverParser.java"
click node_html_helper "https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/source/Html.java"
click node_raw_posting "https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/source/RawPosting.java"
click node_ingestion "https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/ingest/IngestionService.java"
click node_internship_filter "https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/ingest/InternshipFilter.java"
click node_eligibility_extractor "https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/eligibility/EligibilityExtractor.java"
click node_eligibility_model "https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/eligibility/Eligibility.java"
click node_posting_entity "https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/posting/Posting.java"
click node_posting_repository "https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/posting/PostingRepository.java"
click node_posting_controller "https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/posting/PostingController.java"
click node_feed_page "https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/posting/FeedPage.java"
click node_app "https://github.com/abakarkosso/internship-radar/blob/main/frontend/src/App.tsx"
click node_postings_client "https://github.com/abakarkosso/internship-radar/blob/main/frontend/src/lib/postings.ts"
click node_profile_helpers "https://github.com/abakarkosso/internship-radar/blob/main/frontend/src/lib/profile.ts"
click node_accuracy_report "https://github.com/abakarkosso/internship-radar/blob/main/frontend/src/generated/accuracy.json"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_source_config,node_source_registry,node_http_source,node_posting_source,node_greenhouse_parser,node_ashby_parser,node_lever_parser,node_html_helper,node_raw_posting toneBlue
class node_ingestion,node_internship_filter,node_eligibility_extractor,node_eligibility_model toneAmber
class node_posting_entity,node_posting_repository,node_database,node_posting_controller,node_feed_page toneMint
class node_app,node_postings_client,node_profile_helpers,node_accuracy_report toneRose
class node_job_boards,node_browser_user toneIndigo
```

## Components

### Collection and parsing

- [Source configuration](https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/source/SourceConfig.java): `backend/src/main/java/dev/abakarkosso/radar/source/SourceConfig.java`
- [Source registry](https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/source/SourceRegistry.java): `backend/src/main/java/dev/abakarkosso/radar/source/SourceRegistry.java`
- [HTTP board source](https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/source/HttpBoardSource.java): `backend/src/main/java/dev/abakarkosso/radar/source/HttpBoardSource.java`
- [Source contract](https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/source/PostingSource.java): `backend/src/main/java/dev/abakarkosso/radar/source/PostingSource.java`
- [Greenhouse parser](https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/source/GreenhouseParser.java): `backend/src/main/java/dev/abakarkosso/radar/source/GreenhouseParser.java`
- [Ashby parser](https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/source/AshbyParser.java): `backend/src/main/java/dev/abakarkosso/radar/source/AshbyParser.java`
- [Lever parser](https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/source/LeverParser.java): `backend/src/main/java/dev/abakarkosso/radar/source/LeverParser.java`
- [HTML text helper](https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/source/Html.java): `backend/src/main/java/dev/abakarkosso/radar/source/Html.java`
- [Raw posting](https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/source/RawPosting.java): `backend/src/main/java/dev/abakarkosso/radar/source/RawPosting.java`

### Eligibility and ingestion

- [Scheduled ingestion](https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/ingest/IngestionService.java): `backend/src/main/java/dev/abakarkosso/radar/ingest/IngestionService.java`
- [Canada student filter](https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/ingest/InternshipFilter.java): `backend/src/main/java/dev/abakarkosso/radar/ingest/InternshipFilter.java`
- [Eligibility extractor](https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/eligibility/EligibilityExtractor.java): `backend/src/main/java/dev/abakarkosso/radar/eligibility/EligibilityExtractor.java`
- [Eligibility rules](https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/eligibility/Eligibility.java): `backend/src/main/java/dev/abakarkosso/radar/eligibility/Eligibility.java`

### Posting API and storage

- [Posting record](https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/posting/Posting.java): `backend/src/main/java/dev/abakarkosso/radar/posting/Posting.java`
- [Posting repository](https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/posting/PostingRepository.java): `backend/src/main/java/dev/abakarkosso/radar/posting/PostingRepository.java`
- **PostgreSQL**
- [Postings API](https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/posting/PostingController.java): `backend/src/main/java/dev/abakarkosso/radar/posting/PostingController.java`
- [Feed response](https://github.com/abakarkosso/internship-radar/blob/main/backend/src/main/java/dev/abakarkosso/radar/posting/FeedPage.java): `backend/src/main/java/dev/abakarkosso/radar/posting/FeedPage.java`

### Browser experience

- [Feed and profile UI](https://github.com/abakarkosso/internship-radar/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Postings API client](https://github.com/abakarkosso/internship-radar/blob/main/frontend/src/lib/postings.ts): `frontend/src/lib/postings.ts`
- [Browser profile](https://github.com/abakarkosso/internship-radar/blob/main/frontend/src/lib/profile.ts): `frontend/src/lib/profile.ts`
- [Rule accuracy data](https://github.com/abakarkosso/internship-radar/blob/main/frontend/src/generated/accuracy.json): `frontend/src/generated/accuracy.json`

### Other components

- **Public job boards**
- **Internship seeker**

## Connections

- Source configuration → Source registry: configures (evidence: `backend/src/main/java/dev/abakarkosso/radar/source/SourceConfig.java`)
- Source configuration → HTTP board source: creates (evidence: `backend/src/main/java/dev/abakarkosso/radar/source/SourceConfig.java`)
- Source configuration → Greenhouse parser: registers (evidence: `backend/src/main/java/dev/abakarkosso/radar/source/SourceConfig.java`)
- Source configuration → Ashby parser: registers (evidence: `backend/src/main/java/dev/abakarkosso/radar/source/SourceConfig.java`)
- Source configuration → Lever parser: registers (evidence: `backend/src/main/java/dev/abakarkosso/radar/source/SourceConfig.java`)
- HTTP board source → Public job boards: fetches (evidence: `README.md`)
- HTTP board source → Source contract: implements (evidence: `backend/src/main/java/dev/abakarkosso/radar/source/HttpBoardSource.java`)
- Greenhouse parser → Raw posting: parses into (evidence: `backend/src/main/java/dev/abakarkosso/radar/source/GreenhouseParser.java`)
- Ashby parser → Raw posting: parses into (evidence: `backend/src/main/java/dev/abakarkosso/radar/source/AshbyParser.java`)
- Lever parser → Raw posting: parses into (evidence: `backend/src/main/java/dev/abakarkosso/radar/source/LeverParser.java`)
- Lever parser → HTML text helper: converts HTML (evidence: `backend/src/main/java/dev/abakarkosso/radar/source/LeverParser.java`)
- Greenhouse parser → HTML text helper: uses (evidence: `backend/src/main/java/dev/abakarkosso/radar/source/GreenhouseParser.java`)
- Ashby parser → HTML text helper: uses (evidence: `backend/src/main/java/dev/abakarkosso/radar/source/AshbyParser.java`)
- Scheduled ingestion → Source registry: gets sources (evidence: `backend/src/main/java/dev/abakarkosso/radar/ingest/IngestionService.java`)
- Scheduled ingestion → Source contract: fetches (evidence: `backend/src/main/java/dev/abakarkosso/radar/ingest/IngestionService.java`)
- Scheduled ingestion → Canada student filter: filters postings (evidence: `backend/src/main/java/dev/abakarkosso/radar/ingest/IngestionService.java`)
- Canada student filter → Raw posting: checks (evidence: `backend/src/main/java/dev/abakarkosso/radar/ingest/InternshipFilter.java`)
- Scheduled ingestion → Eligibility extractor: extracts rules (evidence: `backend/src/main/java/dev/abakarkosso/radar/ingest/IngestionService.java`)
- Eligibility extractor → Eligibility rules: produces (evidence: `backend/src/main/java/dev/abakarkosso/radar/eligibility/EligibilityExtractor.java`)
- Scheduled ingestion → Posting record: refreshes records (evidence: `backend/src/main/java/dev/abakarkosso/radar/ingest/IngestionService.java`)
- Scheduled ingestion → Posting repository: reconciles postings (evidence: `backend/src/main/java/dev/abakarkosso/radar/ingest/IngestionService.java`)
- Posting record → Eligibility rules: stores fields from (evidence: `backend/src/main/java/dev/abakarkosso/radar/posting/Posting.java`)
- Posting repository → PostgreSQL: reads and writes (evidence: `README.md`)
- Postings API → Posting repository: queries (evidence: `backend/src/main/java/dev/abakarkosso/radar/posting/PostingController.java`)
- Postings API → Feed response: returns (evidence: `backend/src/main/java/dev/abakarkosso/radar/posting/PostingController.java`)
- Internship seeker → Feed and profile UI: browses (evidence: `README.md`)
- Feed and profile UI → Browser profile: loads and saves profile (evidence: `frontend/src/App.tsx`)
- Feed and profile UI → Postings API client: requests feed and stats (evidence: `frontend/src/App.tsx`)
- Postings API client → Postings API: calls API (evidence: `README.md`)
- Postings API → PostgreSQL: serves posting data (evidence: `README.md`)
- Feed and profile UI → Rule accuracy data: displays accuracy (evidence: `frontend/src/App.tsx`)
