💊 MediGuard - Smart Medication Management System

MediGuard is a comprehensive, secure medication management platform designed to help individuals, families, and caregivers track medications, manage prescriptions, set reminders, and ensure medication safety with AI-powered assistance.

🌟 Key Features

📋 Medication Management

Complete Medicine Tracking - Add, edit, and organize medications with detailed information
Expiry Date Monitoring - Automatic alerts for expiring medications
Stock Level Management - Track quantities and get low stock notifications
Barcode/QR Code Support - Quick medicine entry via scanning
Batch Operations - Manage multiple medications efficiently

👥 Multi-User & Family Support

Role-Based Access Control - Admin and User roles with granular permissions
Family Member Management - Add and manage family members' medications
Caregiver Permissions - Grant controlled access to caregivers
Emergency Contacts - Quick access to emergency contact information

🔔 Smart Notifications

Email Notifications - Expiry alerts, low stock warnings, and reminders
SMS Alerts - Critical notifications via Twilio integration
Customizable Reminders - Set medication reminders with flexible schedules
Daily/Weekly Digests - Summary reports of medication status

🤖 AI-Powered Assistant

Medication Information - Get instant answers about medications
Drug Interactions - Check for potential interactions
Dosage Guidance - AI-powered dosage recommendations
Health Tips - Personalized medication management advice
Powered by Google Gemini - Advanced natural language processing

🏢 Manufacturer & Category Management

Manufacturer Database - Track medication manufacturers with contact details
Category Organization - Organize medicines by therapeutic categories
Verification System - Verify manufacturer authenticity
Detailed Profiles - Store licenses, websites, and descriptions

🔒 Security & Compliance

CSRF Protection - Secure forms with Flask-WTF
Rate Limiting - Prevent abuse with Flask-Limiter
Secure Headers - Enhanced security with Flask-Talisman
Password Hashing - Werkzeug secure password storage
Session Management - Secure session handling
Audit Logging - Complete activity tracking for compliance

📊 Admin Dashboard

System Overview - Real-time statistics and metrics
User Management - Promote, demote, activate/deactivate users
Audit Logs - Comprehensive activity monitoring
System Health - Monitor application performance
Bulk Operations - Efficient management of large datasets

📱 Modern UI/UX

Responsive Design - Works seamlessly on desktop, tablet, and mobile
Bootstrap 5 - Modern, clean interface
Font Awesome Icons - Beautiful iconography
Gradient Themes - Eye-catching visual design
Dark Mode Ready - Comfortable viewing in any lighting

🚀 Quick Start

Prerequisites

Python 3.9 or higher
MySQL 8.0 or higher
Redis (optional, for caching)
Gmail account (for email notifications)
Twilio account (optional, for SMS)
Google Gemini API key (for AI assistant)

Installation

Clone the repository

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

Create virtual environment

python -m venv .venv

Activate virtual environment

Windows:

.venv\Scripts\activate

Linux/Mac:

source .venv/bin/activate

Install dependencies

pip install -r requirements.txt

Set up MySQL database

# Login to MySQL
mysql -u root -p

# Create database
CREATE DATABASE medication_navigator;

Configure environment variables

# Copy example environment file
cp .env.example .env

# Edit .env with your configuration
# Required: SECRET_KEY, MYSQL credentials, MAIL settings

Initialize database

python
>>> from app import app, db
>>> with app.app_context():
>>>     db.create_all()
>>> exit()

Run the application

python app.py

Access the application

http://127.0.0.1:5000

⚙️ Configuration

Environment Variables

Create a .env file in the root directory with the following variables:

# Application
SECRET_KEY=your-secret-key-here
FLASK_ENV=development
DEBUG=True

# Database
MYSQL_HOST=localhost
MYSQL_PORT=3306
MYSQL_USER=root
MYSQL_PASSWORD=your-password
MYSQL_DATABASE=medication_navigator

