Ajout documents - MTES-MCT/histologe GitHub Wiki
Gestion des documents et photos d'un signalement
Sommaire
- Principes
- Ajout de documents par l'usager (FO)
- Ajout de document par les partenaires (BO)
- BO - Editer les documents et photos
- BO - Supprimer les documents et photos
Principes
Plusieurs documents peuvent être rattachés à un signalement. Les documents peuvent avoir 2 sources :
- L'usager qui les uploadent depuis le formulaire ou depuis la page de suivi
- Les agents qui les uploadent depuis le BO
Chaque document a :
- Un nom (nom du fichier)
- Un type
- Une source : le type d'utilisateur qui l'a ajouté
- Une date d'upload
Types de documents
- Situation du foyer
- Bail
- DPE
- Etat des lieux
- Diagnostic plomb amiante
- Procédure
- Mise en demeure
- Rapport de visite
- Arrêté municipal
- Arrêté préfectoral
- Saisine
- Bailleur
- Devis pour travaux
- Réponse bailleur
- Autre
Chaque photo a
- Un nom (nom du fichier)
- Un type
- Une description (désordre pour les photos situation / description pour les photos visite)
- Une source : le type d'utilisateur qui l'a ajouté
- Une date d'upload
Types de photos
- Situation
- Visite
Formats acceptés :
- PDF, ODF
- DOC, DOCX, ODT
- Images (JPG, PNG)
Poids max. par fichier: 10 Mo
Ajout de documents par l'usager (FO)
Types de document
- Situation du foyer :
- Bail
- DPE
- Etat des lieux
- Diagnostic plomb amiante
- Bailleur :
- Devis pour travaux
- Réponse bailleur
- Autre
Types de photos
- Photos rattachées à des désordres
- Autre
Ajouter un document depuis le formulaire
Lorsque l'usager ajoute un document depuis le formulaire, son type est défini par l'endroit où il est ajouté.
Exemple : si l'usager ajoute un document via le champ "Ajouter le bail" : le type du document sera "Bail".
Exemple : si l'usager ajoute une photo avec un désordre : la photo sera rattachée à ce désordre
Ajouter un document depuis la page de suivi actuelle
Flow
- Le user accède à la page de suivi
- Le user saisi un message
- Le user clique sur ajout document ou photo
- Le user sélectionne le fichier sur son appareil
- Le user envoie son message
Conséquences
- Retour à la page de suivi avec success message
Votre message a bien été envoyé. - Les documents et photos sont enregistrées avec le type "Autre" et visibles dans la partie déclaration usager du BO
- Un nouveau suivi est créé
Ajouter un document ou une photo depuis la nouvelle page de suivi
Flow document
- Le user accède à la page de suivi
- Le user saisi un message
- Le user clique sur le bouton d'ajout de document
- Le user qualifie ses doc dans la modale
- Le user enregistre la modale
- Le user envoie son message
Flow photo
- Le user accède à la page de suivi
- Le user saisi un message
- Le user clique sur le bouton d'ajout de photo
- Le user sélectionne ses photos
- Le user enregistre la modale
- Le user envoie son message
Conséquences
- Retour à la page de suivi avec success message
Votre message a bien été envoyé. - Les photos sont enregistrées avec le type "Autre" et visibles dans la partie déclaration usager du BO
- Les documents sont enregistrés avec le type sélectionné et visibles dans la partie déclaration usager du BO
- Un nouveau suivi est créé
Ajout de documents par les agents (BO)
Types de document
Les documents sont de différents types, organisés en catégories :
- Procédure
- Mise en demeure
- Rapport de visite
- Arrêté municipal
- Arrêté préfectoral
- Saisine
- Bailleur
- Devis pour travaux
- Réponse bailleur
- Autre
Ajouter des documents partenaires
Conditions
- Avoir un compte actif sur la plateforme
- Avoir le rôle agent ou supérieur
- Signalement statut en cours
- Affectation acceptée (pour les agents et admin partenaire)
Flow
- Accès au signalement
- Accès à la partie "Documents partenaires"
- Clic sur le bouton "Ajouter des documents"
- Ouverture de la modale "Ajouter des documents" qui comprend :
- Un titre
- Un message d'intro :
Ajouter un ou plusieurs documents. Pour chaque document, veuillez renseigner son type. - Un message info:
Pour ajouter des documents de type Bail, DPE, Diagnostic et Etat des lieux, rendez-vous dans la partie "Déclaration usager" - Un champ drag n drop
- Un bouton "Parcourir"
- Une zone d'action avec deux boutons : un "Annuler" et un "Valider"
- Clic sur upload (ou drag n drop des documents)
- Pour chaque document, on affiche :
- Le nom du fichier
- L'état du téléchargement
- Un menu déroulant "type" parmi lequel l'agent doit sélectionner le type du document (parmi les catégories Procédure / Bailleur / Autre)
- Une fois les champs remplis, clic sur "Valider"
Conséquences
- Fermeture de la modale, actualisation de la page signalement
- Affichage d'un success message en haut :
Les documents ont bien été ajoutés. - Les documents sont ajoutés et visibles dans la partie "Documents partenaires"
- Un suivi automatique est créé
Liste des documents partenaires
Sur la fiche du signalement, une liste des documents partenaires est disponible en fin de page. Pour chaque document, elle comprend :
- La date d'ajout
- Le nom du document (tronqué si trop long)
- Le type de document
- L'auteur du document (le partenaire + user l'ayant ajouté)
- Des boutons d'actions :
- Un bouton afficher : ouvre le document dans un nouvel onglet
- Un bouton éditer : permet de modifier le type de document (disponible pour l'auteur et le RT)
- Un bouton supprimer : supprimer le document (disponible pour l'auteur et le RT)
Ajouter des documents sur la situation usager
Conditions
- Avoir un compte actif sur la plateforme
- Avoir le rôle agent ou supérieur
- Signalement statut en cours
- Affectation acceptée (pour les agents et admin partenaire)
Flow
- Accès au signalement
- Accès à la partie "Déclaration usager"
- Clic sur le bouton "Ajouter des documents"
- Ouverture de la modale "Ajouter des documents" qui comprend :
- Un titre
- Un message d'intro :
Ajouter un ou plusieurs documents fournis par l'usager. Pour chaque document, veuillez renseigner son type. - Un message info:
Pour ajouter des documents concernant la procédure ou le bailleur, rendez-vous dans la partie "Documents partenaires". - Un champ drag n drop
- Un bouton "Parcourir"
- Un message d'avertissement:
Ces documents seront partagés à l'usager. Une fois validés, ils ne pourront plus être supprimés. - Une zone d'action avec deux boutons : un "Annuler" et un "Valider"
- Clic sur upload (ou drag n drop des documents)
- Pour chaque document, on affiche :
- Le nom du fichier
- L'état du téléchargement
- Un menu déroulant "type" parmi lequel l'agent doit sélectionner le type du document (dans la catégorie Situation du foyer)
- Une fois les champs remplis, clic sur "Valider"
Conséquences
- Fermeture de la modale, actualisation de la page signalement
- Affichage d'un success message en haut :
Les documents ont bien été ajoutés. - Les documents sont ajoutés et visibles dans la partie "Déclaration usager"
- Un suivi automatique est créé
Liste des documents usager
Sur la fiche du signalement, une liste des documents partenaires est disponible en fin de page. Pour chaque document, elle comprend :
- La date d'ajout
- Le nom du document (tronqué si trop long)
- Le type de document
- L'auteur du document (le partenaire + user l'ayant ajouté OU "Usager")
- Des boutons d'actions :
- Un bouton afficher : ouvre le document dans un nouvel onglet
- Un bouton éditer : permet de modifier le type de document (disponible pour l'auteur et le RT) -> uniquement sur ceux ajoutés depuis le BO
Visite : ajout du CR et / ou de photos
Ajouter des photos au signalement
Flow
- Accès au signalement
- Accès à la partie "Déclaration usager"
- Clic sur le bouton "Ajouter des photos"
- Ouverture de la modale "Ajouter des photos" qui comprend :
- Un titre
- Un message d'intro :
Ajouter une ou plusieurs photos au signalement. Pour chaque photo, veuillez sélectionner le désordre auquel elle est rattachée. Si vous ne trouvez pas le désordre, sélectionnez "Autre". - Un champ drag n drop
- Un bouton "Parcourir"
- Un message d'avertissement:
Ces photos seront partagées à l'usager. Une fois validées, elles ne pourront plus être supprimées. - Une zone d'action avec deux boutons : un "Annuler" et un "Valider"
- Clic sur upload (ou drag n drop des documents)
- Pour chaque photo, on affiche :
- Le nom du fichier
- L'état du téléchargement
- Un menu déroulant "Désordre" parmi lequel l'agent doit sélectionner le désordre correspondant, parmi ceux sélectionnés dans le signalement
- Une fois les champs remplis, clic sur "Valider"
Conséquences
- Fermeture de la modale, actualisation de la page signalement
- Affichage d'un success message en haut :
Les photos ont bien été ajoutées. - Les photos sont ajoutées et visibles dans la partie "Déclaration usager"
- Un suivi automatique est créé
Liste des photos
Sur la fiche du signalement, une liste des photos est disponible dans la déclaration usager. Pour chaque photo, on affiche :
- Une miniature
- Un bouton "afficher" -> Affiche la photo en mode album photo
- Un bouton "éditer" -> permet d'éditer le désordre associé
Mode "Album"
Quand on clique sur le bouton Afficher, la photo est affichée en plein écran, en mode album.
On affiche à l'écran :
- La photo format portrait ou paysage (suivant son orientation d'origine)
- Le titre de l'album et position de la photo dans l'album (ex. :
Photos de la situation : 1/6) - Un bouton précédent et un bouton suivant respectivement à gauche et à droite de la photo
- En légende : le désordre concerné puis
Photo ajoutée par {{nom}} - {{partenaire}}* - Un bouton "Fermer" sous forme de lien en haut à droite de la photo
*Si la photo est ajoutée par l'usager on affiche Photo ajoutée par l'usager
BO - Editer les documents et photos
Editer les documents partenaires
Condition
- Avoir ajouté le document OU avoir le rôle RT ou supérieur
- Signalement en cours
Flow
- Clic sur le bouton d'édition
- Affichage d'une modale avec
- Titre : Editer le document
- Nom du fichier
- Menu déroulant
Type - Zone d'action avec boutons Annuler et Valider
- Sélection du type
- Clic sur Valider
Conséquences
- Retour sur la page signalement avec le success message
Le document a bien été modifié. - Changements visibles dans la liste des documents partenaires
Editer les documents situation usager
Condition
- Avoir ajouté le document OU avoir le rôle RT ou supérieur
- Signalement en cours
Flow
- Clic sur le bouton d'édition
- Affichage d'une modale avec
- Titre : Editer le document
- Nom du fichier
- Ajouté le {{date}} par {{partenaire}} - {{agent}}
- Menu déroulant
Type - Zone d'action avec boutons Annuler et Valider
- Sélection du type
- Clic sur Valider
Conséquences
- Retour sur la page signalement avec le success message
Le document a bien été modifié. - Changements visibles dans la liste des documents déclaration usager
Editer les photos situation usager
Condition
- Avoir ajouté la photo OU avoir le rôle RT ou supérieur
- Signalement en cours
Flow
- Clic sur le bouton d'édition
- Affichage d'une modale avec
- Titre : Editer la photo
- Nom du fichier
- Ajouté le {{date}} par {{partenaire}} - {{agent}} (ou "usager")
- Miniature
- Menu déroulant
Désordre - Zone d'action avec boutons Annuler et Valider
- Sélection du désordre associé
- Clic sur Valider
Conséquences
- Retour sur la page signalement avec le success message
La photo a bien été modifiée. - Changements visibles dans la liste des désordres et dans l'affichage album de la photo
BO - Supprimer les documents et photos
Supprimer les documents partenaires
Condition
- Avoir ajouté le document OU avoir le rôle RT ou supérieur
- Signalement en cours
Flow
- Clic sur le bouton de suppression
- Affichage d'une modale de validation:
- Titre : Supprimer le document
- Texte: "Vous êtes sur le point de supprimer le document {{nom}}. Une fois supprimé, le document ne sera plus visible dans le signalement. Voulez-vous vraiment supprimer ce document ?"
- Zone d'action: boutons "Supprimer le document" et "Annuler"
- Clic sur supprimer
Conséquences
- Retour sur la page signalement avec le success message
Le document a bien été supprimé. - Changements visibles dans la liste des documents partenaires
- Ajout d'un suivi automatique