How tejaswinikannan/job-search-platform works
Job Board is a React frontend backed by a FastAPI CRUD and search API. Users browse listings, open details, and employers create, edit, or delete jobs. Natural-language search parses a query, retrieves semantic candidates, reranks them, and applies structured filters. The API persists jobs and company records in SQLite; semantic search also uses a persisted Chroma index and external LLM services. Edges reflect the sampled calls and README-documented capabilities; unsampled page-to-API details are not inferred beyond those documented.
Main entry points: App.jsx Routes & mutations · jobs.py Job endpoints · JobsPage.jsx Browse & search · JobListings.jsx Listing cards
Components 20
Web experience
- Routes & mutations
frontend/src/App.jsx - Home page
frontend/src/pages/HomePage.jsx - Browse & search
frontend/src/pages/JobsPage.jsx - Listing cards
frontend/src/components/JobListings.jsx - Job details
frontend/src/pages/JobPage.jsx - Create listing
frontend/src/pages/AddJobPage.jsx - Edit listing
frontend/src/pages/EditJobPage.jsx - Shared layout
frontend/src/layouts/MainLayout.jsx
Job API
- FastAPI application
api/main.py - Job endpoints
api/app/routes/jobs.py - API schemas
api/app/schemas.py
Search services
- Query parsing
api/app/nlp_search.py - Semantic retrieval
api/app/vector_search.py - Result reranking
api/app/rerank.py - Chroma vector index
api/app/vector_search.py
Persistence
- DB sessions
api/app/database.py - Job & company models
api/app/models.py - SQLite job store
api/data/jobs.json
Other components
- Job seekers & employers
- OpenAI LLM
Connections 27
- Job seekers & employers → Routes & mutations: uses
README.md - Routes & mutations → Home page: routes to
frontend/src/App.jsx - Routes & mutations → Browse & search: routes to
frontend/src/App.jsx - Routes & mutations → Job details: routes to
frontend/src/App.jsx - Routes & mutations → Create listing: routes to
frontend/src/App.jsx - Routes & mutations → Edit listing: routes to
frontend/src/App.jsx - Routes & mutations → Shared layout: wraps routes
frontend/src/App.jsx - Browse & search → Listing cards: renders
frontend/src/pages/JobsPage.jsx - Home page → Listing cards: renders
frontend/src/pages/HomePage.jsx - Listing cards → Job endpoints: fetches listings
frontend/src/components/JobListings.jsx - Routes & mutations → Job endpoints: submits mutations
frontend/src/App.jsx - Job details → Job endpoints: loads listing
README.md - Create listing → Routes & mutations: submits listing
frontend/src/App.jsx - Edit listing → Routes & mutations: submits changes
frontend/src/App.jsx - FastAPI application → Job endpoints: mounts router
api/main.py - Job endpoints → DB sessions: requests session
api/app/routes/jobs.py - Job endpoints → Job & company models: queries records
api/app/routes/jobs.py - Job & company models → DB sessions: uses base
api/app/models.py - Job endpoints → API schemas: validates payloads
api/app/routes/jobs.py - Job endpoints → Query parsing: parses query
api/app/routes/jobs.py - Job endpoints → Semantic retrieval: retrieves candidates
api/app/routes/jobs.py - Job endpoints → Result reranking: reranks candidates
api/app/routes/jobs.py - Query parsing → OpenAI LLM: invokes LLM
api/app/nlp_search.py - Result reranking → OpenAI LLM: judges relevance
- Semantic retrieval → Chroma vector index: queries index
api/app/vector_search.py - DB sessions → SQLite job store: stores records
README.md - Job seekers & employers → Browse & search: searches listings
README.md