Commit fb5ac950 authored by Bertrand Gauthier's avatar Bertrand Gauthier
Browse files

Notifications : inventaires + renommages + corrections de fautes.

parent ae0e3172
Loading
Loading
Loading
Loading

doc/notifications.md

0 → 100644
+469 −0
Changes for doc/notifications.md: 469 added lines, 0 removed lines.
Original line number Diff line number Diff line
Notifications envoyées par l'application
========================================


Module Dépôt
------------

### Notification à propos de la validation de la page de couverture
- Quand :
  - Lorsque la page de couverture est validée.
- Déclenchement :
  - Auto
- Destinataires :
  - BU
- Template :
  - module/Application/view/application/notification/mail/notif-validation-page-couverture.phtml

### Notification à propos de la fin du retraitement du fichier de thèse
- Quand :
  - Un utilisateur peut demander le retraitement automatique de la thèse PDF pour la rendre archivable. 
    Si le retraitement dure trop longtemps, il est relancé en ligne de commande sur le serveur de façon
    asynchrone et l'utilisateur est notifié lorsque le retraitement est terminé.
- Déclenchement :
  - Auto
- Destinataires :
  - Utilisateur ayant lancé le retraitement.
- Template :
  - module/Application/view/application/these/mail/notif-retraitement-fini.phtml

### Notification à propos de la saisie des informations pour le Rendez-vous avec la BU
- Quand :
  - Lorsqu'un doctorant renseigne/modifie les informations nécessaires au RDV avec la BU (disponibilités).
- Déclenchement :
  - Auto
- Destinataires :
  - BU
- Template :
  - module/Application/view/application/these/mail/notif-modif-rdv-bu-doctorant.phtml

### Notification à propos de la validation Rendez-vous BU
- Quand : 
  - Une fois la validation du RDV BU enregistrée.
- Déclenchement :
  - Auto
- Destinataires : 
  - Doctorant (à la 1ere validation seulement).
  - MDD
  - BU
- Template :
  - module/Application/view/application/these/mail/notif-validation-rdv-bu.phtml

### Notification à propos de la dévalidation Rendez-vous BU
- Quand : 
  - Lorsque la validation du RDV BU est annulée.
- Déclenchement :
  - Auto
- Destinataires : 
  - MDD
  - BU
- Template :
  - module/Application/view/application/these/mail/notif-validation-rdv-bu.phtml

### Notification à propos de résultats de thèses passés à 'Admis'
- Quand : 
  - À l'issue de l'import, si des résultats de thèses sont passés à 'Admis'.
- Déclenchement :
  - Auto
- Destinataires : 
  - MDD
  - BU
- Template :
  - module/Application/view/application/these/mail/notif-evenement-import.phtml

### Notification à propos de résultats de thèses passés à 'Admis'
- Quand :
  - À l'issue de l'import, si des résultats de thèses sont passés à 'Admis'.
- Déclenchement :
  - Auto
- Destinataires :
  - Doctorant dont le résultat de thèse est passé à 'Admis'.
- Template :
  - module/Application/view/application/these/mail/notif-resultat-admis-doctorant.phtml

### Notification à propos de corrections attendues
- Quand :
  - À l'issue de l'import, si des témoins de corrections attendues passent à 'facultative' ou à 'obligatoire'.
  - Puis 1 mois avant la date butoir en cas de corrections obligatoires attendues.
- Déclenchement :
  - Auto
- Destinataires :
  - Doctorant
  - Directeur et co-directeur de thèse en copie en cas de corrections obligatoires
- Template :
  - module/Application/view/application/these/mail/notif-depot-version-corrigee-attendu.phtml

### Notification à propos des thèses dont la date butoir pour le dépôt de la version corrigée est dépassée
- Quand :
  - JAMAIS ! À croner ? À supprimer ?
- Déclenchement :
  - Auto
- Destinataires :
  - MDD
- Template :
  - module/Application/view/application/these/mail/notif-date-butoir-correction-depassee.phtml

### Notification pour inviter à valider les corrections
- Quand :
  - Dans le cadre du dépôt d'une version corrigée :
    - soit après le dépôt de la version corrigée dans le cas où elle est testée/jugée archivable ;
    - soit après le dépôt de la version corrigée dans le cas où ell est testée/jugée non archivable mais retraitée 
      par l'application puis certifiée conforme par le doctorant.
- Déclenchement :
  - Auto
- Destinataires :
  - Président du jury
  - MDD en copie
- Template :
  - module/Application/view/application/notification/mail/notif-validation-depot-these-corrigee.phtml

### Notification à propos de l'absence d'adresse connue pour un président du jury
- Quand :
  - Lorsque la notification pour inviter à valider les corrections n'est pas possible car le PJ n'a pas d'adresse 
    connue.
- Déclenchement :
  - Auto
- Destinataires :
  - MDD
- Template :
  - module/Application/view/application/notification/mail/notif-pas-de-mail-president-jury.phtml

### Notification à propos de la validation des corrections attendues
- Quand :
  - Lorsque les corrections de la thèse ont été validées (par le président du jury). 
- Déclenchement :
  - Auto
- Destinataires :
  - MDD
  - Doctorant
- Template :
  - module/Application/view/application/notification/mail/notif-validation-correction-these.phtml

### Notification pour confirmation d'une adresse mail.
- Quand :
  - Pour finaliser la création d'un compte local.
  - Lors de la saisie de son adresse de contact par le doctorant.
- Déclenchement :
  - Auto
- Destinataires :
  - À l'adresse renseignée par un utitlisateur et dont il faut confirmer la validité.
- Template :
  - module/Application/view/application/doctorant/empty-mail.phtml 
    PAS UN TEMPLATE !! Y placer ce qui est dans MailConfirmationController::envoieAction().

### Modification dans vos rôles
- Quand :
  - Lorsque qu'un rôle est attribué/retiré à un utilisateur.
- Déclenchement :
  - Auto
- Destinataires :
  - L'utilisateur en question.
- Template :
  - module/Application/view/application/utilisateur/changement-role.phtml

### Notification à propos de la création d'un compte local
- Quand :
  - Dès qu'un compte local est créé pour quelqu'un, pour l'informer de son identifiant de connexion et l'inviter 
    à initialiser son compte.
- Déclenchement :
  - Auto
- Destinataires :
  - Adresse de la personne spécifiée dans le formulaire de création d'un compte local. 
- Template :
  - module/Application/view/application/utilisateur/mail/init-compte.phtml

### Notification à propos de la réinitialisation du mot de passe d'un compte local
- Quand :
  - Dès qu'une demande de réinitialisation du mot de passe d'un compte local est faite.
- Déclenchement :
  - Auto
- Destinataires :
  - Adresse mail associée au compte local en question.
- Template :
  - module/Application/view/application/utilisateur/mail/reinit-compte.phtml

### Notification à propos d'abonnés de liste de diffusion sans adresse connue  
- Quand :
  - JAMAIS !
- Déclenchement :
  - Auto
- Destinataires :
  - Utilisateurs ayant le rôle "Administrateur technique".
- Template :
  - module/Application/view/application/liste-diffusion/mail/notif-abonnes-sans-adresse.phtml

### Notification que la fusion de la page de couverture avec la thèse PDF est terminée
- Quand :
  - Un utilisateur peut demander le téléchargement de la thèse PDF avec page de couverture. 
    Si la fusion de la thèse avec la page de couverture dure trop longtemps, la fusion est relancée en ligne de 
    commande sur le serveur de façon asynchrone et l'utilisateur est notifié lorsque la fusion est terminée.
- Déclenchement :
  - Auto
- Destinataires :
  - Utilisateur ayant demandé le téléchargement de la thèse PDF avec page de couverture.
- Template :
  - module/Application/view/application/these/mail/notif-fusion-fini.phtml

### Notification à propos du téléversement d'un fichier de thèse
- Quand :
  - Lorsqu'un fichier de thèse PDF est téléversé
- Déclenchement :
  - Auto
- Destinataires :
  - MDD
- Template :
  - En bdd (table NOTIF)

### Notification à propos du téléversement d'un rapport de soutenance
- Quand :
  - Lorsqu'un rapport de soutenance est téléversé
