Doc-Scripter/JobRiseAfrica

Official African Opportunities, One Place # JobRise Africa JobRise Africa is a web application dedicated to helping job seekers across the African continent find verified job opportunities directly from official company career pages. The platform crawls and aggregates listings from trusted sources, ensuring that users access genuine, up-to-date opportunities. This README provides an overview of the system architecture, setup requirements, development workflow, and contribution guidelines. ## Overview JobRise Africa offers curated job listings sourced from company websites. Users can browse opportunities, save or bookmark jobs locally without an account, and access a clean, fast, and reliable interface built for the African job market. ## Features * Aggregates jobs by crawling official company career pages. * Clean, intuitive user interface built with Vue.js. * Server-side API built with Flask for job aggregation and data processing. * Local caching for saving or bookmarking jobs without requiring account creation. * Deployment with separate frontend and backend infrastructure. * “Non-Commercial Use Only” license requirement for public usage. ## Preview --- --- ## Architecture JobRise Africa is built using a modular, modern architecture: ### Frontend * Built with Vue.js. * Handles job browsing, search, filters, bookmarks, and UI interactions. * Stateless with respect to user authentication until full account functionality is implemented. * Deployed on Vercel. ### Backend * Developed using Python Flask. * Handles the crawling engine, API endpoints, job data processing, and caching logic. * Deployed on Render. ### Database * Supabase serves as the primary database. * Stores job entries, crawl metadata, logs, and future user accounts. ### Crawling Layer * Scheduled crawlers fetch jobs from known company career pages. * Each crawler normalizes job fields such as title, company, location, description, and apply URL. * Deduplication logic prevents repeated listings. * Error-handling and logg …