Code Explanation

The project is built on the Django framework, which follows the Model-View-Controller (MVC) architecture. Let’s explore some key components of the code:

1. User Roles and Authentication:

Each user role is managed with Django’s built-in authentication system. The roles include specific permissions and access levels.

from django.contrib.auth.models import AbstractUser

class CustomUser(AbstractUser):
    role = models.CharField(max_length=20, choices=[
        ('Administrator', 'Administrator'),
        ('Pharmacist', 'Pharmacist'),
        ('Doctor', 'Doctor'),
        ('Receptionist', 'Receptionist'),
        ('Patient', 'Patient'),
    ])

This CustomUser model extends Django’s default user model to include a role field, which defines the type of user.

2. Managing Medications:

Administrators and pharmacists can add and manage drug inventories. Below is a snippet for managing drugs:

class Drug(models.Model):
    name = models.CharField(max_length=100)
    category = models.ForeignKey(DrugCategory, on_delete=models.CASCADE)
    quantity = models.IntegerField()
    price = models.FloatField()

    def __str__(self):
        return self.name

This model defines the drug details, including its name, category, quantity, and price.

3. Prescription Management:

Doctors can create prescriptions for patients. Pharmacists can view and dispense medications based on these prescriptions.

class Prescription(models.Model):
    patient = models.ForeignKey(CustomUser, on_delete=models.CASCADE, limit_choices_to={'role': 'Patient'})
    doctor = models.ForeignKey(CustomUser, on_delete=models.CASCADE, limit_choices_to={'role': 'Doctor'})
    date = models.DateField(auto_now_add=True)

    def __str__(self):
        return f"Prescription for {self.patient.username} by Dr. {self.doctor.username}"

The prescription model links patients to their doctors and includes a timestamp for tracking.

4. Dispensing Medications:

Pharmacists dispense medications and update stock levels accordingly.

class Dispense(models.Model):
    prescription = models.ForeignKey(Prescription, on_delete=models.CASCADE)
    drug = models.ForeignKey(Drug, on_delete=models.CASCADE)
    quantity = models.IntegerField()

    def save(self, *args, **kwargs):
        # Update stock quantity
        self.drug.quantity -= self.quantity
        self.drug.save()
        super().save(*args, **kwargs)

The Dispense model ensures that stock levels are automatically updated whenever a medication is dispensed.