- Déclenchement :
  - Auto
- Destinataires :
  - MDD
- Template :
  - module/Application/view/application/these/mail/notif-depot-rapport-soutenance.phtml



Module Soutenance
-----------------

Doctorant => dir & codir => resp UR => resp ED => MDD (signature du pres).

### Notification à propos de la validation de la proposition de soutenance par un acteur direct
- Quand :
  - Lorsqu'une proposition de soutenance est validée par un acteur direct de la thèse (acteurs directs : doctorant, 
    directeur & codirecteur de thèse).
- Déclenchement :
  - Auto
- Destinataires :
  - Doctorant
  - Directeur et codirecteur de thèse
- Template :
  - module/Soutenance/view/soutenance/notification/validation-acteur.phtml

### Notification à propos de la validation de la proposition de soutenance par une structure associée
- Quand :
  - Lorsqu'une proposition de soutenance est validée par une structure associée (ED ou UR ou MDD).
- Déclenchement :
  - Auto
- Destinataires :
  - ED ou UR ou MDD.
- Template :
  - module/Soutenance/view/soutenance/notification/validation-structure.phtml

### Notification à propos de la dévalidation d'une proposition de soutenance
- Quand :
  - Lorsqu'une validation de proposition de soutenance est annulée.
- Déclenchement :
  - Auto
- Destinataires :
  - Auteur de la validation annulée.
- Template :
  - module/Soutenance/view/soutenance/notification/devalidation.phtml

### Notification à propos de la totalité des validations obtenues par la proposition de soutenance
- Quand :
  - Lorsqu'une proposition de soutenance a obtenu toutes les validations attendues (acteurs directs & structures 
    associées).
- Déclenchement :
  - Auto
- Destinataires :
  - Doctorant
  - Directeur et codirecteur de thèse
  - ED
  - UR
  - MDD
- Template :
  - module/Soutenance/view/soutenance/notification/validation-soutenance.phtml

### Notification à propos de la possibilité de procéder au renseignement des informations de soutenance
- Quand :
  - Lorsqu'une proposition de soutenance a obtenu toutes les validations attendues (acteurs directs & structures 
    associées).
- Déclenchement :
  - Auto
- Destinataires :
  - MDD
- Template :
  - module/Soutenance/view/soutenance/notification/presoutenance.phtml
  
### Notification à propos du refus de la proposistion de soutenance
- Quand :
  - Lorsqu'une proposition de soutenance est refusée par un acteur direct ou une structure associée.
- Déclenchement :
  - Auto
- Destinataires :
  - MDD
- Template :
  - module/Soutenance/view/soutenance/notification/refus.phtml
  
### Notification de demande de signature de l'engagement d'impartialité aux rapporteurs
- Quand :
  - ?
- Déclenchement :
  - ?
- Destinataires :
  - Chaque rapporteur du jury
- Template :
  - module/Soutenance/view/soutenance/notification/engagement-impartialite-demande.phtml

### Notification à propos de la signature d'un engagement d'impartialité
- Quand :
  - Lorsqu'un engagement d'impartialité est signé par un rapporteur.
- Déclenchement :
  - Auto
- Destinataires :
  - MDD
- Template :
  - module/Soutenance/view/soutenance/notification/engagement-impartialite-signature.phtml

### Notification à propos du refus de signature d'un engagement d'impartialité
- Quand :
  - Lorsqu'un rapporteur refuse de signer l'engagement d'impartialité.
- Déclenchement :
  - Auto
- Destinataires :
  - Doctorant
  - Directeur et codirecteur de thèse
  - MDD
- Template :
  - module/Soutenance/view/soutenance/notification/engagement-impartialite-refus.phtml

### Notification à propos de l'annulation d'une signature d'un engagement d'impartialité
- Quand :
  - Lorsqu'une signature d'un engagement d'impartialité est annulée.
- Déclenchement :
  - Auto
- Destinataires :
  - Rapporteur ayant signé.
- Template :
  - module/Soutenance/view/soutenance/notification/engagement-impartialite-annulation.phtml

### Notification de demande d'avis de soutenance aux rapporteurs
- Quand :
  - ?
- Déclenchement :
  - ?
