How quangdungluong/job-finder works
Project type and purpose
• From the file tree and README, this is a full-stack web application called “LinkedIn-Job-Explorer.”
• Frontend: A Next.js/React app under the frontend/ directory.
• Backend: A Python service (scripts main.py and server.py) that reads user configs, scrapes or fetches job listings (via modules in src/), filters them, and serves them to the frontend.
• Configurations: YAML files in configs/ for secrets (LinkedIn credentials) and work preferences.
• Orchestration: Docker Compose setup under docker/docker-compose.yaml.
• CI/CD and quality tools: GitHub workflows, ESLint, Pre-commit, style-check, tests under tests/.
File structure
• Top-level directories:
• frontend/ – stateless UI components, pages, CSS, Next.js config.
• src/ – Python modules:
– authenticator.py: handles LinkedIn authentication
– job_manager.py plus itviec_job_manager.py, topcv_job_manager.py – source-specific scraping/fetching logic
– job.py, models.py: domain models for jobs, filters
– config_validator.py, clean_blacklist.py, regex_utils.py, utils.py – supporting utilities
– logger.py – application logging
• configs/ – sample YAMLs for secrets and preferences
• docker/ – container definitions and Compose file
• main.py – CLI entrypoint to run in interactive mode
• server.py – HTTP server exposing REST endpoints to the frontend
• tests/ – pytest suite for core logic
• .github/workflows/ – CI for linting and style