MediTracked is a comprehensive, AI-powered healthcare management system designed for modern healthcare institutions. This advanced platform includes patient tracking, appointment management, telemedicine capabilities, AI health analytics, and comprehensive clinical workflows.
- Advanced User & Role Management: Patient, doctor, receptionist, and admin roles with granular permissions
- Comprehensive Patient Management: Complete patient profiles, medical history, treatment tracking
- Smart Appointment System: Intelligent scheduling with availability checking and conflict resolution
- Digital Treatment Records: Electronic health records with integrated prescription management
- Advanced Notification System: Multi-channel notifications (email, SMS, push) with templates
- Video Consultations: HD video/audio calls with screen sharing capabilities
- Real-time Chat: Secure messaging during consultations with file sharing
- Session Recording: Automatic session recording for compliance and review
- Virtual Waiting Rooms: Organized patient queues for teleconsultations
- Multi-device Support: Desktop, tablet, and mobile compatibility
- Symptom Analysis: AI-driven symptom checker with health recommendations
- Drug Interaction Detection: Comprehensive medication safety checking
- Health Risk Assessment: Predictive analytics for patient health risks
- Personalized Health Insights: AI-generated health recommendations
- Clinical Decision Support: Evidence-based treatment suggestions
- Real-time Dashboard: Comprehensive analytics with interactive charts
- Performance Metrics: Hospital efficiency and patient outcome tracking
- Predictive Analytics: AI-powered forecasting for resource planning
- Custom Reports: Flexible reporting with multiple export formats
- Data Visualization: Interactive charts and graphs for clinical insights
- Multi-language Support: Turkish, English, Arabic, German, French
- Medical Terminology Database: Standardized medical terms across languages
- Responsive Design: Mobile-first approach with full responsive layout
- Accessibility Features: WCAG compliant with screen reader support
- RESTful API: Complete mobile app integration support
- Cross-platform Mobile: iOS and Android compatibility
- Offline Capabilities: Critical features available offline
- Push Notifications: Real-time mobile notifications
- Secure Authentication: JWT-based security with multi-factor authentication
- Python 3.9+
- Node.js 16+ (for development)
- Redis (for real-time features)
- PostgreSQL (recommended for production)
-
Clone the repository:
git clone https://github.com/your-org/meditracked.git cd meditracked -
Create virtual environment:
python -m venv venv source venv/bin/activate # Unix/Mac # or venv\Scripts\activate # Windows
-
Install dependencies:
pip install -r requirements.txt
-
Environment configuration:
cp .env.example .env # Edit .env file with your configuration -
Database setup:
python manage.py manage_migrations python manage.py setup_meditracked --all
-
Start the development server:
python manage.py runserver
-
Start Redis (for real-time features):
redis-server
For production deployment, see our Deployment Guide.
After running the setup command, you'll have these test accounts:
| Username | Password | Role | Description |
|---|---|---|---|
admin |
admin123 |
Administrator | Full system access |
dr_sarah |
doctor123 |
Doctor (Cardiology) | Sample cardiologist |
dr_michael |
doctor123 |
Doctor (Neurology) | Sample neurologist |
dr_emma |
doctor123 |
Doctor (Pediatrics) | Sample pediatrician |
receptionist |
receptionist123 |
Receptionist | Front desk staff |
patient_john |
patient123 |
Patient | Sample patient |
patient_jane |
patient123 |
Patient | Sample patient |
core/- Core functionality, analytics, AI featuresusers/- User management and authenticationappointments/- Appointment scheduling and managementtreatments/- Medical treatments and prescriptionstelemedicine/- Video consultations and remote care
- Analytics Engine (
core/analytics.py) - Real-time data analysis - AI Health Assistant (
core/ai_features.py) - ML-powered health insights - Mobile API (
core/mobile_api.py) - REST API for mobile apps - Notification System (
core/models_notifications.py) - Multi-channel notifications - Internationalization (
core/models_i18n.py) - Multi-language support
# Database
DATABASE_URL=postgresql://user:pass@localhost/meditracked
# AI Services
OPENAI_API_KEY=your_openai_key
HUGGINGFACE_API_KEY=your_hf_key
# Email Configuration
EMAIL_BACKEND=django.core.mail.backends.smtp.EmailBackend
EMAIL_HOST=smtp.gmail.com
EMAIL_PORT=587
EMAIL_USE_TLS=True
EMAIL_HOST_USER=your-email@gmail.com
EMAIL_HOST_PASSWORD=your-app-password
# Security
SECRET_KEY=your-secret-key
DEBUG=False
ALLOWED_HOSTS=yourdomain.com,www.yourdomain.com
# Redis (for real-time features)
REDIS_URL=redis://localhost:6379/0Enable/disable features in settings.py:
AI_SETTINGS = {
'ENABLE_AI_FEATURES': True,
'SYMPTOM_ANALYSIS_ENABLED': True,
'DRUG_INTERACTION_CHECK': True,
'HEALTH_RISK_ASSESSMENT': True,
}
TELEMEDICINE_SETTINGS = {
'MAX_SESSION_DURATION': 120, # minutes
'RECORDING_ENABLED': True,
'AUTO_END_SESSION_AFTER': 150,
}# Get API token
curl -X POST http://localhost:8000/core/api/auth/login/ \
-H "Content-Type: application/json" \
-d '{"username": "your_username", "password": "your_password"}'
# Use token in requests
curl -H "Authorization: Token your_token_here" \
http://localhost:8000/core/api/dashboard/GET /core/api/dashboard/- User dashboard dataGET /core/api/appointments/- User appointmentsPOST /core/api/appointments/- Create appointmentGET /core/api/health-summary/- Health summaryPOST /core/api/ai/symptom-check/- AI symptom analysisGET /telemedicine/- Telemedicine sessionsPOST /telemedicine/schedule/- Schedule teleconsultation
# Run all tests
python manage.py test
# Run specific app tests
python manage.py test telemedicine
python manage.py test core.tests.test_ai_features
# Run with coverage
coverage run --source='.' manage.py test
coverage report# Create migrations for new models
python manage.py manage_migrations
# Reset development database
python manage.py manage_migrations --reset
python manage.py setup_meditracked --all
# Generate sample data
python manage.py setup_meditracked --sample-data
# Check system health
python manage.py check --deploy- Schedule Session: Doctor or patient schedules a teleconsultation
- Join Session: Both parties join via video link
- Consultation: Video/audio call with real-time chat and file sharing
- Documentation: Session notes, prescriptions, and follow-up plans
- Recording: Automatic session recording for compliance
- Symptom Input: Patient describes symptoms to AI assistant
- Analysis: AI analyzes symptoms and medical history
- Recommendations: Evidence-based health recommendations
- Risk Assessment: Identification of potential health risks
- Doctor Referral: Automatic referral suggestions when needed
- Real-time Metrics: Live hospital performance indicators
- Predictive Analytics: AI-powered forecasting and insights
- Custom Reports: Flexible reporting with multiple formats
- Data Export: PDF, Excel, CSV export capabilities
- Multi-factor Authentication (MFA)
- Role-based Access Control (RBAC)
- Data Encryption at rest and in transit
- HIPAA Compliance features
- Audit Logging for all critical actions
- Session Management with automatic timeout
- API Rate Limiting and DDoS protection
- Symptom analysis with medical knowledge base
- Drug interaction detection using pharmaceutical databases
- Predictive health risk modeling
- Personalized treatment recommendations
- Clinical decision support tools
- WebRTC-based video calling
- Screen sharing for consultations
- Real-time chat with file sharing
- Session recording and playback
- Virtual waiting rooms
- Multi-device support
- Real-time dashboard with live metrics
- Interactive charts and visualizations
- Predictive analytics for resource planning
- Custom report generation
- Data export in multiple formats
- Performance benchmarking
- HIPAA - Health Insurance Portability and Accountability Act
- GDPR - General Data Protection Regulation
- HL7 FHIR - Healthcare data exchange standards
- ICD-10 - International Classification of Diseases
- SNOMED CT - Systematized Nomenclature of Medicine Clinical Terms
We welcome contributions! Please see our Contributing Guide for details.
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests for new functionality
- Submit a pull request
This project is licensed under the MIT License - see the LICENSE file for details.
- Django & Django REST Framework communities
- OpenAI for AI capabilities
- WebRTC for real-time communication
- Chart.js for data visualization
- Bootstrap for responsive design
MediTracked - Transforming Healthcare Through Technology
For more information, visit www.meditracked.com
|------|-------------|
| Patient | - Can view their own appointments
- Can view their own treatment history
- Can update their own profile |
| Doctor | - Can view their own appointments
- Can add treatments and prescriptions to their patients
- Can view information about their patients |
| Receptionist | - Can create patient records
- Can create and update appointments
- Can view all patients and appointments |
| Admin | - Full system access
- Can manage all users
- Can view and edit all data |
- Django 5.2
- SQLite (for development)
- Bootstrap 5
- JavaScript
This project is licensed under the Apache 2.0 License.
Please get in touch with any questions or feedback.
Developer: K. Umut Araz