- Destinataires :
  - Chaque rapporteur.
- Template :
  - module/Soutenance/view/soutenance/notification/demande-avis-soutenance.phtml

### Notification d'invitation des rapporteurs à se connecter avec un token
- Quand :
  - Lorsqu'un rapporteur du jury est validé par la MDD à partir de la saisie du doctorant, et que l'appli lui crée
  un compte de connexion à l'aide d'un token.
- Déclenchement :
  - ?
- Destinataires :
  - Rapporteur
- Template :
  - module/Soutenance/view/soutenance/notification/connexion-rapporteur.phtml

### Notification à propos du rendu de tous les avis de soutenance 
- Quand :
  - Lorsque le dernier avis de soutenance est saisi par un rapporteur.
- Déclenchement :
  - Auto
- Destinataires :
  - MDD
- Template :
  - module/Soutenance/view/soutenance/notification/tous-avis-soutenance.phtml

### Notification à propos du rendu d'un avis de soutenance favorable
- Quand :
  - Lorsqu'un avis de soutenance favorable est saisi par un rapporteur.
- Déclenchement :
  - Auto
- Destinataires :
  - Doctorant
  - Directeur et codirecteur de thèse
  - MDD
  - ED
  - UR
- Template :
  - module/Soutenance/view/soutenance/notification/avis-favorable.phtml
  
### Notification à propos du rendu d'un avis de soutenance défavorable
- Quand :
  - Lorsqu'un avis de soutenance défavorable est saisi par un rapporteur.
- Déclenchement :
  - Auto
- Destinataires :
  - Directeur et codirecteur de thèse
  - ED
  - UR
- Template :
  - module/Soutenance/view/soutenance/notification/avis-defavorable.phtml
  
### Notification à propos de l'acceptation de la soutenance
- Quand :
  - ?
- Déclenchement :
  - Manuel ?
- Destinataires :
  - Doctorant
  - Directeur et codirecteur de thèse
  - ED
  - UR
- Template :
  - module/Soutenance/view/soutenance/notification/feu-vert-soutenance.phtml

### Notification à propos de l'arrêt de la démarche de la soutenance
- Quand :
  - Lorsque la MDD déclenche l'arrêt de la démarche... ? Un mot du Pourquoi ?
- Déclenchement :
  - Auto
- Destinataires :
  - Doctorant
  - Directeur et codirecteur de thèse
  - ED
  - UR
- Template :
  - module/Soutenance/view/soutenance/notification/stopper-demarche-soutenance.phtml

### Notification à propos de l'initialisation d'un compte
- Quand :
  - Lorsque la MDD déclenche l'arrêt de la démarche... ? Un mot du Pourquoi ?
- Déclenchement :
  - Auto
- Destinataires :
  - Doctorant
  - Directeur et codirecteur de thèse
  - ED
  - UR
- Template :
  - module/Soutenance/view/soutenance/notification/stopper-demarche-soutenance.phtml

### Notification de retard dans le dépôt du rapport de présoutenance
- Quand :
  - ?
- Déclenchement :
  - Auto ?
- Destinataires :
  - Rapporteurs en retard dans le rendu du rapport de présoutenance
- Template :
  - module/Soutenance/view/soutenance/notification/retard-rapporteur.phtml
  
### Notification de convocation du doctorant à la soutenance de thèse
- Quand :
  - ?
- Déclenchement :
  - Auto ?
- Destinataires :
  - Doctorant
- Template :
  - module/Soutenance/view/soutenance/notification/convocation-doctorant.phtml

### Notification de convocation des membres du jury à la soutenance de thèse
- Quand :
  - ?
- Déclenchement :
  - Auto ?
- Destinataires :
  - Membres du jury sensés assister à la soutenance
- Template :
  - module/Soutenance/view/soutenance/notification/convocation-membre.phtml
  
 No newline at end of file
+1 −1
Changes for module/Application/src/Application/Notification/ChangementCorrectionAttendueNotification.php: 1 added line, 1 removed line.
Original line number Diff line number Diff line
@@ -6,7 +6,7 @@ use Application\Entity\Db\Interfaces\TheseAwareTrait;
use Notification\Notification;
use UnicaenApp\Exception\LogicException;

