Medicare

Medicare - Autonomous Multi-Agent Orchestration for Healthcare Data

Streamlining patient data, connecting doctors and patients, and leveraging AI for better healthcare outcomes.

Features • Tech Stack • Getting Started • Documentation • Contributing

---

📖 Overview

Medicare is a comprehensive healthcare management system designed to bridge the gap between doctors and patients. It offers a secure platform for managing patient records, sharing medical history, creating prescriptions, and tracking vital signs. With built-in AI capabilities, Medicare aims to simplify document processing and provide actionable insights.

The system is built with a modern tech stack, ensuring performance, scalability, and a seamless user experience.

📸 Screenshots

Homepage	Doctor Dashboard
Doctor Patient View	Patient Profile
MediDoc AI Assistant	Fullscreen Chat Mode

✨ Features

🏥 For Doctors

• Dashboard: centralized view of recent activities and patient statistics.
• Patient Management: Add, edit, and view detailed patient profiles.
• Document Handling: Upload and organize medical documents (Lab Reports, Prescriptions, Imaging).
• Prescriptions: Create and manage digital prescriptions.
• Sharing: Request and manage access to patient records securely.
• Vitals Tracking: Monitor patient vitals with visual trends.

👤 For Patients

• Personal Health Record: Access personal medical history and documents.
• Vitals Monitoring: Log and view vital signs over time.
• Doctor Access: Grant or revoke access to medical records for different doctors.
• Mobile Responsive: Access health data on the go.

🤖 AI & Security

• AI Integration Ready: Architecture designed for AI-powered document analysis and insights.
• Secure Authentication: Powered by Supabase Auth with Row Level Security (RLS).
• Data Privacy: Granular permission controls for sharing data between patients and doctors.

🛠 Tech Stack

Frontend

• Framework: React 19 (via Vite)
• Language: TypeScript
• Styling: Tailwind CSS v4
• UI Components: shadcn/ui (Radix UI + Tailwind)
• State Management: React Query (TanStack Query)
• Routing: React Router v6
• Charts: Chart.js & react-chartjs-2

Backend

• Framework: FastAPI (Python 3.8+)
• Database: PostgreSQL (via Supabase)
• Authentication: Supabase Auth (JWT)
• Validation: Pydantic
• Server: Uvicorn

🚀 Getting Started

Follow these steps to set up the project locally.

Prerequisites

• Node.js (v18 or higher)
• pnpm (preferred package manager) or npm/yarn
• Python (v3.8 or higher)
• Supabase Account (for database and auth)

1. Clone the Repository

git clone https://github.com/yourusername/medicare.git
cd medicare

2. Supabase Configuration

1. Create a new project at Supabase.
2. Go to Project Settings > API and copy your Project URL and anon public key.
3. Run the database setup SQL scripts (located in backend/README.md or provided in the documentation) to create tables and policies.

3. Backend Setup

cd backend

# Create a virtual environment
python -m venv venv

# Activate the virtual environment
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Configure Environment Variables
cp env.example .env
# Edit .env and add your Supabase credentials

Run the backend server:

python start.py
# OR
uvicorn main:app --reload --port 8000

The API will be available at http://localhost:8000. API Docs at http://localhost:8000/docs.

4. Frontend Setup

Open a new terminal window:

cd frontend

# Install dependencies
pnpm install

# Configure Environment Variables
cp env.example .env
# Edit .env and add your Supabase credentials & Backend URL

# Start the development server
pnpm dev

The application will be available at http://localhost:5173.

📁 Project Structure

Medicare/
├── backend/                 # FastAPI Backend Application
│   ├── main.py             # App Entry Point & Routes
│   ├── services.py         # Business Logic
│   ├── models.py           # Data Models (Pydantic)
│   ├── database.py         # Database Connection
│   └── ...
├── frontend/                # React Frontend Application
│   ├── public/             # Static Assets
│   ├── src/
│   │   ├── components/     # Reusable UI Components
│   │   ├── pages/          # Route Pages
│   │   ├── services/       # API Integration
│   │   ├── contexts/       # React Contexts (Auth, Theme)
│   │   └── lib/            # Utilities
│   └── ...
└── README.md               # Project Documentation

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the project
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

PolyForm Noncommercial License 1.0.0

This project is licensed for Non-Commercial Use Only.

• You may use, copy, modify, and distribute this software for personal, educational, or non-profit purposes.
• You may NOT use this software for any commercial or business purpose without explicit written permission.

For commercial inquiries, licensing, or partnership opportunities, please contact the repository owner.

See the LICENSE file for full details.