Skip to content
BranchesTags
 
 

Repository files navigation

🩺 MedInternia

Empowering Medical Learning, Collaboration & Career Growth

MedInternia is a comprehensive medical education and collaboration platform designed for doctors, interns, medical students, and patients.

🚀 Official GSSoC 2026 Project

🚨 Problem Statement

The medical education and collaboration ecosystem faces critical real-world challenges:

  • Limited collaborative case discussion platforms — Medical professionals lack dedicated spaces for structured peer-to-peer case discussions
  • Difficulty accessing medical mentorship and peer learning — Interns and students struggle to connect with experienced doctors for guidance
  • Fragmented internship and job discovery — No centralized hub exists for medical internship, residency, and job opportunities
  • Lack of centralized medical learning and networking ecosystems — Medical knowledge, networking, and career tools are scattered across disconnected platforms

🎯 Project Vision

MedInternia was built to transform how medical professionals learn, collaborate, and grow:

  • Why MedInternia was built — To create a unified platform where doctors, interns, students, and patients can connect, share knowledge, and advance their careers together
  • Long-term goals — To become the leading ecosystem for medical education, peer learning, mentorship, and career development globally
  • Intended impact on medical education and collaboration — Improve healthcare quality by empowering better-trained and better-connected medical professionals

💡 Solution Overview

MedInternia addresses these challenges through an integrated platform:

  • Case-Based Learning — Explore and analyze real medical cases with peers
  • Medical Job Board — Find internships and career opportunities in one place
  • Webinars & Live AMAs — Join live sessions with experienced professionals
  • Leaderboard & Achievements — Track contributions and earn recognition
  • AI-Powered Suggestions — Get smart recommendations for learning and collaboration
  • Peer Review & Ratings — Maintain quality through community feedback

👥 User-Centric Narrative

MedInternia is built for everyone in the medical ecosystem:

User How MedInternia Helps
🎓 Medical Students Case-based peer learning, mentorship, certifications
🏥 Interns Job and residency discovery, skill building
👨‍⚕️ Doctors Share expertise, review cases, host webinars
🤝 Contributors Clear docs, good first issues, active maintainers
🏅 GSSoC Reviewers Problem-driven architecture, real-world impact
💼 Recruiters Modern tech stack, healthcare domain experience

🌟 Features

🗂️ Case-Based Learning System

  • Create, publish, and discuss medical cases
  • Nested comments and threaded replies
  • Interactive peer discussions

🧑‍⚕️ Peer Review & Ratings

  • Doctors and interns can review cases
  • Rating system for cases and comments

🏅 Badges & Certifications

  • Earn participation badges
  • Achievement-based certificates

💼 Medical Job Board

  • Browse and apply for medical jobs
  • Internship and residency opportunities

🎥 Webinars & AMA Sessions

  • Attend and host webinars
  • Interactive live sessions

🤖 AI-Powered Suggestions

  • Smart recommendations for discussions
  • AI-assisted learning support

📹 Video Conferencing

  • Secure video calls via Daily.co (WebRTC)
  • Webinar and live AMA session support
  • Role-based controls (host can mute/remove participants)
  • Status: Implementation in progress — see docs/video-conferencing.md

👤 User Profiles

  • Manage professional information
  • Personalized dashboards

🔒 Authentication & Security

  • JWT Authentication
  • OTP Verification
  • Protected routes

🛠️ Tech Stack

Frontend

  • Next.js
  • React.js
  • Material UI

Backend

  • Node.js
  • Express.js
  • MongoDB
  • Mongoose

Authentication & Security

  • JWT
  • Nodemailer
  • Helmet
  • CORS

📁 Folder Structure

MedInternia/
│
├── backend/
├── frontend/
├── README.md
└── package.json

📁 Folder Structure

MedInternia/ │ ├── backend/ # Node.js + Express API (port 3000) ├── frontend/ # Next.js frontend (port 3001) ├── docs/ # Architecture documentation │ └── ai-nlp-integration.md # AI/NLP module plan ├── requirements.txt # Python dependencies (for future NLP module) ├── README.md └── package.json

Note on requirements.txt: This file is a placeholder for the planned Python NLP microservice. See docs/ai-nlp-integration.md for the implementation plan and backend/.env.example for the NLP_SERVICE_URL configuration. Also update the "Getting Started" section to add: markdown## 4️⃣ Start Development Servers

Backend

cd backend
npm run dev

Frontend

cd frontend  
npm run dev

NLP Service (Optional — only needed for AI Suggestions feature)

⚠️ The NLP module is not yet implemented. The AI-Powered Suggestions feature is currently planned. See docs/ai-nlp-integration.md for the implementation roadmap.

⚡ Getting Started

1️⃣ Clone Repository

git clone https://github.com/AnirudhPhophalia/MedInternia.git
cd MedInternia

2️⃣ Install Dependencies

Backend

cd backend
npm install

Frontend

cd frontend
npm install

3️⃣ Configure Environment Variables

Create a .env file inside backend/

PORT=3000
MONGODB_URI=your_mongodb_connection
JWT_SECRET=your_jwt_secret
CLOUDINARY_CLOUD_NAME=your_cloudinary_cloud_name
CLOUDINARY_API_KEY=your_cloudinary_api_key
CLOUDINARY_API_SECRET=your_cloudinary_api_secret

EMAIL_USER=your_gmail@gmail.com
EMAIL_PASS=your_gmail_app_password    # ⚠️ 16-char App Password — NOT your Gmail password
                                       # Generate at: myaccount.google.com/apppasswords
EMAIL_HOST=smtp.gmail.com
EMAIL_PORT=587

> **⚠️ Gmail SMTP Note:** Google permanently removed support for password-based SMTP
> in August 2024. `EMAIL_PASS` must be a **Gmail App Password** (not your account password).
> Enable 2-Step Verification first, then generate an App Password at
> [myaccount.google.com/apppasswords](https://myaccount.google.com/apppasswords).
> For local development without sending real emails, use [Mailtrap](https://mailtrap.io) (free).

4️⃣ Start Development Servers

Backend

npm run dev

Frontend

npm run dev

🌐 Local Development URLs

Service URL
Frontend http://localhost:3001
Backend API http://localhost:3000/api

📝 Usage

  • Register as a doctor, intern, or patient
  • Verify email via OTP
  • Create and discuss cases
  • Attend webinars
  • Apply for jobs
  • Earn badges and certificates

🤝 Contributing

We welcome contributions from developers, designers, and medical enthusiasts!

Contribution Steps

  1. Fork the repository
  2. Clone your fork
  3. Create a branch
git checkout -b feature/your-feature-name
  1. Commit changes
git commit -m "feat: added new feature"
  1. Push changes
git push origin feature/your-feature-name
  1. Open a Pull Request

🌟 Contributors

Thanks to all the amazing contributors who help improve MedInternia ❤️

👨‍💻 Project Admins / Maintainers


Anirudh Phophalia
Anushka Verma
Ishwinder Kaur Ahluwalia
Bhagya Vardhan

🏷️ GSSoC 2026

✨ Officially Selected in GirlScript Summer of Code 2026 ✨

📄 License

This project is licensed under the MIT License. See LICENSE for details.

For responsible vulnerability reporting, see SECURITY.md. For setup and usage help, see SUPPORT.md.

📬 Contact

📧 Team Blue Spies 🌐 https://github.com/AnirudhPhophalia/MedInternia

Made with ❤️ for the Medical Community & Open Source Ecosystem

About

medinternia.vercel.app/

Resources

Readme
License

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages