===============================
Moteur de recherche de patients
===============================

.. |date| date:: %d/%m/%Y à %H:%M

:Auteur: `Fidinirina RANDRIA`_
:Version: 3.4.0
:Date: |date|
:Copyright: `Voozanoo / EpiConcept`__.

__ http://www.voozanoo.net


Le moteur de recherche de patient est la fonctionnalité principale proposeée sur la page d'accueil.
On peut aborder son utilisation de deux manières différentes :

* Pour retrouver un patient qui à priori existe dans la base de données.
* Pour vérifier si un patient existe déjà dans la base avant le démarrage d'une nouvelle enquête.

Dans le cas du démarrage d'une nouvelle enquête, l'utilisation du moteur de recherche permet d'éviter
la création d'un doublon dans la base patients. Dans ce cas, il est recommandé de commencer la recherche
avec peu d'informations pour éviter les erreurs dues aux fautes de frappe (ex. : recherche avec le début
du nom et / ou le début du prénom du patient). Si ces premiers critères de recherche renvoient plusieurs
résultats, on peut alors affiner la recherche.
A l'issue de la recherche, plusieurs cas de figure peuvent se présenter :

* Le patient n'est pas connu dans la base : on est dans le cadre de la `Création d'un nouveau patient`_
* Le patient est connu dans la base :

  * S'il a un dossier actif (AVIS ou Contact), il faut conclure (clôturer) le dossier existant pour
    démarrer un nouvelle enquête
  * S'il n'a pas de dossier actif, on est dans le cadre de la `Création d'un dossier pour un patient existant`_

Formulaire de recherche
=======================

.. figure:: ../../_static/images/accueil-recherche.png
   :align: center

   *Formulaire de recherche de patients.*

Le formulaire de recherche de patients permet de rechercher par :

* Numéro du patient : le code d'identification patient unique attribué par DAMOC
* Nom : le début du nom
* Prénom : le début du prénom
* Date de naissance
* Sexe
* Dernier :abbr:`CP (Code Postal)` connu

.. note::

   Le numéro de patient permet de retrouver un patient via le moteur de recherche de manière
   unique et anonymisée. On peut retrouver ce numéro dans le :doc:`dossier Cas Index <../cas-index>`
   ou le :doc:`dossier Contact <../sujet-contact>` du patient.
   **Pour des raisons de confidentialité, il est important d'utiliser uniquement ce numéro dans les
   communications et en particulier par email**.

Résultat de recherche
=====================

.. figure:: ../../_static/images/resultats-recherche.png
   :align: center

   *Résultat de recherche.*

Le résultat de recherche est répartie dans trois listings différents.
La figure ci-dessus affiche le nombre de patients trouvés.
Chaque ligne est cliquable pour accéder directement au listing correspondant.

Sur chaque listing, on affiche le nom, prénom et date de naissance du patient.
De plus pour les listings des :abbr:`CI (Cas Index)` et des :abbr:`SC (Sujet Contact)`,
on affiche le code postal et le numéro DAMOC du patient.

De manière global, le fond gris indique un dossier inactif.

Listing des Cas Index (MALADIE, ITL -15 ans et AVIS)
----------------------------------------------------

.. figure:: ../../_static/images/listing-ci.png
   :align: center

   *Listing des Cas Index.*

Le listing permet de distinguer le type de dossier :

* Pour les tuberculoses maladies, on affiche la localisation si connue (R / ER).
* Les :abbr:`ITL (Inféction Tuberculose Latente)` (-15 ans) sont affichées en jaune.
* Les AVIS sont affichés en vert
* Le nombre de Sujets Contacts rattachés au patient est affiché en orange.
* Un clic sur le nom du patient permet d'accéder à son :doc:`dossier Cas Index <../cas-index>`.

.. _liste_SC:

Listing des Sujets Contacts
---------------------------

.. figure:: ../../_static/images/listing-sc.png
   :align: center

   *Listing des Sujet Contact.*

Sur le listing de :abbr:`SC (Sujet Contact)`, un clic sur le nom du patient permet d'accéder à
son :doc:`dossier Contact <../sujet-contact>`.
De plus, on rappelle en dessous sur fond violet son Cas Index.

Listing des patients n'ayant aucun dossier actif
------------------------------------------------

.. figure:: ../../_static/images/listing-sans-dossier.png
   :align: center

   *Listing des patients sans dossier actif.*

Sur le listing des patients n'ayant aucun dossier actif, le bouton **Créer un nouveau dossier**
permet d'atteindre la page `Création d'un dossier pour un patient existant`_.

Création d'un nouveau patient
=============================

.. figure:: ../../_static/images/nouveau-patient.png
   :align: center

   *Création d'un patient.*

Le bouton **Créer un nouveau patient** permet de créer un nouveau patient en lui rattachant un dossier
MALADIE, :abbr:`ITL (Inféction Tuberculose Latente)` (-15 ans) ou AVIS
via l'interface de `Saisie rapide`_.

.. note::

   Si on clique sur ce bouton après avoir lancé une recherche,
   les informations entrées dans le formulaire de recherche seront renseignés automatiquement
   dans le formulaire de :ref:`saisie rapide <saisie_rapide>`.

Création d'un dossier pour un patient existant
==============================================

.. figure:: ../../_static/images/nouveau-dossier.png
   :align: center

   *Création d'un dossier.*

Sur cette interface, l'utilisateur doit choisir le type du nouveau dossier
(MALADIE, :abbr:`ITL (Inféction Tuberculose Latente)` (-15 ans) ou AVIS).
Après enregistrement, on arrive directement sur la page :doc:`dossier Cas Index <../cas-index>` du patient.

.. _saisie_rapide:

Saisie rapide
=============

L'interface de saisie rapide permet saisir rapidement un dossier
:abbr:`CI (Cas Index)` ou :abbr:`SC (Sujet Contact)` pour un nouveau patient (formulaire réduit).
L'idée étant de pouvoir renseigner rapidement un dossier sans rentrer dans le détail
(ex. saisie de plusieurs dossiers papiers). Il est toujours possible ultérieurement de compléter le dossier.

A l'enregistrement, l'utilisateur est redirigé vers la page du dossier concerné.

.. _Fidinirina RANDRIA: damoc-ticket@epiconcept.fr