class CorrectionAttendueUpdatedNotification extends Notification
class ChangementCorrectionAttendueNotification extends Notification
{
    use TheseAwareTrait;

+1 −1
Changes for module/Application/src/Application/Notification/ChangementsResultatsThesesNotification.php: 1 added line, 1 removed line.
Original line number Diff line number Diff line
@@ -5,7 +5,7 @@ namespace Application\Notification;
use Application\Entity\Db\Interfaces\TheseAwareTrait;
use Notification\Notification;

class ResultatTheseModifieNotification extends Notification
class ChangementsResultatsThesesNotification extends Notification
{
    use TheseAwareTrait;

+2 −2
Changes for module/Application/src/Application/Service/Notification/NotificationFactory.php: 2 added lines, 2 removed lines.
Original line number Diff line number Diff line
@@ -188,14 +188,14 @@ class NotificationFactory extends \Notification\Service\NotificationFactory
    }

    /**
     * Notifie que le retraitement automatique du fichier PDF est terminé.
     * Notifie que la fusion de la page de couverture avec la thèse PDF est terminée.
     *
     * @param string $destinataires Emails séparés par une virgule
     * @param These $these
     * @param string $outputFilePath Chemin vers le fichier stocké en local
     * @return Notification
     */
    public function createNotificationFusionFini($destinataires, $these, $outputFilePath)
    public function createNotificationFusionFini(string $destinataires, These $these, string $outputFilePath): Notification
    {
        $to = array_map('trim', explode(',', $destinataires));

+33 −16
Changes for module/Application/src/Application/Service/Notification/NotifierService.php: 33 added lines, 16 removed lines.
Original line number Diff line number Diff line
@@ -9,10 +9,10 @@ use Application\Entity\Db\Role;
use Application\Entity\Db\These;
use Application\Entity\Db\Utilisateur;
use Application\Entity\Db\Variable;
use Application\Notification\CorrectionAttendueUpdatedNotification;
use Application\Notification\ChangementCorrectionAttendueNotification;
use Application\Notification\PasDeMailPresidentJury;
use Application\Notification\ResultatTheseAdmisNotification;
use Application\Notification\ResultatTheseModifieNotification;
use Application\Notification\ChangementsResultatsThesesNotification;
use Application\Notification\ValidationDepotTheseCorrigeeNotification;
use Application\Notification\ValidationRdvBuNotification;
use Application\Rule\NotificationDepotVersionCorrigeeAttenduRule;
@@ -63,19 +63,19 @@ class NotifierService extends \Notification\Service\NotifierService
    }

    /**
     * Notification du BDD concernant l'évolution des résultats de thèses.
     * Notification concernant des changements quelconques de résultats de thèses.
     *
     * @param array $data
     * @return ResultatTheseModifieNotification
     * @param array $data Données concernant les thèses dont le résultat a changé
     * @return ChangementsResultatsThesesNotification
     */
    public function triggerBdDUpdateResultat(array $data)
    public function triggerChangementResultatTheses(array $data): ChangementsResultatsThesesNotification
    {
        $these = current($data)['these'];

        $emailBdd = $this->fetchEmailBdd($these);
        $emailBu = $this->fetchEmailBu($these);

        $notif = new ResultatTheseModifieNotification();
        $notif = new ChangementsResultatsThesesNotification();
        $notif->setData($data);
        $notif->setTo([$emailBdd, $emailBu]);

@@ -85,12 +85,12 @@ class NotifierService extends \Notification\Service\NotifierService
    }

    /**
     * Notification des doctorants dont le résultat de la thèse est passé à Admis.
     * Notification à propos de résultats de thèses passés à 'Admis'.
     *
     * @param array $data
     * @return ResultatTheseAdmisNotification[]
     */
    public function triggerDoctorantResultatAdmis(array $data)
    public function triggerChangementResultatThesesAdmis(array $data): array
    {
        $notifs = [];

@@ -113,12 +113,14 @@ class NotifierService extends \Notification\Service\NotifierService
    }

