BETAIL-BOYS/medlink-sms

Automating healthcare communication across Africa helping medical professionals deliver lab results instantly and reliably through SMS. # MedLink SMS - Healthcare Communication Platform > Automating healthcare communication across Africa—helping medical professionals deliver lab results instantly and reliably through SMS. ## Features - **User Authentication** - Secure JWT-based login - **Patient Management** - Add and manage patient contacts - **SMS Delivery** - Automated SMS via Africa's Talking API - **Real-time Tracking** - Monitor delivery status - **Analytics Dashboard** - Delivery rates and insights - **Webhook Support** - Delivery confirmation callbacks ## Tech Stack ### Backend - **FastAPI** - Modern Python web framework - **SQLAlchemy** - SQL ORM - **SQLite/PostgreSQL** - Database - **JWT** - Authentication - **Africa's Talking API** - SMS delivery ### Frontend - **React 18** - UI library - **Tailwind CSS** - Styling - **Axios** - HTTP client - **Vite** - Build tool ### DevOps - **Docker** - Containerization - **GitLab CI/CD** - Automated deployment - **Render.com** - Hosting ## Quick Start ### Using Docker (Recommended) ```bash # Clone repository git clone gitlab.com cd medlink-sms # Create .env file cp backend/.env.example backend/.env # Edit backend/.env with your credentials # Run with Docker Compose docker-compose up -d # Access API curl localhost # API Docs: localhost ``` ### Manual Setup #### Backend ```bash cd backend python3 -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate pip install -r requirements.txt cp .env.example .env # Edit .env with your credentials uvicorn main:app --reload ``` #### Frontend ```bash cd frontend npm install npm run dev ``` ## Docker Commands ```bash # Build images docker-compose build # Start services docker-compose up -d # View logs docker-compose logs -f # Stop services docker-compose down # Rebuild and restart docker-compose up -d --build ``` ## API Documentation Once running, visit: - **Interactive Docs**: localhost …