kpmatlakala/TenderScan

enderScan Automated Government Tender Intelligence for South African Tenderpreneurs A lightweight tender scraping and aggregation system that helps SMMEs, contractors, and service providers discover relevant government opportunities faster — without the manual search hassle. # 📡 TenderScan Automated Government Tender Intelligence for South African Tenderpreneurs. A lightweight tender scraping and aggregation system that helps SMMEs, contractors, and service providers discover relevant government opportunities faster, without the manual search hassle. ## 🎯 Mission Reduce tender discovery time from hours to minutes by: - Scraping public tender portals (`eTenders.gov.za`, provincial bulletins, SETA portals) - Filtering opportunities by user profile (sector, CIDB grade, location, keywords) - Delivering personalised alerts and dashboard views - Guiding users to official sources for document downloads ## 🚀 Features (MVP Scope) | Feature | Description | Status | |---|---|---| | Tender Scraping | Extract metadata from `eTenders.gov.za` + aggregators | 🟡 In Progress | | Search-Optimized Tracker | Keywords, entity clues, closing dates, contact info | ✅ Done | | User Profiles | Sector, CIDB grading, province, budget range | 🔲 Planned | | Smart Filtering | Match tenders to user profile automatically | 🔲 Planned | | Email Alerts | Notify users when new tenders match their criteria | 🔲 Planned | | Dashboard UI | “My Tenders”, deadline calendar, saved items | 🔲 Planned | | Compliance Tracker | CSD, Tax Clearance, B-BBEE status checklist | 🔲 Planned | ## 🛠️ Tech Stack | Layer | Technology | Purpose | |---|---|---| | Language | Python 3.10+ | Core scraping & automation logic | | Environment | Jupyter Notebook | Interactive prototyping & testing | | Libraries | `requests`, `BeautifulSoup4`, `Selenium` | HTML parsing & dynamic content | | Data Storage | CSV/JSON (Phase 1) → PostgreSQL (Phase 2) | Structured tender metadata | | Backend | Node.js/Express OR Django REST | API layer (future) | | Frontend | Next.js + Tailwind | User dashboard (future) | | Auth | NextAuth.js / Django AllAuth | Multi-tenant user management | | Alerts | Resend/SendGrid + Twilio (optional) | Email/SMS notifications | | Hosting | Vercel (frontend) + Render/Railway (backend …