Review travail d'Adrien + ajouts (un début de contexte et les questions)

documents/requirements/Cahier_des_Charges.tex

@@ -25,13 +25,17 @@ Cahier des charges du projet de gestion de distribution d'eau en Haïti, mémoir
   \begin{description} %ToDo : trouver un moyen de display ça beau, je sais pas si c'est l'idéal. Aussi y'a pas moyen d'auto-sort par ordre alphabétique ?
     %ToDo 2 : définir les termes
     %ToDo 3 : ordonner alphabétiquement le truc si on peut pas le faire automatiquement
-    %ToDo 4 : check le document résuglièrement et ajouter tous les termes qui peuvent prêter à confusion
+    %ToDo 4 : check le document régulièrement et ajouter tous les termes qui peuvent prêter à confusion
     \item[CAEPA]
     \item[DINEPA]
     \item[HTG]
     \item[Utilisateur]
-    \item[Application]
+    \item[Application ou système]
     \item[Permission]
+    \item[éléments du réseau de distribution de type "sortie"] %TODO change in text
+    \item[Profils]
+    \item[Client]
+    \item[Citizen science]
     \item[Réseau]
     \item[Fontaine]
     \item[Kiosque]
@@ -40,30 +44,41 @@ Cahier des charges du projet de gestion de distribution d'eau en Haïti, mémoir
   \end{description}
 \section{Introduction}
 % Contexte de l'application
