Walefa/Tender-Insight-Hub

Tender Insight Hub is a cloud-native SaaS platform designed to assist South African SMEs in navigating public procurement opportunities. It simplifies complex tender documents, enables meaningful analysis, and helps SMEs assess their readiness to apply for tenders. The system is built as a collaborative, AI-assisted application t # Tender Insight Hub Tender Insight Hub is a SaaS platform for managing tenders, designed for teams and companies to search, analyze, and collaborate on tender opportunities with AI-powered insights. ## Features - **User Authentication**: Secure JWT-based login and registration. - **Team & Company Management**: Create teams, invite members, manage company profiles. - **Tender Search**: Search tenders with advanced filters and AI-powered document summarization. - **Readiness Scoring**: Automated scoring to assess your team's readiness for each tender. - **Plan Enforcement**: SaaS plans (Free, Basic, Pro) with feature gating. - **Activity Feed**: Track team actions and tender updates. ## Architecture - **Frontend**: React + Vite - Located in `src/frontend` - Modern UI with Material UI, custom themes, and responsive design - **Backend**: FastAPI + PostgreSQL - Located in `src/backend` - Async API endpoints, SQLAlchemy ORM, Alembic migrations - **AI Services**: Document summarization and scoring in `src/backend/app/services/ai_service.py` ## Directory Structure - `src/frontend`: React app (UI, pages, components, context) - `src/backend`: FastAPI app (API, models, services, migrations) - `src/backend/app/api/endpoints`: API routes - `src/backend/app/models`: Database models - `src/backend/app/services`: Business logic & AI - `src/backend/app/utils`: Utility functions ## Getting Started ### Prerequisites - Node.js & npm (for frontend) - Python 3.11(the required packages have conflicts with the latest version of Python, hence you have to revert to version 3.11.0 ) & pip (for backend) - PostgreSQL (production) or SQLite (dev) ### Frontend Setup ```powershell cd src/frontend npm install npm run dev ``` Visit `localhost` in your browser. ### Backend Setup ```powershell cd src/backend python -3.11 -m venv venv (It is important to include the version) .\venv\Scripts\activate pip install -r requirements.txt uvicorn app.main:app --reload ``` API docs: `http …