💖 TelMedSphere 💖

🧾 Table of Contents

📌 Introduction.
💡 Features.
🚀 Technology Used.
⭐ Overview.
💥 Getting Started.
🐳 Docker Setup.
📑 Contributing Guidelines.
📑 Code Of Conduct.
⚡ Project Admin & Mentors.
🧡 Contributing with fun.

📌Introduction

TelMedSphere is designed to make healthcare simple and accessible for both doctors and patients. It allows patients to connect with doctors through video calls, manage their health records, and make payments easily. For doctors, the app provides tools to schedule consultations, write prescriptions, and manage their time effectively.

💡Features

🚨 For Patients:

• Book Video Calls: Easily schedule video consultations with doctors.
• Share Feedback: Rate and review the doctor after your consultation.
• Manage Your Profile: Update and view your personal details.
• View Past Records: Check previous orders and prescriptions in one place.
• Easy Payments: Use the wallet feature powered by Stripe for secure payments.

🚨 For Doctors:

• Set Up Your Profile: Add information about yourself and your services.
• Manage Availability: Set your working hours for consultations.
• Join Video Calls: Connect with patients at the scheduled time.
• Write Prescriptions: Share prescriptions directly with patients after the consultation.
• Queue System: Organize appointments efficiently with a smart queue feature.

🚀Technology Used

🚨 Frontend: HTML, CSS, JS, ReactJs
🚨 Styling: SCSS
🚨 Backend: Python, Flask
🚨 Database: MongoDB
🚨 Containerization: Docker

⭐Overview

Live Project Demo ↗️

⬆️

💥Getting Started

• Fork this Repository.
• Clone the forked repository in your local system.

git clone https://github.com/<your-github-username>/TelMedSphere.git

💻Local Setup

• Navigate to the project directory for frontend Setup.

# Navigate to frontend directory
cd frontend    
# Install all npm packages for react frontend
npm install
# Set .env file
mv .env.example .env   
# Start the frontend 
npm run dev    

• Navigate to the project directory for backend Setup.

# Navigate to backeend directory
cd backend
# Set .env file
mv .env.example .env
# Create a virtual environment
python -m venv venv # This will create a folder named venv inside your project directory
# Activate the virtual environment
venv\Scripts\activate
# Install all dependencies for flask server
pip install -r requirements.txt     
# Run flask server
flask run
# deactivate the virtual environment, when you are done
deactivate

⬆️

🐳Docker Setup

Docker provides an easier way to set up and run TelMedSphere with all its dependencies.

Prerequisites

• Docker and Docker Compose installed on your system
• Environment variables ready for configuration

Steps to Run with Docker

1. Clone the repository same as above:

2. Update Enviroment variables:

   • Update Environment variables mentioned in docker-compose based on each project's .env respectively

3. Start the application using Docker Compose:

docker-compose up --build -d

The application will be available at:

• Frontend: http://localhost:3000
• Backend: http://localhost:5000

Stopping the Application

docker-compose down

Remove the Container

docker-compose kill

⬆️

📑Contributing Guidelines

Read our Contributing Guidelines to learn about our development process, how to propose bugfixes and improvements, and contributions.

📑Code Of Conduct

TelMedSphere and everyone participating in it is governed by the Code of Conduct. By participating, you are expected to uphold this code.

⚡Project Admin and Mentors

Project Admin - Pratik Mane

KWoC Mentor - Harshwardhan Patil

SWoC Mentor - Aditya Bavadekar

🚩 Project is part of below Open Source Programs

KWOC 2k24

SWOC 2k25

🫂Project Contributors

🧡Contributing with fun

Join Discord Server↗️

🎊 Contributions are always welcome 👨‍💻 Give it a 🌟 if you 🧡 TelMedSphere. Happy Coding !!!!! 🎊

⬆️