# Email (Gmail)
MAIL_SERVER=smtp.gmail.com
MAIL_PORT=587
MAIL_USE_TLS=True
MAIL_USERNAME=your-email@gmail.com
MAIL_PASSWORD=your-app-password
MAIL_DEFAULT_SENDER=your-email@gmail.com
EMAIL_NOTIFICATIONS_ENABLED=True

# SMS (Twilio - Optional)
TWILIO_ACCOUNT_SID=your-account-sid
TWILIO_AUTH_TOKEN=your-auth-token
TWILIO_PHONE_NUMBER=+1234567890
SMS_NOTIFICATIONS_ENABLED=False

# AI Assistant (Google Gemini)
GEMINI_API_KEY=your-gemini-api-key

# Scheduler
SCHEDULER_ENABLED=True
REMINDER_CHECK_INTERVAL=60

Getting API Keys

Gmail App Password:

Enable 2-Factor Authentication on your Google account
Go to Google Account > Security > App Passwords
Generate a new app password for "Mail"

Twilio (Optional):

Sign up at https://www.twilio.com
Get your Account SID and Auth Token from the dashboard
Purchase a phone number for SMS

Google Gemini API:

Visit https://makersuite.google.com/app/apikey
Create a new API key
Copy the key to your .env file

📖 Usage Guide

First Time Setup

Create Admin Account
- Navigate to /signup
- Register with your details
- First user is automatically assigned admin role
Add Categories
- Go to Admin Dashboard > Manage Categories
- Add medication categories (e.g., Antibiotics, Pain Relief)
Add Manufacturers
- Go to Admin Dashboard > Manage Manufacturers
- Add pharmaceutical manufacturers with contact details
Add Medications
- Go to Dashboard > Add Medicine
- Fill in medication details
- Set expiry dates and stock levels
Set Up Reminders
- Go to Reminders section
- Create medication reminders with schedules

User Roles

Admin:

Full system access
User management
View all medications across users
System configuration
Audit log access

User:

Manage own medications
Add family members
Set reminders
View personal dashboard
Use AI assistant

🏗️ Project Structure

mediguard/
│
├── app.py                      # Main application file
├── forms.py                    # WTForms form definitions
├── sms_templates.py            # SMS notification templates
├── requirements.txt            # Python dependencies
├── .env.example               # Environment variables template
├── .gitignore                 # Git ignore rules
│
├── config/
│   └── secure_config.py       # Application configuration
│
├── services/
│   ├── ai_assistant_service.py    # AI assistant logic
│   ├── medicine_service.py        # Medicine business logic
│   └── notification_service.py    # Notification handling
│
├── scripts/
│   ├── mysql_schema.sql           # Database schema
│   ├── setup_mysql_database.py    # Database setup script
│   └── mysql_backup.py            # Backup utility
│
├── templates/
│   ├── base.html                  # Base template
│   ├── index.html                 # Landing page
│   ├── dashboard.html             # User dashboard
│   ├── admin_dashboard.html       # Admin dashboard
│   ├── medicines.html             # Medicine list
│   ├── add_medicine.html          # Add medicine form
│   ├── edit_medicine.html         # Edit medicine form
│   ├── reminders.html             # Reminders page
│   ├── manage_users.html          # User management
│   ├── manage_manufacturers.html  # Manufacturer management
│   ├── manage_categories.html     # Category management
│   ├── medication_assistant.html  # AI assistant interface
│   ├── profile.html               # User profile
│   ├── login.html                 # Login page
│   ├── signup.html                # Registration page
│   ├── emails/                    # Email templates
│   └── errors/                    # Error pages
│
├── static/
│   └── uploads/                   # User uploaded files
│
└── backups/                       # Database backups

🔧 Database Schema

Core Tables

users - User accounts and authentication
medicines - Medication records
categories - Medication categories
manufacturers - Pharmaceutical manufacturers
reminders - Medication reminders
family_members - Family member profiles
caregiver_permissions - Access control for caregivers
emergency_contacts - Emergency contact information
audit_logs - System activity tracking
notifications - Notification queue

