lilhop36/jobhunterET

Ethiopia-first intelligent job search, aggregation, matching & notification system # 🎯 JobHunter ### Intelligent Job Search, Aggregation & Matching System for Ethiopia **Automatically discovers, normalizes, scores, and delivers personalized job matches — with zero manual searching.** ### 🟢 Live Demo → --- ## 📖 What is JobHunter? JobHunter is a **full-stack, multi-user job search agent** built for the Ethiopian job market. It continuously scrapes job boards, company career pages, NGOs, and international sources — then uses a **deterministic, explainable scoring engine** to match every new job against each user's profile and deliver personalized alerts via **Telegram** or a **web Inbox**. > **Core promise:** Register once → JobHunter searches continuously → evaluates per user → explains why each match matters → notifies you instantly → you decide whether to apply. --- ## ✨ Key Features | Feature | Description | |---|---| | 🔍 **Automated Collection** | 11+ source adapters (EthioJobs, Remotive, ReliefWeb, Arbeitnow, etc.) with polite rate limiting | | 🧠 **Deterministic Matching** | 7-factor scoring engine — role, skills, experience, location, employment, salary, freshness decay | | 📊 **Explainable Scores** | Every match shows *why* — matched skills, missing skills, relevance breakdown | | 📱 **Telegram Alerts** | Instant bot notifications with inline action buttons (Save / Reject / Apply) | | 📥 **Web Inbox** | Fallback for users without Telegram — no match is ever silently lost | | 👻 **Ghost Job Detection** | Automatically removes dead listings after 3 missed collection cycles | | 🔗 **Link-Rot Detection** | Daily sweep validates apply URLs; dead links get flagged | | 👤 **Multi-User** | Per-user profiles, isolated matches, role-based access (USER / ADMIN) | | 🎛️ **Admin Dashboard** | Source health monitoring, manual collection triggers, user management | | 📈 **Match Score Ring** | Animated hero visualization showing match quality at a glance | | 🌙 **Dark Mode** | Full light/dark theme with system preference detection | | 🔒 **Security …