MoAmanjee/medrate-sa

🏥 Modern Healthcare Platform for South Africa - Discovery-inspired design with comprehensive hospital directory, doctor profiles, AI-powered DocBot, and interactive maps # RateTheDoctor - AI-Powered Doctor Locator & Booking Platform A production-grade, full-stack healthcare platform for South Africa that enables patients to find, rate, and book appointments with verified doctors. Built with modern technologies and designed for scalability, security, and POPIA compliance. ## 🏗️ System Architecture RateTheDoctor is built using a microservices architecture with the following components: - **Frontend**: React (Web) + Flutter (Mobile) - **Backend**: FastAPI (Python) or Node.js (Express) - **Database**: PostgreSQL with Prisma ORM - **Authentication**: Firebase Auth with role-based access - **Hosting**: Vercel (Frontend) + Google Cloud Run/AWS Lambda (Backend) - **Payments**: Paystack/Stripe for subscriptions - **Maps**: Google Maps API for locations and directions - **AI**: OpenAI API for symptom checker and sentiment analysis - **Notifications**: Twilio/FCM for SMS and push notifications ## 📚 Documentation Comprehensive documentation is available in the `/docs` directory: 1. **System Architecture** - Complete system architecture overview 2. **ERD (Entity Relationship Diagram)** - Database schema and relationships 3. **System Design Summary** - Detailed system design documentation 4. **Architecture Diagrams** - Visual architecture diagrams 5. **Integrations** - External service integration guide ## 🚀 Quick Start ### Prerequisites - Node.js 18+ or Python 3.11+ - PostgreSQL 15+ - Redis 7+ - Firebase project - Google Cloud / AWS account ### Installation #### Frontend (React) ```bash cd fraud-frontend npm install cp env.example .env # Configure environment variables npm run dev ``` #### Backend ```bash cd backend npm install # or pip install -r requirements.txt cp .env.example .env # Configure environment variables npx prisma generate npx prisma migrate dev npm run dev ``` #### Database Setup ```bash # Create PostgreSQL database createdb ratethedoctor # Run migrations cd backend npx prisma migrate dev ``` ## 📁 Project Structu …