💊 MediTrack

Système de Suivi de Médicaments

---

📌 Présentation

MediTrack est une application web développée avec Django permettant aux utilisateurs de suivre leur prise quotidienne de médicaments.
Elle propose une interface simple et intuitive pour :

• Gérer les médicaments
• Planifier les doses
• Suivre l’adhérence au traitement médical

---

✨ Fonctionnalités

🧾 Gestion des Médicaments

• Ajout, modification et suppression de médicaments
• Informations détaillées : nom, dosage, instructions
• Dates de début et de fin optionnelles

⏰ Suivi des Doses

• Tableau de bord quotidien par période :
  • Matin
  • Midi
  • Soir
  • Coucher
• Enregistrement manuel du statut :
  • Prise
  • Manquée
  • Sautée
• Marquage automatique des doses manquées

📊 Historique & Statistiques

• Historique complet avec filtres
• Statistiques d’adhérence :
  • Pourcentage global
  • Tendance hebdomadaire

🔐 Authentification & Sécurité

• Inscription et connexion sécurisées
• Données isolées par utilisateur
• Interface d’administration pour les gestionnaires

🎨 Interface Utilisateur

• Design professionnel (Bootstrap – thème vert)
• Interface responsive (mobile & desktop)
• Notifications pour les actions importantes

---

🛠️ Architecture Technique

📁 Structure du Projet

meditrack_project/
├── meditrack/
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
├── tracker/
│   ├── models.py
│   ├── views.py
│   ├── forms.py
│   ├── urls.py
│   ├── admin.py
│   ├── templates/
│   └── static/
├── manage.py
└── db.sqlite3


---

🧩 Modèles de Données

👤 Utilisateur

Modèle User intégré de Django

Gestion de l’authentification et du profil


💊 Médicament (Medication)

Associé à un utilisateur

Nom, dosage, instructions

Dates de début et de fin


🕒 Dose

Liée à un médicament et à un utilisateur

Heure prévue et heure réelle

Statut : En attente, Prise, Manquée, Sautée

Notes optionnelles



---

🚀 Installation (Développement)

1️⃣ Cloner le projet

git clone https://github.com/your-username/meditrack.git
cd meditrack

2️⃣ Environnement virtuel

# Windows
python -m venv venv
venv\Scripts\activate

# Linux / macOS
python -m venv venv
source venv/bin/activate

3️⃣ Installer les dépendances

pip install -r requirements.txt

4️⃣ Variables d’environnement

cp .env.example .env

DJANGO_SECRET_KEY=your-secret-key-here
DJANGO_DEBUG=True
DJANGO_ALLOWED_HOSTS=localhost,127.0.0.1
CSRF_TRUSTED_ORIGINS=http://localhost:8000,http://127.0.0.1:8000

5️⃣ Appliquer les migrations

python manage.py migrate

6️⃣ Créer un superutilisateur

python manage.py createsuperuser

7️⃣ Lancer le serveur

python manage.py runserver


---

🔒 Sécurité

Ne jamais commiter le fichier .env

Générer une nouvelle SECRET_KEY pour chaque installation

Toujours définir DEBUG=False en production

Utiliser HTTPS en production

Sauvegardes régulières de la base de données



---

🤝 Contribution

1. Fork le projet


2. Créer une branche :

git checkout -b feature/AmazingFeature


3. Commit :

git commit -m "Add AmazingFeature"


4. Push :

git push origin feature/AmazingFeature


5. Ouvrir une Pull Request




---

📄 Licence

Projet académique / pédagogique.