Skip to content

janista-ng/2340-Project-1-

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

68 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TalentSwarm (Nexora)

Job board for job seekers and recruiters. Built with Django.

Quick Start

python -m venv venv
venv\Scripts\activate          # Windows
# source venv/bin/activate     # Mac/Linux
pip install -r requirements.txt
python manage.py migrate
python manage.py cities_light  # Populate US cities (~5–10 min)
python manage.py seed_dummy_data --clear  # Test data (password: testpass123)
python manage.py runserver

Open http://127.0.0.1:8000/

User Stories

17 of 21 completed

Job Seeker

  • Create profile (headline, skills, education, work experience, links)
  • Search jobs (title, skills, location, salary, remote, visa)
  • Apply with one click + optional note
  • Track application status (Applied → Review → Interview → Offer → Closed)
  • Set profile privacy options
  • Receive job recommendations based on skills
  • View jobs on interactive map with clustering
  • Filter map by distance from my location
  • Set commute radius on map

Recruiter

  • Post and edit job roles
  • Search candidates by skills, location, projects
  • Organize applicants in pipeline (Kanban)
  • Message candidates in-app
  • Receive candidate recommendations for jobs
  • Pin job location on map (State/City + optional pin-drop)
  • See clusters of applicants by location on map
  • Email candidates through platform
  • Save searches and get notified about new matches

Administrator

  • Manage users and roles
  • Moderate or remove job posts
  • Export data (CSV)

Features

  • Location: State/City dropdowns (django-cities-light), lat/lng stored for maps
  • Pin-drop: Fine-tune location on map when creating/editing jobs or profiles (seed mimics this with random offsets)
  • Map: Job seeker home page shows jobs on Leaflet map with marker clustering
  • Commute radius: On Jobs page — seekers with profile location get a slider (0–50 mi) to filter by distance; radius circle shown on map
  • Applicant map: Recruiters see applicant clusters by location on home page
  • Map API: GET /jobs/map-markers/ — jobs (optional lat/lng/radius_miles), applicants (job_id or recruiter_applicants=1)

Development

git pull origin main
python manage.py migrate
python manage.py runserver

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors