AmarHealth - Your Complete Healthcare Companion

Team Members

• Md. Mehedi Hasan Parvez - mehediparvez (Team Leader)
• Faysal Ahammed - Faysal0009
• Ishtiak Ahmed - YEAD007

Mentor

• Mohammad Ahad - maahad767

Project Description

AmarHealth is a comprehensive healthcare management platform designed to empower users with complete control over their medical data. Our solution simplifies medical record management, and provides AI-powered insights for better healthcare decision-making.

Project Structure

The application is built with a modern tech stack and follows a microservices architecture:

Backend

• Django REST Framework: Core API services for user management, medical records
• MySQL: Primary database
• Redis: Caching and background task management
• Celery: Asynchronous task processing

Frontend

• React: Single-page application with modular component structure
• Redux Toolkit: State management with RTK Query for API interactions
• TailwindCSS: Utility-first CSS framework for styling

OCR Service

• FastAPI: High-performance OCR and document processing service
• AI Processing: Integration with OpenAI/Gemini models for medical document analysis

DevOps

• Docker & Docker Compose: Containerization
• Azure Container Apps: Cloud deployment platform
• GitHub Actions: CI/CD pipeline automation

Features

User Management

• Secure account creation and authentication
• Profile management and preferences
• Two-factor authentication

Medical Records

• Health issue tracking
• Symptom recording and monitoring
• Document management with smart OCR processing
• Lab result tracking and visualization

Medication Management

• Medication tracking and reminders
• Prescription management
• Refill notifications

Clinician Portal

• Provider profiles and specializations
• Review system and ratings
• Availability management

OCR & AI Features

• Automated extraction of test results from uploaded documents
• Parameter classification and abnormality detection
• Trend analysis and visualization

Getting Started

1. Clone the repository

   git clone https://github.com/yourusername/web-wizards.git
   cd web-wizards

2. Install Dependencies

   # Backend
   cd backend
   pip install -r requirements.txt
   
   # Frontend
   cd ../frontend
   npm install
   
   # OCR Service
   cd ../ocr_service
   pip install -r requirements.txt

3. Set Up Environment Variables

   • Create .env files for each service based on the provided examples

4. Start Development Servers

   # Using Docker Compose
   docker-compose -f docker-compose.dev.yml up

Development Guidelines

1. Create feature branches from the dev branch

   git checkout -b feature/your-feature dev

2. Make small, focused commits with descriptive messages

   git commit -m "feat: implement lab result visualization component"

3. Follow the migrations guide for database changes

   git checkout migrations
   # Make model changes and create migrations
   python manage.py makemigrations

4. Create pull requests for review

Documentation

• API Documentation
• Development Setup
• Database Schema
• OCR Service Integration
• Contribution Guidelines

Resources

• Project Documentation
• Development Setup
• Contributing Guidelines
• Migrations Guide