🔐 Security Features

Password Hashing - Werkzeug PBKDF2 with salt
CSRF Protection - Token-based form protection
Rate Limiting - Prevent brute force attacks
Secure Headers - CSP, HSTS, X-Frame-Options
Session Security - HTTPOnly, Secure, SameSite cookies
Input Validation - WTForms validators
SQL Injection Prevention - SQLAlchemy ORM
XSS Protection - Jinja2 auto-escaping
Audit Logging - Complete activity tracking

📊 API Endpoints

Authentication

POST /login - User login
POST /signup - User registration
GET /logout - User logout
POST /forgot-password - Password reset request
POST /reset-password - Password reset

Medicines

GET /medicines/ - List user medicines
POST /medicines/add - Add new medicine
GET /medicines/edit/<id> - Edit medicine
POST /medicines/delete/<id> - Delete medicine
GET /api/medicines - API endpoint for medicines

Admin

GET /admin/dashboard - Admin dashboard
GET /admin/users - User management
GET /admin/medicines - All medicines view
GET /admin/manufacturers - Manufacturer management
GET /admin/categories - Category management
GET /admin/audit-logs - Audit logs
GET /admin/system-status - System health

AI Assistant

POST /medication-assistant - AI chat endpoint

🧪 Testing

# Run tests (when implemented)
pytest

# Check code coverage
pytest --cov=app

# Lint code
flake8 app.py

📦 Deployment

Production Checklist

Set FLASK_ENV=production in .env
Set DEBUG=False
Use strong SECRET_KEY
Enable SESSION_COOKIE_SECURE=True (HTTPS only)
Configure production database
Set up Redis for caching
Configure email/SMS services
Enable HTTPS with SSL certificate
Set up automated backups
Configure monitoring and logging

Deployment Options

Option 1: Traditional Server

# Install gunicorn
pip install gunicorn

# Run with gunicorn
gunicorn -w 4 -b 0.0.0.0:5000 app:app

Option 2: Docker

# Create Dockerfile
FROM python:3.9-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
CMD ["gunicorn", "-w", "4", "-b", "0.0.0.0:5000", "app:app"]

Option 3: Cloud Platforms

Heroku
AWS Elastic Beanstalk
Google Cloud Run
Azure App Service
DigitalOcean App Platform

🤝 Contributing

Contributions are welcome! Please follow these steps:

Fork the repository
Create a feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

Coding Standards

Follow PEP 8 style guide
Write descriptive commit messages
Add comments for complex logic
Update documentation
Test your changes

🐛 Troubleshooting

Common Issues

Database Connection Error:

Solution: Check MySQL is running and credentials in .env are correct

Email Not Sending:

Solution: Verify Gmail app password and enable "Less secure app access"

Redis Connection Failed:

Solution: Application falls back to SimpleCache automatically

AI Assistant Not Working:

Solution: Verify GEMINI_API_KEY is set correctly in .env

Port Already in Use:

# Windows
netstat -ano | findstr :5000
taskkill /PID <PID> /F

# Linux/Mac
lsof -ti:5000 | xargs kill -9

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Your Name

GitHub: @yourusername
Email: your.email@example.com

🙏 Acknowledgments

Flask framework and community
Bootstrap for UI components
Font Awesome for icons
Google Gemini for AI capabilities
Twilio for SMS services
All contributors and users

📞 Support

For support, email support@mediguard.com or open an issue on GitHub.

🗺️ Roadmap

Version 2.0 (Planned)

Version 1.5 (In Progress)

Made with ❤️ for better medication management

Name		Name	Last commit message	Last commit date
config		config
scripts		scripts
services		services
static/uploads		static/uploads
templates		templates
.env.example		.env.example
.gitignore		.gitignore
README.md		README.md
app.py		app.py
forms.py		forms.py
requirements.txt		requirements.txt
sms_templates.py		sms_templates.py

Latest commit

History

Folders and files

Repository files navigation