+Dans chaque section du document, nous avons ajouté une partie "Questions et remarques", où nous demandons à Protos ou aux intervenant Haïtiens de donner des précisions ou leur avis car nous estimons n'avoir pas assez d'informations ou de connaissances sur le sujet. Ce sont les points sur lesquels nous avons le plus besoin d'aide et dont il faut discuter en priorité, mais toute remarque venant des clients sera prise en compte et appréciée.
 \section{Types d'utilisateurs}
+Cette section du document contient une description détaillée de tous les types d'utilisateurs qui, à terme, interagiront avec l'application. Nous détaillons aussi ce que ceux-ci pourront faire avec l'application, pour vous donner un contexte familier.
+
   \begin{description}
-    \item[Gestionnaire de zone] est un utilisateur qui gère un groupe de gestionnaires de fontaines. Il dispose des mêmes permissions que les gestionnaires de fontaines dans sa zone et peut donc agir comme un gestionnaire de fontaine. En plus, le gestionnaire de zone peut créer des gestionnaires de fontaines et des techniciens/plombiers et leur assigner des permissions sur les éléments du réseau.
+    \item[Gestionnaire de fontaines] est un utilisateur auquel on assigne un ou plusieurs éléments du réseau de distribution de type "sortie" (fontaine, kiosque, réservoir, branchement individuel) dont il est responsable.
+    Il gère également la gestion des consommateurs d'eau dans sa zone et les ajoute/supprime/modifie dans le système lorsque c'est nécessaire (naissance, décès, déménagement).
+    Il utilise l'application pour signaler des problèmes et ainsi pouvoir en avertir le technicien/plombier et sa hiérarchie. Chaque mois, le gestionnaire de fontaines utilise l'application pour déposer un rapport. Ce rapport contient, pour chaque élément du réseau sous sa responsabilité, les quantités d'eau distribuées (si un compteur est présent), les recettes (HTG), l'état (en service, hors service). Une section générale (une seule fois par rapport) déclare également les heures et jours de service du gestionnaire de fontaines.
+
+    \emph{Exemple : une personne chargée de gérer un point d'eau pourrait être un gestionnaire de fontaine. Il peut ainsi utiliser l'application pour envoyer mensuellement les données, ajouter les utilisateurs lorsque nécessaire et déclarer les problèmes.}
+
+    \item[Gestionnaire de zone] est un utilisateur qui gère un groupe de gestionnaires de fontaines. Il dispose des mêmes permissions que les gestionnaires de fontaines dans sa zone et peut donc effectuer les mêmes actions avec l'application. En plus de ça, le gestionnaire de zone peut créer des profils de gestionnaires de fontaines et de techniciens/plombiers et leur assigner des permissions sur les éléments du réseau. %Meh
 
     \emph{Exemple 1 : Protos ou la DINEPA peuvent être assignés en tant que gestionnaires de zone ayant les accès sur tous les systèmes et agir en tant que gestionnaires généraux de tout le système. Ils peuvent donc consulter toutes les informations rapportées par les autres utilisateurs.}
 
     \emph{Exemple 2 : un CAEPA pourrait être assigné en tant que gestionnaire de zone et avoir accès aux infrastructures du réseau de distribution dans sa zone géographique et ainsi consulter les informations et les modifier pour venir en aide aux gestionnaires de fontaine.}
 
-    \item[Gestionnaire de fontaines] est un utilisateur auquel on assigne un ou plusieurs éléments du réseau de distribution de type "sortie" (fontaine, kiosque, réservoir, branchement individuel) dont il est responsable.
-    Il est responsable de la gestion des utilisateurs dans sa zone et les ajoute/supprime dans le système lorsque c'est nécessaire (naissance, décès, déménagement).
-    Il utilise l'application pour signaler des problèmes et ainsi pouvoir avertir le technicien/plombier et sa hiérarchie. Chaque mois, le gestionnaire de fontaines utilise l'application pour déposer un rapport. Ce rapport contient, pour chaque élément sous la responsabilité du gestionnaire de fontaines, les quantités d'eau distribuées, les recettes (HTG), l'état (en service, hors service). Une section générale (une seule fois par rapport) déclare également les heures et jours de service du gestionnaire de fontaines.
+    \item[Consommateur] est un utilisateur du réseau de distribution d'eau, mais dans un premier temps, n'aura pas accès à l'application. Dans le futur, l'additiond d'un volet \emph{Citizen science} lui permettra de signaler un problème sur le réseau, de consulter l'état de celui-ci et éventuellement d'autres fonctionnalités, qui seront détaillées par la suite.
 
-    \emph{Exemple : une personne chargée de gérer un point d'eau pourrait être un gestionnaire de fontaine. Il peut ainsi utiliser l'application pour envoyer mensuellement les données, ajouter les utilisateurs lorsque nécessaire et déclarer les problèmes.}
-
-    \item[Technicien/Plombier] est un utilisateur auquel on assigne des éléments du réseau de distribution (fontaine, réservoir, prise individuelle, etc). Chaque technicien/plombier utilise l'application pour voir les problèmes déclarés par les gestionnaires de fontaines. Il peut utiliser l'application pour répondre aux demandes d'intervention pour demander plus d'informations ou proposer une solution si le déplacement n'est pas nécessaire. Il peut modifier l'état d'un probème et le marquer en cours de résolution ou résolu une fois l'intervention terminée.
+    \item[Technicien/Plombier] est un utilisateur auquel on assigne des éléments du réseau de distribution (fontaine, réservoir, prise individuelle, etc). Chaque technicien/plombier utilise l'application pour voir les problèmes déclarés par les autres utilisateurs (gestionnaires de fontaine, de zone ou consommateurs quand le volet \emph{Citizen science} sera ajouté). Il peut utiliser l'application pour répondre aux demandes d'intervention pour demander plus d'informations ou proposer une solution si le déplacement n'est pas nécessaire. Il peut modifier l'état d'un problème, demander des précisions et le marquer en cours de résolution ou résolu une fois l'intervention terminée.
 
     \emph{Exemple : un technicien plombier démarrant sa journée peut consulter l'application et voir quels sont les problèmes qui requièrent son attention. Il peut dialoguer avec les gestionnaires et modifier l'état des problèmes afin qu'à terme le réseau fonctionne sans problème.}
+
   \end{description}
-  \subsection{Questions}
+  \subsection{Questions et remarques}
   % Questions
-  % Cas pratique de la sécurité de l'administrateur
+  \begin{itemize}
+    \item Le contenu du rapport mensuel d'un gestionaire de fontaine sera un élément essentiel de l'application. S'il manque quoique ce soit, précisez-le nous au plus vite.
+    \item Un gestionnaire de zone dont la zone recouvre tous les systèmes peut être vu comme un administrateur et aurait dès lors accès en lecture et écriture à toutes les données de l'application. Par erreur ou malveillance, il pourrait en effacer ou modifier certaines, faussant l'ensemble. Une pratique courante en informatique pour gérer ce problème potentiel est d'archiver les données : elles ne sont ainsi jamais vraiment modifiées ou effacées et peuvent être restaurées à l'état précédent. Est-ce une fonctionnalité que vous souhaitez pour l'application, ou n'est-ce pas nécéssaire de s'en occuper ? Si ce modèle d'archivage ne vous convient pas, souhaitez-vous autre chose ?
+    \item L'utilisateur "technicien/plombier" et les fonctionnalités qui lui seront associées sont une interprétation de notre part car il nous semblait pratique de pouvoir centraliser la gestion du réseau de distribution entièrement au sein de l'application. Cela vous semble-t-il utile d'avoir une interface destinée au technicien ?
+  \end{itemize}
+
 \section{Fonctionnalités}
 % Liste exhaustive des fonctionnalités de l'application
-  \subsection{Questions}
+  \subsection{Questions et remarques}
 \section{Exemples principaux}
   \subsection{Fonctionnement général}
     \begin{figure}[H]
@@ -98,8 +113,9 @@ Cahier des charges du projet de gestion de distribution d'eau en Haïti, mémoir
 
 \section{Besoins non-fonctionnels}
 % Explication des besoins non-fonctionnels
-\section{Fonctionnement de la recherche de fonctionnalités}
+\section{Approche utilisée dans la création de ce document}
 % D'où viennent les idées
+% PS au lecteur : si vous voyez une autre source d'idées envoyez là !
 \section{Choix technolgiques}
 % Point de vue purement "positif pour le projet" sans termes techniques
 \end{document}