Guide d'Installation et d'Utilisation - Système de Gestion de Vaccination

Table des matières

1. Introduction
2. Prérequis
3. Installation
4. Configuration de la base de données
5. Démarrage de l'application
6. Utilisation de l'application
7. Fonctionnalités principales
8. Dépannage

Introduction

Ce système de gestion de vaccination permet aux centres hospitaliers provinciaux de gérer efficacement les patients, les vaccinations et les stocks de vaccins. L'application offre une interface intuitive pour enregistrer de nouveaux patients, gérer les vaccinations, suivre les stocks de vaccins et visualiser des statistiques pertinentes.

Prérequis

• Python 3.8 ou supérieur
• Django 5.0 ou supérieur
• SQLite (par défaut) ou MySQL (optionnel)
• Pip (gestionnaire de paquets Python)
• Environnement virtuel Python (recommandé)

Installation

1. Cloner le repository

git clone https://github.com/votre-username/centre-vaccination.git
cd centre-vaccination

2. Créer un environnement virtuel

python -m venv env
source env/bin/activate  # Linux/Mac
# ou
env\Scripts\activate  # Windows

3. Installer les dépendances

pip install -r requirements.txt

4. Configuration de l'environnement

# Copier le fichier d'exemple
cp .env.example .env

# Modifier le fichier .env avec vos paramètres
# IMPORTANT: Générer une nouvelle clé secrète pour la production

5. Effectuer les migrations

python manage.py makemigrations
python manage.py migrate

6. Créer un superutilisateur

python manage.py createsuperuser

7. Charger les données de test (optionnel)

python load_initial_data.py

8. Lancer le serveur de développement

python manage.py runserver

Structure du Projet

• vaccination/ : Application principale
  • models.py : Définition des modèles de données
  • views.py : Logique de l'application
  • urls.py : Configuration des URLs
  • admin.py : Configuration de l'interface d'administration
  • templates/ : Templates HTML
  • static/ : Fichiers statiques (CSS, JS, images)

Variables d'Environnement

Le projet utilise des variables d'environnement pour la configuration. Copiez le fichier .env.example vers .env et configurez les variables suivantes :

• DJANGO_SECRET_KEY : Clé secrète Django (à changer en production)
• DJANGO_DEBUG : Mode debug (True/False)
• DJANGO_ALLOWED_HOSTS : Hôtes autorisés (séparés par des virgules)
• DJANGO_DB_ENGINE : Moteur de base de données
• DJANGO_DB_NAME : Nom de la base de données
• DJANGO_DB_USER : Utilisateur de la base de données (si MySQL)
• DJANGO_DB_PASSWORD : Mot de passe de la base de données (si MySQL)
• DJANGO_DB_HOST : Hôte de la base de données (si MySQL)
• DJANGO_DB_PORT : Port de la base de données (si MySQL)

Technologies Utilisées

• Django
• Bootstrap
• SQLite (base de données par défaut)

Sécurité

• Ne jamais commiter le fichier .env contenant les variables d'environnement
• Toujours utiliser des variables d'environnement pour les informations sensibles
• Changer la clé secrète Django en production
• Désactiver le mode DEBUG en production

Contribution

Les contributions sont les bienvenues ! N'hésitez pas à :

1. Fork le projet
2. Créer une branche pour votre fonctionnalité
3. Commiter vos changements
4. Pousser vers la branche
5. Ouvrir une Pull Request

Configuration de la base de données

Option 1 : Utiliser SQLite (par défaut, pour développement)

Aucune configuration supplémentaire n'est nécessaire. Django utilisera SQLite par défaut.

Option 2 : Utiliser MySQL (recommandé pour production)

1. Créez une base de données MySQL :

   mysql -u root -p < database.sql

2. Modifiez les paramètres de connexion à la base de données dans le fichier vaccination_center/settings.py :

   DATABASES = {
       'default': {
           'ENGINE': 'django.db.backends.mysql',
           'NAME': 'vaccination_db',
           'USER': 'votre_utilisateur',
           'PASSWORD': 'votre_mot_de_passe',
           'HOST': 'localhost',
           'PORT': '3306',
       }
   }

3. Installez le pilote MySQL pour Python :

   pip install mysqlclient

Démarrage de l'application

1. Appliquez les migrations pour créer les tables dans la base de données :

   python manage.py migrate

2. Créez un superutilisateur pour accéder à l'interface d'administration :

   python manage.py createsuperuser

3. Démarrez le serveur de développement :

   python manage.py runserver

4. Accédez à l'application dans votre navigateur web à l'adresse :

   http://127.0.0.1:8000
   

5. Pour accéder à l'interface d'administration :

   http://127.0.0.1:8000/admin
   

Utilisation de l'application

Gestion des patients

• Liste des patients : Accédez à la liste complète des patients enregistrés.
• Ajouter un patient : Enregistrez un nouveau patient avec ses informations personnelles.
• Modifier un patient : Mettez à jour les informations d'un patient existant.
• Supprimer un patient : Retirez un patient de la base de données.

Gestion des vaccinations

• Liste des vaccinations : Consultez toutes les vaccinations effectuées.
• Nouvelle vaccination : Enregistrez une nouvelle vaccination pour un patient.
• Détails d'une vaccination : Consultez les informations détaillées d'une vaccination.
• Modifier une vaccination : Mettez à jour les informations d'une vaccination existante.

Gestion des stocks de vaccins

• Liste des vaccins : Consultez tous les vaccins disponibles et leur niveau de stock.
• Ajouter un vaccin : Enregistrez un nouveau type de vaccin.
• Gérer le stock : Ajoutez ou retirez des doses d'un vaccin spécifique.
• Suivi des stocks : Visualisez l'état des stocks et les alertes de rupture.

Tableau de bord

• Statistiques : Consultez des graphiques et statistiques sur les vaccinations.
• Répartition par type de vaccin : Visualisez la distribution des vaccinations par type de vaccin.
• Évolution temporelle : Suivez l'évolution des vaccinations au fil du temps.
• Répartition par sexe : Analysez la distribution des vaccinations par sexe des patients.

Fonctionnalités principales

1. Gestion complète des patients

   • Enregistrement des informations personnelles
   • Suivi de l'historique des vaccinations

2. Gestion des vaccinations

   • Enregistrement des vaccinations avec date, personnel médical et vaccin utilisé
   • Suivi automatique des stocks de vaccins

3. Gestion du personnel médical

   • Médecins, infirmiers et aides-soignants
   • Attribution des rôles dans le processus de vaccination

4. Gestion des stocks de vaccins

   • Suivi en temps réel des niveaux de stock
   • Alertes de rupture de stock
   • Gestion des approvisionnements

5. Tableau de bord et statistiques

   • Visualisations graphiques des données avec Chart.js
   • Indicateurs clés de performance
   • Suivi de l'évolution des vaccinations

Dépannage

Problèmes de connexion à la base de données

• Vérifiez que MySQL est en cours d'exécution.
• Assurez-vous que les identifiants de connexion sont corrects dans settings.py.
• Vérifiez que la base de données vaccination_db existe.

L'application ne démarre pas

• Vérifiez que toutes les dépendances sont installées : pip install -r requirements.txt
• Assurez-vous que les migrations ont été appliquées : python manage.py migrate
• Vérifiez les logs d'erreur pour plus d'informations.

Problèmes d'affichage

• Assurez-vous que vous utilisez un navigateur moderne et à jour.
• Videz le cache de votre navigateur si nécessaire.
• Vérifiez votre connexion internet pour le chargement des ressources externes (Bootstrap, Chart.js).

Pour toute assistance supplémentaire, veuillez contacter le support technique.