    /**
     * Notification à propos de corrections attendues.
     *
     * @param ImportObservResult $record
     * @param These $these
     * @param string $message
     * @return CorrectionAttendueUpdatedNotification|null
     * @return ChangementCorrectionAttendueNotification|null
     */
    public function triggerCorrectionAttendue(ImportObservResult $record, These $these, &$message = null)
    public function triggerCorrectionAttendue(ImportObservResult $record, These $these, &$message = null): ?ChangementCorrectionAttendueNotification
    {
        // interrogation de la règle métier pour savoir comment agir...
        $rule = new NotificationDepotVersionCorrigeeAttenduRule();
@@ -141,7 +143,7 @@ class NotifierService extends \Notification\Service\NotifierService
            return null;
        }

        $notif = new CorrectionAttendueUpdatedNotification();
        $notif = new ChangementCorrectionAttendueNotification();
        $notif
            ->setThese($these)
            ->setEstPremiereNotif($estPremiereNotif);
@@ -152,6 +154,8 @@ class NotifierService extends \Notification\Service\NotifierService
    }

    /**
     * Notification à propos du dépassement de la date butoir de dépôt de la version corrigée de la thèse.
     *
     * @param These $these
     */
    public function triggerDateButoirCorrectionDepassee(These $these)
@@ -171,7 +175,7 @@ class NotifierService extends \Notification\Service\NotifierService
    }

    /**
     * Notification par mail des directeurs de thèse pour les inviter à valider les corrections.
     * Notification pour inviter à valider les corrections.
     *
     * @param These $these
     */
@@ -204,14 +208,13 @@ class NotifierService extends \Notification\Service\NotifierService
    }

    /**
     * Notification par mail des directeurs de thèse pour les inviter à valider les corrections.
     * Notification à propos de l'absence de mail connu pour le président du jury.
     *
     * @param These $these
     * @param Acteur|null $president
     */
    public function triggerPasDeMailPresidentJury(These $these, ?Acteur $president)
    {
        // envoi de mail aux directeurs de thèse
        $notif = new PasDeMailPresidentJury();
        $notif
            ->setThese($these)
@@ -236,6 +239,8 @@ class NotifierService extends \Notification\Service\NotifierService
    }

    /**
     * Notification à propos de la validation des corrections attendues.
     *
     * @param Notification $notif
     * @param These        $these
     */
@@ -280,6 +285,8 @@ class NotifierService extends \Notification\Service\NotifierService
    }

    /**
     * Notification pour confirmation d'une adresse mail.
     *
     * @param MailConfirmation $mailConfirmation
     * @param string           $confirm
     */
@@ -344,6 +351,8 @@ class NotifierService extends \Notification\Service\NotifierService
    }

    /**
     * Notification à propos d'un rôle attribué/retiré à un utilisateur.
     *
     * @var string $type
     * @var Role $role
     * @var Individu $individu
@@ -366,6 +375,8 @@ class NotifierService extends \Notification\Service\NotifierService
    }

    /**
     * Notification à propos de la création d'un compte local.
     *
     * @param Utilisateur $utilisateur
     * @param string $token
     */
@@ -392,6 +403,8 @@ class NotifierService extends \Notification\Service\NotifierService
    }

    /**
     * Notification à propos de la réinitialisation d'un compte local.
     *
     * @param Utilisateur $utilisateur
     * @param string $url
     */
@@ -418,6 +431,8 @@ class NotifierService extends \Notification\Service\NotifierService
    }

    /**
     * Notification à propos d'abonnés de liste de diffusion sans adresse connue.
     *
     * @param string[] $to
     * @param string $liste
     * @param string[] $individusAvecAdresse
@@ -440,6 +455,8 @@ class NotifierService extends \Notification\Service\NotifierService
    }

    /**
     * Notification à propos d'abonnés de liste de diffusion sans adresse connue.
     *
     * @param string[] $to
     * @param string $liste
     * @param string[] $individusAvecAdresse
@@ -450,7 +467,7 @@ class NotifierService extends \Notification\Service\NotifierService
        array $to,
        $liste,
        array $individusAvecAdresse,
        array $individusSansAdresse)
        array $individusSansAdresse): Notification
    {
        $notif = new Notification();
        $notif
Loading