Adomy | Atlantis - Projet GL02

Description : Application suivant le cahier des charges livré par le groupe Atlantis. Cette application est composée de deux parser : un parser de fichiers de type ICalendar et un autre parsant les fichiers de type Csv. Trois fonctionnalités sont disponibles. La première est la détection de conflits entre différents fichiers ICalendar pour une adresse donnée. La deuxième est la conversion de fichiers Csv en ICalendar. Enfin la troisième et dernière fonctionnalité permet de calculer le nombre d'heures totales réalisées pour chaque intervenants ainsi que le nombre d'interventions pour chacun au cours d'une semaine donnée.

Initiatives prises :

Etant donnée la liberté d'action autorisée par le cahier des charges nous ayant été fourni, des décisions ont dûes être prises pour mener à bien ce projet. Les voici.

Tout d'abord il n'était pas précisé sur quelle référence se baser (l'EF_1) pour trouver les conflits pour un domicile. Nous avons donc décidé que l'utilisateur devra saisir l'adresse pour qu'ensuite l'application trouve les enventuels conflits en ce lieu. La liste des conflits pour ce lieu et pour chaque rendez-vous est créée dans un document csv. Nous avons dû définir un format, ce dernier n'ayant pas été défini dans le cahier des charges (voir un peu plus bas dans ce document).

Pour l'EF_2, nous avons défini une cellule type d'un rendez-vous :
fonctionIntervenant-nomIntervenant-prenomIntervenant-telIntervenant-societeIntervenant-prenomPatient-nomPatient-telPatient-villePatient-numRuePatient ruePatient-codePostalPatient.
Cette cellule-type est reprise dans l'ABNF suivante, décrivant le CSV d'un planning de domicile :

CSV = COLONNES (CRLF LIGNE)
COLONNES = ‘lundi;mardi;mercredi;jeudi;vendredi;samedi;dimanche’
LIGNE = RDV.';'.RDV.';'.RDV.';'.RDV.';'.RDV.';'.RDV.';'.RDV.';'
RDV = FONCTIONINTERVENANT.'-'.NOMINTERVENANT.'-'.PRENOMINTERVENANT.'-'.TELINTERVENANT.'-'.SOCIETEINTERVENANT.'-'.NOMPATIENT.'-'.PRENOMPATIENT.'-'.TELPATIENT.'-'.VILLEPATIENT.'-'.NUMRUEPATIENT RUEPATIENT.'-'.CODEPOSTALPATIENT
FONCTIONINTERVENANT = TEXTAPOSTROPHE
NOMINTERVENANT = TEXTAPOSTROPHE
PRENOMINTERVENANT = TEXT
TELINTERVENANT = 10DIGIT
SOCIETEINTERVENANT = 1(VCHAR WSP VCHAR/VCHAR/VCHAR.'''.VCHAR/DIGIT/DIGIT WSP VCHAR/VCHAR WSP DIGIT)
NOMPATIENT = TEXTAPOSTROPHE
PRENOMPATIENT = TEXT
TELPATIENT = 10DIGIT
VILLEPATIENT = TEXTAPOSTROPHE
NUMRUEPATIENT RUEPATIENT = 1DIGIT WSP 1(VCHAR/VCHAR WSP VCHAR/VCHAR.'''.VCHAR)
CODEPOSTALPATIENT = 5DIGIT
TEXT = 1(VCHAR WSP VCHAR/VCHAR)
TEXTAPOSTROPHE = 1*(VCHAR WSP VCHAR/VCHAR/VCHAR.'''.VCHAR)

L'utilisateur passe en paramètre le nom du fichier Csv contenant le planning à transformer. L'application vérifie la conformité du planning et le transforme en planning au format iCalendar.

Pour l'EF_3, nous avons choisi la solution qui est que l'utilisateur passe en paramètre, en plus des plannings a comparer, la date du lundi de la semaine à analyser. A partir de cette date l'application peut calculer le volume horaire des intervenants pour la semaine ainsi que le nombre d'intervention. Il est possible de passer plusieurs plannings pour un même intervenant, l'application s'assurera de trouver les interventions pour la semaine voulue.

Format ICalendar :

ICalendar = 'BEGIN:VCALENDAR' CRLF 'VERSION:2.0' CRLF 'PRODID:-//hacksw/handcal//NONSGML v1.0//EN' VEVENT 'END:VCALENDAR'
VEVENT = 'BEGIN:VEVENT' CRLF DTSTART CRLF DURATION CRLF ORGANIZER CRLF LOCATION CRLF CONTACT CRLF 'END:VEVENT'
DTSTART = 'DTSTART:'.8DIGIT.'T'.6DIGIT
DURATION = 'DURATION:PT'.1/2DIGIT.'H'.1/2DIGIT.'M'.1/2DIGIT.'S'
ORGANIZER = 'ORGANIZER:'.TEXT.','.TEXT.','.TEXT.','.10DIGIT
LOCATION = 'LOCATION:'.TEXT.','.TEXTBIS.','.5DIGIT
CONTACT = 'CONTACT:'.TEXT.'\,'.10DIGIT
TEXT = 1(WSP/VCHAR)
TEXTBIS = 1*(WSP/VCHAR/DIGIT)

Format de sortie csv fonctionnalité n°1 :

Le nom du fichier crée sera de la forme : 'conflict-'.<ville>.''.<adresse>.'</adresse>'..'.csv'
Il sera crée dans un dossier "conflits" qui devra se situer à la racine du projet.
Chaque ligne correspond à un conflit pour une tranche horaire donnée.</ville>

$ npm install

$ node main 1 <adresse> 2*<fichier.ics>
    - <adresse> = chaîne de caractère de type "<Ville>,<info rue>,<code postal>"

$ node mainApp 2 <fichier.csv>
    - <fichier.csv> = nom du fichier à transformer au format Csv

$ node main 3 <date> 1*<fichier.ics>
    - <date> = format jj/mm/aaaa

Équipe Dionysos
- Rémi Beraux remi.beraux@utt.fr
- Vincent Fouquet vincent.fouquet@utt.fr
- Alexis Grosjean alexis.grosjean@utt.fr
- Shiduo Shiduo shiduo.zhang@utt.fr