air - User contributions [en]

ECOM-1FO

2018-12-18T08:23:03Z

Sybille.Caffiau: /* Rendus */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système
'''Autres :'''
* ADE : Emploi du temps en ligne

==Groupes et sujets==
===Groupes eCOM-1F0 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

* [[ECOM-1FO_1819_Restaurant]] : '''William Weill (CP)''', Théo Lévesque, Loris Gentillon, Benjamin Besnier, Thomas Ozenda
* [[ECOM-1FO_1819_Spectacle]] : '''Thibaud Vegreville (CP)''', Joffrey Ferreira, Bastien Terrier, Cédric Lafrasse
* [[ECOM-1FO_1819_Camping]] : '''Timothée Depriester (CP)''', Sekina Belguendouz, Servan Charlot, Samuel Bamba, Florian Cuzin
* [[ECOM-1FO_1819_Transport]] : '''Julien Courtial (CP)''', Aurélien Surier, Raphaël Manger, Théo Echevet
* [[ECOM-1FO_1819_Sport]] : '''Hugo Gros-Daillon (CP)''', Quentin Fombaron, Tim Lepage, Vincent Aubert
* [[ECOM-1F0_1819_BTB|ECOM-1FO_1819_BruleTaBuche]] : '''Léo Valette (CP)''', Amina Boucherima, Zoran Chanet, Najwa Ez-zine, Enzo Molion

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et VZ).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2018.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P005)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production) (F214, F215).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P257)
* 25/09 15h45-18h30 : Séance en autonomie (F114, F214)

* 02/10 8h00-12h15 : Test utilisateur (SC) puis Séance en autonomie (P039)
* 02/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 09/10 8h00-12h15 : Audit 1 (P013) et Séance en autonomie (P105, P133)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (F114, F214)

* 16/10 8h00-12h15 : Séance en autonomie (P257)
* 16/10 15h45-18h30 : Séance encadrée (SC) (F214, F215)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P257)
* 23/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 06/11 8h00-12h15 : Audit 2 (F114) et Séance en autonomie (F202)
* 06/11 15h45-18h30 : Séance en autonomie (F214, F215)

* 12/11 8h00-12h15 : Séance en autonomie (P257)

* 20/11 8h00-12h15 : Séance en autonomie + Séance encadrée (SC) (P257)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 27/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 04/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 11/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 18/12 8h00-12h15 : Soutenances (F114) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (F114) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie [[Spring Boot]] / [[JHipster]].
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]] sur plusieurs VM dans un cloud public (AWS, GAE, Heroku, Azure, Bluemix, Digital Ocean ...), le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P013
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- 8h35 : Restaurant

- 9h10 : Spectacle

- 9h45 : Camping

- 10h20 : Transport

- 10h55 : Sport

- 11h30 : Brule ta bûche

''''' Contenu :'''''

Pour la partie GL et gestion de projet
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques et état de prise en main

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)
* Modèle de tâches et IHMA pour les premières tâches

===Audit 2 ===
*Salle : F114
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL et gestion de projet :
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Procédure de tests
* Procédure d'intégration du code

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- 8h : Transport

- 8h30 : Spectacle

- 9h : Restaurant

- 9h30 : Camping

- 10h : Sport

- 10h30 : Brule ta bûche

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : F114
* Durée totale : 30 min (max 15 minutes de présentation, min 5 minutes de démo)
* Utilisez des transparents pour présenter votre projet ( [[Media:Présentation RICM-2018.odp]]). Lors de votre passage vous devez présenter une démo PRÉPARÉE.

* ordre de passage :

- 8h : Sport

- 8h35 : Restaurant

- 9h10 : Spectacle

- 9h45 : Camping

- 10h20 : Transport

- 11h : Brule ta bûche

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation :'''''
Votre présentation doit suivre le template suivante : [[Media:Présentation RICM-2018.odp]]
Vous devez suivre l'ordre dans lequel les items sont proposés mais vous pouvez ajouter des slides en cas de besoin pour illustrer (ex : pour expliquer votre processus).
Si vous avec des remarques/questions n'attendez pas pour les poser

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et VZ pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Tout votre projet doit être suivi grâce à gitLab.

A tout moment, les enseignants doivent donc pouvoir
* avoir la dernière version du code (dernière version du logiciel en production et ce qui est en cours de développement dans des branches dédiées)
* voir les tâches prévues/en cours/réalisées
* savoir le travail de chaque membre (effectué et assigné)
* consulter les documents de conception (à jour)
* consulter les CR des daily meeting et autres réunions et les rétrospectives et vos présentations aux différents audits
* avoir connaissance des procédures de qualité que vous mettez en place au sein de votre projet
* consulter les résultats des différents tests pour chaque release

Attention : nous insistons particulièrement sur le fait que toutes ces données doivent être maintenues en temps réel et accessibles sur le gitlab de votre projet.

Attention : nous consulterons également les messages de commit.

===Rendus===
Vous trouverez ci-dessous une liste (non exhaustive) de certains livrables pouvant être produits au sein de votre projet

'''''L1. Composition des groupes et sujet'''''. (obligatoire)
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants Spring de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation Spring : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement Spring. Un composant peut être implanté par un client généré à partir de l'interface de/des micro-services, par un micro-service REST (Controller), par un Service, par un Entity ou par un client Feign vers un micro-service externe au systeme (par exemple, service de paiement Swipe.com, ...).

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (tableau de tâches de Gitlab)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluations de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Evaluation de la cybersécurité du projet (option)'''''.

'''''L16. Evaluation des performances du projet (option)'''''.
* Résultat d'une injection de charge simpliste avec [[Gatling]]
* Résultat d'une injection de charge suivant un scénario complet avec [[Gatling]]

'''''L17. Gestion des risques (option)'''''.

'''''L18. Slides de présentation conception'''''.

'''''L19. Diapos de votre présentation de conception'''''.

'''''L20. Diapos de votre présentation finale'''''.

'''''L21. Auto evaluation'''''.
Système : [[Media:FicheEval20182019-ECOM]]

'''''L22. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à utiliser un outil adapté cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

Vous devez utiliser GitLab comme support à votre projet (versioning, gestion des tâches...).

Nous vous demandons également d'utiliser les issues pour la communication avec les enseignants. En particulier, toute absence ou télétravail doit être signalé par ce média.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer un groupe GitLab. Y ajouter les membres du projet eCOM. Créer plusieurs projets pour les différents parties. Activer les notifications. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données (UML ou similaire [https://www.jhipster.tech/jdl/ JDL]) et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des Entity (annotations JAX-RS, annotations [[Swagger]]).

L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl (généré avec le générateur [https://swagger.io/tools/swagger-codegen/ swagger-codegen]), [[Swagger]] UI, injecteur de charge [[Gatling]], ....) et le frontend AngularX que vous aurez généré avec [[JHipster]].

Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et utilisateurs finaux) et exécuter certaines requêtes avec des garanties transactionnelles.

TRES IMPORTANT : Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]]/IPtables pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, ...) pour la production (non répliquée)
# Mise en place de 2 containers base de données (MySQL) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] ou [[Nginx]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
# Génération et rafraichissement des certificats SSL avec [[Let's Encrypt]]
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec un FileStorageService ([https://www.callicoder.com/spring-boot-file-upload-download-rest-api-example/ lien])
** Gestion adaptative des contenus multimedia (photos) avec un ThumbnailService (montrez l'amélioration des performances avec Gatling)
** Gestion du cache client pour les photos et les thumbnails avec Cache-Control et ETag (montrez l'amélioration des performances avec Gatling)
** Utilisation de mode Lazy pour les chargements (fetch) des collections et des médias (CLOB,BLOB).
** Génération d'une application mobile [[Ionic]] avec [https://github.com/oktadeveloper/generator-jhipster-ionic generator-jhipster-ionic] (inclure les plugins [[Apache Cordova]] utiles à votre projet).
** Utilisation d'un cache ([https://www.jhipster.tech/using-cache/ préconisé par JHipster])
* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Génération de documents PDF à partir des valeurs de champs d'une entité ou du collection d'entités (exemple d'applications : facture, dossard coureur, export RGPD, ...) [https://www.stackextend.com/java/generate-pdf-document-using-jasperreports-and-spring-boot/ lien]
** Import et export massifs de collections d'entités en format CSV, JSON.
** Suivi du ''click stream'' avec des Filters/Aspects en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST avec [[Keycloak]] ou [[OKTA]].
** Utilisation du service de paiement Stripe.com en mode développeur
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Chatbot du helpdesk (comme [https://github.com/ovh-ux/ovh-chatbot ovh-chatbot])
** Gestion d'un [[CaaS]] Docker privé avec [[Minikube]], [[Kubernetes]], [[Rancher]] ou [[Docker Swarm]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers.
** Script périodique (crontab) de dump et de backup distant de la base MySQL.
** Gestion asynchrone et transactionnelle de l'envoi des courriels via le MailService, Thymeleaf et des taches @Scheduled
** Gestion asynchrone et transactionnelle de l'envoi de SMS (si le destinataire a un compte gratuit pour l'auto-réception de SMS)

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google, [https://www.jhipster.tech/heroku/ Heroku])
* Performances (résultat du injection de charge avec [[Apache JMeter]] ou [[Gatling]]) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Script "basique" pour le rolling update des composants répliqués (application, base de données, serveurs de mail, load balancer). Remarque: [[Kubernetes]] gère les rolling updates ([https://kubernetes.io/docs/tasks/run-application/rolling-update-replication-controller/ lien]).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom. JHipster génère le dockerfile de l'application et quelques descripteurs docker-compose.
* Préparation d'images [[Docker]]
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]], [[Telegraf]] + [[InfluxDB]] + [[Grafana]], [[Prometheus]] ...* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des mécanismes pour intégrer les besoins des utilisateurs
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits

===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

===Evaluation des IHMs===
Une IHM doit être évaluée par au moins deux types d'évaluation (en plus de l'évaluation fonctionnelle) :
* évaluation experte pour vérifier que les principes fondamentaux d'utilisabilité sont respectés
* tests utilisateur pour étudier comment vos utilisateurs utilise dans leurs contextes d'utilisation votre interface

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2018-2019.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html

===Quelques livres et technologies===

REMARQUE: les livres sur ces technologies se périment très vite.

====[[Spring]]====
* Bons tutoriels sur https://www.baeldung.com/rest-with-spring-series/
* Les manuels de références de Spring https://spring.io/projects/spring-boot#overview
* Craig Walls, Spring in Action, Fifth Edition, https://www.manning.com/books/spring-in-action-fifth-edition

====[[JHipster]]====
* Matt Raible, The JHipster Mini-Book 4.5 (GRATUIT) https://www.infoq.com/minibooks/jhipster-4x-mini-book
* Deepu K Sasidharan, Sendil Kumar N, Full Stack Development with JHipster, (10 $ en promotion) March 2018, https://www.packtpub.com/application-development/full-stack-development-jhipster

====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

File:FicheEval20182019-ECOM.doc

2018-12-18T08:01:21Z

Sybille.Caffiau:

ECOM-1FO

2018-12-18T07:57:42Z

Sybille.Caffiau: /* Rendus */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système
'''Autres :'''
* ADE : Emploi du temps en ligne

==Groupes et sujets==
===Groupes eCOM-1F0 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

* [[ECOM-1FO_1819_Restaurant]] : '''William Weill (CP)''', Théo Lévesque, Loris Gentillon, Benjamin Besnier, Thomas Ozenda
* [[ECOM-1FO_1819_Spectacle]] : '''Thibaud Vegreville (CP)''', Joffrey Ferreira, Bastien Terrier, Cédric Lafrasse
* [[ECOM-1FO_1819_Camping]] : '''Timothée Depriester (CP)''', Sekina Belguendouz, Servan Charlot, Samuel Bamba, Florian Cuzin
* [[ECOM-1FO_1819_Transport]] : '''Julien Courtial (CP)''', Aurélien Surier, Raphaël Manger, Théo Echevet
* [[ECOM-1FO_1819_Sport]] : '''Hugo Gros-Daillon (CP)''', Quentin Fombaron, Tim Lepage, Vincent Aubert
* [[ECOM-1F0_1819_BTB|ECOM-1FO_1819_BruleTaBuche]] : '''Léo Valette (CP)''', Amina Boucherima, Zoran Chanet, Najwa Ez-zine, Enzo Molion

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et VZ).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2018.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P005)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production) (F214, F215).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P257)
* 25/09 15h45-18h30 : Séance en autonomie (F114, F214)

* 02/10 8h00-12h15 : Test utilisateur (SC) puis Séance en autonomie (P039)
* 02/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 09/10 8h00-12h15 : Audit 1 (P013) et Séance en autonomie (P105, P133)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (F114, F214)

* 16/10 8h00-12h15 : Séance en autonomie (P257)
* 16/10 15h45-18h30 : Séance encadrée (SC) (F214, F215)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P257)
* 23/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 06/11 8h00-12h15 : Audit 2 (F114) et Séance en autonomie (F202)
* 06/11 15h45-18h30 : Séance en autonomie (F214, F215)

* 12/11 8h00-12h15 : Séance en autonomie (P257)

* 20/11 8h00-12h15 : Séance en autonomie + Séance encadrée (SC) (P257)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 27/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 04/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 11/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 18/12 8h00-12h15 : Soutenances (F114) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (F114) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie [[Spring Boot]] / [[JHipster]].
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]] sur plusieurs VM dans un cloud public (AWS, GAE, Heroku, Azure, Bluemix, Digital Ocean ...), le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P013
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- 8h35 : Restaurant

- 9h10 : Spectacle

- 9h45 : Camping

- 10h20 : Transport

- 10h55 : Sport

- 11h30 : Brule ta bûche

''''' Contenu :'''''

Pour la partie GL et gestion de projet
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques et état de prise en main

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)
* Modèle de tâches et IHMA pour les premières tâches

===Audit 2 ===
*Salle : F114
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL et gestion de projet :
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Procédure de tests
* Procédure d'intégration du code

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- 8h : Transport

- 8h30 : Spectacle

- 9h : Restaurant

- 9h30 : Camping

- 10h : Sport

- 10h30 : Brule ta bûche

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : F114
* Durée totale : 30 min (max 15 minutes de présentation, min 5 minutes de démo)
* Utilisez des transparents pour présenter votre projet ( [[Media:Présentation RICM-2018.odp]]). Lors de votre passage vous devez présenter une démo PRÉPARÉE.

* ordre de passage :

- 8h : Sport

- 8h35 : Restaurant

- 9h10 : Spectacle

- 9h45 : Camping

- 10h20 : Transport

- 11h : Brule ta bûche

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation :'''''
Votre présentation doit suivre le template suivante : [[Media:Présentation RICM-2018.odp]]
Vous devez suivre l'ordre dans lequel les items sont proposés mais vous pouvez ajouter des slides en cas de besoin pour illustrer (ex : pour expliquer votre processus).
Si vous avec des remarques/questions n'attendez pas pour les poser

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et VZ pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Tout votre projet doit être suivi grâce à gitLab.

A tout moment, les enseignants doivent donc pouvoir
* avoir la dernière version du code (dernière version du logiciel en production et ce qui est en cours de développement dans des branches dédiées)
* voir les tâches prévues/en cours/réalisées
* savoir le travail de chaque membre (effectué et assigné)
* consulter les documents de conception (à jour)
* consulter les CR des daily meeting et autres réunions et les rétrospectives et vos présentations aux différents audits
* avoir connaissance des procédures de qualité que vous mettez en place au sein de votre projet
* consulter les résultats des différents tests pour chaque release

Attention : nous insistons particulièrement sur le fait que toutes ces données doivent être maintenues en temps réel et accessibles sur le gitlab de votre projet.

Attention : nous consulterons également les messages de commit.

===Rendus===
Vous trouverez ci-dessous une liste (non exhaustive) de certains livrables pouvant être produits au sein de votre projet

'''''L1. Composition des groupes et sujet'''''. (obligatoire)
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants Spring de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation Spring : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement Spring. Un composant peut être implanté par un client généré à partir de l'interface de/des micro-services, par un micro-service REST (Controller), par un Service, par un Entity ou par un client Feign vers un micro-service externe au systeme (par exemple, service de paiement Swipe.com, ...).

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (tableau de tâches de Gitlab)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Evaluation de la cybersécurité du projet (option)'''''.

'''''L16. Evaluation des performances du projet (option)'''''.
* Résultat d'une injection de charge simpliste avec [[Gatling]]
* Résultat d'une injection de charge suivant un scénario complet avec [[Gatling]]

'''''L17. Gestion des risques (option)'''''.

'''''L18. Slides de présentation conception'''''.

'''''L19. Diapos de votre présentation de conception'''''.

'''''L20. Diapos de votre présentation finale'''''.

'''''L21. Auto evaluation'''''.
Système : [[Media:FicheEval20182019-ECOM]]

'''''L22. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à utiliser un outil adapté cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

Vous devez utiliser GitLab comme support à votre projet (versioning, gestion des tâches...).

Nous vous demandons également d'utiliser les issues pour la communication avec les enseignants. En particulier, toute absence ou télétravail doit être signalé par ce média.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer un groupe GitLab. Y ajouter les membres du projet eCOM. Créer plusieurs projets pour les différents parties. Activer les notifications. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données (UML ou similaire [https://www.jhipster.tech/jdl/ JDL]) et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des Entity (annotations JAX-RS, annotations [[Swagger]]).

L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl (généré avec le générateur [https://swagger.io/tools/swagger-codegen/ swagger-codegen]), [[Swagger]] UI, injecteur de charge [[Gatling]], ....) et le frontend AngularX que vous aurez généré avec [[JHipster]].

Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et utilisateurs finaux) et exécuter certaines requêtes avec des garanties transactionnelles.

TRES IMPORTANT : Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]]/IPtables pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, ...) pour la production (non répliquée)
# Mise en place de 2 containers base de données (MySQL) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] ou [[Nginx]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
# Génération et rafraichissement des certificats SSL avec [[Let's Encrypt]]
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec un FileStorageService ([https://www.callicoder.com/spring-boot-file-upload-download-rest-api-example/ lien])
** Gestion adaptative des contenus multimedia (photos) avec un ThumbnailService (montrez l'amélioration des performances avec Gatling)
** Gestion du cache client pour les photos et les thumbnails avec Cache-Control et ETag (montrez l'amélioration des performances avec Gatling)
** Utilisation de mode Lazy pour les chargements (fetch) des collections et des médias (CLOB,BLOB).
** Génération d'une application mobile [[Ionic]] avec [https://github.com/oktadeveloper/generator-jhipster-ionic generator-jhipster-ionic] (inclure les plugins [[Apache Cordova]] utiles à votre projet).
** Utilisation d'un cache ([https://www.jhipster.tech/using-cache/ préconisé par JHipster])
* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Génération de documents PDF à partir des valeurs de champs d'une entité ou du collection d'entités (exemple d'applications : facture, dossard coureur, export RGPD, ...) [https://www.stackextend.com/java/generate-pdf-document-using-jasperreports-and-spring-boot/ lien]
** Import et export massifs de collections d'entités en format CSV, JSON.
** Suivi du ''click stream'' avec des Filters/Aspects en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST avec [[Keycloak]] ou [[OKTA]].
** Utilisation du service de paiement Stripe.com en mode développeur
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Chatbot du helpdesk (comme [https://github.com/ovh-ux/ovh-chatbot ovh-chatbot])
** Gestion d'un [[CaaS]] Docker privé avec [[Minikube]], [[Kubernetes]], [[Rancher]] ou [[Docker Swarm]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers.
** Script périodique (crontab) de dump et de backup distant de la base MySQL.
** Gestion asynchrone et transactionnelle de l'envoi des courriels via le MailService, Thymeleaf et des taches @Scheduled
** Gestion asynchrone et transactionnelle de l'envoi de SMS (si le destinataire a un compte gratuit pour l'auto-réception de SMS)

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google, [https://www.jhipster.tech/heroku/ Heroku])
* Performances (résultat du injection de charge avec [[Apache JMeter]] ou [[Gatling]]) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Script "basique" pour le rolling update des composants répliqués (application, base de données, serveurs de mail, load balancer). Remarque: [[Kubernetes]] gère les rolling updates ([https://kubernetes.io/docs/tasks/run-application/rolling-update-replication-controller/ lien]).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom. JHipster génère le dockerfile de l'application et quelques descripteurs docker-compose.
* Préparation d'images [[Docker]]
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]], [[Telegraf]] + [[InfluxDB]] + [[Grafana]], [[Prometheus]] ...* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des mécanismes pour intégrer les besoins des utilisateurs
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits

===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

===Evaluation des IHMs===
Une IHM doit être évaluée par au moins deux types d'évaluation (en plus de l'évaluation fonctionnelle) :
* évaluation experte pour vérifier que les principes fondamentaux d'utilisabilité sont respectés
* tests utilisateur pour étudier comment vos utilisateurs utilise dans leurs contextes d'utilisation votre interface

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2018-2019.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html

===Quelques livres et technologies===

REMARQUE: les livres sur ces technologies se périment très vite.

====[[Spring]]====
* Bons tutoriels sur https://www.baeldung.com/rest-with-spring-series/
* Les manuels de références de Spring https://spring.io/projects/spring-boot#overview
* Craig Walls, Spring in Action, Fifth Edition, https://www.manning.com/books/spring-in-action-fifth-edition

====[[JHipster]]====
* Matt Raible, The JHipster Mini-Book 4.5 (GRATUIT) https://www.infoq.com/minibooks/jhipster-4x-mini-book
* Deepu K Sasidharan, Sendil Kumar N, Full Stack Development with JHipster, (10 $ en promotion) March 2018, https://www.packtpub.com/application-development/full-stack-development-jhipster

====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-12-11T13:27:53Z

Sybille.Caffiau: /* Soutenance de fin de projet */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système
'''Autres :'''
* ADE : Emploi du temps en ligne

==Groupes et sujets==
===Groupes eCOM-1F0 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

* [[ECOM-1FO_1819_Restaurant]] : '''William Weill (CP)''', Théo Lévesque, Loris Gentillon, Benjamin Besnier, Thomas Ozenda
* [[ECOM-1FO_1819_Spectacle]] : '''Thibaud Vegreville (CP)''', Joffrey Ferreira, Bastien Terrier, Cédric Lafrasse
* [[ECOM-1FO_1819_Camping]] : '''Timothée Depriester (CP)''', Sekina Belguendouz, Servan Charlot, Samuel Bamba, Florian Cuzin
* [[ECOM-1FO_1819_Transport]] : '''Julien Courtial (CP)''', Aurélien Surier, Raphaël Manger, Théo Echevet
* [[ECOM-1FO_1819_Sport]] : '''Hugo Gros-Daillon (CP)''', Quentin Fombaron, Tim Lepage, Vincent Aubert
* [[ECOM-1F0_1819_BTB|ECOM-1FO_1819_BruleTaBuche]] : '''Léo Valette (CP)''', Amina Boucherima, Zoran Chanet, Najwa Ez-zine, Enzo Molion

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et VZ).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2018.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P005)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production) (F214, F215).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P257)
* 25/09 15h45-18h30 : Séance en autonomie (F114, F214)

* 02/10 8h00-12h15 : Test utilisateur (SC) puis Séance en autonomie (P039)
* 02/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 09/10 8h00-12h15 : Audit 1 (P013) et Séance en autonomie (P105, P133)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (F114, F214)

* 16/10 8h00-12h15 : Séance en autonomie (P257)
* 16/10 15h45-18h30 : Séance encadrée (SC) (F214, F215)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P257)
* 23/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 06/11 8h00-12h15 : Audit 2 (F114) et Séance en autonomie (F202)
* 06/11 15h45-18h30 : Séance en autonomie (F214, F215)

* 12/11 8h00-12h15 : Séance en autonomie (P257)

* 20/11 8h00-12h15 : Séance en autonomie + Séance encadrée (SC) (P257)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 27/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 04/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 11/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 18/12 8h00-12h15 : Soutenances (F114) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (F114) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie [[Spring Boot]] / [[JHipster]].
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]] sur plusieurs VM dans un cloud public (AWS, GAE, Heroku, Azure, Bluemix, Digital Ocean ...), le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P013
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- 8h35 : Restaurant

- 9h10 : Spectacle

- 9h45 : Camping

- 10h20 : Transport

- 10h55 : Sport

- 11h30 : Brule ta bûche

''''' Contenu :'''''

Pour la partie GL et gestion de projet
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques et état de prise en main

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)
* Modèle de tâches et IHMA pour les premières tâches

===Audit 2 ===
*Salle : F114
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL et gestion de projet :
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Procédure de tests
* Procédure d'intégration du code

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- 8h : Transport

- 8h30 : Spectacle

- 9h : Restaurant

- 9h30 : Camping

- 10h : Sport

- 10h30 : Brule ta bûche

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : F114
* Durée totale : 30 min (max 15 minutes de présentation, min 5 minutes de démo)
* Utilisez des transparents pour présenter votre projet ( [[Media:Présentation RICM-2018.odp]]). Lors de votre passage vous devez présenter une démo PRÉPARÉE.

* ordre de passage :

- 8h : Sport

- 8h35 : Restaurant

- 9h10 : Spectacle

- 9h45 : Camping

- 10h20 : Transport

- 11h : Brule ta bûche

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation :'''''
Votre présentation doit suivre le template suivante : [[Media:Présentation RICM-2018.odp]]
Vous devez suivre l'ordre dans lequel les items sont proposés mais vous pouvez ajouter des slides en cas de besoin pour illustrer (ex : pour expliquer votre processus).
Si vous avec des remarques/questions n'attendez pas pour les poser

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et VZ pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Tout votre projet doit être suivi grâce à gitLab.

A tout moment, les enseignants doivent donc pouvoir
* avoir la dernière version du code (dernière version du logiciel en production et ce qui est en cours de développement dans des branches dédiées)
* voir les tâches prévues/en cours/réalisées
* savoir le travail de chaque membre (effectué et assigné)
* consulter les documents de conception (à jour)
* consulter les CR des daily meeting et autres réunions et les rétrospectives et vos présentations aux différents audits
* avoir connaissance des procédures de qualité que vous mettez en place au sein de votre projet
* consulter les résultats des différents tests pour chaque release

Attention : nous insistons particulièrement sur le fait que toutes ces données doivent être maintenues en temps réel et accessibles sur le gitlab de votre projet.

Attention : nous consulterons également les messages de commit.

===Rendus===
Vous trouverez ci-dessous une liste (non exhaustive) de certains livrables pouvant être produits au sein de votre projet

'''''L1. Composition des groupes et sujet'''''. (obligatoire)
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants Spring de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation Spring : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement Spring. Un composant peut être implanté par un client généré à partir de l'interface de/des micro-services, par un micro-service REST (Controller), par un Service, par un Entity ou par un client Feign vers un micro-service externe au systeme (par exemple, service de paiement Swipe.com, ...).

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (tableau de tâches de Gitlab)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Evaluation de la cybersécurité du projet (option)'''''.

'''''L16. Evaluation des performances du projet (option)'''''.
* Résultat d'une injection de charge simpliste avec [[Gatling]]
* Résultat d'une injection de charge suivant un scénario complet avec [[Gatling]]

'''''L17. Gestion des risques (option)'''''.

'''''L18. Slides de présentation conception'''''.

'''''L19. Diapos de votre présentation de conception'''''.

'''''L20. Diapos de votre présentation finale'''''.

'''''L21. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L22. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à utiliser un outil adapté cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

Vous devez utiliser GitLab comme support à votre projet (versioning, gestion des tâches...).

Nous vous demandons également d'utiliser les issues pour la communication avec les enseignants. En particulier, toute absence ou télétravail doit être signalé par ce média.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer un groupe GitLab. Y ajouter les membres du projet eCOM. Créer plusieurs projets pour les différents parties. Activer les notifications. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données (UML ou similaire [https://www.jhipster.tech/jdl/ JDL]) et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des Entity (annotations JAX-RS, annotations [[Swagger]]).

L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl (généré avec le générateur [https://swagger.io/tools/swagger-codegen/ swagger-codegen]), [[Swagger]] UI, injecteur de charge [[Gatling]], ....) et le frontend AngularX que vous aurez généré avec [[JHipster]].

Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et utilisateurs finaux) et exécuter certaines requêtes avec des garanties transactionnelles.

TRES IMPORTANT : Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]]/IPtables pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, ...) pour la production (non répliquée)
# Mise en place de 2 containers base de données (MySQL) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] ou [[Nginx]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
# Génération et rafraichissement des certificats SSL avec [[Let's Encrypt]]
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec un FileStorageService ([https://www.callicoder.com/spring-boot-file-upload-download-rest-api-example/ lien])
** Gestion adaptative des contenus multimedia (photos) avec un ThumbnailService (montrez l'amélioration des performances avec Gatling)
** Gestion du cache client pour les photos et les thumbnails avec Cache-Control et ETag (montrez l'amélioration des performances avec Gatling)
** Utilisation de mode Lazy pour les chargements (fetch) des collections et des médias (CLOB,BLOB).
** Génération d'une application mobile [[Ionic]] avec [https://github.com/oktadeveloper/generator-jhipster-ionic generator-jhipster-ionic] (inclure les plugins [[Apache Cordova]] utiles à votre projet).
** Utilisation d'un cache ([https://www.jhipster.tech/using-cache/ préconisé par JHipster])
* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Génération de documents PDF à partir des valeurs de champs d'une entité ou du collection d'entités (exemple d'applications : facture, dossard coureur, export RGPD, ...) [https://www.stackextend.com/java/generate-pdf-document-using-jasperreports-and-spring-boot/ lien]
** Import et export massifs de collections d'entités en format CSV, JSON.
** Suivi du ''click stream'' avec des Filters/Aspects en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST avec [[Keycloak]] ou [[OKTA]].
** Utilisation du service de paiement Stripe.com en mode développeur
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Chatbot du helpdesk (comme [https://github.com/ovh-ux/ovh-chatbot ovh-chatbot])
** Gestion d'un [[CaaS]] Docker privé avec [[Minikube]], [[Kubernetes]], [[Rancher]] ou [[Docker Swarm]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers.
** Script périodique (crontab) de dump et de backup distant de la base MySQL.
** Gestion asynchrone et transactionnelle de l'envoi des courriels via le MailService, Thymeleaf et des taches @Scheduled
** Gestion asynchrone et transactionnelle de l'envoi de SMS (si le destinataire a un compte gratuit pour l'auto-réception de SMS)

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google, [https://www.jhipster.tech/heroku/ Heroku])
* Performances (résultat du injection de charge avec [[Apache JMeter]] ou [[Gatling]]) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Script "basique" pour le rolling update des composants répliqués (application, base de données, serveurs de mail, load balancer). Remarque: [[Kubernetes]] gère les rolling updates ([https://kubernetes.io/docs/tasks/run-application/rolling-update-replication-controller/ lien]).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom. JHipster génère le dockerfile de l'application et quelques descripteurs docker-compose.
* Préparation d'images [[Docker]]
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]], [[Telegraf]] + [[InfluxDB]] + [[Grafana]], [[Prometheus]] ...* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des mécanismes pour intégrer les besoins des utilisateurs
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits

===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

===Evaluation des IHMs===
Une IHM doit être évaluée par au moins deux types d'évaluation (en plus de l'évaluation fonctionnelle) :
* évaluation experte pour vérifier que les principes fondamentaux d'utilisabilité sont respectés
* tests utilisateur pour étudier comment vos utilisateurs utilise dans leurs contextes d'utilisation votre interface

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2018-2019.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html

===Quelques livres et technologies===

REMARQUE: les livres sur ces technologies se périment très vite.

====[[Spring]]====
* Bons tutoriels sur https://www.baeldung.com/rest-with-spring-series/
* Les manuels de références de Spring https://spring.io/projects/spring-boot#overview
* Craig Walls, Spring in Action, Fifth Edition, https://www.manning.com/books/spring-in-action-fifth-edition

====[[JHipster]]====
* Matt Raible, The JHipster Mini-Book 4.5 (GRATUIT) https://www.infoq.com/minibooks/jhipster-4x-mini-book
* Deepu K Sasidharan, Sendil Kumar N, Full Stack Development with JHipster, (10 $ en promotion) March 2018, https://www.packtpub.com/application-development/full-stack-development-jhipster

====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-12-11T13:17:28Z

Sybille.Caffiau: /* Soutenance de fin de projet */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système
'''Autres :'''
* ADE : Emploi du temps en ligne

==Groupes et sujets==
===Groupes eCOM-1F0 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

* [[ECOM-1FO_1819_Restaurant]] : '''William Weill (CP)''', Théo Lévesque, Loris Gentillon, Benjamin Besnier, Thomas Ozenda
* [[ECOM-1FO_1819_Spectacle]] : '''Thibaud Vegreville (CP)''', Joffrey Ferreira, Bastien Terrier, Cédric Lafrasse
* [[ECOM-1FO_1819_Camping]] : '''Timothée Depriester (CP)''', Sekina Belguendouz, Servan Charlot, Samuel Bamba, Florian Cuzin
* [[ECOM-1FO_1819_Transport]] : '''Julien Courtial (CP)''', Aurélien Surier, Raphaël Manger, Théo Echevet
* [[ECOM-1FO_1819_Sport]] : '''Hugo Gros-Daillon (CP)''', Quentin Fombaron, Tim Lepage, Vincent Aubert
* [[ECOM-1F0_1819_BTB|ECOM-1FO_1819_BruleTaBuche]] : '''Léo Valette (CP)''', Amina Boucherima, Zoran Chanet, Najwa Ez-zine, Enzo Molion

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et VZ).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2018.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P005)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production) (F214, F215).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P257)
* 25/09 15h45-18h30 : Séance en autonomie (F114, F214)

* 02/10 8h00-12h15 : Test utilisateur (SC) puis Séance en autonomie (P039)
* 02/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 09/10 8h00-12h15 : Audit 1 (P013) et Séance en autonomie (P105, P133)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (F114, F214)

* 16/10 8h00-12h15 : Séance en autonomie (P257)
* 16/10 15h45-18h30 : Séance encadrée (SC) (F214, F215)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P257)
* 23/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 06/11 8h00-12h15 : Audit 2 (F114) et Séance en autonomie (F202)
* 06/11 15h45-18h30 : Séance en autonomie (F214, F215)

* 12/11 8h00-12h15 : Séance en autonomie (P257)

* 20/11 8h00-12h15 : Séance en autonomie + Séance encadrée (SC) (P257)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 27/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 04/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 11/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 18/12 8h00-12h15 : Soutenances (F114) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (F114) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie [[Spring Boot]] / [[JHipster]].
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]] sur plusieurs VM dans un cloud public (AWS, GAE, Heroku, Azure, Bluemix, Digital Ocean ...), le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P013
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- 8h35 : Restaurant

- 9h10 : Spectacle

- 9h45 : Camping

- 10h20 : Transport

- 10h55 : Sport

- 11h30 : Brule ta bûche

''''' Contenu :'''''

Pour la partie GL et gestion de projet
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques et état de prise en main

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)
* Modèle de tâches et IHMA pour les premières tâches

===Audit 2 ===
*Salle : F114
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL et gestion de projet :
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Procédure de tests
* Procédure d'intégration du code

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- 8h : Transport

- 8h30 : Spectacle

- 9h : Restaurant

- 9h30 : Camping

- 10h : Sport

- 10h30 : Brule ta bûche

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : F114
* Durée totale : 30 min (max 15 minutes de présentation, min 5 minutes de démo)
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

* ordre de passage :

- 8h : Sport

- 8h35 : Restaurant

- 9h10 : Spectacle

- 9h45 : Camping

- 10h20 : Transport

- 11h : Brule ta bûche

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
Votre présentation doit suivre le template suivante : [[Media:Présentation RICM-2018.odp]]
Vous devez suivre l'ordre dans lequel les items sont proposés mais vous pouvez ajouter des slides en cas de besoin pour illustrer (ex : pour expliquer votre processus).
Si vous avec des remarques/questions n'attendez pas pour les poser

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et VZ pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Tout votre projet doit être suivi grâce à gitLab.

A tout moment, les enseignants doivent donc pouvoir
* avoir la dernière version du code (dernière version du logiciel en production et ce qui est en cours de développement dans des branches dédiées)
* voir les tâches prévues/en cours/réalisées
* savoir le travail de chaque membre (effectué et assigné)
* consulter les documents de conception (à jour)
* consulter les CR des daily meeting et autres réunions et les rétrospectives et vos présentations aux différents audits
* avoir connaissance des procédures de qualité que vous mettez en place au sein de votre projet
* consulter les résultats des différents tests pour chaque release

Attention : nous insistons particulièrement sur le fait que toutes ces données doivent être maintenues en temps réel et accessibles sur le gitlab de votre projet.

Attention : nous consulterons également les messages de commit.

===Rendus===
Vous trouverez ci-dessous une liste (non exhaustive) de certains livrables pouvant être produits au sein de votre projet

'''''L1. Composition des groupes et sujet'''''. (obligatoire)
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants Spring de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation Spring : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement Spring. Un composant peut être implanté par un client généré à partir de l'interface de/des micro-services, par un micro-service REST (Controller), par un Service, par un Entity ou par un client Feign vers un micro-service externe au systeme (par exemple, service de paiement Swipe.com, ...).

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (tableau de tâches de Gitlab)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Evaluation de la cybersécurité du projet (option)'''''.

'''''L16. Evaluation des performances du projet (option)'''''.
* Résultat d'une injection de charge simpliste avec [[Gatling]]
* Résultat d'une injection de charge suivant un scénario complet avec [[Gatling]]

'''''L17. Gestion des risques (option)'''''.

'''''L18. Slides de présentation conception'''''.

'''''L19. Diapos de votre présentation de conception'''''.

'''''L20. Diapos de votre présentation finale'''''.

'''''L21. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L22. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à utiliser un outil adapté cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

Vous devez utiliser GitLab comme support à votre projet (versioning, gestion des tâches...).

Nous vous demandons également d'utiliser les issues pour la communication avec les enseignants. En particulier, toute absence ou télétravail doit être signalé par ce média.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer un groupe GitLab. Y ajouter les membres du projet eCOM. Créer plusieurs projets pour les différents parties. Activer les notifications. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données (UML ou similaire [https://www.jhipster.tech/jdl/ JDL]) et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des Entity (annotations JAX-RS, annotations [[Swagger]]).

L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl (généré avec le générateur [https://swagger.io/tools/swagger-codegen/ swagger-codegen]), [[Swagger]] UI, injecteur de charge [[Gatling]], ....) et le frontend AngularX que vous aurez généré avec [[JHipster]].

Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et utilisateurs finaux) et exécuter certaines requêtes avec des garanties transactionnelles.

TRES IMPORTANT : Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]]/IPtables pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, ...) pour la production (non répliquée)
# Mise en place de 2 containers base de données (MySQL) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] ou [[Nginx]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
# Génération et rafraichissement des certificats SSL avec [[Let's Encrypt]]
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec un FileStorageService ([https://www.callicoder.com/spring-boot-file-upload-download-rest-api-example/ lien])
** Gestion adaptative des contenus multimedia (photos) avec un ThumbnailService (montrez l'amélioration des performances avec Gatling)
** Gestion du cache client pour les photos et les thumbnails avec Cache-Control et ETag (montrez l'amélioration des performances avec Gatling)
** Utilisation de mode Lazy pour les chargements (fetch) des collections et des médias (CLOB,BLOB).
** Génération d'une application mobile [[Ionic]] avec [https://github.com/oktadeveloper/generator-jhipster-ionic generator-jhipster-ionic] (inclure les plugins [[Apache Cordova]] utiles à votre projet).
** Utilisation d'un cache ([https://www.jhipster.tech/using-cache/ préconisé par JHipster])
* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Génération de documents PDF à partir des valeurs de champs d'une entité ou du collection d'entités (exemple d'applications : facture, dossard coureur, export RGPD, ...) [https://www.stackextend.com/java/generate-pdf-document-using-jasperreports-and-spring-boot/ lien]
** Import et export massifs de collections d'entités en format CSV, JSON.
** Suivi du ''click stream'' avec des Filters/Aspects en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST avec [[Keycloak]] ou [[OKTA]].
** Utilisation du service de paiement Stripe.com en mode développeur
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Chatbot du helpdesk (comme [https://github.com/ovh-ux/ovh-chatbot ovh-chatbot])
** Gestion d'un [[CaaS]] Docker privé avec [[Minikube]], [[Kubernetes]], [[Rancher]] ou [[Docker Swarm]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers.
** Script périodique (crontab) de dump et de backup distant de la base MySQL.
** Gestion asynchrone et transactionnelle de l'envoi des courriels via le MailService, Thymeleaf et des taches @Scheduled
** Gestion asynchrone et transactionnelle de l'envoi de SMS (si le destinataire a un compte gratuit pour l'auto-réception de SMS)

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google, [https://www.jhipster.tech/heroku/ Heroku])
* Performances (résultat du injection de charge avec [[Apache JMeter]] ou [[Gatling]]) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Script "basique" pour le rolling update des composants répliqués (application, base de données, serveurs de mail, load balancer). Remarque: [[Kubernetes]] gère les rolling updates ([https://kubernetes.io/docs/tasks/run-application/rolling-update-replication-controller/ lien]).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom. JHipster génère le dockerfile de l'application et quelques descripteurs docker-compose.
* Préparation d'images [[Docker]]
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]], [[Telegraf]] + [[InfluxDB]] + [[Grafana]], [[Prometheus]] ...* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des mécanismes pour intégrer les besoins des utilisateurs
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits

===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

===Evaluation des IHMs===
Une IHM doit être évaluée par au moins deux types d'évaluation (en plus de l'évaluation fonctionnelle) :
* évaluation experte pour vérifier que les principes fondamentaux d'utilisabilité sont respectés
* tests utilisateur pour étudier comment vos utilisateurs utilise dans leurs contextes d'utilisation votre interface

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2018-2019.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html

===Quelques livres et technologies===

REMARQUE: les livres sur ces technologies se périment très vite.

====[[Spring]]====
* Bons tutoriels sur https://www.baeldung.com/rest-with-spring-series/
* Les manuels de références de Spring https://spring.io/projects/spring-boot#overview
* Craig Walls, Spring in Action, Fifth Edition, https://www.manning.com/books/spring-in-action-fifth-edition

====[[JHipster]]====
* Matt Raible, The JHipster Mini-Book 4.5 (GRATUIT) https://www.infoq.com/minibooks/jhipster-4x-mini-book
* Deepu K Sasidharan, Sendil Kumar N, Full Stack Development with JHipster, (10 $ en promotion) March 2018, https://www.packtpub.com/application-development/full-stack-development-jhipster

====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-12-11T13:17:00Z

Sybille.Caffiau: /* Soutenance de fin de projet */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système
'''Autres :'''
* ADE : Emploi du temps en ligne

==Groupes et sujets==
===Groupes eCOM-1F0 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

* [[ECOM-1FO_1819_Restaurant]] : '''William Weill (CP)''', Théo Lévesque, Loris Gentillon, Benjamin Besnier, Thomas Ozenda
* [[ECOM-1FO_1819_Spectacle]] : '''Thibaud Vegreville (CP)''', Joffrey Ferreira, Bastien Terrier, Cédric Lafrasse
* [[ECOM-1FO_1819_Camping]] : '''Timothée Depriester (CP)''', Sekina Belguendouz, Servan Charlot, Samuel Bamba, Florian Cuzin
* [[ECOM-1FO_1819_Transport]] : '''Julien Courtial (CP)''', Aurélien Surier, Raphaël Manger, Théo Echevet
* [[ECOM-1FO_1819_Sport]] : '''Hugo Gros-Daillon (CP)''', Quentin Fombaron, Tim Lepage, Vincent Aubert
* [[ECOM-1F0_1819_BTB|ECOM-1FO_1819_BruleTaBuche]] : '''Léo Valette (CP)''', Amina Boucherima, Zoran Chanet, Najwa Ez-zine, Enzo Molion

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et VZ).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2018.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P005)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production) (F214, F215).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P257)
* 25/09 15h45-18h30 : Séance en autonomie (F114, F214)

* 02/10 8h00-12h15 : Test utilisateur (SC) puis Séance en autonomie (P039)
* 02/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 09/10 8h00-12h15 : Audit 1 (P013) et Séance en autonomie (P105, P133)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (F114, F214)

* 16/10 8h00-12h15 : Séance en autonomie (P257)
* 16/10 15h45-18h30 : Séance encadrée (SC) (F214, F215)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P257)
* 23/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 06/11 8h00-12h15 : Audit 2 (F114) et Séance en autonomie (F202)
* 06/11 15h45-18h30 : Séance en autonomie (F214, F215)

* 12/11 8h00-12h15 : Séance en autonomie (P257)

* 20/11 8h00-12h15 : Séance en autonomie + Séance encadrée (SC) (P257)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 27/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 04/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 11/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 18/12 8h00-12h15 : Soutenances (F114) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (F114) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie [[Spring Boot]] / [[JHipster]].
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]] sur plusieurs VM dans un cloud public (AWS, GAE, Heroku, Azure, Bluemix, Digital Ocean ...), le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P013
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- 8h35 : Restaurant

- 9h10 : Spectacle

- 9h45 : Camping

- 10h20 : Transport

- 10h55 : Sport

- 11h30 : Brule ta bûche

''''' Contenu :'''''

Pour la partie GL et gestion de projet
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques et état de prise en main

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)
* Modèle de tâches et IHMA pour les premières tâches

===Audit 2 ===
*Salle : F114
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL et gestion de projet :
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Procédure de tests
* Procédure d'intégration du code

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- 8h : Transport

- 8h30 : Spectacle

- 9h : Restaurant

- 9h30 : Camping

- 10h : Sport

- 10h30 : Brule ta bûche

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : F114
* Durée totale : 30 min (max 15 minutes de présentation, min 5 minutes de démo)
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

* ordre de passage :

- 8h : Sport

- 8h35 : Restaurant

- 9h10 : Spectacle

- 9h45 : Camping

- 10h20 : Transport

- 11h : Brule ta bûche

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
Votre présentation doit suivre le template suivante : [[Media:Présentation RICM-2018.odp]
Vous devez suivre l'ordre dans lequel les items sont proposés mais vous pouvez ajouter des slides en cas de besoin pour illustrer (ex : pour expliquer votre processus).
Si vous avec des remarques/questions n'attendez pas pour les poser

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et VZ pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Tout votre projet doit être suivi grâce à gitLab.

A tout moment, les enseignants doivent donc pouvoir
* avoir la dernière version du code (dernière version du logiciel en production et ce qui est en cours de développement dans des branches dédiées)
* voir les tâches prévues/en cours/réalisées
* savoir le travail de chaque membre (effectué et assigné)
* consulter les documents de conception (à jour)
* consulter les CR des daily meeting et autres réunions et les rétrospectives et vos présentations aux différents audits
* avoir connaissance des procédures de qualité que vous mettez en place au sein de votre projet
* consulter les résultats des différents tests pour chaque release

Attention : nous insistons particulièrement sur le fait que toutes ces données doivent être maintenues en temps réel et accessibles sur le gitlab de votre projet.

Attention : nous consulterons également les messages de commit.

===Rendus===
Vous trouverez ci-dessous une liste (non exhaustive) de certains livrables pouvant être produits au sein de votre projet

'''''L1. Composition des groupes et sujet'''''. (obligatoire)
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants Spring de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation Spring : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement Spring. Un composant peut être implanté par un client généré à partir de l'interface de/des micro-services, par un micro-service REST (Controller), par un Service, par un Entity ou par un client Feign vers un micro-service externe au systeme (par exemple, service de paiement Swipe.com, ...).

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (tableau de tâches de Gitlab)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Evaluation de la cybersécurité du projet (option)'''''.

'''''L16. Evaluation des performances du projet (option)'''''.
* Résultat d'une injection de charge simpliste avec [[Gatling]]
* Résultat d'une injection de charge suivant un scénario complet avec [[Gatling]]

'''''L17. Gestion des risques (option)'''''.

'''''L18. Slides de présentation conception'''''.

'''''L19. Diapos de votre présentation de conception'''''.

'''''L20. Diapos de votre présentation finale'''''.

'''''L21. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L22. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à utiliser un outil adapté cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

Vous devez utiliser GitLab comme support à votre projet (versioning, gestion des tâches...).

Nous vous demandons également d'utiliser les issues pour la communication avec les enseignants. En particulier, toute absence ou télétravail doit être signalé par ce média.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer un groupe GitLab. Y ajouter les membres du projet eCOM. Créer plusieurs projets pour les différents parties. Activer les notifications. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données (UML ou similaire [https://www.jhipster.tech/jdl/ JDL]) et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des Entity (annotations JAX-RS, annotations [[Swagger]]).

L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl (généré avec le générateur [https://swagger.io/tools/swagger-codegen/ swagger-codegen]), [[Swagger]] UI, injecteur de charge [[Gatling]], ....) et le frontend AngularX que vous aurez généré avec [[JHipster]].

Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et utilisateurs finaux) et exécuter certaines requêtes avec des garanties transactionnelles.

TRES IMPORTANT : Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]]/IPtables pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, ...) pour la production (non répliquée)
# Mise en place de 2 containers base de données (MySQL) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] ou [[Nginx]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
# Génération et rafraichissement des certificats SSL avec [[Let's Encrypt]]
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec un FileStorageService ([https://www.callicoder.com/spring-boot-file-upload-download-rest-api-example/ lien])
** Gestion adaptative des contenus multimedia (photos) avec un ThumbnailService (montrez l'amélioration des performances avec Gatling)
** Gestion du cache client pour les photos et les thumbnails avec Cache-Control et ETag (montrez l'amélioration des performances avec Gatling)
** Utilisation de mode Lazy pour les chargements (fetch) des collections et des médias (CLOB,BLOB).
** Génération d'une application mobile [[Ionic]] avec [https://github.com/oktadeveloper/generator-jhipster-ionic generator-jhipster-ionic] (inclure les plugins [[Apache Cordova]] utiles à votre projet).
** Utilisation d'un cache ([https://www.jhipster.tech/using-cache/ préconisé par JHipster])
* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Génération de documents PDF à partir des valeurs de champs d'une entité ou du collection d'entités (exemple d'applications : facture, dossard coureur, export RGPD, ...) [https://www.stackextend.com/java/generate-pdf-document-using-jasperreports-and-spring-boot/ lien]
** Import et export massifs de collections d'entités en format CSV, JSON.
** Suivi du ''click stream'' avec des Filters/Aspects en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST avec [[Keycloak]] ou [[OKTA]].
** Utilisation du service de paiement Stripe.com en mode développeur
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Chatbot du helpdesk (comme [https://github.com/ovh-ux/ovh-chatbot ovh-chatbot])
** Gestion d'un [[CaaS]] Docker privé avec [[Minikube]], [[Kubernetes]], [[Rancher]] ou [[Docker Swarm]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers.
** Script périodique (crontab) de dump et de backup distant de la base MySQL.
** Gestion asynchrone et transactionnelle de l'envoi des courriels via le MailService, Thymeleaf et des taches @Scheduled
** Gestion asynchrone et transactionnelle de l'envoi de SMS (si le destinataire a un compte gratuit pour l'auto-réception de SMS)

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google, [https://www.jhipster.tech/heroku/ Heroku])
* Performances (résultat du injection de charge avec [[Apache JMeter]] ou [[Gatling]]) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Script "basique" pour le rolling update des composants répliqués (application, base de données, serveurs de mail, load balancer). Remarque: [[Kubernetes]] gère les rolling updates ([https://kubernetes.io/docs/tasks/run-application/rolling-update-replication-controller/ lien]).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom. JHipster génère le dockerfile de l'application et quelques descripteurs docker-compose.
* Préparation d'images [[Docker]]
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]], [[Telegraf]] + [[InfluxDB]] + [[Grafana]], [[Prometheus]] ...* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des mécanismes pour intégrer les besoins des utilisateurs
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits

===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

===Evaluation des IHMs===
Une IHM doit être évaluée par au moins deux types d'évaluation (en plus de l'évaluation fonctionnelle) :
* évaluation experte pour vérifier que les principes fondamentaux d'utilisabilité sont respectés
* tests utilisateur pour étudier comment vos utilisateurs utilise dans leurs contextes d'utilisation votre interface

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2018-2019.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html

===Quelques livres et technologies===

REMARQUE: les livres sur ces technologies se périment très vite.

====[[Spring]]====
* Bons tutoriels sur https://www.baeldung.com/rest-with-spring-series/
* Les manuels de références de Spring https://spring.io/projects/spring-boot#overview
* Craig Walls, Spring in Action, Fifth Edition, https://www.manning.com/books/spring-in-action-fifth-edition

====[[JHipster]]====
* Matt Raible, The JHipster Mini-Book 4.5 (GRATUIT) https://www.infoq.com/minibooks/jhipster-4x-mini-book
* Deepu K Sasidharan, Sendil Kumar N, Full Stack Development with JHipster, (10 $ en promotion) March 2018, https://www.packtpub.com/application-development/full-stack-development-jhipster

====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-12-11T13:14:26Z

Sybille.Caffiau: /* Soutenance de fin de projet */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système
'''Autres :'''
* ADE : Emploi du temps en ligne

==Groupes et sujets==
===Groupes eCOM-1F0 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

* [[ECOM-1FO_1819_Restaurant]] : '''William Weill (CP)''', Théo Lévesque, Loris Gentillon, Benjamin Besnier, Thomas Ozenda
* [[ECOM-1FO_1819_Spectacle]] : '''Thibaud Vegreville (CP)''', Joffrey Ferreira, Bastien Terrier, Cédric Lafrasse
* [[ECOM-1FO_1819_Camping]] : '''Timothée Depriester (CP)''', Sekina Belguendouz, Servan Charlot, Samuel Bamba, Florian Cuzin
* [[ECOM-1FO_1819_Transport]] : '''Julien Courtial (CP)''', Aurélien Surier, Raphaël Manger, Théo Echevet
* [[ECOM-1FO_1819_Sport]] : '''Hugo Gros-Daillon (CP)''', Quentin Fombaron, Tim Lepage, Vincent Aubert
* [[ECOM-1F0_1819_BTB|ECOM-1FO_1819_BruleTaBuche]] : '''Léo Valette (CP)''', Amina Boucherima, Zoran Chanet, Najwa Ez-zine, Enzo Molion

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et VZ).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2018.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P005)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production) (F214, F215).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P257)
* 25/09 15h45-18h30 : Séance en autonomie (F114, F214)

* 02/10 8h00-12h15 : Test utilisateur (SC) puis Séance en autonomie (P039)
* 02/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 09/10 8h00-12h15 : Audit 1 (P013) et Séance en autonomie (P105, P133)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (F114, F214)

* 16/10 8h00-12h15 : Séance en autonomie (P257)
* 16/10 15h45-18h30 : Séance encadrée (SC) (F214, F215)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P257)
* 23/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 06/11 8h00-12h15 : Audit 2 (F114) et Séance en autonomie (F202)
* 06/11 15h45-18h30 : Séance en autonomie (F214, F215)

* 12/11 8h00-12h15 : Séance en autonomie (P257)

* 20/11 8h00-12h15 : Séance en autonomie + Séance encadrée (SC) (P257)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 27/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 04/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 11/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 18/12 8h00-12h15 : Soutenances (F114) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (F114) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie [[Spring Boot]] / [[JHipster]].
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]] sur plusieurs VM dans un cloud public (AWS, GAE, Heroku, Azure, Bluemix, Digital Ocean ...), le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P013
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- 8h35 : Restaurant

- 9h10 : Spectacle

- 9h45 : Camping

- 10h20 : Transport

- 10h55 : Sport

- 11h30 : Brule ta bûche

''''' Contenu :'''''

Pour la partie GL et gestion de projet
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques et état de prise en main

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)
* Modèle de tâches et IHMA pour les premières tâches

===Audit 2 ===
*Salle : F114
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL et gestion de projet :
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Procédure de tests
* Procédure d'intégration du code

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- 8h : Transport

- 8h30 : Spectacle

- 9h : Restaurant

- 9h30 : Camping

- 10h : Sport

- 10h30 : Brule ta bûche

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : P
* Durée totale : 30 min (max 15 minutes de présentation, min 5 minutes de démo)
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

* ordre de passage :

- 8h : Sport

- 8h35 : Restaurant

- 9h10 : Spectacle

- 9h45 : Camping

- 10h20 : Transport

- 11h : Brule ta bûche

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
Votre présentation doit suivre le template suivante :
Vous devez suivre l'ordre dans lequel les items sont proposés mais vous pouvez ajouter des slides en cas de besoin pour illustrer (ex : pour expliquer votre processus).
Si vous avec des remarques/questions n'attendez pas pour les poser

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et VZ pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Tout votre projet doit être suivi grâce à gitLab.

A tout moment, les enseignants doivent donc pouvoir
* avoir la dernière version du code (dernière version du logiciel en production et ce qui est en cours de développement dans des branches dédiées)
* voir les tâches prévues/en cours/réalisées
* savoir le travail de chaque membre (effectué et assigné)
* consulter les documents de conception (à jour)
* consulter les CR des daily meeting et autres réunions et les rétrospectives et vos présentations aux différents audits
* avoir connaissance des procédures de qualité que vous mettez en place au sein de votre projet
* consulter les résultats des différents tests pour chaque release

Attention : nous insistons particulièrement sur le fait que toutes ces données doivent être maintenues en temps réel et accessibles sur le gitlab de votre projet.

Attention : nous consulterons également les messages de commit.

===Rendus===
Vous trouverez ci-dessous une liste (non exhaustive) de certains livrables pouvant être produits au sein de votre projet

'''''L1. Composition des groupes et sujet'''''. (obligatoire)
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants Spring de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation Spring : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement Spring. Un composant peut être implanté par un client généré à partir de l'interface de/des micro-services, par un micro-service REST (Controller), par un Service, par un Entity ou par un client Feign vers un micro-service externe au systeme (par exemple, service de paiement Swipe.com, ...).

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (tableau de tâches de Gitlab)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Evaluation de la cybersécurité du projet (option)'''''.

'''''L16. Evaluation des performances du projet (option)'''''.
* Résultat d'une injection de charge simpliste avec [[Gatling]]
* Résultat d'une injection de charge suivant un scénario complet avec [[Gatling]]

'''''L17. Gestion des risques (option)'''''.

'''''L18. Slides de présentation conception'''''.

'''''L19. Diapos de votre présentation de conception'''''.

'''''L20. Diapos de votre présentation finale'''''.

'''''L21. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L22. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à utiliser un outil adapté cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

Vous devez utiliser GitLab comme support à votre projet (versioning, gestion des tâches...).

Nous vous demandons également d'utiliser les issues pour la communication avec les enseignants. En particulier, toute absence ou télétravail doit être signalé par ce média.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer un groupe GitLab. Y ajouter les membres du projet eCOM. Créer plusieurs projets pour les différents parties. Activer les notifications. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données (UML ou similaire [https://www.jhipster.tech/jdl/ JDL]) et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des Entity (annotations JAX-RS, annotations [[Swagger]]).

L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl (généré avec le générateur [https://swagger.io/tools/swagger-codegen/ swagger-codegen]), [[Swagger]] UI, injecteur de charge [[Gatling]], ....) et le frontend AngularX que vous aurez généré avec [[JHipster]].

Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et utilisateurs finaux) et exécuter certaines requêtes avec des garanties transactionnelles.

TRES IMPORTANT : Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]]/IPtables pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, ...) pour la production (non répliquée)
# Mise en place de 2 containers base de données (MySQL) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] ou [[Nginx]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
# Génération et rafraichissement des certificats SSL avec [[Let's Encrypt]]
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec un FileStorageService ([https://www.callicoder.com/spring-boot-file-upload-download-rest-api-example/ lien])
** Gestion adaptative des contenus multimedia (photos) avec un ThumbnailService (montrez l'amélioration des performances avec Gatling)
** Gestion du cache client pour les photos et les thumbnails avec Cache-Control et ETag (montrez l'amélioration des performances avec Gatling)
** Utilisation de mode Lazy pour les chargements (fetch) des collections et des médias (CLOB,BLOB).
** Génération d'une application mobile [[Ionic]] avec [https://github.com/oktadeveloper/generator-jhipster-ionic generator-jhipster-ionic] (inclure les plugins [[Apache Cordova]] utiles à votre projet).
** Utilisation d'un cache ([https://www.jhipster.tech/using-cache/ préconisé par JHipster])
* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Génération de documents PDF à partir des valeurs de champs d'une entité ou du collection d'entités (exemple d'applications : facture, dossard coureur, export RGPD, ...) [https://www.stackextend.com/java/generate-pdf-document-using-jasperreports-and-spring-boot/ lien]
** Import et export massifs de collections d'entités en format CSV, JSON.
** Suivi du ''click stream'' avec des Filters/Aspects en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST avec [[Keycloak]] ou [[OKTA]].
** Utilisation du service de paiement Stripe.com en mode développeur
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Chatbot du helpdesk (comme [https://github.com/ovh-ux/ovh-chatbot ovh-chatbot])
** Gestion d'un [[CaaS]] Docker privé avec [[Minikube]], [[Kubernetes]], [[Rancher]] ou [[Docker Swarm]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers.
** Script périodique (crontab) de dump et de backup distant de la base MySQL.
** Gestion asynchrone et transactionnelle de l'envoi des courriels via le MailService, Thymeleaf et des taches @Scheduled
** Gestion asynchrone et transactionnelle de l'envoi de SMS (si le destinataire a un compte gratuit pour l'auto-réception de SMS)

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google, [https://www.jhipster.tech/heroku/ Heroku])
* Performances (résultat du injection de charge avec [[Apache JMeter]] ou [[Gatling]]) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Script "basique" pour le rolling update des composants répliqués (application, base de données, serveurs de mail, load balancer). Remarque: [[Kubernetes]] gère les rolling updates ([https://kubernetes.io/docs/tasks/run-application/rolling-update-replication-controller/ lien]).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom. JHipster génère le dockerfile de l'application et quelques descripteurs docker-compose.
* Préparation d'images [[Docker]]
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]], [[Telegraf]] + [[InfluxDB]] + [[Grafana]], [[Prometheus]] ...* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des mécanismes pour intégrer les besoins des utilisateurs
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits

===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

===Evaluation des IHMs===
Une IHM doit être évaluée par au moins deux types d'évaluation (en plus de l'évaluation fonctionnelle) :
* évaluation experte pour vérifier que les principes fondamentaux d'utilisabilité sont respectés
* tests utilisateur pour étudier comment vos utilisateurs utilise dans leurs contextes d'utilisation votre interface

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2018-2019.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html

===Quelques livres et technologies===

REMARQUE: les livres sur ces technologies se périment très vite.

====[[Spring]]====
* Bons tutoriels sur https://www.baeldung.com/rest-with-spring-series/
* Les manuels de références de Spring https://spring.io/projects/spring-boot#overview
* Craig Walls, Spring in Action, Fifth Edition, https://www.manning.com/books/spring-in-action-fifth-edition

====[[JHipster]]====
* Matt Raible, The JHipster Mini-Book 4.5 (GRATUIT) https://www.infoq.com/minibooks/jhipster-4x-mini-book
* Deepu K Sasidharan, Sendil Kumar N, Full Stack Development with JHipster, (10 $ en promotion) March 2018, https://www.packtpub.com/application-development/full-stack-development-jhipster

====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

File:Présentation RICM-2018.odp

2018-12-11T12:58:58Z

Sybille.Caffiau:

ECOM-1FO

2018-12-04T16:47:56Z

Sybille.Caffiau: /* Soutenance de fin de projet */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système
'''Autres :'''
* ADE : Emploi du temps en ligne

==Groupes et sujets==
===Groupes eCOM-1F0 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

* [[ECOM-1FO_1819_Restaurant]] : '''William Weill (CP)''', Théo Lévesque, Loris Gentillon, Benjamin Besnier, Thomas Ozenda
* [[ECOM-1FO_1819_Spectacle]] : '''Thibaud Vegreville (CP)''', Joffrey Ferreira, Bastien Terrier, Cédric Lafrasse
* [[ECOM-1FO_1819_Camping]] : '''Timothée Depriester (CP)''', Sekina Belguendouz, Servan Charlot, Samuel Bamba, Florian Cuzin
* [[ECOM-1FO_1819_Transport]] : '''Julien Courtial (CP)''', Aurélien Surier, Raphaël Manger, Théo Echevet
* [[ECOM-1FO_1819_Sport]] : '''Hugo Gros-Daillon (CP)''', Quentin Fombaron, Tim Lepage, Vincent Aubert
* [[ECOM-1F0_1819_BTB|ECOM-1FO_1819_BruleTaBuche]] : '''Léo Valette (CP)''', Amina Boucherima, Zoran Chanet, Najwa Ez-zine, Enzo Molion

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et VZ).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2018.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P005)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production) (F214, F215).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P257)
* 25/09 15h45-18h30 : Séance en autonomie (F114, F214)

* 02/10 8h00-12h15 : Test utilisateur (SC) puis Séance en autonomie (P039)
* 02/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 09/10 8h00-12h15 : Audit 1 (P013) et Séance en autonomie (P105, P133)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (F114, F214)

* 16/10 8h00-12h15 : Séance en autonomie (P257)
* 16/10 15h45-18h30 : Séance encadrée (SC) (F214, F215)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P257)
* 23/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 06/11 8h00-12h15 : Audit 2 (F114) et Séance en autonomie (F202)
* 06/11 15h45-18h30 : Séance en autonomie (F214, F215)

* 12/11 8h00-12h15 : Séance en autonomie (P257)

* 20/11 8h00-12h15 : Séance en autonomie + Séance encadrée (SC) (P257)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 27/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 04/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 11/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 18/12 8h00-12h15 : Soutenances (F114) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (F114) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie [[Spring Boot]] / [[JHipster]].
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]] sur plusieurs VM dans un cloud public (AWS, GAE, Heroku, Azure, Bluemix, Digital Ocean ...), le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P013
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- 8h35 : Restaurant

- 9h10 : Spectacle

- 9h45 : Camping

- 10h20 : Transport

- 10h55 : Sport

- 11h30 : Brule ta bûche

''''' Contenu :'''''

Pour la partie GL et gestion de projet
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques et état de prise en main

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)
* Modèle de tâches et IHMA pour les premières tâches

===Audit 2 ===
*Salle : F114
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL et gestion de projet :
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Procédure de tests
* Procédure d'intégration du code

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- 8h : Transport

- 8h30 : Spectacle

- 9h : Restaurant

- 9h30 : Camping

- 10h : Sport

- 10h30 : Brule ta bûche

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : P
* Durée totale : 30 min (max 15 minutes de présentation, min 5 minutes de démo)
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

* ordre de passage :

- 8h : Sport

- 8h35 : Restaurant

- 9h10 : Spectacle

- 9h45 : Camping

- 10h20 : Transport

- 11h : Brule ta bûche

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré avec vos différentes productions)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et VZ pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Tout votre projet doit être suivi grâce à gitLab.

A tout moment, les enseignants doivent donc pouvoir
* avoir la dernière version du code (dernière version du logiciel en production et ce qui est en cours de développement dans des branches dédiées)
* voir les tâches prévues/en cours/réalisées
* savoir le travail de chaque membre (effectué et assigné)
* consulter les documents de conception (à jour)
* consulter les CR des daily meeting et autres réunions et les rétrospectives et vos présentations aux différents audits
* avoir connaissance des procédures de qualité que vous mettez en place au sein de votre projet
* consulter les résultats des différents tests pour chaque release

Attention : nous insistons particulièrement sur le fait que toutes ces données doivent être maintenues en temps réel et accessibles sur le gitlab de votre projet.

Attention : nous consulterons également les messages de commit.

===Rendus===
Vous trouverez ci-dessous une liste (non exhaustive) de certains livrables pouvant être produits au sein de votre projet

'''''L1. Composition des groupes et sujet'''''. (obligatoire)
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants Spring de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation Spring : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement Spring. Un composant peut être implanté par un client généré à partir de l'interface de/des micro-services, par un micro-service REST (Controller), par un Service, par un Entity ou par un client Feign vers un micro-service externe au systeme (par exemple, service de paiement Swipe.com, ...).

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (tableau de tâches de Gitlab)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Evaluation de la cybersécurité du projet (option)'''''.

'''''L16. Evaluation des performances du projet (option)'''''.
* Résultat d'une injection de charge simpliste avec [[Gatling]]
* Résultat d'une injection de charge suivant un scénario complet avec [[Gatling]]

'''''L17. Gestion des risques (option)'''''.

'''''L18. Slides de présentation conception'''''.

'''''L19. Diapos de votre présentation de conception'''''.

'''''L20. Diapos de votre présentation finale'''''.

'''''L21. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L22. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à utiliser un outil adapté cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

Vous devez utiliser GitLab comme support à votre projet (versioning, gestion des tâches...).

Nous vous demandons également d'utiliser les issues pour la communication avec les enseignants. En particulier, toute absence ou télétravail doit être signalé par ce média.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer un groupe GitLab. Y ajouter les membres du projet eCOM. Créer plusieurs projets pour les différents parties. Activer les notifications. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données (UML ou similaire [https://www.jhipster.tech/jdl/ JDL]) et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des Entity (annotations JAX-RS, annotations [[Swagger]]).

L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl (généré avec le générateur [https://swagger.io/tools/swagger-codegen/ swagger-codegen]), [[Swagger]] UI, injecteur de charge [[Gatling]], ....) et le frontend AngularX que vous aurez généré avec [[JHipster]].

Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et utilisateurs finaux) et exécuter certaines requêtes avec des garanties transactionnelles.

TRES IMPORTANT : Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]]/IPtables pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, ...) pour la production (non répliquée)
# Mise en place de 2 containers base de données (MySQL) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] ou [[Nginx]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
# Génération et rafraichissement des certificats SSL avec [[Let's Encrypt]]
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec un FileStorageService ([https://www.callicoder.com/spring-boot-file-upload-download-rest-api-example/ lien])
** Gestion adaptative des contenus multimedia (photos) avec un ThumbnailService (montrez l'amélioration des performances avec Gatling)
** Gestion du cache client pour les photos et les thumbnails avec Cache-Control et ETag (montrez l'amélioration des performances avec Gatling)
** Utilisation de mode Lazy pour les chargements (fetch) des collections et des médias (CLOB,BLOB).
** Génération d'une application mobile [[Ionic]] avec [https://github.com/oktadeveloper/generator-jhipster-ionic generator-jhipster-ionic] (inclure les plugins [[Apache Cordova]] utiles à votre projet).
** Utilisation d'un cache ([https://www.jhipster.tech/using-cache/ préconisé par JHipster])
* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Génération de documents PDF à partir des valeurs de champs d'une entité ou du collection d'entités (exemple d'applications : facture, dossard coureur, export RGPD, ...) [https://www.stackextend.com/java/generate-pdf-document-using-jasperreports-and-spring-boot/ lien]
** Import et export massifs de collections d'entités en format CSV, JSON.
** Suivi du ''click stream'' avec des Filters/Aspects en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST avec [[Keycloak]] ou [[OKTA]].
** Utilisation du service de paiement Stripe.com en mode développeur
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Chatbot du helpdesk (comme [https://github.com/ovh-ux/ovh-chatbot ovh-chatbot])
** Gestion d'un [[CaaS]] Docker privé avec [[Minikube]], [[Kubernetes]], [[Rancher]] ou [[Docker Swarm]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers.
** Script périodique (crontab) de dump et de backup distant de la base MySQL.
** Gestion asynchrone et transactionnelle de l'envoi des courriels via le MailService, Thymeleaf et des taches @Scheduled
** Gestion asynchrone et transactionnelle de l'envoi de SMS (si le destinataire a un compte gratuit pour l'auto-réception de SMS)

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google, [https://www.jhipster.tech/heroku/ Heroku])
* Performances (résultat du injection de charge avec [[Apache JMeter]] ou [[Gatling]]) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Script "basique" pour le rolling update des composants répliqués (application, base de données, serveurs de mail, load balancer). Remarque: [[Kubernetes]] gère les rolling updates ([https://kubernetes.io/docs/tasks/run-application/rolling-update-replication-controller/ lien]).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom. JHipster génère le dockerfile de l'application et quelques descripteurs docker-compose.
* Préparation d'images [[Docker]]
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]], [[Telegraf]] + [[InfluxDB]] + [[Grafana]], [[Prometheus]] ...* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des mécanismes pour intégrer les besoins des utilisateurs
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits

===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

===Evaluation des IHMs===
Une IHM doit être évaluée par au moins deux types d'évaluation (en plus de l'évaluation fonctionnelle) :
* évaluation experte pour vérifier que les principes fondamentaux d'utilisabilité sont respectés
* tests utilisateur pour étudier comment vos utilisateurs utilise dans leurs contextes d'utilisation votre interface

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2018-2019.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html

===Quelques livres et technologies===

REMARQUE: les livres sur ces technologies se périment très vite.

====[[Spring]]====
* Bons tutoriels sur https://www.baeldung.com/rest-with-spring-series/
* Les manuels de références de Spring https://spring.io/projects/spring-boot#overview
* Craig Walls, Spring in Action, Fifth Edition, https://www.manning.com/books/spring-in-action-fifth-edition

====[[JHipster]]====
* Matt Raible, The JHipster Mini-Book 4.5 (GRATUIT) https://www.infoq.com/minibooks/jhipster-4x-mini-book
* Deepu K Sasidharan, Sendil Kumar N, Full Stack Development with JHipster, (10 $ en promotion) March 2018, https://www.packtpub.com/application-development/full-stack-development-jhipster

====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-11-05T09:05:10Z

Sybille.Caffiau: /* Audit 2 */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système
'''Autres :'''
* ADE : Emploi du temps en ligne

==Groupes et sujets==
===Groupes eCOM-1F0 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

* [[ECOM-1FO_1819_Restaurant]] : '''William Weill (CP)''', Théo Lévesque, Loris Gentillon, Benjamin Besnier, Thomas Ozenda
* [[ECOM-1FO_1819_Spectacle]] : '''Thibaud Vegreville (CP)''', Joffrey Ferreira, Bastien Terrier, Cédric Lafrasse
* [[ECOM-1FO_1819_Camping]] : '''Timothée Depriester (CP)''', Sekina Belguendouz, Servan Charlot, Samuel Bamba, Florian Cuzin
* [[ECOM-1FO_1819_Transport]] : '''Julien Courtial (CP)''', Aurélien Surier, Raphaël Manger, Théo Echevet
* [[ECOM-1FO_1819_Sport]] : '''Hugo Gros-Daillon (CP)''', Quentin Fombaron, Tim Lepage, Vincent Aubert
* [[ECOM-1F0_1819_BTB|ECOM-1FO_1819_BruleTaBuche]] : '''Léo Valette (CP)''', Amina Boucherima, Zoran Chanet, Najwa Ez-zine, Enzo Molion

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et VZ).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2018.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P005)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production) (F214, F215).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P257)
* 25/09 15h45-18h30 : Séance en autonomie (F114, F214)

* 02/10 8h00-12h15 : Test utilisateur (SC) puis Séance en autonomie (P039)
* 02/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 09/10 8h00-12h15 : Audit 1 (P013) et Séance en autonomie (P105, P133)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (F114, F214)

* 16/10 8h00-12h15 : Séance en autonomie (P257)
* 16/10 15h45-18h30 : Séance encadrée (SC) (F214, F215)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P257)
* 23/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 06/11 8h00-12h15 : Audit 2 (F114) et Séance en autonomie (F202)
* 06/11 15h45-18h30 : Séance en autonomie (F214, F215)

* 12/11 8h00-12h15 : Séance en autonomie (P257)

* 20/11 8h00-12h15 : Séance en autonomie + Séance encadrée (SC) (P257)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 27/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 04/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 11/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 18/12 8h00-12h15 : Soutenances (F114) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (F114) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie [[Spring Boot]] / [[JHipster]].
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]] sur plusieurs VM dans un cloud public (AWS, GAE, Heroku, Azure, Bluemix, Digital Ocean ...), le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P013
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- 8h35 : Restaurant

- 9h10 : Spectacle

- 9h45 : Camping

- 10h20 : Transport

- 10h55 : Sport

- 11h30 : Brule ta bûche

''''' Contenu :'''''

Pour la partie GL et gestion de projet
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques et état de prise en main

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)
* Modèle de tâches et IHMA pour les premières tâches

===Audit 2 ===
*Salle : F114
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL et gestion de projet :
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Procédure de tests
* Procédure d'intégration du code

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- 8h : Transport

- 8h30 : Spectacle

- 9h : Restaurant

- 9h30 : Camping

- 10h : Sport

- 10h30 : Brule ta bûche

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : P
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré avec vos différentes productions)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* groupe 1
* groupe 3
* groupe 5
* groupe 4
* groupe 6
* groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et VZ pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Tout votre projet doit être suivi grâce à gitLab.

A tout moment, les enseignants doivent donc pouvoir
* avoir la dernière version du code (dernière version du logiciel en production et ce qui est en cours de développement dans des branches dédiées)
* voir les tâches prévues/en cours/réalisées
* savoir le travail de chaque membre (effectué et assigné)
* consulter les documents de conception (à jour)
* consulter les CR des daily meeting et autres réunions et les rétrospectives et vos présentations aux différents audits
* avoir connaissance des procédures de qualité que vous mettez en place au sein de votre projet
* consulter les résultats des différents tests pour chaque release

Attention : nous insistons particulièrement sur le fait que toutes ces données doivent être maintenues en temps réel et accessibles sur le gitlab de votre projet.

Attention : nous consulterons également les messages de commit.

===Rendus===
Vous trouverez ci-dessous une liste (non exhaustive) de certains livrables pouvant être produits au sein de votre projet

'''''L1. Composition des groupes et sujet'''''. (obligatoire)
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants Spring de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation Spring : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement Spring. Un composant peut être implanté par un client généré à partir de l'interface de/des micro-services, par un micro-service REST (Controller), par un Service, par un Entity ou par un client Feign vers un micro-service externe au systeme (par exemple, service de paiement Swipe.com, ...).

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (tableau de tâches de Gitlab)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Evaluation de la cybersécurité du projet (option)'''''.

'''''L16. Evaluation des performances du projet (option)'''''.
* Résultat d'une injection de charge simpliste avec [[Gatling]]
* Résultat d'une injection de charge suivant un scénario complet avec [[Gatling]]

'''''L17. Gestion des risques (option)'''''.

'''''L18. Slides de présentation conception'''''.

'''''L19. Diapos de votre présentation de conception'''''.

'''''L20. Diapos de votre présentation finale'''''.

'''''L21. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L22. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à utiliser un outil adapté cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

Vous devez utiliser GitLab comme support à votre projet (versioning, gestion des tâches...).

Nous vous demandons également d'utiliser les issues pour la communication avec les enseignants. En particulier, toute absence ou télétravail doit être signalé par ce média.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer un groupe GitLab. Y ajouter les membres du projet eCOM. Créer plusieurs projets pour les différents parties. Activer les notifications. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données (UML ou similaire [https://www.jhipster.tech/jdl/ JDL]) et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des Entity (annotations JAX-RS, annotations [[Swagger]]).

L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl (généré avec le générateur [https://swagger.io/tools/swagger-codegen/ swagger-codegen]), [[Swagger]] UI, injecteur de charge [[Gatling]], ....) et le frontend AngularX que vous aurez généré avec [[JHipster]].

Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et utilisateurs finaux) et exécuter certaines requêtes avec des garanties transactionnelles.

TRES IMPORTANT : Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]]/IPtables pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, ...) pour la production (non répliquée)
# Mise en place de 2 containers base de données (MySQL) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] ou [[Nginx]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
# Génération et rafraichissement des certificats SSL avec [[Let's Encrypt]]
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec un FileStorageService ([https://www.callicoder.com/spring-boot-file-upload-download-rest-api-example/ lien])
** Gestion adaptative des contenus multimedia (photos) avec un ThumbnailService (montrez l'amélioration des performances avec Gatling)
** Gestion du cache client pour les photos et les thumbnails avec Cache-Control et ETag (montrez l'amélioration des performances avec Gatling)
** Utilisation de mode Lazy pour les chargements (fetch) des collections et des médias (CLOB,BLOB).
** Génération d'une application mobile [[Ionic]] avec [https://github.com/oktadeveloper/generator-jhipster-ionic generator-jhipster-ionic] (inclure les plugins [[Apache Cordova]] utiles à votre projet).
** Utilisation d'un cache ([https://www.jhipster.tech/using-cache/ préconisé par JHipster])
* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Génération de documents PDF à partir des valeurs de champs d'une entité ou du collection d'entités (exemple d'applications : facture, dossard coureur, export RGPD, ...) [https://www.stackextend.com/java/generate-pdf-document-using-jasperreports-and-spring-boot/ lien]
** Import et export massifs de collections d'entités en format CSV, JSON.
** Suivi du ''click stream'' avec des Filters/Aspects en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST avec [[Keycloak]] ou [[OKTA]].
** Utilisation du service de paiement Stripe.com en mode développeur
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Chatbot du helpdesk (comme [https://github.com/ovh-ux/ovh-chatbot ovh-chatbot])
** Gestion d'un [[CaaS]] Docker privé avec [[Minikube]], [[Kubernetes]], [[Rancher]] ou [[Docker Swarm]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers.
** Script périodique (crontab) de dump et de backup distant de la base MySQL.
** Gestion asynchrone et transactionnelle de l'envoi des courriels via le MailService, Thymeleaf et des taches @Scheduled
** Gestion asynchrone et transactionnelle de l'envoi de SMS (si le destinataire a un compte gratuit pour l'auto-réception de SMS)

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google, [https://www.jhipster.tech/heroku/ Heroku])
* Performances (résultat du injection de charge avec [[Apache JMeter]] ou [[Gatling]]) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Script "basique" pour le rolling update des composants répliqués (application, base de données, serveurs de mail, load balancer). Remarque: [[Kubernetes]] gère les rolling updates ([https://kubernetes.io/docs/tasks/run-application/rolling-update-replication-controller/ lien]).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom. JHipster génère le dockerfile de l'application et quelques descripteurs docker-compose.
* Préparation d'images [[Docker]]
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]], [[Telegraf]] + [[InfluxDB]] + [[Grafana]], [[Prometheus]] ...* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des mécanismes pour intégrer les besoins des utilisateurs
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits

===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

===Evaluation des IHMs===
Une IHM doit être évaluée par au moins deux types d'évaluation (en plus de l'évaluation fonctionnelle) :
* évaluation experte pour vérifier que les principes fondamentaux d'utilisabilité sont respectés
* tests utilisateur pour étudier comment vos utilisateurs utilise dans leurs contextes d'utilisation votre interface

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2018-2019.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html

===Quelques livres et technologies===

REMARQUE: les livres sur ces technologies se périment très vite.

====[[Spring]]====
* Bons tutoriels sur https://www.baeldung.com/rest-with-spring-series/
* Les manuels de références de Spring https://spring.io/projects/spring-boot#overview
* Craig Walls, Spring in Action, Fifth Edition, https://www.manning.com/books/spring-in-action-fifth-edition

====[[JHipster]]====
* Matt Raible, The JHipster Mini-Book 4.5 (GRATUIT) https://www.infoq.com/minibooks/jhipster-4x-mini-book
* Deepu K Sasidharan, Sendil Kumar N, Full Stack Development with JHipster, (10 $ en promotion) March 2018, https://www.packtpub.com/application-development/full-stack-development-jhipster

====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-10-29T08:45:48Z

Sybille.Caffiau: /* Audit 2 */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système
'''Autres :'''
* ADE : Emploi du temps en ligne

==Groupes et sujets==
===Groupes eCOM-1F0 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

* [[ECOM-1FO_1819_Restaurant]] : '''William Weill (CP)''', Théo Lévesque, Loris Gentillon, Benjamin Besnier, Thomas Ozenda
* [[ECOM-1FO_1819_Spectacle]] : '''Thibaud Vegreville (CP)''', Joffrey Ferreira, Bastien Terrier, Cédric Lafrasse
* [[ECOM-1FO_1819_Camping]] : '''Timothée Depriester (CP)''', Sekina Belguendouz, Servan Charlot, Samuel Bamba, Florian Cuzin
* [[ECOM-1FO_1819_Transport]] : '''Prénom Nom (CP)''', Prénom Nom, Prénom Nom, Prénom Nom, Prénom Nom
* [[ECOM-1FO_1819_Sport]] : '''Hugo Gros-Daillon (CP)''', Quentin Fombaron, Tim Lepage, Vincent Aubert
* [[ECOM-1F0_1819_BTB|ECOM-1FO_1819_BruleTaBuche]] : '''Léo Valette (CP)''', Amina Boucherima, Zoran Chanet, Najwa Ez-zine, Enzo Molion

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et VZ).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2018.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P005)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production) (F214, F215).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P257)
* 25/09 15h45-18h30 : Séance en autonomie (F114, F214)

* 02/10 8h00-12h15 : Test utilisateur (SC) puis Séance en autonomie (P039)
* 02/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 09/10 8h00-12h15 : Audit 1 (P013) et Séance en autonomie (P105, P133)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (F114, F214)

* 16/10 8h00-12h15 : Séance en autonomie (P257)
* 16/10 15h45-18h30 : Séance encadrée (SC) (F214, F215)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P257)
* 23/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 06/11 8h00-12h15 : Audit 2 (F114) et Séance en autonomie (F202)
* 06/11 15h45-18h30 : Séance en autonomie (F214, F215)

* 12/11 8h00-12h15 : Séance en autonomie (P257)

* 20/11 8h00-12h15 : Séance en autonomie + Séance encadrée (SC) (P257)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 27/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 04/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 11/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 18/12 8h00-12h15 : Soutenances (F114) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (F114) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie [[Spring Boot]] / [[JHipster]].
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]] sur plusieurs VM dans un cloud public (AWS, GAE, Heroku, Azure, Bluemix, Digital Ocean ...), le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P013
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- 8h35 : Restaurant

- 9h10 : Spectacle

- 9h45 : Camping

- 10h20 : Transport

- 10h55 : Sport

- 11h30 : Brule ta bûche

''''' Contenu :'''''

Pour la partie GL et gestion de projet
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques et état de prise en main

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)
* Modèle de tâches et IHMA pour les premières tâches

===Audit 2 ===
*Salle : F114
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL et gestion de projet :
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Procédure de tests
* Procédure d'intégration du code

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''
- 8h : Transport

- 8h30 : Spectacle

- 9h : Restaurant

- 9h30 : Camping

- 10h : Sport

- 10h30 : Brule ta bûche

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : P
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré avec vos différentes productions)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* groupe 1
* groupe 3
* groupe 5
* groupe 4
* groupe 6
* groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et VZ pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Tout votre projet doit être suivi grâce à gitLab.

A tout moment, les enseignants doivent donc pouvoir
* avoir la dernière version du code (dernière version du logiciel en production et ce qui est en cours de développement dans des branches dédiées)
* voir les tâches prévues/en cours/réalisées
* savoir le travail de chaque membre (effectué et assigné)
* consulter les documents de conception (à jour)
* consulter les CR des daily meeting et autres réunions et les rétrospectives et vos présentations aux différents audits
* avoir connaissance des procédures de qualité que vous mettez en place au sein de votre projet
* consulter les résultats des différents tests pour chaque release

Attention : nous insistons particulièrement sur le fait que toutes ces données doivent être maintenues en temps réel et accessibles sur le gitlab de votre projet.

Attention : nous consulterons également les messages de commit.

===Rendus===
Vous trouverez ci-dessous une liste (non exhaustive) de certains livrables pouvant être produits au sein de votre projet

'''''L1. Composition des groupes et sujet'''''. (obligatoire)
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants Spring de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation Spring : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement Spring. Un composant peut être implanté par un client généré à partir de l'interface de/des micro-services, par un micro-service REST (Controller), par un Service, par un Entity ou par un client Feign vers un micro-service externe au systeme (par exemple, service de paiement Swipe.com, ...).

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (tableau de tâches de Gitlab)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Evaluation de la cybersécurité du projet (option)'''''.

'''''L16. Evaluation des performances du projet (option)'''''.
* Résultat d'une injection de charge simpliste avec [[Gatling]]
* Résultat d'une injection de charge suivant un scénario complet avec [[Gatling]]

'''''L17. Gestion des risques (option)'''''.

'''''L18. Slides de présentation conception'''''.

'''''L19. Diapos de votre présentation de conception'''''.

'''''L20. Diapos de votre présentation finale'''''.

'''''L21. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L22. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à utiliser un outil adapté cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

Vous devez utiliser GitLab comme support à votre projet (versioning, gestion des tâches...).

Nous vous demandons également d'utiliser les issues pour la communication avec les enseignants. En particulier, toute absence ou télétravail doit être signalé par ce média.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer un groupe GitLab. Y ajouter les membres du projet eCOM. Créer plusieurs projets pour les différents parties. Activer les notifications. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données (UML ou similaire [https://www.jhipster.tech/jdl/ JDL]) et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des Entity (annotations JAX-RS, annotations [[Swagger]]).

L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl (généré avec le générateur [https://swagger.io/tools/swagger-codegen/ swagger-codegen]), [[Swagger]] UI, injecteur de charge [[Gatling]], ....) et le frontend AngularX que vous aurez généré avec [[JHipster]].

Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et utilisateurs finaux) et exécuter certaines requêtes avec des garanties transactionnelles.

TRES IMPORTANT : Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]]/IPtables pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, ...) pour la production (non répliquée)
# Mise en place de 2 containers base de données (MySQL) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] ou [[Nginx]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
# Génération et rafraichissement des certificats SSL avec [[Let's Encrypt]]
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec un FileStorageService ([https://www.callicoder.com/spring-boot-file-upload-download-rest-api-example/ lien])
** Gestion adaptative des contenus multimedia (photos) avec un ThumbnailService (montrez l'amélioration des performances avec Gatling)
** Gestion du cache client pour les photos et les thumbnails avec Cache-Control et ETag (montrez l'amélioration des performances avec Gatling)
** Utilisation de mode Lazy pour les chargements (fetch) des collections et des médias (CLOB,BLOB).
** Génération d'une application mobile [[Ionic]] avec [https://github.com/oktadeveloper/generator-jhipster-ionic generator-jhipster-ionic] (inclure les plugins [[Apache Cordova]] utiles à votre projet).
** Utilisation d'un cache ([https://www.jhipster.tech/using-cache/ préconisé par JHipster])
* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Génération de documents PDF à partir des valeurs de champs d'une entité ou du collection d'entités (exemple d'applications : facture, dossard coureur, export RGPD, ...) [https://www.stackextend.com/java/generate-pdf-document-using-jasperreports-and-spring-boot/ lien]
** Import et export massifs de collections d'entités en format CSV, JSON.
** Suivi du ''click stream'' avec des Filters/Aspects en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST avec [[Keycloak]] ou [[OKTA]].
** Utilisation du service de paiement Stripe.com en mode développeur
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Chatbot du helpdesk (comme [https://github.com/ovh-ux/ovh-chatbot ovh-chatbot])
** Gestion d'un [[CaaS]] Docker privé avec [[Minikube]], [[Kubernetes]], [[Rancher]] ou [[Docker Swarm]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers.
** Script périodique (crontab) de dump et de backup distant de la base MySQL.
** Gestion asynchrone et transactionnelle de l'envoi des courriels via le MailService, Thymeleaf et des taches @Scheduled
** Gestion asynchrone et transactionnelle de l'envoi de SMS (si le destinataire a un compte gratuit pour l'auto-réception de SMS)

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google, [https://www.jhipster.tech/heroku/ Heroku])
* Performances (résultat du injection de charge avec [[Apache JMeter]] ou [[Gatling]]) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Script "basique" pour le rolling update des composants répliqués (application, base de données, serveurs de mail, load balancer). Remarque: [[Kubernetes]] gère les rolling updates ([https://kubernetes.io/docs/tasks/run-application/rolling-update-replication-controller/ lien]).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom. JHipster génère le dockerfile de l'application et quelques descripteurs docker-compose.
* Préparation d'images [[Docker]]
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]], [[Telegraf]] + [[InfluxDB]] + [[Grafana]], [[Prometheus]] ...* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des mécanismes pour intégrer les besoins des utilisateurs
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits

===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

===Evaluation des IHMs===
Une IHM doit être évaluée par au moins deux types d'évaluation (en plus de l'évaluation fonctionnelle) :
* évaluation experte pour vérifier que les principes fondamentaux d'utilisabilité sont respectés
* tests utilisateur pour étudier comment vos utilisateurs utilise dans leurs contextes d'utilisation votre interface

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2018-2019.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html

===Quelques livres et technologies===

REMARQUE: les livres sur ces technologies se périment très vite.

====[[Spring]]====
* Bons tutoriels sur https://www.baeldung.com/rest-with-spring-series/
* Les manuels de références de Spring https://spring.io/projects/spring-boot#overview
* Craig Walls, Spring in Action, Fifth Edition, https://www.manning.com/books/spring-in-action-fifth-edition

====[[JHipster]]====
* Matt Raible, The JHipster Mini-Book 4.5 (GRATUIT) https://www.infoq.com/minibooks/jhipster-4x-mini-book
* Deepu K Sasidharan, Sendil Kumar N, Full Stack Development with JHipster, (10 $ en promotion) March 2018, https://www.packtpub.com/application-development/full-stack-development-jhipster

====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-M2PGI

2018-10-26T09:23:44Z

Sybille.Caffiau: /* M2PGI (Classique) */

ECOM-M2PGI

2018-10-25T16:59:05Z

Sybille.Caffiau: /* Audit 3 (Soutenances) : */

ECOM-1FO

2018-10-22T08:47:56Z

Sybille.Caffiau: /* Planning des séances */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système
'''Autres :'''
* ADE : Emploi du temps en ligne

==Groupes et sujets==
===Groupes eCOM-1F0 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

* [[ECOM-1FO_1819_Restaurant]] : '''Prénom Nom (CP)''', Prénom Nom, Prénom Nom, Prénom Nom, Prénom Nom
* [[ECOM-1FO_1819_Spectacle]] : '''Thibaud Vegreville (CP)''', Joffrey Ferreira, Bastien Terrier, Cédric Lafrasse
* [[ECOM-1FO_1819_Camping]] : '''Timothée Depriester (CP)''', Sekina Belguendouz, Servan Charlot, Samuel Bamba, Florian Cuzin
* [[ECOM-1FO_1819_Transport]] : '''Prénom Nom (CP)''', Prénom Nom, Prénom Nom, Prénom Nom, Prénom Nom
* [[ECOM-1FO_1819_Sport]] : '''Hugo Gros-Daillon (CP)''', Quentin Fombaron, Tim Lepage, Vincent Aubert
* [[ECOM-1F0_1819_BTB|ECOM-1FO_1819_BruleTaBuche]] : '''Léo Valette (CP)''', Amina Boucherima, Zoran Chanet, Najwa Ez-zine, Enzo Molion

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et VZ).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2018.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P005)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production) (F214, F215).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P257)
* 25/09 15h45-18h30 : Séance en autonomie (F114, F214)

* 02/10 8h00-12h15 : Test utilisateur (SC) puis Séance en autonomie (P039)
* 02/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 09/10 8h00-12h15 : Audit 1 (P013) et Séance en autonomie (P105, P133)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (F114, F214)

* 16/10 8h00-12h15 : Séance en autonomie (P257)
* 16/10 15h45-18h30 : Séance encadrée (SC) (F214, F215)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P257)
* 23/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 06/11 8h00-12h15 : Audit 2 (F114) et Séance en autonomie (F202)
* 06/11 15h45-18h30 : Séance en autonomie (F214, F215)

* 12/11 8h00-12h15 : Séance en autonomie (P257)

* 20/11 8h00-12h15 : Séance en autonomie + Séance encadrée (SC) (P257)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 27/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 04/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 11/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 18/12 8h00-12h15 : Soutenances (F114) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (F114) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie [[Spring Boot]] / [[JHipster]].
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]] sur plusieurs VM dans un cloud public (AWS, GAE, Heroku, Azure, Bluemix, Digital Ocean ...), le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P013
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- 8h35 : Restaurant

- 9h10 : Spectacle

- 9h45 : Camping

- 10h20 : Transport

- 10h55 : Sport

- 11h30 : Brule ta bûche

''''' Contenu :'''''

Pour la partie GL et gestion de projet
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques et état de prise en main

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)
* Modèle de tâches et IHMA pour les premières tâches

===Audit 2 ===
*Salle : P
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL et gestion de projet :
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Procédure de tests
* Procédure d'intégration du code

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 :

- groupe 1 :

- groupe 5 :

- groupe 2 :

- groupe 4 :

- groupe 3 :

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : P
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré avec vos différentes productions)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* groupe 1
* groupe 3
* groupe 5
* groupe 4
* groupe 6
* groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et VZ pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Tout votre projet doit être suivi grâce à gitLab.

A tout moment, les enseignants doivent donc pouvoir
* avoir la dernière version du code (dernière version du logiciel en production et ce qui est en cours de développement dans des branches dédiées)
* voir les tâches prévues/en cours/réalisées
* savoir le travail de chaque membre (effectué et assigné)
* consulter les documents de conception (à jour)
* consulter les CR des daily meeting et autres réunions et les rétrospectives et vos présentations aux différents audits
* avoir connaissance des procédures de qualité que vous mettez en place au sein de votre projet
* consulter les résultats des différents tests pour chaque release

Attention : nous insistons particulièrement sur le fait que toutes ces données doivent être maintenues en temps réel et accessibles sur le gitlab de votre projet.

Attention : nous consulterons également les messages de commit.

===Rendus===
Vous trouverez ci-dessous une liste (non exhaustive) de certains livrables pouvant être produits au sein de votre projet

'''''L1. Composition des groupes et sujet'''''. (obligatoire)
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants Spring de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation Spring : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement Spring. Un composant peut être implanté par un client généré à partir de l'interface de/des micro-services, par un micro-service REST (Controller), par un Service, par un Entity ou par un client Feign vers un micro-service externe au systeme (par exemple, service de paiement Swipe.com, ...).

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (tableau de tâches de Gitlab)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Evaluation de la cybersécurité du projet (option)'''''.

'''''L16. Evaluation des performances du projet (option)'''''.
* Résultat d'une injection de charge simpliste avec [[Gatling]]
* Résultat d'une injection de charge suivant un scénario complet avec [[Gatling]]

'''''L17. Gestion des risques (option)'''''.

'''''L18. Slides de présentation conception'''''.

'''''L19. Diapos de votre présentation de conception'''''.

'''''L20. Diapos de votre présentation finale'''''.

'''''L21. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L22. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à utiliser un outil adapté cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

Vous devez utiliser GitLab comme support à votre projet (versioning, gestion des tâches...).

Nous vous demandons également d'utiliser les issues pour la communication avec les enseignants. En particulier, toute absence ou télétravail doit être signalé par ce média.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer un groupe GitLab. Y ajouter les membres du projet eCOM. Créer plusieurs projets pour les différents parties. Activer les notifications. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données (UML ou similaire [https://www.jhipster.tech/jdl/ JDL]) et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des Entity (annotations JAX-RS, annotations [[Swagger]]).

L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl (généré avec le générateur [https://swagger.io/tools/swagger-codegen/ swagger-codegen]), [[Swagger]] UI, injecteur de charge [[Gatling]], ....) et le frontend AngularX que vous aurez généré avec [[JHipster]].

Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et utilisateurs finaux) et exécuter certaines requêtes avec des garanties transactionnelles.

TRES IMPORTANT : Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]]/IPtables pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, ...) pour la production (non répliquée)
# Mise en place de 2 containers base de données (MySQL) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] ou [[Nginx]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
# Génération et rafraichissement des certificats SSL avec [[Let's Encrypt]]
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec un FileStorageService ([https://www.callicoder.com/spring-boot-file-upload-download-rest-api-example/ lien])
** Gestion adaptative des contenus multimedia (photos) avec un ThumbnailService (montrez l'amélioration des performances avec Gatling)
** Gestion du cache client pour les photos et les thumbnails avec Cache-Control et ETag (montrez l'amélioration des performances avec Gatling)
** Utilisation de mode Lazy pour les chargements (fetch) des collections et des médias (CLOB,BLOB).
** Génération d'une application mobile [[Ionic]] avec [https://github.com/oktadeveloper/generator-jhipster-ionic generator-jhipster-ionic] (inclure les plugins [[Apache Cordova]] utiles à votre projet).
** Utilisation d'un cache ([https://www.jhipster.tech/using-cache/ préconisé par JHipster])
* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Génération de documents PDF à partir des valeurs de champs d'une entité ou du collection d'entités (exemple d'applications : facture, dossard coureur, export RGPD, ...) [https://www.stackextend.com/java/generate-pdf-document-using-jasperreports-and-spring-boot/ lien]
** Import et export massifs de collections d'entités en format CSV, JSON.
** Suivi du ''click stream'' avec des Filters/Aspects en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST avec [[Keycloak]] ou [[OKTA]].
** Utilisation du service de paiement Stripe.com en mode développeur
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Chatbot du helpdesk (comme [https://github.com/ovh-ux/ovh-chatbot ovh-chatbot])
** Gestion d'un [[CaaS]] Docker privé avec [[Minikube]], [[Kubernetes]], [[Rancher]] ou [[Docker Swarm]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers.
** Script périodique (crontab) de dump et de backup distant de la base MySQL.
** Gestion asynchrone et transactionnelle de l'envoi des courriels via le MailService, Thymeleaf et des taches @Scheduled
** Gestion asynchrone et transactionnelle de l'envoi de SMS (si le destinataire a un compte gratuit pour l'auto-réception de SMS)

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google, [https://www.jhipster.tech/heroku/ Heroku])
* Performances (résultat du injection de charge avec [[Apache JMeter]] ou [[Gatling]]) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Script "basique" pour le rolling update des composants répliqués (application, base de données, serveurs de mail, load balancer). Remarque: [[Kubernetes]] gère les rolling updates ([https://kubernetes.io/docs/tasks/run-application/rolling-update-replication-controller/ lien]).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom. JHipster génère le dockerfile de l'application et quelques descripteurs docker-compose.
* Préparation d'images [[Docker]]
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]], [[Telegraf]] + [[InfluxDB]] + [[Grafana]], [[Prometheus]] ...* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des mécanismes pour intégrer les besoins des utilisateurs
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits

===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

===Evaluation des IHMs===
Une IHM doit être évaluée par au moins deux types d'évaluation (en plus de l'évaluation fonctionnelle) :
* évaluation experte pour vérifier que les principes fondamentaux d'utilisabilité sont respectés
* tests utilisateur pour étudier comment vos utilisateurs utilise dans leurs contextes d'utilisation votre interface

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2018-2019.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html

===Quelques livres et technologies===

REMARQUE: les livres sur ces technologies se périment très vite.

====[[Spring]]====
* Bons tutoriels sur https://www.baeldung.com/rest-with-spring-series/
* Les manuels de références de Spring https://spring.io/projects/spring-boot#overview
* Craig Walls, Spring in Action, Fifth Edition, https://www.manning.com/books/spring-in-action-fifth-edition

====[[JHipster]]====
* Matt Raible, The JHipster Mini-Book 4.5 (GRATUIT) https://www.infoq.com/minibooks/jhipster-4x-mini-book
* Deepu K Sasidharan, Sendil Kumar N, Full Stack Development with JHipster, (10 $ en promotion) March 2018, https://www.packtpub.com/application-development/full-stack-development-jhipster

====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-10-08T07:42:57Z

Sybille.Caffiau: /* Audit 1 */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système
'''Autres :'''
* ADE : Emploi du temps en ligne

==Groupes et sujets==
===Groupes eCOM-RICM 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et VZ).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2018.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P005)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production) (F214, F215).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P257)
* 25/09 15h45-18h30 : Séance en autonomie (F114, F214)

* 02/10 8h00-12h15 : Test utilisateur (SC) puis Séance en autonomie (P039)
* 02/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 09/10 8h00-12h15 : Audit 1 (P013) et Séance en autonomie (P105, P133)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (F114, F214)

* 16/10 8h00-12h15 : Séance en autonomie (P257)
* 16/10 15h45-18h30 : Séance encadrée (SC) (F214, F215)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P257)
* 23/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 06/11 8h00-12h15 : Audit 2 (F114) et Séance en autonomie (F202)
* 06/11 15h45-18h30 : Séance en autonomie (F214, F215)

* 20/11 8h00-12h15 : Séance en autonomie + Séance encadrée (SC) (P257)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 27/11 8h00-12h15 : Séance en autonomie (P257)
* 27/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 04/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 11/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 18/12 8h00-12h15 : Soutenances (F114) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (F114) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie [[Spring Boot]] / [[JHipster]].
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]] sur plusieurs VM dans un cloud public (AWS, GAE, Heroku, Azure, ...), le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P013
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- 8h35 : Restaurant

- 9h10 : Spectacle

- 9h45 : Camping

- 10h20 : Transport

- 10h55 : Sport

- 11h30 : Brule ta bûche

''''' Contenu :'''''

Pour la partie GL et gestion de projet
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques et état de prise en main

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)
* Modèle de tâches et IHMA pour les premières tâches

===Audit 2 ===
*Salle : P
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL et gestion de projet :
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Procédure de tests
* Procédure d'intégration du code

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 :

- groupe 1 :

- groupe 5 :

- groupe 2 :

- groupe 4 :

- groupe 3 :

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : P
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré avec vos différentes productions)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* groupe 1
* groupe 3
* groupe 5
* groupe 4
* groupe 6
* groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et VZ pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Tout votre projet doit être suivi grâce à gitLab.

A tout moment, les enseignants doivent donc pouvoir
* avoir la dernière version du code (dernière version du logiciel en production et ce qui est en cours de développement dans des branches dédiées)
* voir les tâches prévues/en cours/réalisées
* savoir le travail de chaque membre (effectué et assigné)
* consulter les documents de conception (à jour)
* consulter les CR des daily meeting et autres réunions et les rétrospectives et vos présentations aux différents audits
* avoir connaissance des procédures de qualité que vous mettez en place au sein de votre projet
* consulter les résultats des différents tests pour chaque release

Attention : nous insistons particulièrement sur le fait que toutes ces données doivent être maintenues en temps réel et accessibles sur le gitlab de votre projet.

Attention : nous consulterons également les messages de commit.

===Rendus===
Vous trouverez ci-dessous une liste (non exhaustive) de certains livrables pouvant être produits au sein de votre projet

'''''L1. Composition des groupes et sujet'''''. (obligatoire)
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants Spring de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation Spring : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement Spring. Un composant peut être implanté par un client généré à partir de l'interface de/des micro-services, par un micro-service REST (Controller), par un Service, par un Entity ou par un client Feign vers un micro-service externe au systeme (par exemple, service de paiement Swipe.com, ...).

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (tableau de tâches de Gitlab)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation des performances du projet'''''.
* Résultat d'une injection de charge simpliste avec [[Gatling]]
* Résultat d'une injection de charge suivant un scénario complet avec [[Gatling]]

'''''L15. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L16. Diapos de votre présentation de conception'''''.

'''''L17. Diapos de votre présentation finale'''''.

'''''L18. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à utiliser un outil adapté cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

Vous devez utiliser GitLab comme support à votre projet (versioning, gestion des tâches...).

Nous vous demandons également d'utiliser les issues pour la communication avec les enseignants. En particulier, toute absence ou télétravail doit être signalé par ce média.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer un groupe GitLab. Y ajouter les membres du projet eCOM. Créer plusieurs projets pour les différents parties. Activer les notifications. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données (UML ou similaire [https://www.jhipster.tech/jdl/ JDL]) et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des Entity (annotations JAX-RS, annotations [[Swagger]]).

L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl (généré avec le générateur [https://swagger.io/tools/swagger-codegen/ swagger-codegen]), [[Swagger]] UI, injecteur de charge [[Gatling]], ....) et le frontend AngularX que vous aurez généré avec [[JHipster]].

Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et utilisateurs finaux) et exécuter certaines requêtes avec des garanties transactionnelles.

TRES IMPORTANT : Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]]/IPtables pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, ...) pour la production (non répliquée)
# Mise en place de 2 containers base de données (MySQL) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] ou [[Nginx]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
# Génération et rafraichissement des certificats SSL avec [[Let's Encrypt]]
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec un FileStorageService ([https://www.callicoder.com/spring-boot-file-upload-download-rest-api-example/ lien])
** Gestion adaptative des contenus multimedia (photos) avec un ThumbnailService (montrez l'amélioration des performances avec Gatling)
** Gestion du cache client pour les photos et les thumbnails avec Cache-Control et ETag (montrez l'amélioration des performances avec Gatling)
** Utilisation de mode Lazy pour les chargements (fetch) des collections et des médias (CLOB,BLOB).
** Génération d'une application mobile [[Ionic]] avec [https://github.com/oktadeveloper/generator-jhipster-ionic generator-jhipster-ionic] (inclure les plugins [[Apache Cordova]] utiles à votre projet).
** Utilisation d'un cache ([https://www.jhipster.tech/using-cache/ préconisé par JHipster])
* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Génération de documents PDF à partir des valeurs de champs d'une entité ou du collection d'entités (exemple d'applications : facture, dossard coureur, export RGPD, ...) [https://www.stackextend.com/java/generate-pdf-document-using-jasperreports-and-spring-boot/ lien]
** Import et export massifs de collections d'entités en format CSV, JSON.
** Suivi du ''click stream'' avec des Filters/Aspects en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST avec [[Keycloak]] ou [[OKTA]].
** Utilisation du service de paiement Stripe.com en mode développeur
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Chatbot du helpdesk (comme [https://github.com/ovh-ux/ovh-chatbot ovh-chatbot])
** Gestion d'un [[CaaS]] Docker privé avec [[Minikube]], [[Kubernetes]], [[Rancher]] ou [[Docker Swarm]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers.
** Script périodique (crontab) de dump et de backup distant de la base MySQL.
** Gestion asynchrone et transactionnelle de l'envoi des courriels via le MailService, Thymeleaf et des taches @Scheduled
** Gestion asynchrone et transactionnelle de l'envoi de SMS (si le destinataire a un compte gratuit pour l'auto-réception de SMS)

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google, [https://www.jhipster.tech/heroku/ Heroku])
* Performances (résultat du injection de charge avec [[Apache JMeter]] ou [[Gatling]]) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Script "basique" pour le rolling update des composants répliqués (application, base de données, serveurs de mail, load balancer). Remarque: [[Kubernetes]] gère les rolling updates ([https://kubernetes.io/docs/tasks/run-application/rolling-update-replication-controller/ lien]).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom. JHipster génère le dockerfile de l'application et quelques descripteurs docker-compose.
* Préparation d'images [[Docker]]
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]], [[Telegraf]] + [[InfluxDB]] + [[Grafana]] ...* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des mécanismes pour intégrer les besoins des utilisateurs
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits

===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

===Evaluation des IHMs===
Une IHM doit être évaluée par au moins deux types d'évaluation (en plus de l'évaluation fonctionnelle) :
* évaluation experte pour vérifier que les principes fondamentaux d'utilisabilité sont respectés
* tests utilisateur pour étudier comment vos utilisateurs utilise dans leurs contextes d'utilisation votre interface

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2018-2019.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html

===Quelques livres et technologies===

REMARQUE: les livres sur ces technologies se périment très vite.

====[[Spring]]====
* Bons tutoriels sur https://www.baeldung.com/rest-with-spring-series/
* Les manuels de références de Spring https://spring.io/projects/spring-boot#overview

====[[JHipster]]====
* Matt Raible, The JHipster Mini-Book 4.5 (GRATUIT) https://www.infoq.com/minibooks/jhipster-4x-mini-book
* Deepu K Sasidharan, Sendil Kumar N, Full Stack Development with JHipster, (10 $ en promotion) March 2018, https://www.packtpub.com/application-development/full-stack-development-jhipster

====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-10-03T11:01:16Z

Sybille.Caffiau: /* Audit 1 */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système
'''Autres :'''
* ADE : Emploi du temps en ligne

==Groupes et sujets==
===Groupes eCOM-RICM 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et VZ).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2018.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P005)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production) (F214, F215).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P257)
* 25/09 15h45-18h30 : Séance en autonomie (F114, F214)

* 02/10 8h00-12h15 : Test utilisateur (SC) puis Séance en autonomie (P039)
* 02/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 09/10 8h00-12h15 : Audit 1 (P013) et Séance en autonomie (P105, P133)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (F114, F214)

* 16/10 8h00-12h15 : Séance en autonomie (P257)
* 16/10 15h45-18h30 : Séance encadrée (SC) (F214, F215)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P257)
* 23/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 06/11 8h00-12h15 : Audit 2 (F114) et Séance en autonomie (F202)
* 06/11 15h45-18h30 : Séance en autonomie (F214, F215)

* 20/11 8h00-12h15 : Séance en autonomie + Séance encadrée (SC) (P257)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 27/11 8h00-12h15 : Séance en autonomie (P257)
* 27/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 04/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 11/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 18/12 8h00-12h15 : Soutenances (F114) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (F114) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie [[Spring Boot]] / [[JHipster]].
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]] sur plusieurs VM dans un cloud public (AWS, GAE, Heroku, Azure, ...), le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- 8h35 : Restaurant

- 9h10 : Spectacle

- 9h45 : Camping

- 10h20 : Transport

- 10h55 : Sport

- 11h30 : Brule ta bûche

''''' Contenu :'''''

Pour la partie GL et gestion de projet
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques et état de prise en main

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)
* Modèle de tâches et IHMA pour les premières tâches

===Audit 2 ===
*Salle : P
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL et gestion de projet :
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Procédure de tests
* Procédure d'intégration du code

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 :

- groupe 1 :

- groupe 5 :

- groupe 2 :

- groupe 4 :

- groupe 3 :

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : P
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré avec vos différentes productions)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* groupe 1
* groupe 3
* groupe 5
* groupe 4
* groupe 6
* groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et VZ pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Tout votre projet doit être suivi grâce à gitLab.

A tout moment, les enseignants doivent donc pouvoir
* avoir la dernière version du code (dernière version du logiciel en production et ce qui est en cours de développement dans des branches dédiées)
* voir les tâches prévues/en cours/réalisées
* savoir le travail de chaque membre (effectué et assigné)
* consulter les documents de conception (à jour)
* consulter les CR des daily meeting et autres réunions et les rétrospectives et vos présentations aux différents audits
* avoir connaissance des procédures de qualité que vous mettez en place au sein de votre projet
* consulter les résultats des différents tests pour chaque release

Attention : nous insistons particulièrement sur le fait que toutes ces données doivent être maintenues en temps réel et accessibles sur le gitlab de votre projet.

Attention : nous consulterons également les messages de commit.

===Rendus===
Vous trouverez ci-dessous une liste (non exhaustive) de certains livrables pouvant être produits au sein de votre projet

'''''L1. Composition des groupes et sujet'''''. (obligatoire)
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants Spring de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation Spring : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement Spring. Un composant peut être implanté par un client généré à partir de l'interface de/des micro-services, par un micro-service REST (Controller), par un Service, par un Entity ou par un client Feign vers un micro-service externe au systeme (par exemple, service de paiement Swipe.com, ...).

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (tableau de tâches de Gitlab)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation des performances du projet'''''.
* Résultat d'une injection de charge simpliste avec [[Gatling]]
* Résultat d'une injection de charge suivant un scénario complet avec [[Gatling]]

'''''L15. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L16. Diapos de votre présentation de conception'''''.

'''''L17. Diapos de votre présentation finale'''''.

'''''L18. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à utiliser un outil adapté cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

Vous devez utiliser GitLab comme support à votre projet (versioning, gestion des tâches...).

Nous vous demandons également d'utiliser les issues pour la communication avec les enseignants. En particulier, toute absence ou télétravail doit être signalé par ce média.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer un groupe GitLab. Y ajouter les membres du projet eCOM. Créer plusieurs projets pour les différents parties. Activer les notifications. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données (UML ou similaire [https://www.jhipster.tech/jdl/ JDL]) et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des Entity (annotations JAX-RS, annotations [[Swagger]]).

L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl (généré avec le générateur [https://swagger.io/tools/swagger-codegen/ swagger-codegen]), [[Swagger]] UI, injecteur de charge [[Gatling]], ....) et le frontend AngularX que vous aurez généré avec [[JHipster]].

Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et utilisateurs finaux) et exécuter certaines requêtes avec des garanties transactionnelles.

TRES IMPORTANT : Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]]/IPtables pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, ...) pour la production (non répliquée)
# Mise en place de 2 containers base de données (MySQL) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] ou [[Nginx]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
# Génération et rafraichissement des certificats SSL avec [[Let's Encrypt]]
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec un FileStorageService ([https://www.callicoder.com/spring-boot-file-upload-download-rest-api-example/ lien])
** Gestion adaptative des contenus multimedia (photos) avec un ThumbnailService (montrez l'amélioration des performances avec Gatling)
** Gestion du cache client pour les photos et les thumbnails avec Cache-Control et ETag (montrez l'amélioration des performances avec Gatling)
** Utilisation de mode Lazy pour les chargements (fetch) des collections et des médias (CLOB,BLOB).
** Génération d'une application mobile [[Ionic]] avec [https://github.com/oktadeveloper/generator-jhipster-ionic generator-jhipster-ionic] (inclure les plugins [[Apache Cordova]] utiles à votre projet).
** Utilisation d'un cache ([https://www.jhipster.tech/using-cache/ préconisé par JHipster])
* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Génération de documents PDF à partir des valeurs de champs d'une entité ou du collection d'entités (exemple d'applications : facture, dossard coureur, export RGPD, ...) [https://www.stackextend.com/java/generate-pdf-document-using-jasperreports-and-spring-boot/ lien]
** Import et export massifs de collections d'entités en format CSV, JSON.
** Suivi du ''click stream'' avec des Filters/Aspects en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST avec [[Keycloak]] ou [[OKTA]].
** Utilisation du service de paiement Stripe.com en mode développeur
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Chatbot du helpdesk (comme [https://github.com/ovh-ux/ovh-chatbot ovh-chatbot])
** Gestion d'un [[CaaS]] Docker privé avec [[Minikube]], [[Kubernetes]], [[Rancher]] ou [[Docker Swarm]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers.
** Script périodique (crontab) de dump et de backup distant de la base MySQL.
** Gestion asynchrone et transactionnelle de l'envoi des courriels via le MailService, Thymeleaf et des taches @Scheduled
** Gestion asynchrone et transactionnelle de l'envoi de SMS (si le destinataire a un compte gratuit pour l'auto-réception de SMS)

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google, [https://www.jhipster.tech/heroku/ Heroku])
* Performances (résultat du injection de charge avec [[Apache JMeter]] ou [[Gatling]]) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Script "basique" pour le rolling update des composants répliqués (application, base de données, serveurs de mail, load balancer). Remarque: [[Kubernetes]] gère les rolling updates ([https://kubernetes.io/docs/tasks/run-application/rolling-update-replication-controller/ lien]).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom. JHipster génère le dockerfile de l'application et quelques descripteurs docker-compose.
* Préparation d'images [[Docker]]
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]], [[Telegraf]] + [[InfluxDB]] + [[Grafana]] ...* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des mécanismes pour intégrer les besoins des utilisateurs
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits

===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

===Evaluation des IHMs===
Une IHM doit être évaluée par au moins deux types d'évaluation (en plus de l'évaluation fonctionnelle) :
* évaluation experte pour vérifier que les principes fondamentaux d'utilisabilité sont respectés
* tests utilisateur pour étudier comment vos utilisateurs utilise dans leurs contextes d'utilisation votre interface

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2018-2019.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html

===Quelques livres et technologies===

REMARQUE: les livres sur ces technologies se périment très vite.

====[[Spring]]====
* Bons tutoriels sur https://www.baeldung.com/rest-with-spring-series/
* Les manuels de références de Spring https://spring.io/projects/spring-boot#overview

====[[JHipster]]====
* Matt Raible, The JHipster Mini-Book 4.5 (GRATUIT) https://www.infoq.com/minibooks/jhipster-4x-mini-book
* Deepu K Sasidharan, Sendil Kumar N, Full Stack Development with JHipster, (10 $ en promotion) March 2018, https://www.packtpub.com/application-development/full-stack-development-jhipster

====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-10-01T16:11:01Z

Sybille.Caffiau: /* Audit 1 */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système
'''Autres :'''
* ADE : Emploi du temps en ligne

==Groupes et sujets==
===Groupes eCOM-RICM 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et VZ).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2018.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P005)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production) (F214, F215).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P257)
* 25/09 15h45-18h30 : Séance en autonomie (F114, F214)

* 02/10 8h00-12h15 : Test utilisateur (SC) puis Séance en autonomie (P039)
* 02/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 09/10 8h00-12h15 : Audit 1 (P013) et Séance en autonomie (P105, P133)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (F114, F214)

* 16/10 8h00-12h15 : Séance en autonomie (P257)
* 16/10 15h45-18h30 : Séance encadrée (SC) (F214, F215)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P257)
* 23/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 06/11 8h00-12h15 : Audit 2 (F114) et Séance en autonomie (F202)
* 06/11 15h45-18h30 : Séance en autonomie (F214, F215)

* 20/11 8h00-12h15 : Séance en autonomie + Séance encadrée (SC) (P257)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 27/11 8h00-12h15 : Séance en autonomie (P257)
* 27/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 04/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 11/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 18/12 8h00-12h15 : Soutenances (F114) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (F114) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie [[Spring Boot]] / [[JHipster]].
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]] sur plusieurs VM dans un cloud public (AWS, GAE, Heroku, Azure, ...), le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- 8h35 : Restaurant

- 9h10 : Spectacle

- 9h45 : Camping

- 10h20 : Transport

- 10h55 : Sport

- 11h30 : Brule ta bûche

''''' Contenu :'''''

Pour la partie GL et gestion de projet
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Audit 2 ===
*Salle : P
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL et gestion de projet :
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Procédure de tests
* Procédure d'intégration du code

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 :

- groupe 1 :

- groupe 5 :

- groupe 2 :

- groupe 4 :

- groupe 3 :

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : P
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré avec vos différentes productions)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* groupe 1
* groupe 3
* groupe 5
* groupe 4
* groupe 6
* groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et VZ pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Tout votre projet doit être suivi grâce à gitLab.

A tout moment, les enseignants doivent donc pouvoir
* avoir la dernière version du code (dernière version du logiciel en production et ce qui est en cours de développement dans des branches dédiées)
* voir les tâches prévues/en cours/réalisées
* savoir le travail de chaque membre (effectué et assigné)
* consulter les documents de conception (à jour)
* consulter les CR des daily meeting et autres réunions et les rétrospectives et vos présentations aux différents audits
* avoir connaissance des procédures de qualité que vous mettez en place au sein de votre projet
* consulter les résultats des différents tests pour chaque release

Attention : nous insistons particulièrement sur le fait que toutes ces données doivent être maintenues en temps réel et accessibles sur le gitlab de votre projet.

Attention : nous consulterons également les messages de commit.

===Rendus===
Vous trouverez ci-dessous une liste (non exhaustive) de certains livrables pouvant être produits au sein de votre projet

'''''L1. Composition des groupes et sujet'''''. (obligatoire)
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants Spring de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation Spring : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement Spring. Un composant peut être implanté par un client généré à partir de l'interface de/des micro-services, par un micro-service REST (Controller), par un Service, par un Entity ou par un client Feign vers un micro-service externe au systeme (par exemple, service de paiement Swipe.com, ...).

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (tableau de tâches de Gitlab)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation des performances du projet'''''.
* Résultat d'une injection de charge simpliste avec [[Gatling]]
* Résultat d'une injection de charge suivant un scénario complet avec [[Gatling]]

'''''L15. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L16. Diapos de votre présentation de conception'''''.

'''''L17. Diapos de votre présentation finale'''''.

'''''L18. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à utiliser un outil adapté cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

Vous devez utiliser GitLab comme support à votre projet (versioning, gestion des tâches...).

Nous vous demandons également d'utiliser les issues pour la communication avec les enseignants. En particulier, toute absence ou télétravail doit être signalé par ce média.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer un groupe GitLab. Y ajouter les membres du projet eCOM. Créer plusieurs projets pour les différents parties. Activer les notifications. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données (UML ou similaire [https://www.jhipster.tech/jdl/ JDL]) et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des Entity (annotations JAX-RS, annotations [[Swagger]]).

L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl (généré avec le générateur [https://swagger.io/tools/swagger-codegen/ swagger-codegen]), [[Swagger]] UI, injecteur de charge [[Gatling]], ....) et le frontend AngularX que vous aurez généré avec [[JHipster]].

Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et utilisateurs finaux) et exécuter certaines requêtes avec des garanties transactionnelles.

TRES IMPORTANT : Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]]/IPtables pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, ...) pour la production (non répliquée)
# Mise en place de 2 containers base de données (MySQL) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] ou [[Nginx]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
# Génération et rafraichissement des certificats SSL avec [[Let's Encrypt]]
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec un FileStorageService ([https://www.callicoder.com/spring-boot-file-upload-download-rest-api-example/ lien])
** Gestion adaptative des contenus multimedia (photos) avec un ThumbnailService (montrez l'amélioration des performances avec Gatling)
** Gestion du cache client pour les photos et les thumbnails avec Cache-Control et ETag (montrez l'amélioration des performances avec Gatling)
** Utilisation de mode Lazy pour les chargements (fetch) des collections et des médias (CLOB,BLOB).
** Génération d'une application mobile [[Ionic]] avec [https://github.com/oktadeveloper/generator-jhipster-ionic generator-jhipster-ionic] (inclure les plugins [[Apache Cordova]] utiles à votre projet).
** Utilisation d'un cache ([https://www.jhipster.tech/using-cache/ préconisé par JHipster])
* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Génération de documents PDF à partir des valeurs de champs d'une entité ou du collection d'entités (exemple d'applications : facture, dossard coureur, export RGPD, ...) [https://www.stackextend.com/java/generate-pdf-document-using-jasperreports-and-spring-boot/ lien]
** Import et export massifs de collections d'entités en format CSV, JSON.
** Suivi du ''click stream'' avec des Filters/Aspects en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST avec [[Keycloak]] ou [[OKTA]].
** Utilisation du service de paiement Stripe.com en mode développeur
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Chatbot du helpdesk (comme [https://github.com/ovh-ux/ovh-chatbot ovh-chatbot])
** Gestion d'un [[CaaS]] Docker privé avec [[Minikube]], [[Kubernetes]], [[Rancher]] ou [[Docker Swarm]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers.
** Script périodique (crontab) de dump et de backup distant de la base MySQL.
** Gestion asynchrone et transactionnelle de l'envoi des courriels via le MailService, Thymeleaf et des taches @Scheduled
** Gestion asynchrone et transactionnelle de l'envoi de SMS (si le destinataire a un compte gratuit pour l'auto-réception de SMS)

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google, [https://www.jhipster.tech/heroku/ Heroku])
* Performances (résultat du injection de charge avec [[Apache JMeter]] ou [[Gatling]]) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Script "basique" pour le rolling update des composants répliqués (application, base de données, serveurs de mail, load balancer). Remarque: [[Kubernetes]] gère les rolling updates ([https://kubernetes.io/docs/tasks/run-application/rolling-update-replication-controller/ lien]).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom. JHipster génère le dockerfile de l'application et quelques descripteurs docker-compose.
* Préparation d'images [[Docker]]
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]], [[Telegraf]] + [[InfluxDB]] + [[Grafana]] ...* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des mécanismes pour intégrer les besoins des utilisateurs
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits

===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

===Evaluation des IHMs===
Une IHM doit être évaluée par au moins deux types d'évaluation (en plus de l'évaluation fonctionnelle) :
* évaluation experte pour vérifier que les principes fondamentaux d'utilisabilité sont respectés
* tests utilisateur pour étudier comment vos utilisateurs utilise dans leurs contextes d'utilisation votre interface

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2018-2019.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html

===Quelques livres et technologies===

REMARQUE: les livres sur ces technologies se périment très vite.

====[[Spring]]====
* Bons tutoriels sur https://www.baeldung.com/rest-with-spring-series/
* Les manuels de références de Spring https://spring.io/projects/spring-boot#overview

====[[JHipster]]====
* Matt Raible, The JHipster Mini-Book 4.5 (GRATUIT) https://www.infoq.com/minibooks/jhipster-4x-mini-book
* Deepu K Sasidharan, Sendil Kumar N, Full Stack Development with JHipster, (10 $ en promotion) March 2018, https://www.packtpub.com/application-development/full-stack-development-jhipster

====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-09-21T07:53:47Z

Sybille.Caffiau: /* Transparents de cours */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système
'''Autres :'''
* ADE : Emploi du temps en ligne

==Groupes et sujets==
===Groupes eCOM-RICM 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et VZ).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2018.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P005)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production) (F214, F215).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P257)
* 25/09 15h45-18h30 : Séance en autonomie (F114, F214)

* 02/10 8h00-12h15 : Test utilisateur (SC) puis Séance en autonomie (P039)
* 02/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 09/10 8h00-12h15 : Audit 1 (P013) et Séance en autonomie (P105, P133)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (F114, F214)

* 16/10 8h00-12h15 : Séance en autonomie (P257)
* 16/10 15h45-18h30 : Séance encadrée (SC) (F214, F215)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P257)
* 23/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 06/11 8h00-12h15 : Audit 2 (F114) et Séance en autonomie (F202)
* 06/11 15h45-18h30 : Séance en autonomie (F214, F215)

* 20/11 8h00-12h15 : Séance en autonomie + Séance encadrée (SC) (P257)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 27/11 8h00-12h15 : Séance en autonomie (P257)
* 27/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 04/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 11/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 18/12 8h00-12h15 : Soutenances (F114) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (F114) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie [[Spring Boot]] / [[JHipster]].
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]] sur plusieurs VM dans un cloud public (AWS, GAE, Heroku, Azure, ...), le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- groupe 6

- groupe 3

- groupe 1

- groupe 2

- groupe 4

- groupe 5

''''' Contenu :'''''

Pour la partie GL et gestion de projet
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Audit 2 ===
*Salle : P
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL et gestion de projet :
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Procédure de tests
* Procédure d'intégration du code

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 :

- groupe 1 :

- groupe 5 :

- groupe 2 :

- groupe 4 :

- groupe 3 :

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : P
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré avec vos différentes productions)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* groupe 1
* groupe 3
* groupe 5
* groupe 4
* groupe 6
* groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et VZ pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Tout votre projet doit être suivi grâce à gitLab.

A tout moment, les enseignants doivent donc pouvoir
* avoir la dernière version du code (dernière version du logiciel en production et ce qui est en cours de développement dans des branches dédiées)
* voir les tâches prévues/en cours/réalisées
* savoir le travail de chaque membre (effectué et assigné)
* consulter les documents de conception (à jour)
* consulter les CR des daily meeting et autres réunions et les rétrospectives et vos présentations aux différents audits
* avoir connaissance des procédures de qualité que vous mettez en place au sein de votre projet
* consulter les résultats des différents tests pour chaque release

Attention : nous insistons particulièrement sur le fait que toutes ces données doivent être maintenues en temps réel et accessibles sur le gitlab de votre projet.

Attention : nous consulterons également les messages de commit.

===Rendus===
Vous trouverez ci-dessous une liste (non exhaustive) de certains livrables pouvant être produits au sein de votre projet

'''''L1. Composition des groupes et sujet'''''. (obligatoire)
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants Spring de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation Spring : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement Spring. Un composant peut être implanté par un client généré à partir de l'interface de/des micro-services, par un micro-service REST (Controller), par un Service, par un Entity ou par un client Feign vers un micro-service externe au systeme (par exemple, service de paiement Swipe.com, ...).

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (tableau de tâches de Gitlab)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation des performances du projet'''''.
* Résultat d'une injection de charge simpliste avec [[Gatling]]
* Résultat d'une injection de charge suivant un scénario complet avec [[Gatling]]

'''''L15. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L16. Diapos de votre présentation de conception'''''.

'''''L17. Diapos de votre présentation finale'''''.

'''''L18. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à utiliser un outil adapté cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

Vous devez utiliser GitLab comme support à votre projet (versioning, gestion des tâches...).

Nous vous demandons également d'utiliser les issues pour la communication avec les enseignants. En particulier, toute absence ou télétravail doit être signalé par ce média.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer un groupe GitLab. Y ajouter les membres du projet eCOM. Créer plusieurs projets pour les différents parties. Activer les notifications. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données (UML ou similaire [https://www.jhipster.tech/jdl/ JDL]) et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des Entity (annotations JAX-RS, annotations [[Swagger]]).

L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl (généré avec le générateur [https://swagger.io/tools/swagger-codegen/ swagger-codegen]), [[Swagger]] UI, injecteur de charge [[Gatling]], ....) et le frontend AngularX que vous aurez généré avec [[JHipster]].

Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et utilisateurs finaux) et exécuter certaines requêtes avec des garanties transactionnelles.

TRES IMPORTANT : Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]]/IPtables pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, ...) pour la production (non répliquée)
# Mise en place de 2 containers base de données (MySQL) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] ou [[Nginx]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
# Génération et rafraichissement des certificats SSL avec [[Let's Encrypt]]
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec un FileStorageService ([https://www.callicoder.com/spring-boot-file-upload-download-rest-api-example/ lien])
** Gestion adaptative des contenus multimedia (photos) avec un ThumbnailService (montrez l'amélioration des performances avec Gatling)
** Gestion du cache client pour les photos et les thumbnails avec Cache-Control et ETag (montrez l'amélioration des performances avec Gatling)
** Utilisation de mode Lazy pour les chargements (fetch) des collections et des médias (CLOB,BLOB).
** Génération d'une application mobile [[Ionic]] avec [https://github.com/oktadeveloper/generator-jhipster-ionic generator-jhipster-ionic] (inclure les plugins [[Apache Cordova]] utiles à votre projet).
** Utilisation d'un cache ([https://www.jhipster.tech/using-cache/ préconisé par JHipster])
* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Génération de documents PDF à partir des valeurs de champs d'une entité ou du collection d'entités (exemple d'applications : facture, dossard coureur, export RGPD, ...)
** Import et export massifs de collections d'entités en format CSV, JSON, PDF.
** Suivi du ''click stream'' avec des Filters/Aspects en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST avec [[Keycloak]] ou [[OKTA]].
** Utilisation du service de paiement Stripe.com en mode développeur
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Chatbot du helpdesk (comme [https://github.com/ovh-ux/ovh-chatbot ovh-chatbot])
** Gestion d'un [[CaaS]] Docker privé avec [[Minikube]], [[Kubernetes]], [[Rancher]] ou [[Docker Swarm]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers.
** Script périodique (crontab) de dump et de backup distant de la base MySQL.
** Gestion asynchrone et transactionnelle de l'envoi des courriels via le MailService, Thymeleaf et des taches @Scheduled
** Gestion asynchrone et transactionnelle de l'envoi de SMS (si le destinataire a un compte gratuit pour l'auto-réception de SMS)

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google, [https://www.jhipster.tech/heroku/ Heroku])
* Performances (résultat du injection de charge avec [[Apache JMeter]] ou [[Gatling]]) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Script "basique" pour le rolling update des composants répliqués (application, base de données, serveurs de mail, load balancer). Remarque: [[Kubernetes]] gère les rolling updates ([https://kubernetes.io/docs/tasks/run-application/rolling-update-replication-controller/ lien]).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom. JHipster génère le dockerfile de l'application et quelques descripteurs docker-compose.
* Préparation d'images [[Docker]]
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]], [[Telegraf]] + [[InfluxDB]] + [[Grafana]] ...* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des mécanismes pour intégrer les besoins des utilisateurs
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits

===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

===Evaluation des IHMs===
Une IHM doit être évaluée par au moins deux types d'évaluation (en plus de l'évaluation fonctionnelle) :
* évaluation experte pour vérifier que les principes fondamentaux d'utilisabilité sont respectés
* tests utilisateur pour étudier comment vos utilisateurs utilise dans leurs contextes d'utilisation votre interface

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2018-2019.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html

===Quelques livres et technologies===

REMARQUE: les livres sur ces technologies se périment très vite.

====[[Spring]]====
* Bons tutoriels sur https://www.baeldung.com/rest-with-spring-series/
* Les manuels de références de Spring https://spring.io/projects/spring-boot#overview

====[[JHipster]]====
* Matt Raible, The JHipster Mini-Book 4.5 (GRATUIT) https://www.infoq.com/minibooks/jhipster-4x-mini-book
* Deepu K Sasidharan, Sendil Kumar N, Full Stack Development with JHipster, (10 $ en promotion) March 2018, https://www.packtpub.com/application-development/full-stack-development-jhipster

====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

File:ECOMCours2018-2019.pdf

2018-09-21T07:50:50Z

Sybille.Caffiau:

ECOM-1FO

2018-09-20T14:23:13Z

Sybille.Caffiau: /* Planning des séances */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système
'''Autres :'''
* ADE : Emploi du temps en ligne

==Groupes et sujets==
===Groupes eCOM-RICM 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et VZ).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2018.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P005)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production) (F214, F215).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P257)
* 25/09 15h45-18h30 : Séance en autonomie (F114, F214)

* 02/10 8h00-12h15 : Test utilisateur (SC) puis Séance en autonomie (P039)
* 02/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 09/10 8h00-12h15 : Audit 1 (P013) et Séance en autonomie (P105, P133)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (F114, F214)

* 16/10 8h00-12h15 : Séance en autonomie (P257)
* 16/10 15h45-18h30 : Séance encadrée (SC) (F214, F215)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P257)
* 23/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 06/11 8h00-12h15 : Audit 2 (F114) et Séance en autonomie (F202)
* 06/11 15h45-18h30 : Séance en autonomie (F214, F215)

* 20/11 8h00-12h15 : Séance en autonomie + Séance encadrée (SC) (P257)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 27/11 8h00-12h15 : Séance en autonomie (P257)
* 27/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 04/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P257)
* 11/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 18/12 8h00-12h15 : Soutenances (F114) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (F114) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie [[Spring Boot]] / [[JHipster]].
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]] sur plusieurs VM dans un cloud public (AWS, GAE, Heroku, Azure, ...), le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- groupe 6

- groupe 3

- groupe 1

- groupe 2

- groupe 4

- groupe 5

''''' Contenu :'''''

Pour la partie GL et gestion de projet
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Audit 2 ===
*Salle : P
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL et gestion de projet :
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Procédure de tests
* Procédure d'intégration du code

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 :

- groupe 1 :

- groupe 5 :

- groupe 2 :

- groupe 4 :

- groupe 3 :

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : P
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré avec vos différentes productions)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* groupe 1
* groupe 3
* groupe 5
* groupe 4
* groupe 6
* groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et VZ pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Tout votre projet doit être suivi grâce à gitLab.

A tout moment, les enseignants doivent donc pouvoir
* avoir la dernière version du code (dernière version du logiciel en production et ce qui est en cours de développement dans des branches dédiées)
* voir les tâches prévues/en cours/réalisées
* savoir le travail de chaque membre (effectué et assigné)
* consulter les documents de conception (à jour)
* consulter les CR des daily meeting et autres réunions et les rétrospectives et vos présentations aux différents audits
* avoir connaissance des procédures de qualité que vous mettez en place au sein de votre projet
* consulter les résultats des différents tests pour chaque release

Attention : nous insistons particulièrement sur le fait que toutes ces données doivent être maintenues en temps réel et accessibles sur le gitlab de votre projet.

Attention : nous consulterons également les messages de commit.

===Rendus===
Vous trouverez ci-dessous une liste (non exhaustive) de certains livrables pouvant être produits au sein de votre projet

'''''L1. Composition des groupes et sujet'''''. (obligatoire)
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants Spring de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation Spring : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement Spring. Un composant peut être implanté par un client généré à partir de l'interface de/des micro-services, par un micro-service REST (Controller), par un Service, par un Entity ou par un client Feign vers un micro-service externe au systeme (par exemple, service de paiement Swipe.com, ...).

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (tableau de tâches de Gitlab)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation des performances du projet'''''.
* Résultat d'une injection de charge simpliste avec [[Gatling]]
* Résultat d'une injection de charge suivant un scénario complet avec [[Gatling]]

'''''L15. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L16. Diapos de votre présentation de conception'''''.

'''''L17. Diapos de votre présentation finale'''''.

'''''L18. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à utiliser un outil adapté cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

Vous devez utiliser GitLab comme support à votre projet (versioning, gestion des tâches...).

Nous vous demandons également d'utiliser les issues pour la communication avec les enseignants. En particulier, toute absence ou télétravail doit être signalé par ce média.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer un groupe GitLab. Y ajouter les membres du projet eCOM. Créer plusieurs projets pour les différents parties. Activer les notifications. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données (UML ou similaire [https://www.jhipster.tech/jdl/ JDL]) et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des Entity (annotations JAX-RS, annotations [[Swagger]]).

L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl (généré avec le générateur [https://swagger.io/tools/swagger-codegen/ swagger-codegen]), [[Swagger]] UI, injecteur de charge [[Gatling]], ....) et le frontend AngularX que vous aurez généré avec [[JHipster]].

Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et utilisateurs finaux) et exécuter certaines requêtes avec des garanties transactionnelles.

TRES IMPORTANT : Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]]/IPtables pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, ...) pour la production (non répliquée)
# Mise en place de 2 containers base de données (MySQL) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] ou [[Nginx]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
# Génération et rafraichissement des certificats SSL avec [[Let's Encrypt]]
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec un FileStorageService ([https://www.callicoder.com/spring-boot-file-upload-download-rest-api-example/ lien])
** Gestion adaptative des contenus multimedia (photos) avec un ThumbnailService (montrez l'amélioration des performances avec Gatling)
** Gestion du cache client pour les photos et les thumbnails avec Cache-Control et ETag (montrez l'amélioration des performances avec Gatling)
** Utilisation de mode Lazy pour les chargements (fetch) des collections et des médias (CLOB,BLOB).
** Génération d'une application mobile [[Ionic]] avec [https://github.com/oktadeveloper/generator-jhipster-ionic generator-jhipster-ionic] (inclure les plugins [[Apache Cordova]] utiles à votre projet).
** Utilisation d'un cache ([https://www.jhipster.tech/using-cache/ préconisé par JHipster])
* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Génération de documents PDF à partir des valeurs de champs d'une entité ou du collection d'entités (exemple d'applications : facture, dossard coureur, export RGPD, ...)
** Import et export massifs de collections d'entités en format CSV, JSON, PDF.
** Suivi du ''click stream'' avec des Filters/Aspects en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST avec [[Keycloak]] ou [[OKTA]].
** Utilisation du service de paiement Stripe.com en mode développeur
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Chatbot du helpdesk (comme [https://github.com/ovh-ux/ovh-chatbot ovh-chatbot])
** Gestion d'un [[CaaS]] Docker privé avec [[Minikube]], [[Kubernetes]], [[Rancher]] ou [[Docker Swarm]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers.
** Script périodique (crontab) de dump et de backup distant de la base MySQL.
** Gestion asynchrone et transactionnelle de l'envoi des courriels via le MailService, Thymeleaf et des taches @Scheduled
** Gestion asynchrone et transactionnelle de l'envoi de SMS (si le destinataire a un compte gratuit pour l'auto-réception de SMS)

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google, [https://www.jhipster.tech/heroku/ Heroku])
* Performances (résultat du injection de charge avec [[Apache JMeter]] ou [[Gatling]]) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Script "basique" pour le rolling update des composants répliqués (application, base de données, serveurs de mail, load balancer). Remarque: [[Kubernetes]] gère les rolling updates ([https://kubernetes.io/docs/tasks/run-application/rolling-update-replication-controller/ lien]).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom. JHipster génère le dockerfile de l'application et quelques descripteurs docker-compose.
* Préparation d'images [[Docker]]
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]], [[Telegraf]] + [[InfluxDB]] + [[Grafana]] ...* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des mécanismes pour intégrer les besoins des utilisateurs
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits

===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

===Evaluation des IHMs===
Une IHM doit être évaluée par au moins deux types d'évaluation (en plus de l'évaluation fonctionnelle) :
* évaluation experte pour vérifier que les principes fondamentaux d'utilisabilité sont respectés
* tests utilisateur pour étudier comment vos utilisateurs utilise dans leurs contextes d'utilisation votre interface

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html

===Quelques livres et technologies===

REMARQUE: les livres sur ces technologies se périment très vite.

====[[Spring]]====
* Bons tutoriels sur https://www.baeldung.com/rest-with-spring-series/
* Les manuels de références de Spring https://spring.io/projects/spring-boot#overview

====[[JHipster]]====
* Matt Raible, The JHipster Mini-Book 4.5 (GRATUIT) https://www.infoq.com/minibooks/jhipster-4x-mini-book
* Deepu K Sasidharan, Sendil Kumar N, Full Stack Development with JHipster, (10 $ en promotion) March 2018, https://www.packtpub.com/application-development/full-stack-development-jhipster

====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-M2PGI

2018-09-17T10:50:03Z

Sybille.Caffiau: /* Consignes spécifiques pour les soutenances IHM */

Le projet eCOM consiste à concevoir et développer une application de commerce électronique. [[ECOM|suite ...]]

=Étapes du projet=
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Le projet se conclut par une soutenance finale pour chaque partie (IHM et système).

==Conduite de projet==
Le projet eCOM est très court en durée. Il est préconisé d'utiliser la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe.

===Critères d'évaluation===
La conduite du projet sera principalement évaluée en fonction des critères suivants :
* vous devez choisir un Scrum Master (unique ou tournant) : vous devez justifier votre choix
* durée du sprint (idem : vous devez justifier votre choix)
Sur ces 2 premiers critères, vous n'en changez pas !!!

Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à créer un wiki qui regroupera l'ensemble de vos documentations. Cela doit être une documentation Agile !!!!

Un point de bonus pour ceux qui réussiront à mettre en place des "poker planning".
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

==Partie IHM==

===Etapes et documents demandés===
Le détail sur l'organisation et l'évaluation du travail concernant les spécifications du site sera communiqué lors des premières séances de cours. Liste des Livrables et date de rendu pour les M2PGI Alternants :

* Livrable 1 : par email, membres du groupe et brève description du sujet (un seul groupe OK)

====[[Audit 1 :]]====
* L2.1 : Description des profils
* L2.2 : Questionnaire profils (OPT-ALT)
* L3.1 : Scénarios
* L3.2 : Analyse de la concurrence (OPT-ALT)
* L3.3 : Questionnaire sur l'utilisation (OPT-ALT)
* L4 : Modèles de tâches (Audit 2 pour ALT)
* L5 : Fonctionnalités
* L6.1 : Objectifs pour chaque version (priorités de développement)

====[[Audit 2 :]]====
* Mise à jour de L2 à L6.1
* L7.1 : Architecture (OPT-ALT)
* L7.2 : Base de données (OPT-ALT)
* L7.3 : IHM Abstraite
* L7.4 : Maquettes
* L6.2 : Objectifs pour les versions suivantes
* L8 : Démo de V0

====[[Audit 3 (Soutenances) :]]====
* Mise à jour de L7.3 (correction des erreurs)
* L9 : Rapport d'évaluation experte (imprimé pour la soutenance)
* L10 : Démonstration finale
* L11 : Diapos de votre présentation (version numérique à laquelle l'enseignant a accès au moment de votre passage)

OPT signifie que le livrable est optionnel soit parce qu'il ne s'applique pas à tous les groupes, soit parce qu'il ne peut qu'apporter une plus value à votre projet (points en plus mais pas en moins au moment de l'attribution de la note).
Lorsque ce n'est pas précisé, c'est à vous de choisir le mode présentation (écrit, schéma...) des informations du livrable

===Critères d'évaluation===
La partie IHM du projet sera principalement évaluée en fonction des critères suivants :
* Conformité de l'IHM concrète et abstraite avec le modèle de tâches
* Couverture fonctionnelle de l'application et robustesse au regard des priorités que vous avez retenues
* Qualité ergonomique au regard des principes vus en cours
* Rigueur de la démarche

La note est obtenue par l'évaluation tout au long du projet elle est composée de :
* Les besoins (3 pts) : informations sur les besoins que vous allez prendre en compte (livrables et audit 1)
* La conception (5 pts) : proposition de solution pour répondre aux besoins (livrables et audit 2)
* L'évaluation (3 pts) : évaluation de votre (ou vos) solution(s) (livrable et soutenance finale)
* Présentations (3 pts) : qualité des présentations (documents, email et slides de soutenance finale)
* Développement (6 pts) : qualité et quantité du code (démo et code)

Les notes des membres du groupe peuvent être différentes en fonction du travail fourni et constaté par l'enseignant.

==Partie Système==

Remarque : Aucune des phases du projet ne nécessite le développement d'un client lourd en mode graphique (SWT ...).
===Documents demandés===
Deux rapports doivent être rédigés pour la partie Système : un document de conception système et un document d'évaluation système.

====Document de conception système====
Le dossier de conception système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

====Document d'évaluation système====

Le rapport final système du projet ECOM a pour but de préciser l’état d’avancement de votre application ECOM.

Le rapport final système doit préciser :
* L’état de chaque composant : non réalisé, réalisé, réalisé et validé
* Les fonctions réalisées, réalisées et testées, et celles restant à réaliser
* Les propriétés non fonctionnelles garanties par votre réalisation, et celles restant à considérer pour finaliser votre application
* Le temps consacré à la conception système
* Le temps consacré au développement système
* Les principales difficultés rencontrées
===Critères d'évaluation===
La partie système du projet sera principalement évaluée en fonction des critères suivants :
* Conformité aux spécifications de l'application et aux consignes données dans le cadre du projet
* Respect des échéances pour les différentes étapes du projet (y compris pour les prototypes intermédiaires et les documents)
* Qualité de l'architecture de l'application
* Qualité et robustesse du code applicatif
* Compréhension des principaux concepts de la technologie Web
* Rigueur de la démarche de conception
* Qualité des présentations/soutenances
En complément, les aspects suivants seront également considérés :
* Méthodologie de test
* Déploiement et retrait de l'application sur/de la plateforme cloud
* Préparation d'images de VMs avec [[Kameleon]]
* Performances (résultat du injection de charge avec [[Apache JMeter]] ou OW2 CLIF)
* Supervision du système déployé avec des sondes [[Nagios]] ou [[Shinken]] conditionnées dans les VMs à déployer.
* Utilisation (optionnelle) de technologies/APIs/frameworks avancés

==Consignes pour la soutenance==
===Consignes spécifiques pour les soutenances IHM===
Salle : F113

Durée totale : 45 minutes

Pour le 23/09 minuit au plus tard :
* les documents de conception (hors évaluation), gestion de projet et le code doivent être accessibles à l'enseignant : envoyer un email avec l'ensemble des liens permettant d'y accéder

Le jour de la soutenance :
* envoyé avant votre passage les liens vers les derniers documents (évaluations + diapositives de soutenance)
* votre passage doit contenir une présentation globale du projet, le processus de conception (illustré), des évaluations, le bilan (point de vue IHM) et une démo PRÉPARÉE
* présentez individuellement un bilan de ce que vous retenez (positif, améliorations personnelles, négatif)
* arrivez avec l'application démarée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* prévoyez 15 minutes de questions lors de votre passage

===Consignes spécifiques pour les soutenances Système===
* Apportez un exemplaire du dossier d'évaluation système (déposé la veille sur Moodle) lors de la soutenance. Il n'est pas nécessaire d'apporter un exemplaire du dossier de conception système.
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances avec le service développé.
* Prévovez environ 30 minutes pour la présentation/démo/questions. Utilisez des transparents pour présenter votre projet.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de VM.
* Conditionnez le projet final sous la forme d’une archive (zip ou tar.gz) après avoir inclus la documentation (dans un repertoire /main/site). Utilisez la convention de nommage suivante : ecom_final_1213-X.zip où X correspond au nom du projet.
* Déposez immédiatement après la soutenance (et en aucun cas après le 20 décembre) l'archive sur Moodle.
* le rapport de charge (benchmark) doit être (MUST) fourni dans la documentation.
* le rapport sur les métriques logicielles doit être (MUST) fourni dans la documentation.

=Organisation 2018-2019=

==Planning==
===M2PGI (Alternant)===
'''Equipe pédagogique:''' VL = Vincent Lesne, NDP= Noel De Palma, SC = Sybille Caffiaux, SCB = Sebastien Chassande, UD=Ugo Decharriere

*03 sept 09h-12h F022, Boot Projet (NDP)
*03 sept 14h-17h TD F118 / TP F217, Cours Spring (SCB/NDP)
*04 sept 09h-12h TD F218 / TP F217, Cours Angular (SCB/NDP)
*04 sept 14h-17h TD F218 / TP F217, Cours Angular (SCB/NDP)
*05 sept 09h-12h TD F218 / TP F217, Libre service
*05 sept 14h-17h TD F218 / TP F217, Libre service
*06 sept 09h-12h TD F118, Cours IHM (SC)
*06 sept 14h-17h TD F118 / TP F217, Cours Cloud (UD)
*07 sept 09h-12h TD F114 / TP F211, Cours Agile (VL)
*07 sept 14h-17h TD F114 / TP F211, Cours Agile (VL)
*10 sept 09h-12h TD F218 / TP F217, Audit Syst. (SCB/NDP)
*10 sept 14h-17h TD F218 / TP F217, Audit Agile (VL)
*11 sept 09h-12h TD F118 / TP F217, Libre service
*11 sept 14h-17h TD F118 / TP F217, Libre service
*12 sept 09h-12h TD F218 / TP F217, Libre Service
*12 sept 14h-17h TD F218 / TP F217, Libre Service
*13 sept 09h-12h TD F118 / TP F217, Audit Syst. (SCB, NDP)
*13 sept 14h-17h TD F118 / TP F217, Audit Agile (VL)
*14 sept 09h-12h TD F114 / TP F214, Point Infra. (UD)
*14 sept 14h-17h TD F114 / TP F214, Libre Service
*17 sept 09h-12h TD F109 / TP F216, Audit Syst. (SCB/NDP)
*17 sept 14h-17h TD F109 / TP F216, Audit Agile (VL)
*18 sept 09h-12h TD F118 / TP F217, Libre Service
*18 sept 14h-17h TD F118 / TP F217, Point Infra. (UD)
*19 sept 09h-12h TD F218 / TP F217, Libre Service
*19 sept 14h-17h TD F218 / TP F217, Libre Service
*20 sept 09h-12h TD F118 / TP F217, Point Infra. (UD)
*20 sept 14h-17h TD F118 / TP F217, Libre Service
*21 sept 09h-12h TD F109 / TD F114 / TP F211, Soutenance
*21 sept 14h-17h TD F109 / TD F114 / TP F211, Soutenance

===M2PGI (Classique)===
'''Equipe pédagogique:''' Noël de Palma (NdP), Vincent Lesne (VL), Sybille Caffiau (SC), Sebastien Chassand-Barrioz (SCB), Ibrahim Safiedinne (FR)

'''Dates Importantes:'''
en cours.

==Groupes==
===M2PGI Apprenti===

===M2PGI Classique===
Consigne pour la constitution des groupes : Les étudiants ayant choisis l'option multimobile doivent se mettre ensemble. Ils doivent constituer des groupes de 4/5 afin d'avoir en tout 4 groupes (de M2 PGI classiques)

==Soutenance==
===M2PGI Apprenti===

===M2PGI Classique===

IMPERATIF
* le projet doit être (MUST) géré selon la méthode Scrum : le Scrum Master devra présenter le déroulement du projet.
* le serveur JavaEE doit être (MUST) hébergé sur une instance de VM.
* un rapport de charge (benchmark) doit être (MUST) fourni : les outils JMeter ou Clif peuvent être utilisés.
* un rapport sur les métriques logicielles doit être (MUST) fourni : l'outil Sonar peut être utilisé.

'''Ordre de passage :'''
* Respectez l'ordre établi
* Faites attention au temps. Vous disposez de 45 minutes par soutenance pour : votre présentation, la démo et les questions

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Squelette du projet==
[http://dl.dropbox.com/u/66952950/ecom-maven.zip ecom-maven.zip] Inaccessible

==Doc utiles==
* [http://wiki.easybeans.org/xwiki/bin/view/Main/Documentation Documentation Easybeans (conteneur EJB3 utilisé par Jonas)]
* [http://docs.oracle.com/javaee/6/tutorial/doc/ Tutorial JavaEE 6 ]
* [http://netbeans.org/kb/67/javaee/ejb30.html Tutorial NetBean et JEE ]
* [http://docs.oracle.com/javaee/6/api/ API JavaEE 6]
* [https://java.net/projects/javaee-spec/pages/Home Spécifications JavaEE 6]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* [http://jonas.ow2.org/JONAS_5_1_2/doc/doc-en/html/getting_started_guide.html#id1316973 Glossaire]
* [http://www.easybeans.net/xwiki/bin/download/Main/Documentation/ejb3-annotations.pdf Aide mémoire pour les annotations EJB3 ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* Questionnaire pour site web : [[Media:Questionnaire copy.pdf]]
* Questionnaire SUS (évaluation satisfaction) : [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]

===Quelques livres===
REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
* Java EE6 Cookbook for securing, tuning, and extending enterprise applications: http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* Debu Panda, Reza Rahman, Derek Lane, EJB 3 in Action, Pub Mannings, 2007, http://www.manning.com/panda/
* Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, Pub Mannings, 2011, http://www.manning.com/panda2/

ECOM-1FO

2018-09-17T10:21:26Z

Sybille.Caffiau: /* Planning des séances */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système
'''Autres :'''
* ADE : Emploi du temps en ligne

==Groupes et sujets==
===Groupes eCOM-RICM 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et VZ).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2017.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P005)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production) (F214, F215).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P257)
* 25/09 15h45-18h30 : Séance en autonomie (F114, F214)

* 02/10 8h00-12h15 : Test utilisateur (SC) puis Séance en autonomie (P039)
* 02/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 09/10 8h00-12h15 : Audit 1 (P013) et Séance en autonomie (P105, P133)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (F114, F214)

* 16/10 8h00-12h15 : Séance en autonomie (F201, F202)
* 16/10 15h45-18h30 : Séance encadrée (SC) (F214, F215)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (F201, F202)
* 23/10 15h45-18h30 : Séance en autonomie (F214, F215)

* 06/11 8h00-12h15 : Audit 2 (F114) et Séance en autonomie (F202)
* 06/11 15h45-18h30 : Séance en autonomie (F214, F215)

* 20/11 8h00-12h15 : Séance en autonomie + Séance encadrée (SC) (F201, F202)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 27/11 8h00-12h15 : Séance en autonomie (F201, F202)
* 27/11 15h45-18h30 : Séance encadrée (VZ) (F214, F215)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (F201, F202)
* 04/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (F201, F202)
* 11/12 15h45-18h30 : Séance en autonomie (F214, F215)

* 18/12 8h00-12h15 : Soutenances (F114) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (F114) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie [[Spring Boot]] / [[JHipster]].
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]] sur plusieurs VM dans un cloud public (AWS, GAE, Heroku, Azure, ...), le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- groupe 6

- groupe 3

- groupe 1

- groupe 2

- groupe 4

- groupe 5

''''' Contenu :'''''

Pour la partie GL et gestion de projet
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Audit 2 ===
*Salle : P
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL et gestion de projet :
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Procédure de tests
* Procédure d'intégration du code

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 :

- groupe 1 :

- groupe 5 :

- groupe 2 :

- groupe 4 :

- groupe 3 :

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : P
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré avec vos différentes productions)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* groupe 1
* groupe 3
* groupe 5
* groupe 4
* groupe 6
* groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et VZ pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Tout votre projet doit être suivi grâce à gitLab.

A tout moment, les enseignants doivent donc pouvoir
* avoir la dernière version du code (dernière version du logiciel en production et ce qui est en cours de développement dans des branches dédiées)
* voir les tâches prévues/en cours/réalisées
* savoir le travail de chaque membre (effectué et assigné)
* consulter les documents de conception (à jour)
* consulter les CR des daily meeting et autres réunions et les rétrospectives et vos présentations aux différents audits
* avoir connaissance des procédures de qualité que vous mettez en place au sein de votre projet
* consulter les résultats des différents tests pour chaque release

Attention : nous insistons particulièrement sur le fait que toutes ces données doivent être maintenues en temps réel et accessibles sur le gitlab de votre projet.

Attention : nous consulterons également les messages de commit.

===Rendus===
Vous trouverez ci-dessous une liste (non exhaustive) de certains livrables pouvant être produits au sein de votre projet

'''''L1. Composition des groupes et sujet'''''. (obligatoire)
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants Spring de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation Spring : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement Spring. Un composant peut être implanté par un client généré à partir de l'interface de/des micro-services, par un micro-service REST (Controller), par un Service, par un Entity ou par un client Feign vers un micro-service externe au systeme (par exemple, service de paiement Swipe.com, ...).

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (tableau de tâches de Gitlab)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation des performances du projet'''''.
* Résultat d'une injection de charge simpliste avec [[Gatling]]
* Résultat d'une injection de charge suivant un scénario complet avec [[Gatling]]

'''''L15. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L16. Diapos de votre présentation de conception'''''.

'''''L17. Diapos de votre présentation finale'''''.

'''''L18. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à utiliser un outil adapté cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

Vous devez utiliser GitLab comme support à votre projet (versioning, gestion des tâches...).

Nous vous demandons également d'utiliser les issues pour la communication avec les enseignants. En particulier, toute absence ou télétravail doit être signalé par ce média.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer un groupe GitLab. Y ajouter les membres du projet eCOM. Créer plusieurs projets pour les différents parties. Activer les notifications. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données (UML ou similaire [https://www.jhipster.tech/jdl/ JDL]) et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des Entity (annotations JAX-RS, annotations [[Swagger]]).

L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl (généré avec le générateur [https://swagger.io/tools/swagger-codegen/ swagger-codegen]), [[Swagger]] UI, injecteur de charge [[Gatling]], ....) et le frontend AngularX que vous aurez généré avec [[JHipster]].

Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et utilisateurs finaux) et exécuter certaines requêtes avec des garanties transactionnelles.

TRES IMPORTANT : Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]]/IPtables pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, ...) pour la production (non répliquée)
# Mise en place de 2 containers base de données (MySQL) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] ou [[Nginx]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
# Génération et rafraichissement des certificats SSL avec [[Let's Encrypt]]
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec un FileStorageService ([https://www.callicoder.com/spring-boot-file-upload-download-rest-api-example/ lien])
** Gestion adaptative des contenus multimedia (photos) avec un ThumbnailService (montrez l'amélioration des performances avec Gatling)
** Gestion du cache client pour les photos et les thumbnails avec Cache-Control et ETag (montrez l'amélioration des performances avec Gatling)
** Utilisation de mode Lazy pour les chargements (fetch) des collections et des médias (CLOB,BLOB).
** Génération d'une application mobile [[Ionic]] avec [https://github.com/oktadeveloper/generator-jhipster-ionic generator-jhipster-ionic] (inclure les plugins [[Apache Cordova]] utiles à votre projet).
** Utilisation d'un cache ([https://www.jhipster.tech/using-cache/ préconisé par JHipster])
* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Génération de documents PDF à partir des valeurs de champs d'une entité ou du collection d'entités (exemple d'applications : facture, dossard coureur, export RGPD, ...)
** Import et export massifs de collections d'entités en format CSV, JSON, PDF.
** Suivi du ''click stream'' avec des Filters/Aspects en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST avec [[Keycloak]] ou [[OKTA]].
** Utilisation du service de paiement Stripe.com en mode développeur
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Chatbot du helpdesk (comme [https://github.com/ovh-ux/ovh-chatbot ovh-chatbot])
** Gestion d'un [[CaaS]] Docker privé avec [[Minikube]], [[Kubernetes]], [[Rancher]] ou [[Docker Swarm]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers.
** Script périodique (crontab) de dump et de backup distant de la base MySQL.
** Gestion asynchrone et transactionnelle de l'envoi des courriels via le MailService, Thymeleaf et des taches @Scheduled
** Gestion asynchrone et transactionnelle de l'envoi de SMS (si le destinataire a un compte gratuit pour l'auto-réception de SMS)

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google, [https://www.jhipster.tech/heroku/ Heroku])
* Performances (résultat du injection de charge avec [[Apache JMeter]] ou [[Gatling]]) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Script "basique" pour le rolling update des composants répliqués (application, base de données, serveurs de mail, load balancer). Remarque: [[Kubernetes]] gère les rolling updates ([https://kubernetes.io/docs/tasks/run-application/rolling-update-replication-controller/ lien]).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom. JHipster génère le dockerfile de l'application et quelques descripteurs docker-compose.
* Préparation d'images [[Docker]]
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]], [[Telegraf]] + [[InfluxDB]] + [[Grafana]] ...* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des mécanismes pour intégrer les besoins des utilisateurs
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits

===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

===Evaluation des IHMs===
Une IHM doit être évaluée par au moins deux types d'évaluation (en plus de l'évaluation fonctionnelle) :
* évaluation experte pour vérifier que les principes fondamentaux d'utilisabilité sont respectés
* tests utilisateur pour étudier comment vos utilisateurs utilise dans leurs contextes d'utilisation votre interface

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html

===Quelques livres et technologies===

REMARQUE: les livres sur ces technologies se périment très vite.

====[[Spring]]====
* Bons tutoriels sur https://www.baeldung.com/rest-with-spring-series/
* Les manuels de références de Spring https://spring.io/projects/spring-boot#overview

====[[JHipster]]====
* Matt Raible, The JHipster Mini-Book 4.5 (GRATUIT) https://www.infoq.com/minibooks/jhipster-4x-mini-book
* Deepu K Sasidharan, Sendil Kumar N, Full Stack Development with JHipster, (10 $ en promotion) March 2018, https://www.packtpub.com/application-development/full-stack-development-jhipster

====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-09-14T08:58:24Z

Sybille.Caffiau: /* Soutenance de fin de projet */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système
'''Autres :'''
* ADE : Emploi du temps en ligne

==Groupes et sujets==
===Groupes eCOM-RICM 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et VZ).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2017.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P)
* 25/09 15h45-18h30 : Séance en autonomie (P)

* 02/10 8h00-12h15 : Séance en autonomie (P)
* 02/10 15h45-18h30 : Test utilisateur (SC) (P)

* 09/10 8h00-12h15 : Audit 1 (P) et Séance en autonomie (P)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (P)

* 16/10 8h00-12h15 : Séance en autonomie (P)
* 16/10 15h45-18h30 : Séance encadrée (SC) (P)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P)
* 23/10 15h45-18h30 : Séance en autonomie (P)

* 06/11 8h00-12h15 : Audit 2 (P) et Séance en autonomie (P)
* 06/11 15h45-18h30 : Séance en autonomie (P)

* 20/11 8h00-12h15 : Séance en autonomie (P) + Séance encadrée (SC) (P)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 27/11 8h00-12h15 : Séance en autonomie (P)
* 27/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 04/12 15h45-18h30 : Séance en autonomie (P)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 11/12 15h45-18h30 : Séance en autonomie (P)

* 18/12 8h00-12h15 : Soutenances (P) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (P) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie JEE.
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]], le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- groupe 6

- groupe 3

- groupe 1

- groupe 2

- groupe 4

- groupe 5

''''' Contenu :'''''

Pour la partie GL et gestion de projet
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Audit 2 ===
*Salle : P
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL et gestion de projet :
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Procédure de tests
* Procédure d'intégration du code

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 :

- groupe 1 :

- groupe 5 :

- groupe 2 :

- groupe 4 :

- groupe 3 :

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : P
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré avec vos différentes productions)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* groupe 1
* groupe 3
* groupe 5
* groupe 4
* groupe 6
* groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et VZ pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Tout votre projet doit être suivi grâce à gitLab.

A tout moment, les enseignants doivent donc pouvoir
* avoir la dernière version du code (dernière version du logiciel en production et ce qui est en cours de développement dans des branches dédiées)
* voir les tâches prévues/en cours/réalisées
* savoir le travail de chaque membre (effectué et assigné)
* consulter les documents de conception (à jour)
* consulter les CR des daily meeting et autres réunions et les rétrospectives et vos présentations aux différents audits
* avoir connaissance des procédures de qualité que vous mettez en place au sein de votre projet
* consulter les résultats des différents tests pour chaque release

Attention : nous insistons particulièrement sur le fait que toutes ces données doivent être maintenues en temps réel et accessibles sur le gitlab de votre projet.

Attention : nous consulterons également les messages de commit.

===Rendus===
Vous trouverez ci-dessous une liste (non exhaustive) de certains livrables pouvant être produits au sein de votre projet

'''''L1. Composition des groupes et sujet'''''. (obligatoire)
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation JEE : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement JEE. Un composant peut être implanté par un programme Java externe (client léger / client lourd JEE), par un servlet, par un bean ou par un objet POJO. Dans ces derniers cas, il faut préciser les caractéristiques des beans / POJO (local / distribué, session / évenementiel, stateful / stateless, etc). Un lien peut être implanté par une relation JEE, ou bien par conservation de référence de bean.

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (waffle ou autre)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Diapos de votre présentation de conception'''''.

'''''L16. Diapos de votre présentation finale'''''.

'''''L17. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à utiliser un outil adapté cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

Vous devez utiliser GitLab comme support à votre projet (versioning, gestion des tâches...).

Nous vous demandons également d'utiliser les issues pour la communication avec les enseignants. En particulier, toute absence ou télétravail doit être signalé par ce média.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer un groupe GitLab. Y ajouter les membres du projet eCOM. Créer plusieurs projets pour les différents parties. Activer les notifications. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des EJB (session et entity beans, annotations JAX-RS, [[Swagger]]). L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl, [[Swagger]] UI, jmeter, .... Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et consommateur) et exécuter certaines requêtes avec des garanties transactionnelles. Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]] pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, Oracle, HSQL ...) (non répliquée)
# Mise en place de 2 containers base de données (MySQL, Oracle, HSQL ...) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion asynchrone et transactionnelle de l'envoi des courriels via [[JMS]] et des EJBTimer (voir http://ecom.ow2.org/xwiki/bin/view/Main/fremail)
** Gestion asynchrone et transactionnelle de l'envoi de SMS via [[JMS]] et des EJBTimer ([[ECOM/SMSProviders|fournisseurs SMS]])

* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec [[Apache Jackrabbit]]
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Suivi du ''click stream'' avec des Filters en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Intégration de [[Memcached]]
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST.
** Utilisation de services tiers via leurs APIs (voir le catalogue de [[Mashape]])
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Gestion d'un ''cloud'' privé avec [[OpenStack]] avec [[Fuel]]
** Gestion d'un [[CaaS]] Docker privé avec [[Kubernete]] ou [[Docker Swarm]]
** Conditionnement de l'application mobile avec [[Apache Cordova]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers ([[AxiMAG]] par exemple).

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google)
* Performances (résultat du injection de charge avec [[Apache JMeter]], [[Gatling]], OW2 CLIF, BlazeMeter.com) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Supervision des VMs du système déployé avec un de ces systèmes : [[Telegraf]] + [[InfluxDB]] + [[Grafana]].
* Script "basique" pour le Rolling update (Blue-Green Deployment) des composants (applications et intergiciels).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom (utiliser [https://hub.docker.com/_/glassfish/ Glassfish]).
* Préparation d'images [[Docker]]
* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[CoreOS]] ou [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des mécanismes pour intégrer les besoins des utilisateurs
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits

===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

===Evaluation des IHMs===
Une IHM doit être évaluée par au moins deux types d'évaluation (en plus de l'évaluation fonctionnelle) :
* évaluation experte pour vérifier que les principes fondamentaux d'utilisabilité sont respectés
* tests utilisateur pour étudier comment vos utilisateurs utilise dans leurs contextes d'utilisation votre interface

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [https://glassfish.java.net/docs/4.0/administration-guide.pdf Guide d'administration de Glassfish 4]
* [http://docs.oracle.com/javaee/7/tutorial/doc/ Tutorial JavaEE 7 ] ([https://svn.java.net/svn/javaeetutorial~svn/ sources des exemples])
* [http://docs.oracle.com/javaee/7/api/ API JavaEE 7]
* [https://java.net/projects/javaee-spec/pages/Home Java EE Platform Specification]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* [[Bootstrap]]

===Quelques livres et technologies===

REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* [http://www.apress.com/9781430246268 Antonio Goncalves, Beginning JavaEE 7, APress, 2013], ([https://github.com/agoncal/agoncal-book-javaee7 examples] pour [[Glassfish]] 4)
* [https://www.packtpub.com/application-development/java-ee-7-developer-handbook Peter A. Pilgrim, Java EE 7 Developer Handbook, Packt, 2013, ISBN 139781849687942 ]
* [http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book Mick Knutson, Java EE6 Cookbook for securing, tuning, and extending enterprise applications, Packt Publishing, June 2012]
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* [http://www.manning.com/panda2/ Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, March 2014, ISBN: 9781935182993], ([http://www.manning.com/panda2/EJB3iA_2E_SourceCode.zip source code of examples])
* [http://shop.oreilly.com/product/9780596158033.do Andrew Lee Rubinger, Bill Burke, Enterprise JavaBeans 3.1, 6th Edition, O'Reilly Media, Final Release Date: September 2010, Pages]
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[AngularJS]]====
* Brad Green, Shyam Seshadri, AngularJS, Pub OReilly http://shop.oreilly.com/product/0636920028055.do ([https://github.com/shyamseshadri/angularjs-book source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-09-14T08:57:44Z

Sybille.Caffiau: /* Planning des séances */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système
'''Autres :'''
* ADE : Emploi du temps en ligne

==Groupes et sujets==
===Groupes eCOM-RICM 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et VZ).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2017.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P)
* 25/09 15h45-18h30 : Séance en autonomie (P)

* 02/10 8h00-12h15 : Séance en autonomie (P)
* 02/10 15h45-18h30 : Test utilisateur (SC) (P)

* 09/10 8h00-12h15 : Audit 1 (P) et Séance en autonomie (P)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (P)

* 16/10 8h00-12h15 : Séance en autonomie (P)
* 16/10 15h45-18h30 : Séance encadrée (SC) (P)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P)
* 23/10 15h45-18h30 : Séance en autonomie (P)

* 06/11 8h00-12h15 : Audit 2 (P) et Séance en autonomie (P)
* 06/11 15h45-18h30 : Séance en autonomie (P)

* 20/11 8h00-12h15 : Séance en autonomie (P) + Séance encadrée (SC) (P)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 27/11 8h00-12h15 : Séance en autonomie (P)
* 27/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 04/12 15h45-18h30 : Séance en autonomie (P)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 11/12 15h45-18h30 : Séance en autonomie (P)

* 18/12 8h00-12h15 : Soutenances (P) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (P) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie JEE.
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]], le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- groupe 6

- groupe 3

- groupe 1

- groupe 2

- groupe 4

- groupe 5

''''' Contenu :'''''

Pour la partie GL et gestion de projet
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Audit 2 ===
*Salle : P
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL et gestion de projet :
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Procédure de tests
* Procédure d'intégration du code

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 :

- groupe 1 :

- groupe 5 :

- groupe 2 :

- groupe 4 :

- groupe 3 :

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : P
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré avec vos différentes productions)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* groupe 1
* groupe 3
* groupe 5
* groupe 4
* groupe 6
* groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et TR pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Tout votre projet doit être suivi grâce à gitLab.

A tout moment, les enseignants doivent donc pouvoir
* avoir la dernière version du code (dernière version du logiciel en production et ce qui est en cours de développement dans des branches dédiées)
* voir les tâches prévues/en cours/réalisées
* savoir le travail de chaque membre (effectué et assigné)
* consulter les documents de conception (à jour)
* consulter les CR des daily meeting et autres réunions et les rétrospectives et vos présentations aux différents audits
* avoir connaissance des procédures de qualité que vous mettez en place au sein de votre projet
* consulter les résultats des différents tests pour chaque release

Attention : nous insistons particulièrement sur le fait que toutes ces données doivent être maintenues en temps réel et accessibles sur le gitlab de votre projet.

Attention : nous consulterons également les messages de commit.

===Rendus===
Vous trouverez ci-dessous une liste (non exhaustive) de certains livrables pouvant être produits au sein de votre projet

'''''L1. Composition des groupes et sujet'''''. (obligatoire)
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation JEE : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement JEE. Un composant peut être implanté par un programme Java externe (client léger / client lourd JEE), par un servlet, par un bean ou par un objet POJO. Dans ces derniers cas, il faut préciser les caractéristiques des beans / POJO (local / distribué, session / évenementiel, stateful / stateless, etc). Un lien peut être implanté par une relation JEE, ou bien par conservation de référence de bean.

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (waffle ou autre)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Diapos de votre présentation de conception'''''.

'''''L16. Diapos de votre présentation finale'''''.

'''''L17. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à utiliser un outil adapté cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

Vous devez utiliser GitLab comme support à votre projet (versioning, gestion des tâches...).

Nous vous demandons également d'utiliser les issues pour la communication avec les enseignants. En particulier, toute absence ou télétravail doit être signalé par ce média.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer un groupe GitLab. Y ajouter les membres du projet eCOM. Créer plusieurs projets pour les différents parties. Activer les notifications. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des EJB (session et entity beans, annotations JAX-RS, [[Swagger]]). L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl, [[Swagger]] UI, jmeter, .... Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et consommateur) et exécuter certaines requêtes avec des garanties transactionnelles. Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]] pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, Oracle, HSQL ...) (non répliquée)
# Mise en place de 2 containers base de données (MySQL, Oracle, HSQL ...) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion asynchrone et transactionnelle de l'envoi des courriels via [[JMS]] et des EJBTimer (voir http://ecom.ow2.org/xwiki/bin/view/Main/fremail)
** Gestion asynchrone et transactionnelle de l'envoi de SMS via [[JMS]] et des EJBTimer ([[ECOM/SMSProviders|fournisseurs SMS]])

* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec [[Apache Jackrabbit]]
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Suivi du ''click stream'' avec des Filters en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Intégration de [[Memcached]]
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST.
** Utilisation de services tiers via leurs APIs (voir le catalogue de [[Mashape]])
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Gestion d'un ''cloud'' privé avec [[OpenStack]] avec [[Fuel]]
** Gestion d'un [[CaaS]] Docker privé avec [[Kubernete]] ou [[Docker Swarm]]
** Conditionnement de l'application mobile avec [[Apache Cordova]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers ([[AxiMAG]] par exemple).

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google)
* Performances (résultat du injection de charge avec [[Apache JMeter]], [[Gatling]], OW2 CLIF, BlazeMeter.com) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Supervision des VMs du système déployé avec un de ces systèmes : [[Telegraf]] + [[InfluxDB]] + [[Grafana]].
* Script "basique" pour le Rolling update (Blue-Green Deployment) des composants (applications et intergiciels).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom (utiliser [https://hub.docker.com/_/glassfish/ Glassfish]).
* Préparation d'images [[Docker]]
* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[CoreOS]] ou [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des mécanismes pour intégrer les besoins des utilisateurs
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits

===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

===Evaluation des IHMs===
Une IHM doit être évaluée par au moins deux types d'évaluation (en plus de l'évaluation fonctionnelle) :
* évaluation experte pour vérifier que les principes fondamentaux d'utilisabilité sont respectés
* tests utilisateur pour étudier comment vos utilisateurs utilise dans leurs contextes d'utilisation votre interface

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [https://glassfish.java.net/docs/4.0/administration-guide.pdf Guide d'administration de Glassfish 4]
* [http://docs.oracle.com/javaee/7/tutorial/doc/ Tutorial JavaEE 7 ] ([https://svn.java.net/svn/javaeetutorial~svn/ sources des exemples])
* [http://docs.oracle.com/javaee/7/api/ API JavaEE 7]
* [https://java.net/projects/javaee-spec/pages/Home Java EE Platform Specification]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* [[Bootstrap]]

===Quelques livres et technologies===

REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* [http://www.apress.com/9781430246268 Antonio Goncalves, Beginning JavaEE 7, APress, 2013], ([https://github.com/agoncal/agoncal-book-javaee7 examples] pour [[Glassfish]] 4)
* [https://www.packtpub.com/application-development/java-ee-7-developer-handbook Peter A. Pilgrim, Java EE 7 Developer Handbook, Packt, 2013, ISBN 139781849687942 ]
* [http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book Mick Knutson, Java EE6 Cookbook for securing, tuning, and extending enterprise applications, Packt Publishing, June 2012]
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* [http://www.manning.com/panda2/ Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, March 2014, ISBN: 9781935182993], ([http://www.manning.com/panda2/EJB3iA_2E_SourceCode.zip source code of examples])
* [http://shop.oreilly.com/product/9780596158033.do Andrew Lee Rubinger, Bill Burke, Enterprise JavaBeans 3.1, 6th Edition, O'Reilly Media, Final Release Date: September 2010, Pages]
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[AngularJS]]====
* Brad Green, Shyam Seshadri, AngularJS, Pub OReilly http://shop.oreilly.com/product/0636920028055.do ([https://github.com/shyamseshadri/angularjs-book source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-09-14T08:56:46Z

Sybille.Caffiau: /* Acronymes */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système
'''Autres :'''
* ADE : Emploi du temps en ligne

==Groupes et sujets==
===Groupes eCOM-RICM 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et TR).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2017.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P)
* 25/09 15h45-18h30 : Séance en autonomie (P)

* 02/10 8h00-12h15 : Séance en autonomie (P)
* 02/10 15h45-18h30 : Test utilisateur (SC) (P)

* 09/10 8h00-12h15 : Audit 1 (P) et Séance en autonomie (P)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (P)

* 16/10 8h00-12h15 : Séance en autonomie (P)
* 16/10 15h45-18h30 : Séance encadrée (SC) (P)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P)
* 23/10 15h45-18h30 : Séance en autonomie (P)

* 06/11 8h00-12h15 : Audit 2 (P) et Séance en autonomie (P)
* 06/11 15h45-18h30 : Séance en autonomie (P)

* 20/11 8h00-12h15 : Séance en autonomie (P) + Séance encadrée (SC) (P)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 27/11 8h00-12h15 : Séance en autonomie (P)
* 27/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 04/12 15h45-18h30 : Séance en autonomie (P)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 11/12 15h45-18h30 : Séance en autonomie (P)

* 18/12 8h00-12h15 : Soutenances (P) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (P) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie JEE.
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]], le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- groupe 6

- groupe 3

- groupe 1

- groupe 2

- groupe 4

- groupe 5

''''' Contenu :'''''

Pour la partie GL et gestion de projet
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Audit 2 ===
*Salle : P
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL et gestion de projet :
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Procédure de tests
* Procédure d'intégration du code

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 :

- groupe 1 :

- groupe 5 :

- groupe 2 :

- groupe 4 :

- groupe 3 :

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : P
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré avec vos différentes productions)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* groupe 1
* groupe 3
* groupe 5
* groupe 4
* groupe 6
* groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et TR pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Tout votre projet doit être suivi grâce à gitLab.

A tout moment, les enseignants doivent donc pouvoir
* avoir la dernière version du code (dernière version du logiciel en production et ce qui est en cours de développement dans des branches dédiées)
* voir les tâches prévues/en cours/réalisées
* savoir le travail de chaque membre (effectué et assigné)
* consulter les documents de conception (à jour)
* consulter les CR des daily meeting et autres réunions et les rétrospectives et vos présentations aux différents audits
* avoir connaissance des procédures de qualité que vous mettez en place au sein de votre projet
* consulter les résultats des différents tests pour chaque release

Attention : nous insistons particulièrement sur le fait que toutes ces données doivent être maintenues en temps réel et accessibles sur le gitlab de votre projet.

Attention : nous consulterons également les messages de commit.

===Rendus===
Vous trouverez ci-dessous une liste (non exhaustive) de certains livrables pouvant être produits au sein de votre projet

'''''L1. Composition des groupes et sujet'''''. (obligatoire)
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation JEE : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement JEE. Un composant peut être implanté par un programme Java externe (client léger / client lourd JEE), par un servlet, par un bean ou par un objet POJO. Dans ces derniers cas, il faut préciser les caractéristiques des beans / POJO (local / distribué, session / évenementiel, stateful / stateless, etc). Un lien peut être implanté par une relation JEE, ou bien par conservation de référence de bean.

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (waffle ou autre)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Diapos de votre présentation de conception'''''.

'''''L16. Diapos de votre présentation finale'''''.

'''''L17. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à utiliser un outil adapté cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

Vous devez utiliser GitLab comme support à votre projet (versioning, gestion des tâches...).

Nous vous demandons également d'utiliser les issues pour la communication avec les enseignants. En particulier, toute absence ou télétravail doit être signalé par ce média.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer un groupe GitLab. Y ajouter les membres du projet eCOM. Créer plusieurs projets pour les différents parties. Activer les notifications. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des EJB (session et entity beans, annotations JAX-RS, [[Swagger]]). L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl, [[Swagger]] UI, jmeter, .... Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et consommateur) et exécuter certaines requêtes avec des garanties transactionnelles. Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]] pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, Oracle, HSQL ...) (non répliquée)
# Mise en place de 2 containers base de données (MySQL, Oracle, HSQL ...) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion asynchrone et transactionnelle de l'envoi des courriels via [[JMS]] et des EJBTimer (voir http://ecom.ow2.org/xwiki/bin/view/Main/fremail)
** Gestion asynchrone et transactionnelle de l'envoi de SMS via [[JMS]] et des EJBTimer ([[ECOM/SMSProviders|fournisseurs SMS]])

* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec [[Apache Jackrabbit]]
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Suivi du ''click stream'' avec des Filters en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Intégration de [[Memcached]]
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST.
** Utilisation de services tiers via leurs APIs (voir le catalogue de [[Mashape]])
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Gestion d'un ''cloud'' privé avec [[OpenStack]] avec [[Fuel]]
** Gestion d'un [[CaaS]] Docker privé avec [[Kubernete]] ou [[Docker Swarm]]
** Conditionnement de l'application mobile avec [[Apache Cordova]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers ([[AxiMAG]] par exemple).

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google)
* Performances (résultat du injection de charge avec [[Apache JMeter]], [[Gatling]], OW2 CLIF, BlazeMeter.com) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Supervision des VMs du système déployé avec un de ces systèmes : [[Telegraf]] + [[InfluxDB]] + [[Grafana]].
* Script "basique" pour le Rolling update (Blue-Green Deployment) des composants (applications et intergiciels).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom (utiliser [https://hub.docker.com/_/glassfish/ Glassfish]).
* Préparation d'images [[Docker]]
* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[CoreOS]] ou [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des mécanismes pour intégrer les besoins des utilisateurs
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits

===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

===Evaluation des IHMs===
Une IHM doit être évaluée par au moins deux types d'évaluation (en plus de l'évaluation fonctionnelle) :
* évaluation experte pour vérifier que les principes fondamentaux d'utilisabilité sont respectés
* tests utilisateur pour étudier comment vos utilisateurs utilise dans leurs contextes d'utilisation votre interface

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [https://glassfish.java.net/docs/4.0/administration-guide.pdf Guide d'administration de Glassfish 4]
* [http://docs.oracle.com/javaee/7/tutorial/doc/ Tutorial JavaEE 7 ] ([https://svn.java.net/svn/javaeetutorial~svn/ sources des exemples])
* [http://docs.oracle.com/javaee/7/api/ API JavaEE 7]
* [https://java.net/projects/javaee-spec/pages/Home Java EE Platform Specification]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* [[Bootstrap]]

===Quelques livres et technologies===

REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* [http://www.apress.com/9781430246268 Antonio Goncalves, Beginning JavaEE 7, APress, 2013], ([https://github.com/agoncal/agoncal-book-javaee7 examples] pour [[Glassfish]] 4)
* [https://www.packtpub.com/application-development/java-ee-7-developer-handbook Peter A. Pilgrim, Java EE 7 Developer Handbook, Packt, 2013, ISBN 139781849687942 ]
* [http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book Mick Knutson, Java EE6 Cookbook for securing, tuning, and extending enterprise applications, Packt Publishing, June 2012]
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* [http://www.manning.com/panda2/ Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, March 2014, ISBN: 9781935182993], ([http://www.manning.com/panda2/EJB3iA_2E_SourceCode.zip source code of examples])
* [http://shop.oreilly.com/product/9780596158033.do Andrew Lee Rubinger, Bill Burke, Enterprise JavaBeans 3.1, 6th Edition, O'Reilly Media, Final Release Date: September 2010, Pages]
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[AngularJS]]====
* Brad Green, Shyam Seshadri, AngularJS, Pub OReilly http://shop.oreilly.com/product/0636920028055.do ([https://github.com/shyamseshadri/angularjs-book source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-09-04T14:19:36Z

Sybille.Caffiau: /* Réalisations IHM */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système

==Groupes et sujets==
===Groupes eCOM-RICM 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et TR).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2017.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P)
* 25/09 15h45-18h30 : Séance en autonomie (P)

* 02/10 8h00-12h15 : Séance en autonomie (P)
* 02/10 15h45-18h30 : Test utilisateur (SC) (P)

* 09/10 8h00-12h15 : Audit 1 (P) et Séance en autonomie (P)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (P)

* 16/10 8h00-12h15 : Séance en autonomie (P)
* 16/10 15h45-18h30 : Séance encadrée (SC) (P)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P)
* 23/10 15h45-18h30 : Séance en autonomie (P)

* 06/11 8h00-12h15 : Audit 2 (P) et Séance en autonomie (P)
* 06/11 15h45-18h30 : Séance en autonomie (P)

* 20/11 8h00-12h15 : Séance en autonomie (P) + Séance encadrée (SC) (P)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 27/11 8h00-12h15 : Séance en autonomie (P)
* 27/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 04/12 15h45-18h30 : Séance en autonomie (P)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 11/12 15h45-18h30 : Séance en autonomie (P)

* 18/12 8h00-12h15 : Soutenances (P) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (P) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie JEE.
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]], le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- groupe 6

- groupe 3

- groupe 1

- groupe 2

- groupe 4

- groupe 5

''''' Contenu :'''''

Pour la partie GL et gestion de projet
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Audit 2 ===
*Salle : P
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL et gestion de projet :
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Procédure de tests
* Procédure d'intégration du code

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 :

- groupe 1 :

- groupe 5 :

- groupe 2 :

- groupe 4 :

- groupe 3 :

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : P
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré avec vos différentes productions)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* groupe 1
* groupe 3
* groupe 5
* groupe 4
* groupe 6
* groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et TR pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Tout votre projet doit être suivi grâce à gitLab.

A tout moment, les enseignants doivent donc pouvoir
* avoir la dernière version du code (dernière version du logiciel en production et ce qui est en cours de développement dans des branches dédiées)
* voir les tâches prévues/en cours/réalisées
* savoir le travail de chaque membre (effectué et assigné)
* consulter les documents de conception (à jour)
* consulter les CR des daily meeting et autres réunions et les rétrospectives et vos présentations aux différents audits
* avoir connaissance des procédures de qualité que vous mettez en place au sein de votre projet
* consulter les résultats des différents tests pour chaque release

Attention : nous assistons particulièrement sur le fait que toutes ces données doivent être maintenues en temps réel et accessibles sur le gitlab de votre projet.

Attention : nous consulterons également les messages de commit

===Rendus===
Vous trouverez ci-dessous une liste (non exhaustive) de certains livrables pouvant être produits au sein de votre projet

'''''L1. Composition des groupes et sujet'''''. (obligatoire)
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation JEE : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement JEE. Un composant peut être implanté par un programme Java externe (client léger / client lourd JEE), par un servlet, par un bean ou par un objet POJO. Dans ces derniers cas, il faut préciser les caractéristiques des beans / POJO (local / distribué, session / évenementiel, stateful / stateless, etc). Un lien peut être implanté par une relation JEE, ou bien par conservation de référence de bean.

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (waffle ou autre)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Diapos de votre présentation de conception'''''.

'''''L16. Diapos de votre présentation finale'''''.

'''''L17. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à utiliser un outil adapté cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

Vous devez utiliser GitLab comme support à votre projet (versioning, gestion des tâches...).

Nous vous demandons également d'utiliser les issues pour la communication avec les enseignants. En particulier, toute absence ou télétravail doit être signalé par ce média.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer une organisation github ou bitbucket. Ajouter les membres du projet eCOM à l'organisation. Créer plusieurs projets pour les différents parties. Activer les watchs. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des EJB (session et entity beans, annotations JAX-RS, [[Swagger]]). L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl, [[Swagger]] UI, jmeter, .... Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et consommateur) et exécuter certaines requêtes avec des garanties transactionnelles. Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]] pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, Oracle, HSQL ...) (non répliquée)
# Mise en place de 2 containers base de données (MySQL, Oracle, HSQL ...) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion asynchrone et transactionnelle de l'envoi des courriels via [[JMS]] et des EJBTimer (voir http://ecom.ow2.org/xwiki/bin/view/Main/fremail)
** Gestion asynchrone et transactionnelle de l'envoi de SMS via [[JMS]] et des EJBTimer ([[ECOM/SMSProviders|fournisseurs SMS]])

* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec [[Apache Jackrabbit]]
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Suivi du ''click stream'' avec des Filters en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Intégration de [[Memcached]]
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST.
** Utilisation de services tiers via leurs APIs (voir le catalogue de [[Mashape]])
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Gestion d'un ''cloud'' privé avec [[OpenStack]] avec [[Fuel]]
** Gestion d'un [[CaaS]] Docker privé avec [[Kubernete]] ou [[Docker Swarm]]
** Conditionnement de l'application mobile avec [[Apache Cordova]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers ([[AxiMAG]] par exemple).

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google)
* Performances (résultat du injection de charge avec [[Apache JMeter]], [[Gatling]], OW2 CLIF, BlazeMeter.com) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Supervision des VMs du système déployé avec un de ces systèmes : [[Telegraf]] + [[InfluxDB]] + [[Grafana]].
* Script "basique" pour le Rolling update (Blue-Green Deployment) des composants (applications et intergiciels).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom (utiliser [https://hub.docker.com/_/glassfish/ Glassfish]).
* Préparation d'images [[Docker]]
* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[CoreOS]] ou [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des mécanismes pour intégrer les besoins des utilisateurs
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits

===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

===Evaluation des IHMs===
Une IHM doit être évaluée par au moins deux types d'évaluation (en plus de l'évaluation fonctionnelle) :
* évaluation experte pour vérifier que les principes fondamentaux d'utilisabilité sont respectés
* tests utilisateur pour étudier comment vos utilisateurs utilise dans leurs contextes d'utilisation votre interface

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [https://glassfish.java.net/docs/4.0/administration-guide.pdf Guide d'administration de Glassfish 4]
* [http://docs.oracle.com/javaee/7/tutorial/doc/ Tutorial JavaEE 7 ] ([https://svn.java.net/svn/javaeetutorial~svn/ sources des exemples])
* [http://docs.oracle.com/javaee/7/api/ API JavaEE 7]
* [https://java.net/projects/javaee-spec/pages/Home Java EE Platform Specification]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* [[Bootstrap]]

===Quelques livres et technologies===

REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* [http://www.apress.com/9781430246268 Antonio Goncalves, Beginning JavaEE 7, APress, 2013], ([https://github.com/agoncal/agoncal-book-javaee7 examples] pour [[Glassfish]] 4)
* [https://www.packtpub.com/application-development/java-ee-7-developer-handbook Peter A. Pilgrim, Java EE 7 Developer Handbook, Packt, 2013, ISBN 139781849687942 ]
* [http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book Mick Knutson, Java EE6 Cookbook for securing, tuning, and extending enterprise applications, Packt Publishing, June 2012]
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* [http://www.manning.com/panda2/ Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, March 2014, ISBN: 9781935182993], ([http://www.manning.com/panda2/EJB3iA_2E_SourceCode.zip source code of examples])
* [http://shop.oreilly.com/product/9780596158033.do Andrew Lee Rubinger, Bill Burke, Enterprise JavaBeans 3.1, 6th Edition, O'Reilly Media, Final Release Date: September 2010, Pages]
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[AngularJS]]====
* Brad Green, Shyam Seshadri, AngularJS, Pub OReilly http://shop.oreilly.com/product/0636920028055.do ([https://github.com/shyamseshadri/angularjs-book source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-09-04T14:17:23Z

Sybille.Caffiau: /* Conception */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système

==Groupes et sujets==
===Groupes eCOM-RICM 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et TR).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2017.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P)
* 25/09 15h45-18h30 : Séance en autonomie (P)

* 02/10 8h00-12h15 : Séance en autonomie (P)
* 02/10 15h45-18h30 : Test utilisateur (SC) (P)

* 09/10 8h00-12h15 : Audit 1 (P) et Séance en autonomie (P)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (P)

* 16/10 8h00-12h15 : Séance en autonomie (P)
* 16/10 15h45-18h30 : Séance encadrée (SC) (P)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P)
* 23/10 15h45-18h30 : Séance en autonomie (P)

* 06/11 8h00-12h15 : Audit 2 (P) et Séance en autonomie (P)
* 06/11 15h45-18h30 : Séance en autonomie (P)

* 20/11 8h00-12h15 : Séance en autonomie (P) + Séance encadrée (SC) (P)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 27/11 8h00-12h15 : Séance en autonomie (P)
* 27/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 04/12 15h45-18h30 : Séance en autonomie (P)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 11/12 15h45-18h30 : Séance en autonomie (P)

* 18/12 8h00-12h15 : Soutenances (P) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (P) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie JEE.
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]], le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- groupe 6

- groupe 3

- groupe 1

- groupe 2

- groupe 4

- groupe 5

''''' Contenu :'''''

Pour la partie GL et gestion de projet
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Audit 2 ===
*Salle : P
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL et gestion de projet :
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Procédure de tests
* Procédure d'intégration du code

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 :

- groupe 1 :

- groupe 5 :

- groupe 2 :

- groupe 4 :

- groupe 3 :

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : P
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré avec vos différentes productions)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* groupe 1
* groupe 3
* groupe 5
* groupe 4
* groupe 6
* groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et TR pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Tout votre projet doit être suivi grâce à gitLab.

A tout moment, les enseignants doivent donc pouvoir
* avoir la dernière version du code (dernière version du logiciel en production et ce qui est en cours de développement dans des branches dédiées)
* voir les tâches prévues/en cours/réalisées
* savoir le travail de chaque membre (effectué et assigné)
* consulter les documents de conception (à jour)
* consulter les CR des daily meeting et autres réunions et les rétrospectives et vos présentations aux différents audits
* avoir connaissance des procédures de qualité que vous mettez en place au sein de votre projet
* consulter les résultats des différents tests pour chaque release

Attention : nous assistons particulièrement sur le fait que toutes ces données doivent être maintenues en temps réel et accessibles sur le gitlab de votre projet.

Attention : nous consulterons également les messages de commit

===Rendus===
Vous trouverez ci-dessous une liste (non exhaustive) de certains livrables pouvant être produits au sein de votre projet

'''''L1. Composition des groupes et sujet'''''. (obligatoire)
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation JEE : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement JEE. Un composant peut être implanté par un programme Java externe (client léger / client lourd JEE), par un servlet, par un bean ou par un objet POJO. Dans ces derniers cas, il faut préciser les caractéristiques des beans / POJO (local / distribué, session / évenementiel, stateful / stateless, etc). Un lien peut être implanté par une relation JEE, ou bien par conservation de référence de bean.

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (waffle ou autre)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Diapos de votre présentation de conception'''''.

'''''L16. Diapos de votre présentation finale'''''.

'''''L17. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à utiliser un outil adapté cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

Vous devez utiliser GitLab comme support à votre projet (versioning, gestion des tâches...).

Nous vous demandons également d'utiliser les issues pour la communication avec les enseignants. En particulier, toute absence ou télétravail doit être signalé par ce média.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer une organisation github ou bitbucket. Ajouter les membres du projet eCOM à l'organisation. Créer plusieurs projets pour les différents parties. Activer les watchs. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des EJB (session et entity beans, annotations JAX-RS, [[Swagger]]). L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl, [[Swagger]] UI, jmeter, .... Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et consommateur) et exécuter certaines requêtes avec des garanties transactionnelles. Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]] pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, Oracle, HSQL ...) (non répliquée)
# Mise en place de 2 containers base de données (MySQL, Oracle, HSQL ...) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion asynchrone et transactionnelle de l'envoi des courriels via [[JMS]] et des EJBTimer (voir http://ecom.ow2.org/xwiki/bin/view/Main/fremail)
** Gestion asynchrone et transactionnelle de l'envoi de SMS via [[JMS]] et des EJBTimer ([[ECOM/SMSProviders|fournisseurs SMS]])

* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec [[Apache Jackrabbit]]
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Suivi du ''click stream'' avec des Filters en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Intégration de [[Memcached]]
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST.
** Utilisation de services tiers via leurs APIs (voir le catalogue de [[Mashape]])
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Gestion d'un ''cloud'' privé avec [[OpenStack]] avec [[Fuel]]
** Gestion d'un [[CaaS]] Docker privé avec [[Kubernete]] ou [[Docker Swarm]]
** Conditionnement de l'application mobile avec [[Apache Cordova]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers ([[AxiMAG]] par exemple).

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google)
* Performances (résultat du injection de charge avec [[Apache JMeter]], [[Gatling]], OW2 CLIF, BlazeMeter.com) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Supervision des VMs du système déployé avec un de ces systèmes : [[Telegraf]] + [[InfluxDB]] + [[Grafana]].
* Script "basique" pour le Rolling update (Blue-Green Deployment) des composants (applications et intergiciels).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom (utiliser [https://hub.docker.com/_/glassfish/ Glassfish]).
* Préparation d'images [[Docker]]
* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[CoreOS]] ou [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des mécanismes pour intégrer les besoins des utilisateurs
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits

===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [https://glassfish.java.net/docs/4.0/administration-guide.pdf Guide d'administration de Glassfish 4]
* [http://docs.oracle.com/javaee/7/tutorial/doc/ Tutorial JavaEE 7 ] ([https://svn.java.net/svn/javaeetutorial~svn/ sources des exemples])
* [http://docs.oracle.com/javaee/7/api/ API JavaEE 7]
* [https://java.net/projects/javaee-spec/pages/Home Java EE Platform Specification]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* [[Bootstrap]]

===Quelques livres et technologies===

REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* [http://www.apress.com/9781430246268 Antonio Goncalves, Beginning JavaEE 7, APress, 2013], ([https://github.com/agoncal/agoncal-book-javaee7 examples] pour [[Glassfish]] 4)
* [https://www.packtpub.com/application-development/java-ee-7-developer-handbook Peter A. Pilgrim, Java EE 7 Developer Handbook, Packt, 2013, ISBN 139781849687942 ]
* [http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book Mick Knutson, Java EE6 Cookbook for securing, tuning, and extending enterprise applications, Packt Publishing, June 2012]
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* [http://www.manning.com/panda2/ Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, March 2014, ISBN: 9781935182993], ([http://www.manning.com/panda2/EJB3iA_2E_SourceCode.zip source code of examples])
* [http://shop.oreilly.com/product/9780596158033.do Andrew Lee Rubinger, Bill Burke, Enterprise JavaBeans 3.1, 6th Edition, O'Reilly Media, Final Release Date: September 2010, Pages]
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[AngularJS]]====
* Brad Green, Shyam Seshadri, AngularJS, Pub OReilly http://shop.oreilly.com/product/0636920028055.do ([https://github.com/shyamseshadri/angularjs-book source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-09-04T14:15:36Z

Sybille.Caffiau: /* Conduite et suivi de projet */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système

==Groupes et sujets==
===Groupes eCOM-RICM 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et TR).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2017.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P)
* 25/09 15h45-18h30 : Séance en autonomie (P)

* 02/10 8h00-12h15 : Séance en autonomie (P)
* 02/10 15h45-18h30 : Test utilisateur (SC) (P)

* 09/10 8h00-12h15 : Audit 1 (P) et Séance en autonomie (P)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (P)

* 16/10 8h00-12h15 : Séance en autonomie (P)
* 16/10 15h45-18h30 : Séance encadrée (SC) (P)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P)
* 23/10 15h45-18h30 : Séance en autonomie (P)

* 06/11 8h00-12h15 : Audit 2 (P) et Séance en autonomie (P)
* 06/11 15h45-18h30 : Séance en autonomie (P)

* 20/11 8h00-12h15 : Séance en autonomie (P) + Séance encadrée (SC) (P)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 27/11 8h00-12h15 : Séance en autonomie (P)
* 27/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 04/12 15h45-18h30 : Séance en autonomie (P)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 11/12 15h45-18h30 : Séance en autonomie (P)

* 18/12 8h00-12h15 : Soutenances (P) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (P) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie JEE.
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]], le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- groupe 6

- groupe 3

- groupe 1

- groupe 2

- groupe 4

- groupe 5

''''' Contenu :'''''

Pour la partie GL et gestion de projet
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Audit 2 ===
*Salle : P
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL et gestion de projet :
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Procédure de tests
* Procédure d'intégration du code

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 :

- groupe 1 :

- groupe 5 :

- groupe 2 :

- groupe 4 :

- groupe 3 :

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : P
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré avec vos différentes productions)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* groupe 1
* groupe 3
* groupe 5
* groupe 4
* groupe 6
* groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et TR pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Tout votre projet doit être suivi grâce à gitLab.

A tout moment, les enseignants doivent donc pouvoir
* avoir la dernière version du code (dernière version du logiciel en production et ce qui est en cours de développement dans des branches dédiées)
* voir les tâches prévues/en cours/réalisées
* savoir le travail de chaque membre (effectué et assigné)
* consulter les documents de conception (à jour)
* consulter les CR des daily meeting et autres réunions et les rétrospectives et vos présentations aux différents audits
* avoir connaissance des procédures de qualité que vous mettez en place au sein de votre projet
* consulter les résultats des différents tests pour chaque release

Attention : nous assistons particulièrement sur le fait que toutes ces données doivent être maintenues en temps réel et accessibles sur le gitlab de votre projet.

Attention : nous consulterons également les messages de commit

===Rendus===
Vous trouverez ci-dessous une liste (non exhaustive) de certains livrables pouvant être produits au sein de votre projet

'''''L1. Composition des groupes et sujet'''''. (obligatoire)
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation JEE : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement JEE. Un composant peut être implanté par un programme Java externe (client léger / client lourd JEE), par un servlet, par un bean ou par un objet POJO. Dans ces derniers cas, il faut préciser les caractéristiques des beans / POJO (local / distribué, session / évenementiel, stateful / stateless, etc). Un lien peut être implanté par une relation JEE, ou bien par conservation de référence de bean.

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (waffle ou autre)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Diapos de votre présentation de conception'''''.

'''''L16. Diapos de votre présentation finale'''''.

'''''L17. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à utiliser un outil adapté cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

Vous devez utiliser GitLab comme support à votre projet (versioning, gestion des tâches...).

Nous vous demandons également d'utiliser les issues pour la communication avec les enseignants. En particulier, toute absence ou télétravail doit être signalé par ce média.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer une organisation github ou bitbucket. Ajouter les membres du projet eCOM à l'organisation. Créer plusieurs projets pour les différents parties. Activer les watchs. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des EJB (session et entity beans, annotations JAX-RS, [[Swagger]]). L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl, [[Swagger]] UI, jmeter, .... Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et consommateur) et exécuter certaines requêtes avec des garanties transactionnelles. Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]] pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, Oracle, HSQL ...) (non répliquée)
# Mise en place de 2 containers base de données (MySQL, Oracle, HSQL ...) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion asynchrone et transactionnelle de l'envoi des courriels via [[JMS]] et des EJBTimer (voir http://ecom.ow2.org/xwiki/bin/view/Main/fremail)
** Gestion asynchrone et transactionnelle de l'envoi de SMS via [[JMS]] et des EJBTimer ([[ECOM/SMSProviders|fournisseurs SMS]])

* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec [[Apache Jackrabbit]]
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Suivi du ''click stream'' avec des Filters en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Intégration de [[Memcached]]
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST.
** Utilisation de services tiers via leurs APIs (voir le catalogue de [[Mashape]])
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Gestion d'un ''cloud'' privé avec [[OpenStack]] avec [[Fuel]]
** Gestion d'un [[CaaS]] Docker privé avec [[Kubernete]] ou [[Docker Swarm]]
** Conditionnement de l'application mobile avec [[Apache Cordova]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers ([[AxiMAG]] par exemple).

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google)
* Performances (résultat du injection de charge avec [[Apache JMeter]], [[Gatling]], OW2 CLIF, BlazeMeter.com) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Supervision des VMs du système déployé avec un de ces systèmes : [[Telegraf]] + [[InfluxDB]] + [[Grafana]].
* Script "basique" pour le Rolling update (Blue-Green Deployment) des composants (applications et intergiciels).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom (utiliser [https://hub.docker.com/_/glassfish/ Glassfish]).
* Préparation d'images [[Docker]]
* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[CoreOS]] ou [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits
===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [https://glassfish.java.net/docs/4.0/administration-guide.pdf Guide d'administration de Glassfish 4]
* [http://docs.oracle.com/javaee/7/tutorial/doc/ Tutorial JavaEE 7 ] ([https://svn.java.net/svn/javaeetutorial~svn/ sources des exemples])
* [http://docs.oracle.com/javaee/7/api/ API JavaEE 7]
* [https://java.net/projects/javaee-spec/pages/Home Java EE Platform Specification]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* [[Bootstrap]]

===Quelques livres et technologies===

REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* [http://www.apress.com/9781430246268 Antonio Goncalves, Beginning JavaEE 7, APress, 2013], ([https://github.com/agoncal/agoncal-book-javaee7 examples] pour [[Glassfish]] 4)
* [https://www.packtpub.com/application-development/java-ee-7-developer-handbook Peter A. Pilgrim, Java EE 7 Developer Handbook, Packt, 2013, ISBN 139781849687942 ]
* [http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book Mick Knutson, Java EE6 Cookbook for securing, tuning, and extending enterprise applications, Packt Publishing, June 2012]
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* [http://www.manning.com/panda2/ Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, March 2014, ISBN: 9781935182993], ([http://www.manning.com/panda2/EJB3iA_2E_SourceCode.zip source code of examples])
* [http://shop.oreilly.com/product/9780596158033.do Andrew Lee Rubinger, Bill Burke, Enterprise JavaBeans 3.1, 6th Edition, O'Reilly Media, Final Release Date: September 2010, Pages]
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[AngularJS]]====
* Brad Green, Shyam Seshadri, AngularJS, Pub OReilly http://shop.oreilly.com/product/0636920028055.do ([https://github.com/shyamseshadri/angularjs-book source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-09-04T14:10:51Z

Sybille.Caffiau: /* Livrables */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système

==Groupes et sujets==
===Groupes eCOM-RICM 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et TR).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2017.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P)
* 25/09 15h45-18h30 : Séance en autonomie (P)

* 02/10 8h00-12h15 : Séance en autonomie (P)
* 02/10 15h45-18h30 : Test utilisateur (SC) (P)

* 09/10 8h00-12h15 : Audit 1 (P) et Séance en autonomie (P)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (P)

* 16/10 8h00-12h15 : Séance en autonomie (P)
* 16/10 15h45-18h30 : Séance encadrée (SC) (P)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P)
* 23/10 15h45-18h30 : Séance en autonomie (P)

* 06/11 8h00-12h15 : Audit 2 (P) et Séance en autonomie (P)
* 06/11 15h45-18h30 : Séance en autonomie (P)

* 20/11 8h00-12h15 : Séance en autonomie (P) + Séance encadrée (SC) (P)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 27/11 8h00-12h15 : Séance en autonomie (P)
* 27/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 04/12 15h45-18h30 : Séance en autonomie (P)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 11/12 15h45-18h30 : Séance en autonomie (P)

* 18/12 8h00-12h15 : Soutenances (P) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (P) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie JEE.
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]], le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- groupe 6

- groupe 3

- groupe 1

- groupe 2

- groupe 4

- groupe 5

''''' Contenu :'''''

Pour la partie GL et gestion de projet
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Audit 2 ===
*Salle : P
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL et gestion de projet :
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Procédure de tests
* Procédure d'intégration du code

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 :

- groupe 1 :

- groupe 5 :

- groupe 2 :

- groupe 4 :

- groupe 3 :

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : P
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré avec vos différentes productions)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* groupe 1
* groupe 3
* groupe 5
* groupe 4
* groupe 6
* groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et TR pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Tout votre projet doit être suivi grâce à gitLab.

A tout moment, les enseignants doivent donc pouvoir
* avoir la dernière version du code (dernière version du logiciel en production et ce qui est en cours de développement dans des branches dédiées)
* voir les tâches prévues/en cours/réalisées
* savoir le travail de chaque membre (effectué et assigné)
* consulter les documents de conception (à jour)
* consulter les CR des daily meeting et autres réunions et les rétrospectives et vos présentations aux différents audits
* avoir connaissance des procédures de qualité que vous mettez en place au sein de votre projet
* consulter les résultats des différents tests pour chaque release

Attention : nous assistons particulièrement sur le fait que toutes ces données doivent être maintenues en temps réel et accessibles sur le gitlab de votre projet.

Attention : nous consulterons également les messages de commit

===Rendus===
Vous trouverez ci-dessous une liste (non exhaustive) de certains livrables pouvant être produits au sein de votre projet

'''''L1. Composition des groupes et sujet'''''. (obligatoire)
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation JEE : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement JEE. Un composant peut être implanté par un programme Java externe (client léger / client lourd JEE), par un servlet, par un bean ou par un objet POJO. Dans ces derniers cas, il faut préciser les caractéristiques des beans / POJO (local / distribué, session / évenementiel, stateful / stateless, etc). Un lien peut être implanté par une relation JEE, ou bien par conservation de référence de bean.

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (waffle ou autre)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Diapos de votre présentation de conception'''''.

'''''L16. Diapos de votre présentation finale'''''.

'''''L17. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à créer un wiki qui regroupera l'ensemble de vos documentations. Cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer une organisation github ou bitbucket. Ajouter les membres du projet eCOM à l'organisation. Créer plusieurs projets pour les différents parties. Activer les watchs. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des EJB (session et entity beans, annotations JAX-RS, [[Swagger]]). L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl, [[Swagger]] UI, jmeter, .... Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et consommateur) et exécuter certaines requêtes avec des garanties transactionnelles. Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]] pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, Oracle, HSQL ...) (non répliquée)
# Mise en place de 2 containers base de données (MySQL, Oracle, HSQL ...) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion asynchrone et transactionnelle de l'envoi des courriels via [[JMS]] et des EJBTimer (voir http://ecom.ow2.org/xwiki/bin/view/Main/fremail)
** Gestion asynchrone et transactionnelle de l'envoi de SMS via [[JMS]] et des EJBTimer ([[ECOM/SMSProviders|fournisseurs SMS]])

* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec [[Apache Jackrabbit]]
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Suivi du ''click stream'' avec des Filters en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Intégration de [[Memcached]]
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST.
** Utilisation de services tiers via leurs APIs (voir le catalogue de [[Mashape]])
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Gestion d'un ''cloud'' privé avec [[OpenStack]] avec [[Fuel]]
** Gestion d'un [[CaaS]] Docker privé avec [[Kubernete]] ou [[Docker Swarm]]
** Conditionnement de l'application mobile avec [[Apache Cordova]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers ([[AxiMAG]] par exemple).

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google)
* Performances (résultat du injection de charge avec [[Apache JMeter]], [[Gatling]], OW2 CLIF, BlazeMeter.com) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Supervision des VMs du système déployé avec un de ces systèmes : [[Telegraf]] + [[InfluxDB]] + [[Grafana]].
* Script "basique" pour le Rolling update (Blue-Green Deployment) des composants (applications et intergiciels).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom (utiliser [https://hub.docker.com/_/glassfish/ Glassfish]).
* Préparation d'images [[Docker]]
* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[CoreOS]] ou [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits
===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [https://glassfish.java.net/docs/4.0/administration-guide.pdf Guide d'administration de Glassfish 4]
* [http://docs.oracle.com/javaee/7/tutorial/doc/ Tutorial JavaEE 7 ] ([https://svn.java.net/svn/javaeetutorial~svn/ sources des exemples])
* [http://docs.oracle.com/javaee/7/api/ API JavaEE 7]
* [https://java.net/projects/javaee-spec/pages/Home Java EE Platform Specification]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* [[Bootstrap]]

===Quelques livres et technologies===

REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* [http://www.apress.com/9781430246268 Antonio Goncalves, Beginning JavaEE 7, APress, 2013], ([https://github.com/agoncal/agoncal-book-javaee7 examples] pour [[Glassfish]] 4)
* [https://www.packtpub.com/application-development/java-ee-7-developer-handbook Peter A. Pilgrim, Java EE 7 Developer Handbook, Packt, 2013, ISBN 139781849687942 ]
* [http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book Mick Knutson, Java EE6 Cookbook for securing, tuning, and extending enterprise applications, Packt Publishing, June 2012]
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* [http://www.manning.com/panda2/ Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, March 2014, ISBN: 9781935182993], ([http://www.manning.com/panda2/EJB3iA_2E_SourceCode.zip source code of examples])
* [http://shop.oreilly.com/product/9780596158033.do Andrew Lee Rubinger, Bill Burke, Enterprise JavaBeans 3.1, 6th Edition, O'Reilly Media, Final Release Date: September 2010, Pages]
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[AngularJS]]====
* Brad Green, Shyam Seshadri, AngularJS, Pub OReilly http://shop.oreilly.com/product/0636920028055.do ([https://github.com/shyamseshadri/angularjs-book source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-09-03T13:46:10Z

Sybille.Caffiau: /* Audit 1 */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système

==Groupes et sujets==
===Groupes eCOM-RICM 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et TR).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2017.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P)
* 25/09 15h45-18h30 : Séance en autonomie (P)

* 02/10 8h00-12h15 : Séance en autonomie (P)
* 02/10 15h45-18h30 : Test utilisateur (SC) (P)

* 09/10 8h00-12h15 : Audit 1 (P) et Séance en autonomie (P)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (P)

* 16/10 8h00-12h15 : Séance en autonomie (P)
* 16/10 15h45-18h30 : Séance encadrée (SC) (P)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P)
* 23/10 15h45-18h30 : Séance en autonomie (P)

* 06/11 8h00-12h15 : Audit 2 (P) et Séance en autonomie (P)
* 06/11 15h45-18h30 : Séance en autonomie (P)

* 20/11 8h00-12h15 : Séance en autonomie (P) + Séance encadrée (SC) (P)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 27/11 8h00-12h15 : Séance en autonomie (P)
* 27/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 04/12 15h45-18h30 : Séance en autonomie (P)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 11/12 15h45-18h30 : Séance en autonomie (P)

* 18/12 8h00-12h15 : Soutenances (P) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (P) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie JEE.
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]], le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- groupe 6

- groupe 3

- groupe 1

- groupe 2

- groupe 4

- groupe 5

''''' Contenu :'''''

Pour la partie GL et gestion de projet
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Audit 2 ===
*Salle : P
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL et gestion de projet :
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Procédure de tests
* Procédure d'intégration du code

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 :

- groupe 1 :

- groupe 5 :

- groupe 2 :

- groupe 4 :

- groupe 3 :

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : P
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré avec vos différentes productions)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* groupe 1
* groupe 3
* groupe 5
* groupe 4
* groupe 6
* groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et TR pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Deux rapports doivent être rédigés pour la partie Système : un document de conception système et un document d'évaluation système. Ces documents doivent être accessibles depuis le wiki (ils peuvent même être directement édités sur le wiki).

Vous pouvez ajouter les livrables que vous jugez utiles pour présenter le travail que vous avez réalisé. Pour ces livrables : numérotez les

===Rendus===
Chaque livrable est numéroté (détails du livrable ci-dessous) LX, sous une forme à respecter. Certains ont une date de rendu à respecter. Ci-dessous le résumé de ces contraintes :
*L2 : 09/10 minuit : Wiki
*L3 : 09/10 minuit : Wiki
*L4 : 06/11 minuit : Wiki
*L5 : ?
*L6 : 06/11 minuit : Wiki
*L7 : 09/10 minuit : Wiki
*L8 : en continu : Wiki
*L9 : en continu : Wiki
*L10 : 18/12 minuit : Lien Git sur Wiki
*L11 : 18/12 minuit : Lien sur Wiki
*L12 : 19/12 lors du passage
*L13 : 18/12 minuit : Lien Git sur Wiki
*L14 : 18/12 minuit : Lien Git sur Wiki
*L15 : 08/11 lors du passage
*L16 : 19/12 lors du passage
*L17 : 19/12 lors du passage : Tableaux complétés et imprimés
*L18 : 10/10 lors du passage

===Contenu===
'''''L1. Composition des groupes et sujet'''''.
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation JEE : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement JEE. Un composant peut être implanté par un programme Java externe (client léger / client lourd JEE), par un servlet, par un bean ou par un objet POJO. Dans ces derniers cas, il faut préciser les caractéristiques des beans / POJO (local / distribué, session / évenementiel, stateful / stateless, etc). Un lien peut être implanté par une relation JEE, ou bien par conservation de référence de bean.

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (waffle ou autre)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Diapos de votre présentation de conception'''''.

'''''L16. Diapos de votre présentation finale'''''.

'''''L17. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à créer un wiki qui regroupera l'ensemble de vos documentations. Cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer une organisation github ou bitbucket. Ajouter les membres du projet eCOM à l'organisation. Créer plusieurs projets pour les différents parties. Activer les watchs. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des EJB (session et entity beans, annotations JAX-RS, [[Swagger]]). L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl, [[Swagger]] UI, jmeter, .... Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et consommateur) et exécuter certaines requêtes avec des garanties transactionnelles. Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]] pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, Oracle, HSQL ...) (non répliquée)
# Mise en place de 2 containers base de données (MySQL, Oracle, HSQL ...) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion asynchrone et transactionnelle de l'envoi des courriels via [[JMS]] et des EJBTimer (voir http://ecom.ow2.org/xwiki/bin/view/Main/fremail)
** Gestion asynchrone et transactionnelle de l'envoi de SMS via [[JMS]] et des EJBTimer ([[ECOM/SMSProviders|fournisseurs SMS]])

* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec [[Apache Jackrabbit]]
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Suivi du ''click stream'' avec des Filters en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Intégration de [[Memcached]]
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST.
** Utilisation de services tiers via leurs APIs (voir le catalogue de [[Mashape]])
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Gestion d'un ''cloud'' privé avec [[OpenStack]] avec [[Fuel]]
** Gestion d'un [[CaaS]] Docker privé avec [[Kubernete]] ou [[Docker Swarm]]
** Conditionnement de l'application mobile avec [[Apache Cordova]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers ([[AxiMAG]] par exemple).

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google)
* Performances (résultat du injection de charge avec [[Apache JMeter]], [[Gatling]], OW2 CLIF, BlazeMeter.com) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Supervision des VMs du système déployé avec un de ces systèmes : [[Telegraf]] + [[InfluxDB]] + [[Grafana]].
* Script "basique" pour le Rolling update (Blue-Green Deployment) des composants (applications et intergiciels).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom (utiliser [https://hub.docker.com/_/glassfish/ Glassfish]).
* Préparation d'images [[Docker]]
* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[CoreOS]] ou [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits
===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [https://glassfish.java.net/docs/4.0/administration-guide.pdf Guide d'administration de Glassfish 4]
* [http://docs.oracle.com/javaee/7/tutorial/doc/ Tutorial JavaEE 7 ] ([https://svn.java.net/svn/javaeetutorial~svn/ sources des exemples])
* [http://docs.oracle.com/javaee/7/api/ API JavaEE 7]
* [https://java.net/projects/javaee-spec/pages/Home Java EE Platform Specification]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* [[Bootstrap]]

===Quelques livres et technologies===

REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* [http://www.apress.com/9781430246268 Antonio Goncalves, Beginning JavaEE 7, APress, 2013], ([https://github.com/agoncal/agoncal-book-javaee7 examples] pour [[Glassfish]] 4)
* [https://www.packtpub.com/application-development/java-ee-7-developer-handbook Peter A. Pilgrim, Java EE 7 Developer Handbook, Packt, 2013, ISBN 139781849687942 ]
* [http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book Mick Knutson, Java EE6 Cookbook for securing, tuning, and extending enterprise applications, Packt Publishing, June 2012]
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* [http://www.manning.com/panda2/ Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, March 2014, ISBN: 9781935182993], ([http://www.manning.com/panda2/EJB3iA_2E_SourceCode.zip source code of examples])
* [http://shop.oreilly.com/product/9780596158033.do Andrew Lee Rubinger, Bill Burke, Enterprise JavaBeans 3.1, 6th Edition, O'Reilly Media, Final Release Date: September 2010, Pages]
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[AngularJS]]====
* Brad Green, Shyam Seshadri, AngularJS, Pub OReilly http://shop.oreilly.com/product/0636920028055.do ([https://github.com/shyamseshadri/angularjs-book source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-09-03T13:45:43Z

Sybille.Caffiau: /* Audit 2 */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système

==Groupes et sujets==
===Groupes eCOM-RICM 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et TR).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2017.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P)
* 25/09 15h45-18h30 : Séance en autonomie (P)

* 02/10 8h00-12h15 : Séance en autonomie (P)
* 02/10 15h45-18h30 : Test utilisateur (SC) (P)

* 09/10 8h00-12h15 : Audit 1 (P) et Séance en autonomie (P)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (P)

* 16/10 8h00-12h15 : Séance en autonomie (P)
* 16/10 15h45-18h30 : Séance encadrée (SC) (P)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P)
* 23/10 15h45-18h30 : Séance en autonomie (P)

* 06/11 8h00-12h15 : Audit 2 (P) et Séance en autonomie (P)
* 06/11 15h45-18h30 : Séance en autonomie (P)

* 20/11 8h00-12h15 : Séance en autonomie (P) + Séance encadrée (SC) (P)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 27/11 8h00-12h15 : Séance en autonomie (P)
* 27/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 04/12 15h45-18h30 : Séance en autonomie (P)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 11/12 15h45-18h30 : Séance en autonomie (P)

* 18/12 8h00-12h15 : Soutenances (P) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (P) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie JEE.
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]], le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- groupe 6

- groupe 3

- groupe 1

- groupe 2

- groupe 4

- groupe 5

''''' Contenu :'''''

Pour la partie GL
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Audit 2 ===
*Salle : P
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL et gestion de projet :
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Procédure de tests
* Procédure d'intégration du code

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 :

- groupe 1 :

- groupe 5 :

- groupe 2 :

- groupe 4 :

- groupe 3 :

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : P
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré avec vos différentes productions)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* groupe 1
* groupe 3
* groupe 5
* groupe 4
* groupe 6
* groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et TR pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Deux rapports doivent être rédigés pour la partie Système : un document de conception système et un document d'évaluation système. Ces documents doivent être accessibles depuis le wiki (ils peuvent même être directement édités sur le wiki).

Vous pouvez ajouter les livrables que vous jugez utiles pour présenter le travail que vous avez réalisé. Pour ces livrables : numérotez les

===Rendus===
Chaque livrable est numéroté (détails du livrable ci-dessous) LX, sous une forme à respecter. Certains ont une date de rendu à respecter. Ci-dessous le résumé de ces contraintes :
*L2 : 09/10 minuit : Wiki
*L3 : 09/10 minuit : Wiki
*L4 : 06/11 minuit : Wiki
*L5 : ?
*L6 : 06/11 minuit : Wiki
*L7 : 09/10 minuit : Wiki
*L8 : en continu : Wiki
*L9 : en continu : Wiki
*L10 : 18/12 minuit : Lien Git sur Wiki
*L11 : 18/12 minuit : Lien sur Wiki
*L12 : 19/12 lors du passage
*L13 : 18/12 minuit : Lien Git sur Wiki
*L14 : 18/12 minuit : Lien Git sur Wiki
*L15 : 08/11 lors du passage
*L16 : 19/12 lors du passage
*L17 : 19/12 lors du passage : Tableaux complétés et imprimés
*L18 : 10/10 lors du passage

===Contenu===
'''''L1. Composition des groupes et sujet'''''.
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation JEE : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement JEE. Un composant peut être implanté par un programme Java externe (client léger / client lourd JEE), par un servlet, par un bean ou par un objet POJO. Dans ces derniers cas, il faut préciser les caractéristiques des beans / POJO (local / distribué, session / évenementiel, stateful / stateless, etc). Un lien peut être implanté par une relation JEE, ou bien par conservation de référence de bean.

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (waffle ou autre)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Diapos de votre présentation de conception'''''.

'''''L16. Diapos de votre présentation finale'''''.

'''''L17. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à créer un wiki qui regroupera l'ensemble de vos documentations. Cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer une organisation github ou bitbucket. Ajouter les membres du projet eCOM à l'organisation. Créer plusieurs projets pour les différents parties. Activer les watchs. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des EJB (session et entity beans, annotations JAX-RS, [[Swagger]]). L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl, [[Swagger]] UI, jmeter, .... Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et consommateur) et exécuter certaines requêtes avec des garanties transactionnelles. Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]] pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, Oracle, HSQL ...) (non répliquée)
# Mise en place de 2 containers base de données (MySQL, Oracle, HSQL ...) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion asynchrone et transactionnelle de l'envoi des courriels via [[JMS]] et des EJBTimer (voir http://ecom.ow2.org/xwiki/bin/view/Main/fremail)
** Gestion asynchrone et transactionnelle de l'envoi de SMS via [[JMS]] et des EJBTimer ([[ECOM/SMSProviders|fournisseurs SMS]])

* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec [[Apache Jackrabbit]]
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Suivi du ''click stream'' avec des Filters en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Intégration de [[Memcached]]
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST.
** Utilisation de services tiers via leurs APIs (voir le catalogue de [[Mashape]])
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Gestion d'un ''cloud'' privé avec [[OpenStack]] avec [[Fuel]]
** Gestion d'un [[CaaS]] Docker privé avec [[Kubernete]] ou [[Docker Swarm]]
** Conditionnement de l'application mobile avec [[Apache Cordova]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers ([[AxiMAG]] par exemple).

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google)
* Performances (résultat du injection de charge avec [[Apache JMeter]], [[Gatling]], OW2 CLIF, BlazeMeter.com) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Supervision des VMs du système déployé avec un de ces systèmes : [[Telegraf]] + [[InfluxDB]] + [[Grafana]].
* Script "basique" pour le Rolling update (Blue-Green Deployment) des composants (applications et intergiciels).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom (utiliser [https://hub.docker.com/_/glassfish/ Glassfish]).
* Préparation d'images [[Docker]]
* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[CoreOS]] ou [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits
===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [https://glassfish.java.net/docs/4.0/administration-guide.pdf Guide d'administration de Glassfish 4]
* [http://docs.oracle.com/javaee/7/tutorial/doc/ Tutorial JavaEE 7 ] ([https://svn.java.net/svn/javaeetutorial~svn/ sources des exemples])
* [http://docs.oracle.com/javaee/7/api/ API JavaEE 7]
* [https://java.net/projects/javaee-spec/pages/Home Java EE Platform Specification]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* [[Bootstrap]]

===Quelques livres et technologies===

REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* [http://www.apress.com/9781430246268 Antonio Goncalves, Beginning JavaEE 7, APress, 2013], ([https://github.com/agoncal/agoncal-book-javaee7 examples] pour [[Glassfish]] 4)
* [https://www.packtpub.com/application-development/java-ee-7-developer-handbook Peter A. Pilgrim, Java EE 7 Developer Handbook, Packt, 2013, ISBN 139781849687942 ]
* [http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book Mick Knutson, Java EE6 Cookbook for securing, tuning, and extending enterprise applications, Packt Publishing, June 2012]
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* [http://www.manning.com/panda2/ Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, March 2014, ISBN: 9781935182993], ([http://www.manning.com/panda2/EJB3iA_2E_SourceCode.zip source code of examples])
* [http://shop.oreilly.com/product/9780596158033.do Andrew Lee Rubinger, Bill Burke, Enterprise JavaBeans 3.1, 6th Edition, O'Reilly Media, Final Release Date: September 2010, Pages]
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[AngularJS]]====
* Brad Green, Shyam Seshadri, AngularJS, Pub OReilly http://shop.oreilly.com/product/0636920028055.do ([https://github.com/shyamseshadri/angularjs-book source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-09-03T13:43:58Z

Sybille.Caffiau: /* Soutenance de fin de projet */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système

==Groupes et sujets==
===Groupes eCOM-RICM 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et TR).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2017.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P)
* 25/09 15h45-18h30 : Séance en autonomie (P)

* 02/10 8h00-12h15 : Séance en autonomie (P)
* 02/10 15h45-18h30 : Test utilisateur (SC) (P)

* 09/10 8h00-12h15 : Audit 1 (P) et Séance en autonomie (P)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (P)

* 16/10 8h00-12h15 : Séance en autonomie (P)
* 16/10 15h45-18h30 : Séance encadrée (SC) (P)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P)
* 23/10 15h45-18h30 : Séance en autonomie (P)

* 06/11 8h00-12h15 : Audit 2 (P) et Séance en autonomie (P)
* 06/11 15h45-18h30 : Séance en autonomie (P)

* 20/11 8h00-12h15 : Séance en autonomie (P) + Séance encadrée (SC) (P)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 27/11 8h00-12h15 : Séance en autonomie (P)
* 27/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 04/12 15h45-18h30 : Séance en autonomie (P)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 11/12 15h45-18h30 : Séance en autonomie (P)

* 18/12 8h00-12h15 : Soutenances (P) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (P) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie JEE.
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]], le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- groupe 6

- groupe 3

- groupe 1

- groupe 2

- groupe 4

- groupe 5

''''' Contenu :'''''

Pour la partie GL
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Audit 2 ===
*Salle : P
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL : point sur
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Choix technologiques

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 :

- groupe 1 :

- groupe 5 :

- groupe 2 :

- groupe 4 :

- groupe 3 :

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : P
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré avec vos différentes productions)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* groupe 1
* groupe 3
* groupe 5
* groupe 4
* groupe 6
* groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et TR pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Deux rapports doivent être rédigés pour la partie Système : un document de conception système et un document d'évaluation système. Ces documents doivent être accessibles depuis le wiki (ils peuvent même être directement édités sur le wiki).

Vous pouvez ajouter les livrables que vous jugez utiles pour présenter le travail que vous avez réalisé. Pour ces livrables : numérotez les

===Rendus===
Chaque livrable est numéroté (détails du livrable ci-dessous) LX, sous une forme à respecter. Certains ont une date de rendu à respecter. Ci-dessous le résumé de ces contraintes :
*L2 : 09/10 minuit : Wiki
*L3 : 09/10 minuit : Wiki
*L4 : 06/11 minuit : Wiki
*L5 : ?
*L6 : 06/11 minuit : Wiki
*L7 : 09/10 minuit : Wiki
*L8 : en continu : Wiki
*L9 : en continu : Wiki
*L10 : 18/12 minuit : Lien Git sur Wiki
*L11 : 18/12 minuit : Lien sur Wiki
*L12 : 19/12 lors du passage
*L13 : 18/12 minuit : Lien Git sur Wiki
*L14 : 18/12 minuit : Lien Git sur Wiki
*L15 : 08/11 lors du passage
*L16 : 19/12 lors du passage
*L17 : 19/12 lors du passage : Tableaux complétés et imprimés
*L18 : 10/10 lors du passage

===Contenu===
'''''L1. Composition des groupes et sujet'''''.
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation JEE : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement JEE. Un composant peut être implanté par un programme Java externe (client léger / client lourd JEE), par un servlet, par un bean ou par un objet POJO. Dans ces derniers cas, il faut préciser les caractéristiques des beans / POJO (local / distribué, session / évenementiel, stateful / stateless, etc). Un lien peut être implanté par une relation JEE, ou bien par conservation de référence de bean.

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (waffle ou autre)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Diapos de votre présentation de conception'''''.

'''''L16. Diapos de votre présentation finale'''''.

'''''L17. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à créer un wiki qui regroupera l'ensemble de vos documentations. Cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer une organisation github ou bitbucket. Ajouter les membres du projet eCOM à l'organisation. Créer plusieurs projets pour les différents parties. Activer les watchs. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des EJB (session et entity beans, annotations JAX-RS, [[Swagger]]). L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl, [[Swagger]] UI, jmeter, .... Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et consommateur) et exécuter certaines requêtes avec des garanties transactionnelles. Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]] pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, Oracle, HSQL ...) (non répliquée)
# Mise en place de 2 containers base de données (MySQL, Oracle, HSQL ...) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion asynchrone et transactionnelle de l'envoi des courriels via [[JMS]] et des EJBTimer (voir http://ecom.ow2.org/xwiki/bin/view/Main/fremail)
** Gestion asynchrone et transactionnelle de l'envoi de SMS via [[JMS]] et des EJBTimer ([[ECOM/SMSProviders|fournisseurs SMS]])

* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec [[Apache Jackrabbit]]
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Suivi du ''click stream'' avec des Filters en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Intégration de [[Memcached]]
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST.
** Utilisation de services tiers via leurs APIs (voir le catalogue de [[Mashape]])
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Gestion d'un ''cloud'' privé avec [[OpenStack]] avec [[Fuel]]
** Gestion d'un [[CaaS]] Docker privé avec [[Kubernete]] ou [[Docker Swarm]]
** Conditionnement de l'application mobile avec [[Apache Cordova]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers ([[AxiMAG]] par exemple).

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google)
* Performances (résultat du injection de charge avec [[Apache JMeter]], [[Gatling]], OW2 CLIF, BlazeMeter.com) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Supervision des VMs du système déployé avec un de ces systèmes : [[Telegraf]] + [[InfluxDB]] + [[Grafana]].
* Script "basique" pour le Rolling update (Blue-Green Deployment) des composants (applications et intergiciels).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom (utiliser [https://hub.docker.com/_/glassfish/ Glassfish]).
* Préparation d'images [[Docker]]
* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[CoreOS]] ou [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits
===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [https://glassfish.java.net/docs/4.0/administration-guide.pdf Guide d'administration de Glassfish 4]
* [http://docs.oracle.com/javaee/7/tutorial/doc/ Tutorial JavaEE 7 ] ([https://svn.java.net/svn/javaeetutorial~svn/ sources des exemples])
* [http://docs.oracle.com/javaee/7/api/ API JavaEE 7]
* [https://java.net/projects/javaee-spec/pages/Home Java EE Platform Specification]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* [[Bootstrap]]

===Quelques livres et technologies===

REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* [http://www.apress.com/9781430246268 Antonio Goncalves, Beginning JavaEE 7, APress, 2013], ([https://github.com/agoncal/agoncal-book-javaee7 examples] pour [[Glassfish]] 4)
* [https://www.packtpub.com/application-development/java-ee-7-developer-handbook Peter A. Pilgrim, Java EE 7 Developer Handbook, Packt, 2013, ISBN 139781849687942 ]
* [http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book Mick Knutson, Java EE6 Cookbook for securing, tuning, and extending enterprise applications, Packt Publishing, June 2012]
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* [http://www.manning.com/panda2/ Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, March 2014, ISBN: 9781935182993], ([http://www.manning.com/panda2/EJB3iA_2E_SourceCode.zip source code of examples])
* [http://shop.oreilly.com/product/9780596158033.do Andrew Lee Rubinger, Bill Burke, Enterprise JavaBeans 3.1, 6th Edition, O'Reilly Media, Final Release Date: September 2010, Pages]
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[AngularJS]]====
* Brad Green, Shyam Seshadri, AngularJS, Pub OReilly http://shop.oreilly.com/product/0636920028055.do ([https://github.com/shyamseshadri/angularjs-book source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-09-03T13:42:04Z

Sybille.Caffiau: /* Audit 2 */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système

==Groupes et sujets==
===Groupes eCOM-RICM 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et TR).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2017.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P)
* 25/09 15h45-18h30 : Séance en autonomie (P)

* 02/10 8h00-12h15 : Séance en autonomie (P)
* 02/10 15h45-18h30 : Test utilisateur (SC) (P)

* 09/10 8h00-12h15 : Audit 1 (P) et Séance en autonomie (P)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (P)

* 16/10 8h00-12h15 : Séance en autonomie (P)
* 16/10 15h45-18h30 : Séance encadrée (SC) (P)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P)
* 23/10 15h45-18h30 : Séance en autonomie (P)

* 06/11 8h00-12h15 : Audit 2 (P) et Séance en autonomie (P)
* 06/11 15h45-18h30 : Séance en autonomie (P)

* 20/11 8h00-12h15 : Séance en autonomie (P) + Séance encadrée (SC) (P)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 27/11 8h00-12h15 : Séance en autonomie (P)
* 27/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 04/12 15h45-18h30 : Séance en autonomie (P)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 11/12 15h45-18h30 : Séance en autonomie (P)

* 18/12 8h00-12h15 : Soutenances (P) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (P) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie JEE.
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]], le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- groupe 6

- groupe 3

- groupe 1

- groupe 2

- groupe 4

- groupe 5

''''' Contenu :'''''

Pour la partie GL
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Audit 2 ===
*Salle : P
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL : point sur
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Choix technologiques

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 :

- groupe 1 :

- groupe 5 :

- groupe 2 :

- groupe 4 :

- groupe 3 :

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : F114
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* 8h : groupe 1
* 8h35 : groupe 3
* 9h10 : groupe 5
* 15h45 : groupe 4
* 16h20 : groupe 6
* 16h55 : groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et TR pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Deux rapports doivent être rédigés pour la partie Système : un document de conception système et un document d'évaluation système. Ces documents doivent être accessibles depuis le wiki (ils peuvent même être directement édités sur le wiki).

Vous pouvez ajouter les livrables que vous jugez utiles pour présenter le travail que vous avez réalisé. Pour ces livrables : numérotez les

===Rendus===
Chaque livrable est numéroté (détails du livrable ci-dessous) LX, sous une forme à respecter. Certains ont une date de rendu à respecter. Ci-dessous le résumé de ces contraintes :
*L2 : 09/10 minuit : Wiki
*L3 : 09/10 minuit : Wiki
*L4 : 06/11 minuit : Wiki
*L5 : ?
*L6 : 06/11 minuit : Wiki
*L7 : 09/10 minuit : Wiki
*L8 : en continu : Wiki
*L9 : en continu : Wiki
*L10 : 18/12 minuit : Lien Git sur Wiki
*L11 : 18/12 minuit : Lien sur Wiki
*L12 : 19/12 lors du passage
*L13 : 18/12 minuit : Lien Git sur Wiki
*L14 : 18/12 minuit : Lien Git sur Wiki
*L15 : 08/11 lors du passage
*L16 : 19/12 lors du passage
*L17 : 19/12 lors du passage : Tableaux complétés et imprimés
*L18 : 10/10 lors du passage

===Contenu===
'''''L1. Composition des groupes et sujet'''''.
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation JEE : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement JEE. Un composant peut être implanté par un programme Java externe (client léger / client lourd JEE), par un servlet, par un bean ou par un objet POJO. Dans ces derniers cas, il faut préciser les caractéristiques des beans / POJO (local / distribué, session / évenementiel, stateful / stateless, etc). Un lien peut être implanté par une relation JEE, ou bien par conservation de référence de bean.

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (waffle ou autre)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Diapos de votre présentation de conception'''''.

'''''L16. Diapos de votre présentation finale'''''.

'''''L17. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à créer un wiki qui regroupera l'ensemble de vos documentations. Cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer une organisation github ou bitbucket. Ajouter les membres du projet eCOM à l'organisation. Créer plusieurs projets pour les différents parties. Activer les watchs. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des EJB (session et entity beans, annotations JAX-RS, [[Swagger]]). L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl, [[Swagger]] UI, jmeter, .... Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et consommateur) et exécuter certaines requêtes avec des garanties transactionnelles. Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]] pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, Oracle, HSQL ...) (non répliquée)
# Mise en place de 2 containers base de données (MySQL, Oracle, HSQL ...) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion asynchrone et transactionnelle de l'envoi des courriels via [[JMS]] et des EJBTimer (voir http://ecom.ow2.org/xwiki/bin/view/Main/fremail)
** Gestion asynchrone et transactionnelle de l'envoi de SMS via [[JMS]] et des EJBTimer ([[ECOM/SMSProviders|fournisseurs SMS]])

* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec [[Apache Jackrabbit]]
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Suivi du ''click stream'' avec des Filters en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Intégration de [[Memcached]]
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST.
** Utilisation de services tiers via leurs APIs (voir le catalogue de [[Mashape]])
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Gestion d'un ''cloud'' privé avec [[OpenStack]] avec [[Fuel]]
** Gestion d'un [[CaaS]] Docker privé avec [[Kubernete]] ou [[Docker Swarm]]
** Conditionnement de l'application mobile avec [[Apache Cordova]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers ([[AxiMAG]] par exemple).

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google)
* Performances (résultat du injection de charge avec [[Apache JMeter]], [[Gatling]], OW2 CLIF, BlazeMeter.com) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Supervision des VMs du système déployé avec un de ces systèmes : [[Telegraf]] + [[InfluxDB]] + [[Grafana]].
* Script "basique" pour le Rolling update (Blue-Green Deployment) des composants (applications et intergiciels).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom (utiliser [https://hub.docker.com/_/glassfish/ Glassfish]).
* Préparation d'images [[Docker]]
* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[CoreOS]] ou [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits
===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [https://glassfish.java.net/docs/4.0/administration-guide.pdf Guide d'administration de Glassfish 4]
* [http://docs.oracle.com/javaee/7/tutorial/doc/ Tutorial JavaEE 7 ] ([https://svn.java.net/svn/javaeetutorial~svn/ sources des exemples])
* [http://docs.oracle.com/javaee/7/api/ API JavaEE 7]
* [https://java.net/projects/javaee-spec/pages/Home Java EE Platform Specification]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* [[Bootstrap]]

===Quelques livres et technologies===

REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* [http://www.apress.com/9781430246268 Antonio Goncalves, Beginning JavaEE 7, APress, 2013], ([https://github.com/agoncal/agoncal-book-javaee7 examples] pour [[Glassfish]] 4)
* [https://www.packtpub.com/application-development/java-ee-7-developer-handbook Peter A. Pilgrim, Java EE 7 Developer Handbook, Packt, 2013, ISBN 139781849687942 ]
* [http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book Mick Knutson, Java EE6 Cookbook for securing, tuning, and extending enterprise applications, Packt Publishing, June 2012]
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* [http://www.manning.com/panda2/ Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, March 2014, ISBN: 9781935182993], ([http://www.manning.com/panda2/EJB3iA_2E_SourceCode.zip source code of examples])
* [http://shop.oreilly.com/product/9780596158033.do Andrew Lee Rubinger, Bill Burke, Enterprise JavaBeans 3.1, 6th Edition, O'Reilly Media, Final Release Date: September 2010, Pages]
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[AngularJS]]====
* Brad Green, Shyam Seshadri, AngularJS, Pub OReilly http://shop.oreilly.com/product/0636920028055.do ([https://github.com/shyamseshadri/angularjs-book source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-09-03T13:09:46Z

Sybille.Caffiau: /* Soutenance 2 */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système

==Groupes et sujets==
===Groupes eCOM-RICM 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et TR).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2017.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P)
* 25/09 15h45-18h30 : Séance en autonomie (P)

* 02/10 8h00-12h15 : Séance en autonomie (P)
* 02/10 15h45-18h30 : Test utilisateur (SC) (P)

* 09/10 8h00-12h15 : Audit 1 (P) et Séance en autonomie (P)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (P)

* 16/10 8h00-12h15 : Séance en autonomie (P)
* 16/10 15h45-18h30 : Séance encadrée (SC) (P)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P)
* 23/10 15h45-18h30 : Séance en autonomie (P)

* 06/11 8h00-12h15 : Audit 2 (P) et Séance en autonomie (P)
* 06/11 15h45-18h30 : Séance en autonomie (P)

* 20/11 8h00-12h15 : Séance en autonomie (P) + Séance encadrée (SC) (P)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 27/11 8h00-12h15 : Séance en autonomie (P)
* 27/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 04/12 15h45-18h30 : Séance en autonomie (P)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 11/12 15h45-18h30 : Séance en autonomie (P)

* 18/12 8h00-12h15 : Soutenances (P) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (P) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie JEE.
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]], le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- groupe 6

- groupe 3

- groupe 1

- groupe 2

- groupe 4

- groupe 5

''''' Contenu :'''''

Pour la partie GL
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Audit 2 ===
*Salle : F109
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL : point sur
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Architecture complète
* Choix technologiques

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 :

- groupe 1 :

- groupe 5 : 9h

- groupe 2 : 9h45

- groupe 4 : 10h15

- groupe 3 : 10h45

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : F114
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* 8h : groupe 1
* 8h35 : groupe 3
* 9h10 : groupe 5
* 15h45 : groupe 4
* 16h20 : groupe 6
* 16h55 : groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et TR pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Deux rapports doivent être rédigés pour la partie Système : un document de conception système et un document d'évaluation système. Ces documents doivent être accessibles depuis le wiki (ils peuvent même être directement édités sur le wiki).

Vous pouvez ajouter les livrables que vous jugez utiles pour présenter le travail que vous avez réalisé. Pour ces livrables : numérotez les

===Rendus===
Chaque livrable est numéroté (détails du livrable ci-dessous) LX, sous une forme à respecter. Certains ont une date de rendu à respecter. Ci-dessous le résumé de ces contraintes :
*L2 : 09/10 minuit : Wiki
*L3 : 09/10 minuit : Wiki
*L4 : 06/11 minuit : Wiki
*L5 : ?
*L6 : 06/11 minuit : Wiki
*L7 : 09/10 minuit : Wiki
*L8 : en continu : Wiki
*L9 : en continu : Wiki
*L10 : 18/12 minuit : Lien Git sur Wiki
*L11 : 18/12 minuit : Lien sur Wiki
*L12 : 19/12 lors du passage
*L13 : 18/12 minuit : Lien Git sur Wiki
*L14 : 18/12 minuit : Lien Git sur Wiki
*L15 : 08/11 lors du passage
*L16 : 19/12 lors du passage
*L17 : 19/12 lors du passage : Tableaux complétés et imprimés
*L18 : 10/10 lors du passage

===Contenu===
'''''L1. Composition des groupes et sujet'''''.
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation JEE : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement JEE. Un composant peut être implanté par un programme Java externe (client léger / client lourd JEE), par un servlet, par un bean ou par un objet POJO. Dans ces derniers cas, il faut préciser les caractéristiques des beans / POJO (local / distribué, session / évenementiel, stateful / stateless, etc). Un lien peut être implanté par une relation JEE, ou bien par conservation de référence de bean.

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (waffle ou autre)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Diapos de votre présentation de conception'''''.

'''''L16. Diapos de votre présentation finale'''''.

'''''L17. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à créer un wiki qui regroupera l'ensemble de vos documentations. Cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer une organisation github ou bitbucket. Ajouter les membres du projet eCOM à l'organisation. Créer plusieurs projets pour les différents parties. Activer les watchs. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des EJB (session et entity beans, annotations JAX-RS, [[Swagger]]). L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl, [[Swagger]] UI, jmeter, .... Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et consommateur) et exécuter certaines requêtes avec des garanties transactionnelles. Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]] pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, Oracle, HSQL ...) (non répliquée)
# Mise en place de 2 containers base de données (MySQL, Oracle, HSQL ...) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion asynchrone et transactionnelle de l'envoi des courriels via [[JMS]] et des EJBTimer (voir http://ecom.ow2.org/xwiki/bin/view/Main/fremail)
** Gestion asynchrone et transactionnelle de l'envoi de SMS via [[JMS]] et des EJBTimer ([[ECOM/SMSProviders|fournisseurs SMS]])

* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec [[Apache Jackrabbit]]
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Suivi du ''click stream'' avec des Filters en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Intégration de [[Memcached]]
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST.
** Utilisation de services tiers via leurs APIs (voir le catalogue de [[Mashape]])
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Gestion d'un ''cloud'' privé avec [[OpenStack]] avec [[Fuel]]
** Gestion d'un [[CaaS]] Docker privé avec [[Kubernete]] ou [[Docker Swarm]]
** Conditionnement de l'application mobile avec [[Apache Cordova]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers ([[AxiMAG]] par exemple).

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google)
* Performances (résultat du injection de charge avec [[Apache JMeter]], [[Gatling]], OW2 CLIF, BlazeMeter.com) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Supervision des VMs du système déployé avec un de ces systèmes : [[Telegraf]] + [[InfluxDB]] + [[Grafana]].
* Script "basique" pour le Rolling update (Blue-Green Deployment) des composants (applications et intergiciels).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom (utiliser [https://hub.docker.com/_/glassfish/ Glassfish]).
* Préparation d'images [[Docker]]
* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[CoreOS]] ou [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits
===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [https://glassfish.java.net/docs/4.0/administration-guide.pdf Guide d'administration de Glassfish 4]
* [http://docs.oracle.com/javaee/7/tutorial/doc/ Tutorial JavaEE 7 ] ([https://svn.java.net/svn/javaeetutorial~svn/ sources des exemples])
* [http://docs.oracle.com/javaee/7/api/ API JavaEE 7]
* [https://java.net/projects/javaee-spec/pages/Home Java EE Platform Specification]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* [[Bootstrap]]

===Quelques livres et technologies===

REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* [http://www.apress.com/9781430246268 Antonio Goncalves, Beginning JavaEE 7, APress, 2013], ([https://github.com/agoncal/agoncal-book-javaee7 examples] pour [[Glassfish]] 4)
* [https://www.packtpub.com/application-development/java-ee-7-developer-handbook Peter A. Pilgrim, Java EE 7 Developer Handbook, Packt, 2013, ISBN 139781849687942 ]
* [http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book Mick Knutson, Java EE6 Cookbook for securing, tuning, and extending enterprise applications, Packt Publishing, June 2012]
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* [http://www.manning.com/panda2/ Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, March 2014, ISBN: 9781935182993], ([http://www.manning.com/panda2/EJB3iA_2E_SourceCode.zip source code of examples])
* [http://shop.oreilly.com/product/9780596158033.do Andrew Lee Rubinger, Bill Burke, Enterprise JavaBeans 3.1, 6th Edition, O'Reilly Media, Final Release Date: September 2010, Pages]
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[AngularJS]]====
* Brad Green, Shyam Seshadri, AngularJS, Pub OReilly http://shop.oreilly.com/product/0636920028055.do ([https://github.com/shyamseshadri/angularjs-book source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-09-03T13:08:46Z

Sybille.Caffiau: /* Soutenance 1 */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système

==Groupes et sujets==
===Groupes eCOM-RICM 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et TR).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2017.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P)
* 25/09 15h45-18h30 : Séance en autonomie (P)

* 02/10 8h00-12h15 : Séance en autonomie (P)
* 02/10 15h45-18h30 : Test utilisateur (SC) (P)

* 09/10 8h00-12h15 : Audit 1 (P) et Séance en autonomie (P)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (P)

* 16/10 8h00-12h15 : Séance en autonomie (P)
* 16/10 15h45-18h30 : Séance encadrée (SC) (P)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P)
* 23/10 15h45-18h30 : Séance en autonomie (P)

* 06/11 8h00-12h15 : Audit 2 (P) et Séance en autonomie (P)
* 06/11 15h45-18h30 : Séance en autonomie (P)

* 20/11 8h00-12h15 : Séance en autonomie (P) + Séance encadrée (SC) (P)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 27/11 8h00-12h15 : Séance en autonomie (P)
* 27/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 04/12 15h45-18h30 : Séance en autonomie (P)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 11/12 15h45-18h30 : Séance en autonomie (P)

* 18/12 8h00-12h15 : Soutenances (P) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (P) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie JEE.
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]], le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Audit 1 ===
*Salle : P
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- groupe 6

- groupe 3

- groupe 1

- groupe 2

- groupe 4

- groupe 5

''''' Contenu :'''''

Pour la partie GL
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Soutenance 2 ===
*Salle : F109
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL : point sur
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Choix technologiques

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 : 8h

- groupe 1 : 8h30

- groupe 5 : 9h

- groupe 2 : 9h45

- groupe 4 : 10h15

- groupe 3 : 10h45

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : F114
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* 8h : groupe 1
* 8h35 : groupe 3
* 9h10 : groupe 5
* 15h45 : groupe 4
* 16h20 : groupe 6
* 16h55 : groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et TR pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Deux rapports doivent être rédigés pour la partie Système : un document de conception système et un document d'évaluation système. Ces documents doivent être accessibles depuis le wiki (ils peuvent même être directement édités sur le wiki).

Vous pouvez ajouter les livrables que vous jugez utiles pour présenter le travail que vous avez réalisé. Pour ces livrables : numérotez les

===Rendus===
Chaque livrable est numéroté (détails du livrable ci-dessous) LX, sous une forme à respecter. Certains ont une date de rendu à respecter. Ci-dessous le résumé de ces contraintes :
*L2 : 09/10 minuit : Wiki
*L3 : 09/10 minuit : Wiki
*L4 : 06/11 minuit : Wiki
*L5 : ?
*L6 : 06/11 minuit : Wiki
*L7 : 09/10 minuit : Wiki
*L8 : en continu : Wiki
*L9 : en continu : Wiki
*L10 : 18/12 minuit : Lien Git sur Wiki
*L11 : 18/12 minuit : Lien sur Wiki
*L12 : 19/12 lors du passage
*L13 : 18/12 minuit : Lien Git sur Wiki
*L14 : 18/12 minuit : Lien Git sur Wiki
*L15 : 08/11 lors du passage
*L16 : 19/12 lors du passage
*L17 : 19/12 lors du passage : Tableaux complétés et imprimés
*L18 : 10/10 lors du passage

===Contenu===
'''''L1. Composition des groupes et sujet'''''.
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation JEE : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement JEE. Un composant peut être implanté par un programme Java externe (client léger / client lourd JEE), par un servlet, par un bean ou par un objet POJO. Dans ces derniers cas, il faut préciser les caractéristiques des beans / POJO (local / distribué, session / évenementiel, stateful / stateless, etc). Un lien peut être implanté par une relation JEE, ou bien par conservation de référence de bean.

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (waffle ou autre)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Diapos de votre présentation de conception'''''.

'''''L16. Diapos de votre présentation finale'''''.

'''''L17. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à créer un wiki qui regroupera l'ensemble de vos documentations. Cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer une organisation github ou bitbucket. Ajouter les membres du projet eCOM à l'organisation. Créer plusieurs projets pour les différents parties. Activer les watchs. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des EJB (session et entity beans, annotations JAX-RS, [[Swagger]]). L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl, [[Swagger]] UI, jmeter, .... Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et consommateur) et exécuter certaines requêtes avec des garanties transactionnelles. Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]] pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, Oracle, HSQL ...) (non répliquée)
# Mise en place de 2 containers base de données (MySQL, Oracle, HSQL ...) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion asynchrone et transactionnelle de l'envoi des courriels via [[JMS]] et des EJBTimer (voir http://ecom.ow2.org/xwiki/bin/view/Main/fremail)
** Gestion asynchrone et transactionnelle de l'envoi de SMS via [[JMS]] et des EJBTimer ([[ECOM/SMSProviders|fournisseurs SMS]])

* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec [[Apache Jackrabbit]]
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Suivi du ''click stream'' avec des Filters en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Intégration de [[Memcached]]
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST.
** Utilisation de services tiers via leurs APIs (voir le catalogue de [[Mashape]])
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Gestion d'un ''cloud'' privé avec [[OpenStack]] avec [[Fuel]]
** Gestion d'un [[CaaS]] Docker privé avec [[Kubernete]] ou [[Docker Swarm]]
** Conditionnement de l'application mobile avec [[Apache Cordova]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers ([[AxiMAG]] par exemple).

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google)
* Performances (résultat du injection de charge avec [[Apache JMeter]], [[Gatling]], OW2 CLIF, BlazeMeter.com) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Supervision des VMs du système déployé avec un de ces systèmes : [[Telegraf]] + [[InfluxDB]] + [[Grafana]].
* Script "basique" pour le Rolling update (Blue-Green Deployment) des composants (applications et intergiciels).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom (utiliser [https://hub.docker.com/_/glassfish/ Glassfish]).
* Préparation d'images [[Docker]]
* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[CoreOS]] ou [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits
===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [https://glassfish.java.net/docs/4.0/administration-guide.pdf Guide d'administration de Glassfish 4]
* [http://docs.oracle.com/javaee/7/tutorial/doc/ Tutorial JavaEE 7 ] ([https://svn.java.net/svn/javaeetutorial~svn/ sources des exemples])
* [http://docs.oracle.com/javaee/7/api/ API JavaEE 7]
* [https://java.net/projects/javaee-spec/pages/Home Java EE Platform Specification]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* [[Bootstrap]]

===Quelques livres et technologies===

REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* [http://www.apress.com/9781430246268 Antonio Goncalves, Beginning JavaEE 7, APress, 2013], ([https://github.com/agoncal/agoncal-book-javaee7 examples] pour [[Glassfish]] 4)
* [https://www.packtpub.com/application-development/java-ee-7-developer-handbook Peter A. Pilgrim, Java EE 7 Developer Handbook, Packt, 2013, ISBN 139781849687942 ]
* [http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book Mick Knutson, Java EE6 Cookbook for securing, tuning, and extending enterprise applications, Packt Publishing, June 2012]
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* [http://www.manning.com/panda2/ Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, March 2014, ISBN: 9781935182993], ([http://www.manning.com/panda2/EJB3iA_2E_SourceCode.zip source code of examples])
* [http://shop.oreilly.com/product/9780596158033.do Andrew Lee Rubinger, Bill Burke, Enterprise JavaBeans 3.1, 6th Edition, O'Reilly Media, Final Release Date: September 2010, Pages]
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[AngularJS]]====
* Brad Green, Shyam Seshadri, AngularJS, Pub OReilly http://shop.oreilly.com/product/0636920028055.do ([https://github.com/shyamseshadri/angularjs-book source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-09-03T13:08:10Z

Sybille.Caffiau: /* Soutenances */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système

==Groupes et sujets==
===Groupes eCOM-RICM 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et TR).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2017.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P)
* 25/09 15h45-18h30 : Séance en autonomie (P)

* 02/10 8h00-12h15 : Séance en autonomie (P)
* 02/10 15h45-18h30 : Test utilisateur (SC) (P)

* 09/10 8h00-12h15 : Audit 1 (P) et Séance en autonomie (P)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (P)

* 16/10 8h00-12h15 : Séance en autonomie (P)
* 16/10 15h45-18h30 : Séance encadrée (SC) (P)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P)
* 23/10 15h45-18h30 : Séance en autonomie (P)

* 06/11 8h00-12h15 : Audit 2 (P) et Séance en autonomie (P)
* 06/11 15h45-18h30 : Séance en autonomie (P)

* 20/11 8h00-12h15 : Séance en autonomie (P) + Séance encadrée (SC) (P)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 27/11 8h00-12h15 : Séance en autonomie (P)
* 27/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 04/12 15h45-18h30 : Séance en autonomie (P)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 11/12 15h45-18h30 : Séance en autonomie (P)

* 18/12 8h00-12h15 : Soutenances (P) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (P) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie JEE.
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]], le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 09 octobre 2017
* audit 2 (conception) : le 06 novembre 2017
* soutenance de fin de projet le 18 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.
Attention : les concepts que vous avez vus en cours d'architecture doivent être mis en application pour l'architecture de votre projet. Une attention particulière sur ce point doit être portée lors de vos présentations à l'audit 2 et à la soutenance. Le travail que vous présenterez fournira de support à l'évaluation du module de GL.

===Soutenance 1 ===
*Salle : F316
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- groupe 6

- groupe 3

- groupe 1

- groupe 2

- groupe 4

- groupe 5

''''' Contenu :'''''

Pour la partie GL
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Soutenance 2 ===
*Salle : F109
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL : point sur
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Choix technologiques

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 : 8h

- groupe 1 : 8h30

- groupe 5 : 9h

- groupe 2 : 9h45

- groupe 4 : 10h15

- groupe 3 : 10h45

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : F114
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* 8h : groupe 1
* 8h35 : groupe 3
* 9h10 : groupe 5
* 15h45 : groupe 4
* 16h20 : groupe 6
* 16h55 : groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et TR pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Deux rapports doivent être rédigés pour la partie Système : un document de conception système et un document d'évaluation système. Ces documents doivent être accessibles depuis le wiki (ils peuvent même être directement édités sur le wiki).

Vous pouvez ajouter les livrables que vous jugez utiles pour présenter le travail que vous avez réalisé. Pour ces livrables : numérotez les

===Rendus===
Chaque livrable est numéroté (détails du livrable ci-dessous) LX, sous une forme à respecter. Certains ont une date de rendu à respecter. Ci-dessous le résumé de ces contraintes :
*L2 : 09/10 minuit : Wiki
*L3 : 09/10 minuit : Wiki
*L4 : 06/11 minuit : Wiki
*L5 : ?
*L6 : 06/11 minuit : Wiki
*L7 : 09/10 minuit : Wiki
*L8 : en continu : Wiki
*L9 : en continu : Wiki
*L10 : 18/12 minuit : Lien Git sur Wiki
*L11 : 18/12 minuit : Lien sur Wiki
*L12 : 19/12 lors du passage
*L13 : 18/12 minuit : Lien Git sur Wiki
*L14 : 18/12 minuit : Lien Git sur Wiki
*L15 : 08/11 lors du passage
*L16 : 19/12 lors du passage
*L17 : 19/12 lors du passage : Tableaux complétés et imprimés
*L18 : 10/10 lors du passage

===Contenu===
'''''L1. Composition des groupes et sujet'''''.
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation JEE : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement JEE. Un composant peut être implanté par un programme Java externe (client léger / client lourd JEE), par un servlet, par un bean ou par un objet POJO. Dans ces derniers cas, il faut préciser les caractéristiques des beans / POJO (local / distribué, session / évenementiel, stateful / stateless, etc). Un lien peut être implanté par une relation JEE, ou bien par conservation de référence de bean.

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (waffle ou autre)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Diapos de votre présentation de conception'''''.

'''''L16. Diapos de votre présentation finale'''''.

'''''L17. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à créer un wiki qui regroupera l'ensemble de vos documentations. Cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer une organisation github ou bitbucket. Ajouter les membres du projet eCOM à l'organisation. Créer plusieurs projets pour les différents parties. Activer les watchs. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des EJB (session et entity beans, annotations JAX-RS, [[Swagger]]). L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl, [[Swagger]] UI, jmeter, .... Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et consommateur) et exécuter certaines requêtes avec des garanties transactionnelles. Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]] pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, Oracle, HSQL ...) (non répliquée)
# Mise en place de 2 containers base de données (MySQL, Oracle, HSQL ...) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion asynchrone et transactionnelle de l'envoi des courriels via [[JMS]] et des EJBTimer (voir http://ecom.ow2.org/xwiki/bin/view/Main/fremail)
** Gestion asynchrone et transactionnelle de l'envoi de SMS via [[JMS]] et des EJBTimer ([[ECOM/SMSProviders|fournisseurs SMS]])

* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec [[Apache Jackrabbit]]
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Suivi du ''click stream'' avec des Filters en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Intégration de [[Memcached]]
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST.
** Utilisation de services tiers via leurs APIs (voir le catalogue de [[Mashape]])
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Gestion d'un ''cloud'' privé avec [[OpenStack]] avec [[Fuel]]
** Gestion d'un [[CaaS]] Docker privé avec [[Kubernete]] ou [[Docker Swarm]]
** Conditionnement de l'application mobile avec [[Apache Cordova]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers ([[AxiMAG]] par exemple).

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google)
* Performances (résultat du injection de charge avec [[Apache JMeter]], [[Gatling]], OW2 CLIF, BlazeMeter.com) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Supervision des VMs du système déployé avec un de ces systèmes : [[Telegraf]] + [[InfluxDB]] + [[Grafana]].
* Script "basique" pour le Rolling update (Blue-Green Deployment) des composants (applications et intergiciels).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom (utiliser [https://hub.docker.com/_/glassfish/ Glassfish]).
* Préparation d'images [[Docker]]
* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[CoreOS]] ou [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits
===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [https://glassfish.java.net/docs/4.0/administration-guide.pdf Guide d'administration de Glassfish 4]
* [http://docs.oracle.com/javaee/7/tutorial/doc/ Tutorial JavaEE 7 ] ([https://svn.java.net/svn/javaeetutorial~svn/ sources des exemples])
* [http://docs.oracle.com/javaee/7/api/ API JavaEE 7]
* [https://java.net/projects/javaee-spec/pages/Home Java EE Platform Specification]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* [[Bootstrap]]

===Quelques livres et technologies===

REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* [http://www.apress.com/9781430246268 Antonio Goncalves, Beginning JavaEE 7, APress, 2013], ([https://github.com/agoncal/agoncal-book-javaee7 examples] pour [[Glassfish]] 4)
* [https://www.packtpub.com/application-development/java-ee-7-developer-handbook Peter A. Pilgrim, Java EE 7 Developer Handbook, Packt, 2013, ISBN 139781849687942 ]
* [http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book Mick Knutson, Java EE6 Cookbook for securing, tuning, and extending enterprise applications, Packt Publishing, June 2012]
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* [http://www.manning.com/panda2/ Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, March 2014, ISBN: 9781935182993], ([http://www.manning.com/panda2/EJB3iA_2E_SourceCode.zip source code of examples])
* [http://shop.oreilly.com/product/9780596158033.do Andrew Lee Rubinger, Bill Burke, Enterprise JavaBeans 3.1, 6th Edition, O'Reilly Media, Final Release Date: September 2010, Pages]
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[AngularJS]]====
* Brad Green, Shyam Seshadri, AngularJS, Pub OReilly http://shop.oreilly.com/product/0636920028055.do ([https://github.com/shyamseshadri/angularjs-book source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-09-03T13:00:45Z

Sybille.Caffiau: /* Planning des séances */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système

==Groupes et sujets==
===Groupes eCOM-RICM 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et TR).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2017.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (P)
* 18/09 15h45-18h30 : (DD) Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P)
* 25/09 15h45-18h30 : Séance en autonomie (P)

* 02/10 8h00-12h15 : Séance en autonomie (P)
* 02/10 15h45-18h30 : Test utilisateur (SC) (P)

* 09/10 8h00-12h15 : Audit 1 (P) et Séance en autonomie (P)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (P)

* 16/10 8h00-12h15 : Séance en autonomie (P)
* 16/10 15h45-18h30 : Séance encadrée (SC) (P)

* 23/10 8h00-12h15 : Séance encadrée (VZ) (P)
* 23/10 15h45-18h30 : Séance en autonomie (P)

* 06/11 8h00-12h15 : Audit 2 (P) et Séance en autonomie (P)
* 06/11 15h45-18h30 : Séance en autonomie (P)

* 20/11 8h00-12h15 : Séance en autonomie (P) + Séance encadrée (SC) (P)
* 20/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 27/11 8h00-12h15 : Séance en autonomie (P)
* 27/11 15h45-18h30 : Séance encadrée (VZ) (P)

* 04/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 04/12 15h45-18h30 : Séance en autonomie (P)

* 11/12 8h00-12h15 : Séance encadrée (VZ) (P)
* 11/12 15h45-18h30 : Séance en autonomie (P)

* 18/12 8h00-12h15 : Soutenances (P) et rendus finaux
* 18/12 15h45-18h30 : Soutenances (P) et rendus finaux

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie JEE.
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]], le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 10 octobre 2017
* audit 2 (conception) : le 07 novembre 2017
* soutenance de fin de projet le 19 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.

===Soutenance 1 ===
*Salle : F316
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- groupe 6

- groupe 3

- groupe 1

- groupe 2

- groupe 4

- groupe 5

''''' Contenu :'''''

Pour la partie GL
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Soutenance 2 ===
*Salle : F109
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL : point sur
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Choix technologiques

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 : 8h

- groupe 1 : 8h30

- groupe 5 : 9h

- groupe 2 : 9h45

- groupe 4 : 10h15

- groupe 3 : 10h45

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : F114
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* 8h : groupe 1
* 8h35 : groupe 3
* 9h10 : groupe 5
* 15h45 : groupe 4
* 16h20 : groupe 6
* 16h55 : groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et TR pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Deux rapports doivent être rédigés pour la partie Système : un document de conception système et un document d'évaluation système. Ces documents doivent être accessibles depuis le wiki (ils peuvent même être directement édités sur le wiki).

Vous pouvez ajouter les livrables que vous jugez utiles pour présenter le travail que vous avez réalisé. Pour ces livrables : numérotez les

===Rendus===
Chaque livrable est numéroté (détails du livrable ci-dessous) LX, sous une forme à respecter. Certains ont une date de rendu à respecter. Ci-dessous le résumé de ces contraintes :
*L2 : 09/10 minuit : Wiki
*L3 : 09/10 minuit : Wiki
*L4 : 06/11 minuit : Wiki
*L5 : ?
*L6 : 06/11 minuit : Wiki
*L7 : 09/10 minuit : Wiki
*L8 : en continu : Wiki
*L9 : en continu : Wiki
*L10 : 18/12 minuit : Lien Git sur Wiki
*L11 : 18/12 minuit : Lien sur Wiki
*L12 : 19/12 lors du passage
*L13 : 18/12 minuit : Lien Git sur Wiki
*L14 : 18/12 minuit : Lien Git sur Wiki
*L15 : 08/11 lors du passage
*L16 : 19/12 lors du passage
*L17 : 19/12 lors du passage : Tableaux complétés et imprimés
*L18 : 10/10 lors du passage

===Contenu===
'''''L1. Composition des groupes et sujet'''''.
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation JEE : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement JEE. Un composant peut être implanté par un programme Java externe (client léger / client lourd JEE), par un servlet, par un bean ou par un objet POJO. Dans ces derniers cas, il faut préciser les caractéristiques des beans / POJO (local / distribué, session / évenementiel, stateful / stateless, etc). Un lien peut être implanté par une relation JEE, ou bien par conservation de référence de bean.

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (waffle ou autre)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Diapos de votre présentation de conception'''''.

'''''L16. Diapos de votre présentation finale'''''.

'''''L17. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à créer un wiki qui regroupera l'ensemble de vos documentations. Cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer une organisation github ou bitbucket. Ajouter les membres du projet eCOM à l'organisation. Créer plusieurs projets pour les différents parties. Activer les watchs. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des EJB (session et entity beans, annotations JAX-RS, [[Swagger]]). L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl, [[Swagger]] UI, jmeter, .... Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et consommateur) et exécuter certaines requêtes avec des garanties transactionnelles. Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]] pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, Oracle, HSQL ...) (non répliquée)
# Mise en place de 2 containers base de données (MySQL, Oracle, HSQL ...) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion asynchrone et transactionnelle de l'envoi des courriels via [[JMS]] et des EJBTimer (voir http://ecom.ow2.org/xwiki/bin/view/Main/fremail)
** Gestion asynchrone et transactionnelle de l'envoi de SMS via [[JMS]] et des EJBTimer ([[ECOM/SMSProviders|fournisseurs SMS]])

* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec [[Apache Jackrabbit]]
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Suivi du ''click stream'' avec des Filters en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Intégration de [[Memcached]]
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST.
** Utilisation de services tiers via leurs APIs (voir le catalogue de [[Mashape]])
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Gestion d'un ''cloud'' privé avec [[OpenStack]] avec [[Fuel]]
** Gestion d'un [[CaaS]] Docker privé avec [[Kubernete]] ou [[Docker Swarm]]
** Conditionnement de l'application mobile avec [[Apache Cordova]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers ([[AxiMAG]] par exemple).

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google)
* Performances (résultat du injection de charge avec [[Apache JMeter]], [[Gatling]], OW2 CLIF, BlazeMeter.com) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Supervision des VMs du système déployé avec un de ces systèmes : [[Telegraf]] + [[InfluxDB]] + [[Grafana]].
* Script "basique" pour le Rolling update (Blue-Green Deployment) des composants (applications et intergiciels).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom (utiliser [https://hub.docker.com/_/glassfish/ Glassfish]).
* Préparation d'images [[Docker]]
* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[CoreOS]] ou [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits
===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [https://glassfish.java.net/docs/4.0/administration-guide.pdf Guide d'administration de Glassfish 4]
* [http://docs.oracle.com/javaee/7/tutorial/doc/ Tutorial JavaEE 7 ] ([https://svn.java.net/svn/javaeetutorial~svn/ sources des exemples])
* [http://docs.oracle.com/javaee/7/api/ API JavaEE 7]
* [https://java.net/projects/javaee-spec/pages/Home Java EE Platform Specification]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* [[Bootstrap]]

===Quelques livres et technologies===

REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* [http://www.apress.com/9781430246268 Antonio Goncalves, Beginning JavaEE 7, APress, 2013], ([https://github.com/agoncal/agoncal-book-javaee7 examples] pour [[Glassfish]] 4)
* [https://www.packtpub.com/application-development/java-ee-7-developer-handbook Peter A. Pilgrim, Java EE 7 Developer Handbook, Packt, 2013, ISBN 139781849687942 ]
* [http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book Mick Knutson, Java EE6 Cookbook for securing, tuning, and extending enterprise applications, Packt Publishing, June 2012]
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* [http://www.manning.com/panda2/ Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, March 2014, ISBN: 9781935182993], ([http://www.manning.com/panda2/EJB3iA_2E_SourceCode.zip source code of examples])
* [http://shop.oreilly.com/product/9780596158033.do Andrew Lee Rubinger, Bill Burke, Enterprise JavaBeans 3.1, 6th Edition, O'Reilly Media, Final Release Date: September 2010, Pages]
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[AngularJS]]====
* Brad Green, Shyam Seshadri, AngularJS, Pub OReilly http://shop.oreilly.com/product/0636920028055.do ([https://github.com/shyamseshadri/angularjs-book source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-09-03T12:33:45Z

Sybille.Caffiau: /* Planning des séances */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système

==Groupes et sujets==
===Groupes eCOM-RICM 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et TR).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 18/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2017.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (F018)
* 18/09 15h45-18h30 : Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production).

* 25/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P257)
* 25/09 15h45-18h30 : Travail en autonomie (F202, F204)

* 02/10 8h00-12h15 : Travail en autonomie (F201,202)
* 02/10 15h45-18h30 : Travail en autonomie (F202, F204)

* 09/10 8h00-12h15 : Audit 1 (F316) et travail en autonomie (F203)
* 09/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (F203)

* 16/10 8h00-12h15 : Travail en autonomie (F203, F217)
* 16/10 15h45-18h30 : Travail en autonomie (F202, F204)

* 23/10 8h00-12h15 : Travail en autonomie (F203, F217)
* 23/10 15h45-18h30 : Travail en autonomie (F202, F204)

* 06/11 8h00-12h15 : Soutenance 2 (F109) et travail en autonomie (F203)
* 06/11 15h45-18h30 : Test utilisateur (SC) (F116)

* 20/11 8h00-12h15 : Travail encadré (VZ) (F216, F217)
* 20/11 15h45-18h30 : Travail en autonomie (F202, F204)

* 27/11 8h00-12h15 : Travail encadré (VZ) (F216, F217)
* 27/11 15h45-18h30 : Travail en autonomie (F202, F204)

* 04/12 8h00-12h15 : Travail en autonomie (F202, F204)
* 04/12 15h45-18h30 : Travail encadré (VZ) (F216, F217)

* 11/12 8h00-12h15 : Travail encadré (VZ) (F216, F217)

* 18/12 8h00-12h15 : Soutenances finales (F201, F217)
* 18/12 15h45-18h30 : Soutenances finales (F201, F212)

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie JEE.
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]], le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 10 octobre 2017
* audit 2 (conception) : le 07 novembre 2017
* soutenance de fin de projet le 19 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.

===Soutenance 1 ===
*Salle : F316
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- groupe 6

- groupe 3

- groupe 1

- groupe 2

- groupe 4

- groupe 5

''''' Contenu :'''''

Pour la partie GL
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Soutenance 2 ===
*Salle : F109
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL : point sur
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Choix technologiques

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 : 8h

- groupe 1 : 8h30

- groupe 5 : 9h

- groupe 2 : 9h45

- groupe 4 : 10h15

- groupe 3 : 10h45

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : F114
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* 8h : groupe 1
* 8h35 : groupe 3
* 9h10 : groupe 5
* 15h45 : groupe 4
* 16h20 : groupe 6
* 16h55 : groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et TR pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Deux rapports doivent être rédigés pour la partie Système : un document de conception système et un document d'évaluation système. Ces documents doivent être accessibles depuis le wiki (ils peuvent même être directement édités sur le wiki).

Vous pouvez ajouter les livrables que vous jugez utiles pour présenter le travail que vous avez réalisé. Pour ces livrables : numérotez les

===Rendus===
Chaque livrable est numéroté (détails du livrable ci-dessous) LX, sous une forme à respecter. Certains ont une date de rendu à respecter. Ci-dessous le résumé de ces contraintes :
*L2 : 09/10 minuit : Wiki
*L3 : 09/10 minuit : Wiki
*L4 : 06/11 minuit : Wiki
*L5 : ?
*L6 : 06/11 minuit : Wiki
*L7 : 09/10 minuit : Wiki
*L8 : en continu : Wiki
*L9 : en continu : Wiki
*L10 : 18/12 minuit : Lien Git sur Wiki
*L11 : 18/12 minuit : Lien sur Wiki
*L12 : 19/12 lors du passage
*L13 : 18/12 minuit : Lien Git sur Wiki
*L14 : 18/12 minuit : Lien Git sur Wiki
*L15 : 08/11 lors du passage
*L16 : 19/12 lors du passage
*L17 : 19/12 lors du passage : Tableaux complétés et imprimés
*L18 : 10/10 lors du passage

===Contenu===
'''''L1. Composition des groupes et sujet'''''.
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation JEE : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement JEE. Un composant peut être implanté par un programme Java externe (client léger / client lourd JEE), par un servlet, par un bean ou par un objet POJO. Dans ces derniers cas, il faut préciser les caractéristiques des beans / POJO (local / distribué, session / évenementiel, stateful / stateless, etc). Un lien peut être implanté par une relation JEE, ou bien par conservation de référence de bean.

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (waffle ou autre)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Diapos de votre présentation de conception'''''.

'''''L16. Diapos de votre présentation finale'''''.

'''''L17. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à créer un wiki qui regroupera l'ensemble de vos documentations. Cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer une organisation github ou bitbucket. Ajouter les membres du projet eCOM à l'organisation. Créer plusieurs projets pour les différents parties. Activer les watchs. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des EJB (session et entity beans, annotations JAX-RS, [[Swagger]]). L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl, [[Swagger]] UI, jmeter, .... Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et consommateur) et exécuter certaines requêtes avec des garanties transactionnelles. Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]] pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, Oracle, HSQL ...) (non répliquée)
# Mise en place de 2 containers base de données (MySQL, Oracle, HSQL ...) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion asynchrone et transactionnelle de l'envoi des courriels via [[JMS]] et des EJBTimer (voir http://ecom.ow2.org/xwiki/bin/view/Main/fremail)
** Gestion asynchrone et transactionnelle de l'envoi de SMS via [[JMS]] et des EJBTimer ([[ECOM/SMSProviders|fournisseurs SMS]])

* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec [[Apache Jackrabbit]]
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Suivi du ''click stream'' avec des Filters en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Intégration de [[Memcached]]
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST.
** Utilisation de services tiers via leurs APIs (voir le catalogue de [[Mashape]])
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Gestion d'un ''cloud'' privé avec [[OpenStack]] avec [[Fuel]]
** Gestion d'un [[CaaS]] Docker privé avec [[Kubernete]] ou [[Docker Swarm]]
** Conditionnement de l'application mobile avec [[Apache Cordova]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers ([[AxiMAG]] par exemple).

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google)
* Performances (résultat du injection de charge avec [[Apache JMeter]], [[Gatling]], OW2 CLIF, BlazeMeter.com) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Supervision des VMs du système déployé avec un de ces systèmes : [[Telegraf]] + [[InfluxDB]] + [[Grafana]].
* Script "basique" pour le Rolling update (Blue-Green Deployment) des composants (applications et intergiciels).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom (utiliser [https://hub.docker.com/_/glassfish/ Glassfish]).
* Préparation d'images [[Docker]]
* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[CoreOS]] ou [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits
===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [https://glassfish.java.net/docs/4.0/administration-guide.pdf Guide d'administration de Glassfish 4]
* [http://docs.oracle.com/javaee/7/tutorial/doc/ Tutorial JavaEE 7 ] ([https://svn.java.net/svn/javaeetutorial~svn/ sources des exemples])
* [http://docs.oracle.com/javaee/7/api/ API JavaEE 7]
* [https://java.net/projects/javaee-spec/pages/Home Java EE Platform Specification]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* [[Bootstrap]]

===Quelques livres et technologies===

REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* [http://www.apress.com/9781430246268 Antonio Goncalves, Beginning JavaEE 7, APress, 2013], ([https://github.com/agoncal/agoncal-book-javaee7 examples] pour [[Glassfish]] 4)
* [https://www.packtpub.com/application-development/java-ee-7-developer-handbook Peter A. Pilgrim, Java EE 7 Developer Handbook, Packt, 2013, ISBN 139781849687942 ]
* [http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book Mick Knutson, Java EE6 Cookbook for securing, tuning, and extending enterprise applications, Packt Publishing, June 2012]
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* [http://www.manning.com/panda2/ Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, March 2014, ISBN: 9781935182993], ([http://www.manning.com/panda2/EJB3iA_2E_SourceCode.zip source code of examples])
* [http://shop.oreilly.com/product/9780596158033.do Andrew Lee Rubinger, Bill Burke, Enterprise JavaBeans 3.1, 6th Edition, O'Reilly Media, Final Release Date: September 2010, Pages]
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[AngularJS]]====
* Brad Green, Shyam Seshadri, AngularJS, Pub OReilly http://shop.oreilly.com/product/0636920028055.do ([https://github.com/shyamseshadri/angularjs-book source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2018-09-03T12:12:27Z

Sybille.Caffiau: /* Groupes eCOM-RICM 2018-2019 */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* VZ : Vincent Zurczak (vzurczak@linagora.com)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système

==Groupes et sujets==
===Groupes eCOM-RICM 2018-2019===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 18/09 à 8h.

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2017-2018]]
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et TR).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 19/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2017.pdf|transparents]]), CM [[Media:RestfulServices.pdf|REST]], [[MicroServices]], [[Spring]], [[JHipster]] (DD) (F018)
* 19/09 15h45-18h30 : Installation [[JHipster]] et [[Docker]]. Génération de l'application MVP de eCOM, lancement du profile dev, lancement du profil prod (avec Docker), analyse de qualité du code (généré) avec le container SonarQube et déploiement sur Heroku de 2 applications (stage, production).

* 26/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P257)
* 26/09 15h45-18h30 : Travail en autonomie (F202, F204)

* 03/10 8h00-12h15 : Travail en autonomie (F201,202)
* 03/10 15h45-18h30 : Travail en autonomie (F202, F204)

* 10/10 8h00-12h15 : Audit 1 (F316) et travail en autonomie (F203)
* 10/10 15h45-18h30 : Tests de robustesse (charges) (VZ) (F203)

* 17/10 8h00-12h15 : Travail en autonomie (F203, F217)
* 17/10 15h45-18h30 : Travail en autonomie (F202, F204)

* 24/10 8h00-12h15 : Travail en autonomie (F203, F217)
* 24/10 15h45-18h30 : Travail en autonomie (F202, F204)

* 07/11 8h00-12h15 : Soutenance 2 (F109) et travail en autonomie (F203)
* 07/11 15h45-18h30 : Test utilisateur (SC) (F116)

* 14/11 8h00-12h15 : Travail encadré (VZ) (F216, F217)
* 14/11 15h45-18h30 : Travail en autonomie (F202, F204)

* 28/11 8h00-12h15 : Travail encadré (VZ) (F216, F217)
* 28/11 15h45-18h30 : Travail en autonomie (F202, F204)

* 05/12 8h00-12h15 : Travail en autonomie (F202, F204)
* 05/12 15h45-18h30 : Travail encadré (VZ) (F216, F217)

* 12/12 8h00-12h15 : Travail encadré (VZ) (F216, F217)

* 19/12 8h00-12h15 : Soutenances finales (F201, F217)
* 19/12 15h45-18h30 : Soutenances finales (F201, F212)

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie JEE.
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]], le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 10 octobre 2017
* audit 2 (conception) : le 07 novembre 2017
* soutenance de fin de projet le 19 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.

===Soutenance 1 ===
*Salle : F316
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- groupe 6

- groupe 3

- groupe 1

- groupe 2

- groupe 4

- groupe 5

''''' Contenu :'''''

Pour la partie GL
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Soutenance 2 ===
*Salle : F109
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL : point sur
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Choix technologiques

Pour la partie Système
* Architecture systeme du service
* Nombre de Entity, Ressources REST (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 : 8h

- groupe 1 : 8h30

- groupe 5 : 9h

- groupe 2 : 9h45

- groupe 4 : 10h15

- groupe 3 : 10h45

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : F114
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* 8h : groupe 1
* 8h35 : groupe 3
* 9h10 : groupe 5
* 15h45 : groupe 4
* 16h20 : groupe 6
* 16h55 : groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et TR pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Deux rapports doivent être rédigés pour la partie Système : un document de conception système et un document d'évaluation système. Ces documents doivent être accessibles depuis le wiki (ils peuvent même être directement édités sur le wiki).

Vous pouvez ajouter les livrables que vous jugez utiles pour présenter le travail que vous avez réalisé. Pour ces livrables : numérotez les

===Rendus===
Chaque livrable est numéroté (détails du livrable ci-dessous) LX, sous une forme à respecter. Certains ont une date de rendu à respecter. Ci-dessous le résumé de ces contraintes :
*L2 : 09/10 minuit : Wiki
*L3 : 09/10 minuit : Wiki
*L4 : 06/11 minuit : Wiki
*L5 : ?
*L6 : 06/11 minuit : Wiki
*L7 : 09/10 minuit : Wiki
*L8 : en continu : Wiki
*L9 : en continu : Wiki
*L10 : 18/12 minuit : Lien Git sur Wiki
*L11 : 18/12 minuit : Lien sur Wiki
*L12 : 19/12 lors du passage
*L13 : 18/12 minuit : Lien Git sur Wiki
*L14 : 18/12 minuit : Lien Git sur Wiki
*L15 : 08/11 lors du passage
*L16 : 19/12 lors du passage
*L17 : 19/12 lors du passage : Tableaux complétés et imprimés
*L18 : 10/10 lors du passage

===Contenu===
'''''L1. Composition des groupes et sujet'''''.
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation JEE : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement JEE. Un composant peut être implanté par un programme Java externe (client léger / client lourd JEE), par un servlet, par un bean ou par un objet POJO. Dans ces derniers cas, il faut préciser les caractéristiques des beans / POJO (local / distribué, session / évenementiel, stateful / stateless, etc). Un lien peut être implanté par une relation JEE, ou bien par conservation de référence de bean.

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (waffle ou autre)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Diapos de votre présentation de conception'''''.

'''''L16. Diapos de votre présentation finale'''''.

'''''L17. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à créer un wiki qui regroupera l'ensemble de vos documentations. Cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer une organisation github ou bitbucket. Ajouter les membres du projet eCOM à l'organisation. Créer plusieurs projets pour les différents parties. Activer les watchs. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des EJB (session et entity beans, annotations JAX-RS, [[Swagger]]). L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl, [[Swagger]] UI, jmeter, .... Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et consommateur) et exécuter certaines requêtes avec des garanties transactionnelles. Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]] pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, Oracle, HSQL ...) (non répliquée)
# Mise en place de 2 containers base de données (MySQL, Oracle, HSQL ...) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion asynchrone et transactionnelle de l'envoi des courriels via [[JMS]] et des EJBTimer (voir http://ecom.ow2.org/xwiki/bin/view/Main/fremail)
** Gestion asynchrone et transactionnelle de l'envoi de SMS via [[JMS]] et des EJBTimer ([[ECOM/SMSProviders|fournisseurs SMS]])

* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec [[Apache Jackrabbit]]
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Suivi du ''click stream'' avec des Filters en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Intégration de [[Memcached]]
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST.
** Utilisation de services tiers via leurs APIs (voir le catalogue de [[Mashape]])
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Gestion d'un ''cloud'' privé avec [[OpenStack]] avec [[Fuel]]
** Gestion d'un [[CaaS]] Docker privé avec [[Kubernete]] ou [[Docker Swarm]]
** Conditionnement de l'application mobile avec [[Apache Cordova]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers ([[AxiMAG]] par exemple).

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google)
* Performances (résultat du injection de charge avec [[Apache JMeter]], [[Gatling]], OW2 CLIF, BlazeMeter.com) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Supervision des VMs du système déployé avec un de ces systèmes : [[Telegraf]] + [[InfluxDB]] + [[Grafana]].
* Script "basique" pour le Rolling update (Blue-Green Deployment) des composants (applications et intergiciels).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom (utiliser [https://hub.docker.com/_/glassfish/ Glassfish]).
* Préparation d'images [[Docker]]
* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[CoreOS]] ou [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits
===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [https://glassfish.java.net/docs/4.0/administration-guide.pdf Guide d'administration de Glassfish 4]
* [http://docs.oracle.com/javaee/7/tutorial/doc/ Tutorial JavaEE 7 ] ([https://svn.java.net/svn/javaeetutorial~svn/ sources des exemples])
* [http://docs.oracle.com/javaee/7/api/ API JavaEE 7]
* [https://java.net/projects/javaee-spec/pages/Home Java EE Platform Specification]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* [[Bootstrap]]

===Quelques livres et technologies===

REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* [http://www.apress.com/9781430246268 Antonio Goncalves, Beginning JavaEE 7, APress, 2013], ([https://github.com/agoncal/agoncal-book-javaee7 examples] pour [[Glassfish]] 4)
* [https://www.packtpub.com/application-development/java-ee-7-developer-handbook Peter A. Pilgrim, Java EE 7 Developer Handbook, Packt, 2013, ISBN 139781849687942 ]
* [http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book Mick Knutson, Java EE6 Cookbook for securing, tuning, and extending enterprise applications, Packt Publishing, June 2012]
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* [http://www.manning.com/panda2/ Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, March 2014, ISBN: 9781935182993], ([http://www.manning.com/panda2/EJB3iA_2E_SourceCode.zip source code of examples])
* [http://shop.oreilly.com/product/9780596158033.do Andrew Lee Rubinger, Bill Burke, Enterprise JavaBeans 3.1, 6th Edition, O'Reilly Media, Final Release Date: September 2010, Pages]
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[AngularJS]]====
* Brad Green, Shyam Seshadri, AngularJS, Pub OReilly http://shop.oreilly.com/product/0636920028055.do ([https://github.com/shyamseshadri/angularjs-book source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2017-12-15T08:38:33Z

Sybille.Caffiau: /* Soutenance de fin de projet */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* TR : Thomas Ropras (thomas.ropars@imag.fr)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système

==Groupes et sujets==
===Groupes eCOM-RICM 2017-2018===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 19/09 à 8h.
====Groupe 1 ====
*AMODRU-FAVIN Hugo
*CHAMBONNET Simon
*FU Qianqian
*GAMBRO Antoine
*RIVOAL Alice
[[ECOM RICM5 Groupe1 2017|Fiche de suivi]]

====Groupe 2 ====
*ALLARD Estelle
*COCHINHO Louis
*DELISE Antoine
*GUERRY Lucas
*ROCHER Lambert
[[ECOM RICM5 Groupe2 2017|Fiche de suivi]]

====Groupe 3 ====
*BECHER Hervé
*DALLE Oriane
*GEOURJON Anthony
*LACHARTRE Denis
*SAVARY Rémi
[[ECOM RICM5 Groupe3 2017|Fiche de suivi]]

====Groupe 4 ====
*BOISADAM Antoine
*DEREYMEZ Maxime
*LEMAIRE Timothée
*LESAGE Lucas
*ZENNOUCHE Douria
[[ECOM RICM5 Groupe4 2017|Fiche de suivi]]

====Groupe 5 ====
*BONHOURE Gilles
*FERNANDES DE ALMEIDA Héloïse
*MARCHAND Charles
*MOREAU Gwenaël
*VIAL-GRELIER Aymeric
*ZEGAOUI Taquyeddine (arrivée début octobre)
[[ECOM RICM5 Groupe5 2017|Fiche de suivi]]

====Groupe 6 ====
*AUBERTIN Alicia
*BROCHIER Aymeric
*NASSIK Ahmed Amine
*ODIEVRE Boris
*TURRIN Vincent
[[ECOM RICM5 Groupe6 2017|Fiche de suivi]]

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et TR).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 19/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2017.pdf|transparents]]), CM Outils de suivi de projet + JSP 3h00 [http://lig-membres.imag.fr/donsez/cours/http-ecom.pdf HTTP] & [[Media:RestfulServices.pdf|REST]] (DD) (F018)
* 19/09 15h45-18h30 : JavaEE [https://github.com/donsez/javaee7-angular-swagger-docker app JavaEE de démo] [http://lig-membres.imag.fr/donsez/cours/javaee-ejb.pdf Cours JavaEE EJB](DD) Install [[JavaEE]] ([[Docker]] et [[Wildfly]]) Tutoriel EJB, Tutoriel Servlet/JSP/[[REST]]/WS/Filter/Docker ([[https://github.com/donsez/javaee7-angular-swagger-docker|lien]]) et [[JHipster]] pour le groupe "Gestion de courses sportives" (F202, F204). Vous pouvez générer le boilerplate de votre application avec des générateurs tel que http://www.generjee.com/.

* 26/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P257)
* 26/09 15h45-18h30 : Travail en autonomie (F202, F204)

* 03/10 8h00-12h15 : Travail en autonomie (F201,202)
* 03/10 15h45-18h30 : Travail en autonomie (F202, F204)

* 10/10 8h00-12h15 : Audit 1 (F316) et travail en autonomie (F203)
* 10/10 15h45-18h30 : Tests de robustesse (charges) (DD) (F203)

* 17/10 8h00-12h15 : Travail en autonomie (F203, F217)
* 17/10 15h45-18h30 : Travail en autonomie (F202, F204)

* 24/10 8h00-12h15 : Travail en autonomie (F203, F217)
* 24/10 15h45-18h30 : Travail en autonomie (F202, F204)

* 07/11 8h00-12h15 : Soutenance 2 (F109) et travail en autonomie (F203)
* 07/11 15h45-18h30 : Test utilisateur (SC) (F116)

* 14/11 8h00-12h15 : Travail encadré (TR) (F216, F217)
* 14/11 15h45-18h30 : Travail en autonomie (F202, F204)

* 28/11 8h00-12h15 : Travail encadré (TR) (F216, F217)
* 28/11 15h45-18h30 : Travail en autonomie (F202, F204)

* 05/12 8h00-12h15 : Travail en autonomie (F202, F204)
* 05/12 15h45-18h30 : Travail encadré (TR) (F216, F217)

* 12/12 8h00-12h15 : Travail encadré (TR) (F216, F217)

* 19/12 8h00-12h15 : Soutenances finales (F201, F217)
* 19/12 15h45-18h30 : Soutenances finales (F201, F212)

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie JEE.
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]], le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 10 octobre 2017
* audit 2 (conception) : le 07 novembre 2017
* soutenance de fin de projet le 19 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.

===Soutenance 1 ===
*Salle : F316
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- groupe 6

- groupe 3

- groupe 1

- groupe 2

- groupe 4

- groupe 5

''''' Contenu :'''''

Pour la partie GL
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Soutenance 2 ===
*Salle : F109
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL : point sur
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Choix technologiques

Pour la partie Système
* Architecture systeme du service
* Nombre de Beans (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 : 8h

- groupe 1 : 8h30

- groupe 5 : 9h

- groupe 2 : 9h45

- groupe 4 : 10h15

- groupe 3 : 10h45

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle : F114
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* 8h : groupe 1
* 8h35 : groupe 3
* 9h10 : groupe 5
* 15h45 : groupe 4
* 16h20 : groupe 6
* 16h55 : groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et TR pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Deux rapports doivent être rédigés pour la partie Système : un document de conception système et un document d'évaluation système. Ces documents doivent être accessibles depuis le wiki (ils peuvent même être directement édités sur le wiki).

Vous pouvez ajouter les livrables que vous jugez utiles pour présenter le travail que vous avez réalisé. Pour ces livrables : numérotez les

===Rendus===
Chaque livrable est numéroté (détails du livrable ci-dessous) LX, sous une forme à respecter. Certains ont une date de rendu à respecter. Ci-dessous le résumé de ces contraintes :
*L2 : 09/10 minuit : Wiki
*L3 : 09/10 minuit : Wiki
*L4 : 06/11 minuit : Wiki
*L5 : ?
*L6 : 06/11 minuit : Wiki
*L7 : 09/10 minuit : Wiki
*L8 : en continu : Wiki
*L9 : en continu : Wiki
*L10 : 18/12 minuit : Lien Git sur Wiki
*L11 : 18/12 minuit : Lien sur Wiki
*L12 : 19/12 lors du passage
*L13 : 18/12 minuit : Lien Git sur Wiki
*L14 : 18/12 minuit : Lien Git sur Wiki
*L15 : 08/11 lors du passage
*L16 : 19/12 lors du passage
*L17 : 19/12 lors du passage : Tableaux complétés et imprimés
*L18 : 10/10 lors du passage

===Contenu===
'''''L1. Composition des groupes et sujet'''''.
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation JEE : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement JEE. Un composant peut être implanté par un programme Java externe (client léger / client lourd JEE), par un servlet, par un bean ou par un objet POJO. Dans ces derniers cas, il faut préciser les caractéristiques des beans / POJO (local / distribué, session / évenementiel, stateful / stateless, etc). Un lien peut être implanté par une relation JEE, ou bien par conservation de référence de bean.

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (waffle ou autre)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Diapos de votre présentation de conception'''''.

'''''L16. Diapos de votre présentation finale'''''.

'''''L17. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à créer un wiki qui regroupera l'ensemble de vos documentations. Cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer une organisation github ou bitbucket. Ajouter les membres du projet eCOM à l'organisation. Créer plusieurs projets pour les différents parties. Activer les watchs. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des EJB (session et entity beans, annotations JAX-RS, [[Swagger]]). L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl, [[Swagger]] UI, jmeter, .... Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et consommateur) et exécuter certaines requêtes avec des garanties transactionnelles. Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]] pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, Oracle, HSQL ...) (non répliquée)
# Mise en place de 2 containers base de données (MySQL, Oracle, HSQL ...) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion asynchrone et transactionnelle de l'envoi des courriels via [[JMS]] et des EJBTimer (voir http://ecom.ow2.org/xwiki/bin/view/Main/fremail)
** Gestion asynchrone et transactionnelle de l'envoi de SMS via [[JMS]] et des EJBTimer ([[ECOM/SMSProviders|fournisseurs SMS]])

* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec [[Apache Jackrabbit]]
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Suivi du ''click stream'' avec des Filters en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Intégration de [[Memcached]]
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST.
** Utilisation de services tiers via leurs APIs (voir le catalogue de [[Mashape]])
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Gestion d'un ''cloud'' privé avec [[OpenStack]] avec [[Fuel]]
** Gestion d'un [[CaaS]] Docker privé avec [[Kubernete]] ou [[Docker Swarm]]
** Conditionnement de l'application mobile avec [[Apache Cordova]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers ([[AxiMAG]] par exemple).

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google)
* Performances (résultat du injection de charge avec [[Apache JMeter]], [[Gatling]], OW2 CLIF, BlazeMeter.com) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Supervision des VMs du système déployé avec un de ces systèmes : [[Telegraf]] + [[InfluxDB]] + [[Grafana]].
* Script "basique" pour le Rolling update (Blue-Green Deployment) des composants (applications et intergiciels).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom (utiliser [https://hub.docker.com/_/glassfish/ Glassfish]).
* Préparation d'images [[Docker]]
* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[CoreOS]] ou [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits
===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [https://glassfish.java.net/docs/4.0/administration-guide.pdf Guide d'administration de Glassfish 4]
* [http://docs.oracle.com/javaee/7/tutorial/doc/ Tutorial JavaEE 7 ] ([https://svn.java.net/svn/javaeetutorial~svn/ sources des exemples])
* [http://docs.oracle.com/javaee/7/api/ API JavaEE 7]
* [https://java.net/projects/javaee-spec/pages/Home Java EE Platform Specification]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* [[Bootstrap]]

===Quelques livres et technologies===

REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* [http://www.apress.com/9781430246268 Antonio Goncalves, Beginning JavaEE 7, APress, 2013], ([https://github.com/agoncal/agoncal-book-javaee7 examples] pour [[Glassfish]] 4)
* [https://www.packtpub.com/application-development/java-ee-7-developer-handbook Peter A. Pilgrim, Java EE 7 Developer Handbook, Packt, 2013, ISBN 139781849687942 ]
* [http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book Mick Knutson, Java EE6 Cookbook for securing, tuning, and extending enterprise applications, Packt Publishing, June 2012]
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* [http://www.manning.com/panda2/ Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, March 2014, ISBN: 9781935182993], ([http://www.manning.com/panda2/EJB3iA_2E_SourceCode.zip source code of examples])
* [http://shop.oreilly.com/product/9780596158033.do Andrew Lee Rubinger, Bill Burke, Enterprise JavaBeans 3.1, 6th Edition, O'Reilly Media, Final Release Date: September 2010, Pages]
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[AngularJS]]====
* Brad Green, Shyam Seshadri, AngularJS, Pub OReilly http://shop.oreilly.com/product/0636920028055.do ([https://github.com/shyamseshadri/angularjs-book source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-M2PGI

2017-12-15T08:24:09Z

Sybille.Caffiau: /* Consignes spécifiques pour les soutenances IHM */

Le projet eCOM consiste à concevoir et développer une application de commerce électronique. [[ECOM|suite ...]]

=Étapes du projet=
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Le projet se conclut par une soutenance finale pour chaque partie (IHM et système).

==Conduite de projet==
Le projet eCOM est très court en durée. Il est préconisé d'utiliser la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe.

===Critères d'évaluation===
La conduite du projet sera principalement évaluée en fonction des critères suivants :
* vous devez choisir un Scrum Master (unique ou tournant) : vous devez justifier votre choix
* durée du sprint (idem : vous devez justifier votre choix)
Sur ces 2 premiers critères, vous n'en changez pas !!!

Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à créer un wiki qui regroupera l'ensemble de vos documentations. Cela doit être une documentation Agile !!!!

Un point de bonus pour ceux qui réussiront à mettre en place des "poker planning".
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

==Partie IHM==

===Etapes et documents demandés===
Le détail sur l'organisation et l'évaluation du travail concernant les spécifications du site sera communiqué lors des premières séances de cours. Liste des Livrables et date de rendu pour les M2PGI Alternants :

* Livrable 1 : par email, membres du groupe et brève description du sujet (un seul groupe OK)

====[[Audit 1 :]]====
* L2.1 : Description des profils
* L2.2 : Questionnaire profils (OPT-ALT)
* L3.1 : Scénarios
* L3.2 : Analyse de la concurrence (OPT-ALT)
* L3.3 : Questionnaire sur l'utilisation (OPT-ALT)
* L4 : Modèles de tâches (Audit 2 pour ALT)
* L5 : Fonctionnalités
* L6.1 : Objectifs pour chaque version (priorités de développement)

====[[Audit 2 :]]====
* Mise à jour de L2 à L6.1
* L7.1 : Architecture (OPT-ALT)
* L7.2 : Base de données (OPT-ALT)
* L7.3 : IHM Abstraite
* L7.4 : Maquettes
* L6.2 : Objectifs pour les versions suivantes
* L8 : Démo de V0

====[[Audit 3 (Soutenances) :]]====
* Mise à jour de L7.3 (correction des erreurs)
* L9 : Rapport d'évaluation experte (imprimé pour la soutenance)
* L10 : Démonstration finale
* L11 : Diapos de votre présentation (version numérique à laquelle l'enseignant a accès au moment de votre passage)

OPT signifie que le livrable est optionnel soit parce qu'il ne s'applique pas à tous les groupes, soit parce qu'il ne peut qu'apporter une plus value à votre projet (points en plus mais pas en moins au moment de l'attribution de la note).
Lorsque ce n'est pas précisé, c'est à vous de choisir le mode présentation (écrit, schéma...) des informations du livrable

===Critères d'évaluation===
La partie IHM du projet sera principalement évaluée en fonction des critères suivants :
* Conformité de l'IHM concrète et abstraite avec le modèle de tâches
* Couverture fonctionnelle de l'application et robustesse au regard des priorités que vous avez retenues
* Qualité ergonomique au regard des principes vus en cours
* Rigueur de la démarche

La note est obtenue par l'évaluation tout au long du projet elle est composée de :
* Les besoins (3 pts) : informations sur les besoins que vous allez prendre en compte (livrables et audit 1)
* La conception (5 pts) : proposition de solution pour répondre aux besoins (livrables et audit 2)
* L'évaluation (3 pts) : évaluation de votre (ou vos) solution(s) (livrable et soutenance finale)
* Présentations (3 pts) : qualité des présentations (documents, email et slides de soutenance finale)
* Développement (6 pts) : qualité et quantité du code (démo et code)

Les notes des membres du groupe peuvent être différentes en fonction du travail fourni et constaté par l'enseignant.

==Partie Système==
La partie Système est axée sur deux étapes successives.
===Première étape===
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des EJB (session et entity beans).

Il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants. Il est également recommandé de limiter le premier prototype à un sous-ensemble des spécifications fonctionnelles, à la fois assez vaste pour couvrir les principales difficultés techniques et assez léger pour respecter les délais imposés.

À ce stade, l'application est seulement accessible par l'intermédiaire d'un "client lourd" (programme java offrant une console en mode texte). En particulier, il n'est pas demandé, pour cette première étape, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux interfaces (administrateur et consommateur) et exécuter les requêtes avec des garanties transactionnelles.

Une présentation/démonstration du prototype V1 sera réalisée à la fin de l'étape n°1.
===Deuxième étape===
La seconde étape consiste à compléter le premier prototype avec les objectifs suivants :
* ajout des beans nécessaires pour couvrir l'ensemble des spécifications fonctionnelles ;
* développement d'une interface Web basée sur le modèle MVC ;
* rédaction des documents demandés (voir ci-dessous) ;
* modification de la configuration de déploiement : (1) client (lourd/léger) distant, (2) base de données externe (MySQL, Oracle, HSQL ...) et éventuellement distante ;
* ajout éventuel de fonctionnalités non prioritaires.

Une présentation d'une mini-maquette d'interface web aura lieu au milieu de l'étape n°2.

Remarque : Aucune des phases du projet ne nécessite le développement d'un client lourd en mode graphique (SWT ...).
===Documents demandés===
Deux rapports doivent être rédigés pour la partie Système : un document de conception système et un document d'évaluation système.

====Document de conception système====
Le dossier de conception système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation JEE : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement JEE. Un composant peut être implanté par un programme Java externe (client léger / client lourd JEE), par un servlet, par un bean ou par un objet POJO. Dans ces derniers cas, il faut préciser les caractéristiques des beans / POJO (local / distribué, session / évenementiel, stateful / stateless, etc). Un lien peut être implanté par une relation JEE, ou bien par conservation de référence de bean.

====Document d'évaluation système====

Le rapport final système du projet ECOM a pour but de préciser l’état d’avancement de votre application ECOM.

Le rapport final système doit préciser :
* L’état de chaque composant : non réalisé, réalisé, réalisé et validé
* Les fonctions réalisées, réalisées et testées, et celles restant à réaliser
* Les propriétés non fonctionnelles garanties par votre réalisation, et celles restant à considérer pour finaliser votre application
* Le temps consacré à la conception système
* Le temps consacré au développement système
* Les principales difficultés rencontrées
===Critères d'évaluation===
La partie système du projet sera principalement évaluée en fonction des critères suivants :
* Conformité aux spécifications de l'application et aux consignes données dans le cadre du projet
* Respect des échéances pour les différentes étapes du projet (y compris pour les prototypes intermédiaires et les documents)
* Qualité de l'architecture de l'application
* Qualité et robustesse du code applicatif
* Compréhension des principaux concepts de la technologie JEE
* Rigueur de la démarche de conception
* Qualité des présentations/soutenances
En complément, les aspects suivants seront également considérés :
* Méthodologie de test
* Déploiement et retrait de l'application sur/de la plateforme cloud (Azure) avec [http://roboconf.net/ Roboconf] ([http://roboconf.net/en/user-guide/lamp-example-part-1.html voir l'exemple avec LAMP])
* Préparation d'images de VMs avec [[Kameleon]]
* Performances (résultat du injection de charge avec [[Apache JMeter]] ou OW2 CLIF)
* Supervision du système déployé avec des sondes [[Nagios]] ou [[Shinken]] conditionnées dans les VMs à déployer.
* Utilisation (optionnelle) de technologies/APIs/frameworks avancés

==Consignes pour la soutenance==
===Consignes spécifiques pour les soutenances IHM===
Salle : F114

Durée totale : 30 minutes

* tous les livrables doivent être consultable par l'enseignant (en ligne ou ayant été préalablement envoyés)
* votre passage doit contenir une présentation globale du projet, le processus de conception (illustré), des évaluations, le bilan (point de vue IHM) et une démo PRÉPARÉE
* arrivez avec l'application démarée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* prévoyez 15 minutes de questions lors de votre passage

Ordre de passage (22/12)
* 8h Groupe 3
* 8h30 Groupe 4
* 9h Groupe 6
* 9h30 Groupe 1
* 10h Groupe 7
* 10h30 Groupe 2
* 11h Groupe 5

===Consignes spécifiques pour les soutenances Système===
* Apportez un exemplaire du dossier d'évaluation système (déposé la veille sur Moodle) lors de la soutenance. Il n'est pas nécessaire d'apporter un exemplaire du dossier de conception système.
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure avec le service développé.
* Prévovez environ 30 minutes pour la présentation/démo/questions. Utilisez des transparents pour présenter votre projet.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances Windows Azure.
* Conditionnez le projet final sous la forme d’une archive (zip ou tar.gz) après avoir inclus la documentation (dans un repertoire /main/site). Utilisez la convention de nommage suivante : ecom_final_1213-X.zip où X correspond au nom du projet.
* Déposez immédiatement après la soutenance (et en aucun cas après le 20 décembre) l'archive sur Moodle.
* le rapport de charge (benchmark) doit être (MUST) fourni dans la documentation.
* le rapport sur les métriques logicielles doit être (MUST) fourni dans la documentation.

=Organisation 2017-2018=

==Planning==
===M2PGI (Alternant)===
'''Equipe pédagogique:''' Noël de Palma (NdP), Vincent Lesne (VL), Sybille Caffiau (SC), Sebastien Chassand-Barrioz (SCB), Ibrahim Safiedinne (FR)

'''Dates Importantes:'''
*Soutenances (IHM + système) : 9h-17h, le 27 septembre
*Remise du dossier de conception système : le 27 septembre (lors de votre passage)
*Remise du dossier d'évaluation système : le 27 septembre (lors de votre passage)

*01 sept 09h-12h F022, F319, Boot Projet/ JEE (NDP)
*01 sept 14h-17h F319, Boot Projet/ JEE (NDP)
*04 sept 09h-12h F118, cours Agile (VL)
*04 sept 14h-17h F118, cours IHM (SC)
*05 sept 09h-12h F118, cours angular (SCB) (+TP F217)
*05 sept 14h-17h F118, cours angular (SCB) (+TP F217)
*06 sept 09h-12h F118, cours Agile (VL)
*06 sept 14h-17h F217, point Syst. (NDP)
*07 sept 09h-12h Libre service
*07 sept 14h-17h F118, cours Cloud (IS)
*08 sept 09h-12h F201, Point Syst. (SCB)
*08 sept 14h-17h F201, audit agile (VL)
*11 sept 09h-12h Libre service
*11 sept 14h-17h F217, point Syst. (IS)
*12 sept 09h-12h Libre Service
*12 sept 14h-17h Libre Service
*13 sept 09h-12h Libre Service
*13 sept 14h-17h F217, point Syst. (NDP)
*14 sept 09h-12h Libre Service
*14 sept 14h-17h Libre Service
*15 sept 09h-12h F214, point Syst. (SCB)
*15 sept 14h-17h F201, audit agile (VL)
*18 sept 09h-12h Libre Service
*18 sept 14h-17h F211, point Syst. (IS/NDP)
*19 sept 09h-12h Libre Service
*19 sept 14h-17h Libre Service
*20 sept 09h-12h F217 point Syst (IS)
*20 sept 14h-17h Libre Service
*21 sept 09h-12h Libre Service
*21 sept 14h-17h Libre Service
*22 sept 09h-12h Libre Service
*22 sept 14h-17h F211, point Syst. (SCB) + audit agile (VL)
*27 sept 09h-12h Soutenances
*27 sept 14h-17h Soutenances

===M2PGI (Classique)===
'''Equipe pédagogique:''' Noël de Palma (NdP), Vincent Lesne (VL), Sybille Caffiau (SC), Sebastien Chassand-Barrioz (SCB), Ibrahim Safiedinne (FR)

'''Dates Importantes:'''
Vendredi 29 sept. : Début des cours

* 29 sept 9h-12h F114, Boot Projet/ JEE (NDP)
* 29 sept 14h-17h F319, point systeme (NDP)
* 06 oct 09h-12h F114, cours Agile (VL)
* 06 oct 14h-17h F319, cours IHM (SC)
* 13 oct 9h-12h F215, cours Cloud (IS)
* 13 oct 14h-17h F319, cours angular (SCB) +(TP F204)
* 20 oct 9h-12h TP F215, point systeme (NDP) et TD F114 audit Agile (VL)
* 20 oct 14h-17h TD F319/TP F204, cours angular (SCB)
* 27 oct 9h-12h TP F215/TD F114, point système (SCB, NDP)
* 27 oct 14h-17h TD F204, cours Agile (VL)
* 10 nov 9h-12h TD F114 audit2 Agile (VL)
* 10 nov 14h-17h TP F204/TD F319 point système (SCB, IS)
* 17 nov 9h-12h TP F215/TD F114 point système (SCB, NDP).
* 17 nov 14h-17 TDF319 cours ergonomie des IHM + Libre service (TP F204)
* 24 nov 9h-12h TP F215/TD F114, Libre service
* 24 nov 14h-17h TP F204/TD F319 Point système Cl&Alt (IS).
* 01 dec 9h-12h Libre Service
* 01 dec 14h-17h TP F204/TD 319 point systeme (SCB, IS, NDP)
* 08 dec 9h-12h Libre Service
* 08 dec 14-17h TP F204 audit Agile (VL) et point système (IS)
* 15 dec 9h-12h TP F215/TD F114 libre service
* 15 dec 14h-17h TP F204/TD F319 point system (SCB)
* 18 dec-22 dec semaine bloquée libre service

Le 22/12 soutenances tte la journée F215/F216

==Groupes==
===M2PGI Apprenti===

===M2PGI Classique===
Consigne pour la constitution des groupes : Les étudiants ayant choisis l'option multimobile doivent se mettre ensemble. Ils doivent constituer des groupes de 4/5 afin d'avoir en tout 4 groupes (de M2 PGI classiques)

==Soutenance==
===M2PGI Apprenti===

===M2PGI Classique===

IMPERATIF
* le projet doit être (MUST) géré selon la méthode Scrum : le Scrum Master devra présenter le déroulement du projet.
* le serveur JavaEE doit être (MUST) hébergé sur une instance de VM.
* un rapport de charge (benchmark) doit être (MUST) fourni : les outils JMeter ou Clif peuvent être utilisés.
* un rapport sur les métriques logicielles doit être (MUST) fourni : l'outil Sonar peut être utilisé.

'''Ordre de passage :'''
* Respectez l'ordre établi
* Faites attention au temps. Vous disposez de 45 minutes par soutenance pour : votre présentation, la démo et les questions

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Squelette du projet==
[http://dl.dropbox.com/u/66952950/ecom-maven.zip ecom-maven.zip] Inaccessible

==Doc utiles==
* [http://wiki.easybeans.org/xwiki/bin/view/Main/Documentation Documentation Easybeans (conteneur EJB3 utilisé par Jonas)]
* [http://docs.oracle.com/javaee/6/tutorial/doc/ Tutorial JavaEE 6 ]
* [http://netbeans.org/kb/67/javaee/ejb30.html Tutorial NetBean et JEE ]
* [http://docs.oracle.com/javaee/6/api/ API JavaEE 6]
* [https://java.net/projects/javaee-spec/pages/Home Spécifications JavaEE 6]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* [http://jonas.ow2.org/JONAS_5_1_2/doc/doc-en/html/getting_started_guide.html#id1316973 Glossaire]
* [http://www.easybeans.net/xwiki/bin/download/Main/Documentation/ejb3-annotations.pdf Aide mémoire pour les annotations EJB3 ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* Questionnaire pour site web : [[Media:Questionnaire copy.pdf]]
* Questionnaire SUS (évaluation satisfaction) : [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]

===Quelques livres===
REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
* Java EE6 Cookbook for securing, tuning, and extending enterprise applications: http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* Debu Panda, Reza Rahman, Derek Lane, EJB 3 in Action, Pub Mannings, 2007, http://www.manning.com/panda/
* Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, Pub Mannings, 2011, http://www.manning.com/panda2/

ECOM-M2PGI

2017-12-15T08:23:29Z

Sybille.Caffiau: /* Consignes spécifiques pour les soutenances IHM */

Le projet eCOM consiste à concevoir et développer une application de commerce électronique. [[ECOM|suite ...]]

=Étapes du projet=
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Le projet se conclut par une soutenance finale pour chaque partie (IHM et système).

==Conduite de projet==
Le projet eCOM est très court en durée. Il est préconisé d'utiliser la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe.

===Critères d'évaluation===
La conduite du projet sera principalement évaluée en fonction des critères suivants :
* vous devez choisir un Scrum Master (unique ou tournant) : vous devez justifier votre choix
* durée du sprint (idem : vous devez justifier votre choix)
Sur ces 2 premiers critères, vous n'en changez pas !!!

Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à créer un wiki qui regroupera l'ensemble de vos documentations. Cela doit être une documentation Agile !!!!

Un point de bonus pour ceux qui réussiront à mettre en place des "poker planning".
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

==Partie IHM==

===Etapes et documents demandés===
Le détail sur l'organisation et l'évaluation du travail concernant les spécifications du site sera communiqué lors des premières séances de cours. Liste des Livrables et date de rendu pour les M2PGI Alternants :

* Livrable 1 : par email, membres du groupe et brève description du sujet (un seul groupe OK)

====[[Audit 1 :]]====
* L2.1 : Description des profils
* L2.2 : Questionnaire profils (OPT-ALT)
* L3.1 : Scénarios
* L3.2 : Analyse de la concurrence (OPT-ALT)
* L3.3 : Questionnaire sur l'utilisation (OPT-ALT)
* L4 : Modèles de tâches (Audit 2 pour ALT)
* L5 : Fonctionnalités
* L6.1 : Objectifs pour chaque version (priorités de développement)

====[[Audit 2 :]]====
* Mise à jour de L2 à L6.1
* L7.1 : Architecture (OPT-ALT)
* L7.2 : Base de données (OPT-ALT)
* L7.3 : IHM Abstraite
* L7.4 : Maquettes
* L6.2 : Objectifs pour les versions suivantes
* L8 : Démo de V0

====[[Audit 3 (Soutenances) :]]====
* Mise à jour de L7.3 (correction des erreurs)
* L9 : Rapport d'évaluation experte (imprimé pour la soutenance)
* L10 : Démonstration finale
* L11 : Diapos de votre présentation (version numérique à laquelle l'enseignant a accès au moment de votre passage)

OPT signifie que le livrable est optionnel soit parce qu'il ne s'applique pas à tous les groupes, soit parce qu'il ne peut qu'apporter une plus value à votre projet (points en plus mais pas en moins au moment de l'attribution de la note).
Lorsque ce n'est pas précisé, c'est à vous de choisir le mode présentation (écrit, schéma...) des informations du livrable

===Critères d'évaluation===
La partie IHM du projet sera principalement évaluée en fonction des critères suivants :
* Conformité de l'IHM concrète et abstraite avec le modèle de tâches
* Couverture fonctionnelle de l'application et robustesse au regard des priorités que vous avez retenues
* Qualité ergonomique au regard des principes vus en cours
* Rigueur de la démarche

La note est obtenue par l'évaluation tout au long du projet elle est composée de :
* Les besoins (3 pts) : informations sur les besoins que vous allez prendre en compte (livrables et audit 1)
* La conception (5 pts) : proposition de solution pour répondre aux besoins (livrables et audit 2)
* L'évaluation (3 pts) : évaluation de votre (ou vos) solution(s) (livrable et soutenance finale)
* Présentations (3 pts) : qualité des présentations (documents, email et slides de soutenance finale)
* Développement (6 pts) : qualité et quantité du code (démo et code)

Les notes des membres du groupe peuvent être différentes en fonction du travail fourni et constaté par l'enseignant.

==Partie Système==
La partie Système est axée sur deux étapes successives.
===Première étape===
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des EJB (session et entity beans).

Il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants. Il est également recommandé de limiter le premier prototype à un sous-ensemble des spécifications fonctionnelles, à la fois assez vaste pour couvrir les principales difficultés techniques et assez léger pour respecter les délais imposés.

À ce stade, l'application est seulement accessible par l'intermédiaire d'un "client lourd" (programme java offrant une console en mode texte). En particulier, il n'est pas demandé, pour cette première étape, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux interfaces (administrateur et consommateur) et exécuter les requêtes avec des garanties transactionnelles.

Une présentation/démonstration du prototype V1 sera réalisée à la fin de l'étape n°1.
===Deuxième étape===
La seconde étape consiste à compléter le premier prototype avec les objectifs suivants :
* ajout des beans nécessaires pour couvrir l'ensemble des spécifications fonctionnelles ;
* développement d'une interface Web basée sur le modèle MVC ;
* rédaction des documents demandés (voir ci-dessous) ;
* modification de la configuration de déploiement : (1) client (lourd/léger) distant, (2) base de données externe (MySQL, Oracle, HSQL ...) et éventuellement distante ;
* ajout éventuel de fonctionnalités non prioritaires.

Une présentation d'une mini-maquette d'interface web aura lieu au milieu de l'étape n°2.

Remarque : Aucune des phases du projet ne nécessite le développement d'un client lourd en mode graphique (SWT ...).
===Documents demandés===
Deux rapports doivent être rédigés pour la partie Système : un document de conception système et un document d'évaluation système.

====Document de conception système====
Le dossier de conception système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation JEE : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement JEE. Un composant peut être implanté par un programme Java externe (client léger / client lourd JEE), par un servlet, par un bean ou par un objet POJO. Dans ces derniers cas, il faut préciser les caractéristiques des beans / POJO (local / distribué, session / évenementiel, stateful / stateless, etc). Un lien peut être implanté par une relation JEE, ou bien par conservation de référence de bean.

====Document d'évaluation système====

Le rapport final système du projet ECOM a pour but de préciser l’état d’avancement de votre application ECOM.

Le rapport final système doit préciser :
* L’état de chaque composant : non réalisé, réalisé, réalisé et validé
* Les fonctions réalisées, réalisées et testées, et celles restant à réaliser
* Les propriétés non fonctionnelles garanties par votre réalisation, et celles restant à considérer pour finaliser votre application
* Le temps consacré à la conception système
* Le temps consacré au développement système
* Les principales difficultés rencontrées
===Critères d'évaluation===
La partie système du projet sera principalement évaluée en fonction des critères suivants :
* Conformité aux spécifications de l'application et aux consignes données dans le cadre du projet
* Respect des échéances pour les différentes étapes du projet (y compris pour les prototypes intermédiaires et les documents)
* Qualité de l'architecture de l'application
* Qualité et robustesse du code applicatif
* Compréhension des principaux concepts de la technologie JEE
* Rigueur de la démarche de conception
* Qualité des présentations/soutenances
En complément, les aspects suivants seront également considérés :
* Méthodologie de test
* Déploiement et retrait de l'application sur/de la plateforme cloud (Azure) avec [http://roboconf.net/ Roboconf] ([http://roboconf.net/en/user-guide/lamp-example-part-1.html voir l'exemple avec LAMP])
* Préparation d'images de VMs avec [[Kameleon]]
* Performances (résultat du injection de charge avec [[Apache JMeter]] ou OW2 CLIF)
* Supervision du système déployé avec des sondes [[Nagios]] ou [[Shinken]] conditionnées dans les VMs à déployer.
* Utilisation (optionnelle) de technologies/APIs/frameworks avancés

==Consignes pour la soutenance==
===Consignes spécifiques pour les soutenances IHM===
Salle : F114
Durée totale : 30 minutes
* tous les livrables doivent être consultable par l'enseignant (en ligne ou ayant été préalablement envoyés)
* votre passage doit contenir une présentation globale du projet, le processus de conception (illustré), des évaluations, le bilan (point de vue IHM) et une démo PRÉPARÉE
* arrivez avec l'application démarée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* prévoyez 15 minutes de questions lors de votre passage

Ordre de passage (22/12)
* 8h Groupe 3
* 8h30 Groupe 4
* 9h Groupe 6
* 9h30 Groupe 1
* 10h Groupe 7
* 10h30 Groupe 2
* 11h Groupe 5

===Consignes spécifiques pour les soutenances Système===
* Apportez un exemplaire du dossier d'évaluation système (déposé la veille sur Moodle) lors de la soutenance. Il n'est pas nécessaire d'apporter un exemplaire du dossier de conception système.
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure avec le service développé.
* Prévovez environ 30 minutes pour la présentation/démo/questions. Utilisez des transparents pour présenter votre projet.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances Windows Azure.
* Conditionnez le projet final sous la forme d’une archive (zip ou tar.gz) après avoir inclus la documentation (dans un repertoire /main/site). Utilisez la convention de nommage suivante : ecom_final_1213-X.zip où X correspond au nom du projet.
* Déposez immédiatement après la soutenance (et en aucun cas après le 20 décembre) l'archive sur Moodle.
* le rapport de charge (benchmark) doit être (MUST) fourni dans la documentation.
* le rapport sur les métriques logicielles doit être (MUST) fourni dans la documentation.

=Organisation 2017-2018=

==Planning==
===M2PGI (Alternant)===
'''Equipe pédagogique:''' Noël de Palma (NdP), Vincent Lesne (VL), Sybille Caffiau (SC), Sebastien Chassand-Barrioz (SCB), Ibrahim Safiedinne (FR)

'''Dates Importantes:'''
*Soutenances (IHM + système) : 9h-17h, le 27 septembre
*Remise du dossier de conception système : le 27 septembre (lors de votre passage)
*Remise du dossier d'évaluation système : le 27 septembre (lors de votre passage)

*01 sept 09h-12h F022, F319, Boot Projet/ JEE (NDP)
*01 sept 14h-17h F319, Boot Projet/ JEE (NDP)
*04 sept 09h-12h F118, cours Agile (VL)
*04 sept 14h-17h F118, cours IHM (SC)
*05 sept 09h-12h F118, cours angular (SCB) (+TP F217)
*05 sept 14h-17h F118, cours angular (SCB) (+TP F217)
*06 sept 09h-12h F118, cours Agile (VL)
*06 sept 14h-17h F217, point Syst. (NDP)
*07 sept 09h-12h Libre service
*07 sept 14h-17h F118, cours Cloud (IS)
*08 sept 09h-12h F201, Point Syst. (SCB)
*08 sept 14h-17h F201, audit agile (VL)
*11 sept 09h-12h Libre service
*11 sept 14h-17h F217, point Syst. (IS)
*12 sept 09h-12h Libre Service
*12 sept 14h-17h Libre Service
*13 sept 09h-12h Libre Service
*13 sept 14h-17h F217, point Syst. (NDP)
*14 sept 09h-12h Libre Service
*14 sept 14h-17h Libre Service
*15 sept 09h-12h F214, point Syst. (SCB)
*15 sept 14h-17h F201, audit agile (VL)
*18 sept 09h-12h Libre Service
*18 sept 14h-17h F211, point Syst. (IS/NDP)
*19 sept 09h-12h Libre Service
*19 sept 14h-17h Libre Service
*20 sept 09h-12h F217 point Syst (IS)
*20 sept 14h-17h Libre Service
*21 sept 09h-12h Libre Service
*21 sept 14h-17h Libre Service
*22 sept 09h-12h Libre Service
*22 sept 14h-17h F211, point Syst. (SCB) + audit agile (VL)
*27 sept 09h-12h Soutenances
*27 sept 14h-17h Soutenances

===M2PGI (Classique)===
'''Equipe pédagogique:''' Noël de Palma (NdP), Vincent Lesne (VL), Sybille Caffiau (SC), Sebastien Chassand-Barrioz (SCB), Ibrahim Safiedinne (FR)

'''Dates Importantes:'''
Vendredi 29 sept. : Début des cours

* 29 sept 9h-12h F114, Boot Projet/ JEE (NDP)
* 29 sept 14h-17h F319, point systeme (NDP)
* 06 oct 09h-12h F114, cours Agile (VL)
* 06 oct 14h-17h F319, cours IHM (SC)
* 13 oct 9h-12h F215, cours Cloud (IS)
* 13 oct 14h-17h F319, cours angular (SCB) +(TP F204)
* 20 oct 9h-12h TP F215, point systeme (NDP) et TD F114 audit Agile (VL)
* 20 oct 14h-17h TD F319/TP F204, cours angular (SCB)
* 27 oct 9h-12h TP F215/TD F114, point système (SCB, NDP)
* 27 oct 14h-17h TD F204, cours Agile (VL)
* 10 nov 9h-12h TD F114 audit2 Agile (VL)
* 10 nov 14h-17h TP F204/TD F319 point système (SCB, IS)
* 17 nov 9h-12h TP F215/TD F114 point système (SCB, NDP).
* 17 nov 14h-17 TDF319 cours ergonomie des IHM + Libre service (TP F204)
* 24 nov 9h-12h TP F215/TD F114, Libre service
* 24 nov 14h-17h TP F204/TD F319 Point système Cl&Alt (IS).
* 01 dec 9h-12h Libre Service
* 01 dec 14h-17h TP F204/TD 319 point systeme (SCB, IS, NDP)
* 08 dec 9h-12h Libre Service
* 08 dec 14-17h TP F204 audit Agile (VL) et point système (IS)
* 15 dec 9h-12h TP F215/TD F114 libre service
* 15 dec 14h-17h TP F204/TD F319 point system (SCB)
* 18 dec-22 dec semaine bloquée libre service

Le 22/12 soutenances tte la journée F215/F216

==Groupes==
===M2PGI Apprenti===

===M2PGI Classique===
Consigne pour la constitution des groupes : Les étudiants ayant choisis l'option multimobile doivent se mettre ensemble. Ils doivent constituer des groupes de 4/5 afin d'avoir en tout 4 groupes (de M2 PGI classiques)

==Soutenance==
===M2PGI Apprenti===

===M2PGI Classique===

IMPERATIF
* le projet doit être (MUST) géré selon la méthode Scrum : le Scrum Master devra présenter le déroulement du projet.
* le serveur JavaEE doit être (MUST) hébergé sur une instance de VM.
* un rapport de charge (benchmark) doit être (MUST) fourni : les outils JMeter ou Clif peuvent être utilisés.
* un rapport sur les métriques logicielles doit être (MUST) fourni : l'outil Sonar peut être utilisé.

'''Ordre de passage :'''
* Respectez l'ordre établi
* Faites attention au temps. Vous disposez de 45 minutes par soutenance pour : votre présentation, la démo et les questions

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Squelette du projet==
[http://dl.dropbox.com/u/66952950/ecom-maven.zip ecom-maven.zip] Inaccessible

==Doc utiles==
* [http://wiki.easybeans.org/xwiki/bin/view/Main/Documentation Documentation Easybeans (conteneur EJB3 utilisé par Jonas)]
* [http://docs.oracle.com/javaee/6/tutorial/doc/ Tutorial JavaEE 6 ]
* [http://netbeans.org/kb/67/javaee/ejb30.html Tutorial NetBean et JEE ]
* [http://docs.oracle.com/javaee/6/api/ API JavaEE 6]
* [https://java.net/projects/javaee-spec/pages/Home Spécifications JavaEE 6]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* [http://jonas.ow2.org/JONAS_5_1_2/doc/doc-en/html/getting_started_guide.html#id1316973 Glossaire]
* [http://www.easybeans.net/xwiki/bin/download/Main/Documentation/ejb3-annotations.pdf Aide mémoire pour les annotations EJB3 ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* Questionnaire pour site web : [[Media:Questionnaire copy.pdf]]
* Questionnaire SUS (évaluation satisfaction) : [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]

===Quelques livres===
REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
* Java EE6 Cookbook for securing, tuning, and extending enterprise applications: http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* Debu Panda, Reza Rahman, Derek Lane, EJB 3 in Action, Pub Mannings, 2007, http://www.manning.com/panda/
* Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, Pub Mannings, 2011, http://www.manning.com/panda2/

ECOM-1FO

2017-12-12T09:19:10Z

Sybille.Caffiau: /* Soutenance de fin de projet */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* TR : Thomas Ropras (thomas.ropars@imag.fr)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système

==Groupes et sujets==
===Groupes eCOM-RICM 2017-2018===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 19/09 à 8h.
====Groupe 1 ====
*AMODRU-FAVIN Hugo
*CHAMBONNET Simon
*FU Qianqian
*GAMBRO Antoine
*RIVOAL Alice
[[ECOM RICM5 Groupe1 2017|Fiche de suivi]]

====Groupe 2 ====
*ALLARD Estelle
*COCHINHO Louis
*DELISE Antoine
*GUERRY Lucas
*ROCHER Lambert
[[ECOM RICM5 Groupe2 2017|Fiche de suivi]]

====Groupe 3 ====
*BECHER Hervé
*DALLE Oriane
*GEOURJON Anthony
*LACHARTRE Denis
*SAVARY Rémi
[[ECOM RICM5 Groupe3 2017|Fiche de suivi]]

====Groupe 4 ====
*BOISADAM Antoine
*DEREYMEZ Maxime
*LEMAIRE Timothée
*LESAGE Lucas
*ZENNOUCHE Douria
[[ECOM RICM5 Groupe4 2017|Fiche de suivi]]

====Groupe 5 ====
*BONHOURE Gilles
*FERNANDES DE ALMEIDA Héloïse
*MARCHAND Charles
*MOREAU Gwenaël
*VIAL-GRELIER Aymeric
*ZEGAOUI Taquyeddine (arrivée début octobre)
[[ECOM RICM5 Groupe5 2017|Fiche de suivi]]

====Groupe 6 ====
*AUBERTIN Alicia
*BROCHIER Aymeric
*NASSIK Ahmed Amine
*ODIEVRE Boris
*TURRIN Vincent
[[ECOM RICM5 Groupe6 2017|Fiche de suivi]]

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et TR).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 19/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2017.pdf|transparents]]), CM Outils de suivi de projet + JSP 3h00 [http://lig-membres.imag.fr/donsez/cours/http-ecom.pdf HTTP] & [[Media:RestfulServices.pdf|REST]] (DD) (F018)
* 19/09 15h45-18h30 : JavaEE [https://github.com/donsez/javaee7-angular-swagger-docker app JavaEE de démo] [http://lig-membres.imag.fr/donsez/cours/javaee-ejb.pdf Cours JavaEE EJB](DD) Install [[JavaEE]] ([[Docker]] et [[Wildfly]]) Tutoriel EJB, Tutoriel Servlet/JSP/[[REST]]/WS/Filter/Docker ([[https://github.com/donsez/javaee7-angular-swagger-docker|lien]]) et [[JHipster]] pour le groupe "Gestion de courses sportives" (F202, F204). Vous pouvez générer le boilerplate de votre application avec des générateurs tel que http://www.generjee.com/.

* 26/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P257)
* 26/09 15h45-18h30 : Travail en autonomie (F202, F204)

* 03/10 8h00-12h15 : Travail en autonomie (F201,202)
* 03/10 15h45-18h30 : Travail en autonomie (F202, F204)

* 10/10 8h00-12h15 : Audit 1 (F316) et travail en autonomie (F203)
* 10/10 15h45-18h30 : Tests de robustesse (charges) (DD) (F203)

* 17/10 8h00-12h15 : Travail en autonomie (F203, F217)
* 17/10 15h45-18h30 : Travail en autonomie (F202, F204)

* 24/10 8h00-12h15 : Travail en autonomie (F203, F217)
* 24/10 15h45-18h30 : Travail en autonomie (F202, F204)

* 07/11 8h00-12h15 : Soutenance 2 (F109) et travail en autonomie (F203)
* 07/11 15h45-18h30 : Test utilisateur (SC) (F116)

* 14/11 8h00-12h15 : Travail encadré (TR) (F216, F217)
* 14/11 15h45-18h30 : Travail en autonomie (F202, F204)

* 28/11 8h00-12h15 : Travail encadré (TR) (F216, F217)
* 28/11 15h45-18h30 : Travail en autonomie (F202, F204)

* 05/12 8h00-12h15 : Travail en autonomie (F202, F204)
* 05/12 15h45-18h30 : Travail encadré (TR) (F216, F217)

* 12/12 8h00-12h15 : Travail encadré (TR) (F216, F217)

* 19/12 8h00-12h15 : Soutenances finales (F201, F217)
* 19/12 15h45-18h30 : Soutenances finales (F201, F212)

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie JEE.
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]], le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 10 octobre 2017
* audit 2 (conception) : le 07 novembre 2017
* soutenance de fin de projet le 19 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.

===Soutenance 1 ===
*Salle : F316
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- groupe 6

- groupe 3

- groupe 1

- groupe 2

- groupe 4

- groupe 5

''''' Contenu :'''''

Pour la partie GL
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Soutenance 2 ===
*Salle : F109
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL : point sur
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Choix technologiques

Pour la partie Système
* Architecture systeme du service
* Nombre de Beans (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 : 8h

- groupe 1 : 8h30

- groupe 5 : 9h

- groupe 2 : 9h45

- groupe 4 : 10h15

- groupe 3 : 10h45

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle :
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
* 8h : groupe 1
* 8h35 : groupe 3
* 9h10 : groupe 5
* 15h45 : groupe 4
* 16h20 : groupe 6
* 16h55 : groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et TR pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Deux rapports doivent être rédigés pour la partie Système : un document de conception système et un document d'évaluation système. Ces documents doivent être accessibles depuis le wiki (ils peuvent même être directement édités sur le wiki).

Vous pouvez ajouter les livrables que vous jugez utiles pour présenter le travail que vous avez réalisé. Pour ces livrables : numérotez les

===Rendus===
Chaque livrable est numéroté (détails du livrable ci-dessous) LX, sous une forme à respecter. Certains ont une date de rendu à respecter. Ci-dessous le résumé de ces contraintes :
*L2 : 09/10 minuit : Wiki
*L3 : 09/10 minuit : Wiki
*L4 : 06/11 minuit : Wiki
*L5 : ?
*L6 : 06/11 minuit : Wiki
*L7 : 09/10 minuit : Wiki
*L8 : en continu : Wiki
*L9 : en continu : Wiki
*L10 : 18/12 minuit : Lien Git sur Wiki
*L11 : 18/12 minuit : Lien sur Wiki
*L12 : 19/12 lors du passage
*L13 : 18/12 minuit : Lien Git sur Wiki
*L14 : 18/12 minuit : Lien Git sur Wiki
*L15 : 08/11 lors du passage
*L16 : 19/12 lors du passage
*L17 : 19/12 lors du passage : Tableaux complétés et imprimés
*L18 : 10/10 lors du passage

===Contenu===
'''''L1. Composition des groupes et sujet'''''.
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation JEE : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement JEE. Un composant peut être implanté par un programme Java externe (client léger / client lourd JEE), par un servlet, par un bean ou par un objet POJO. Dans ces derniers cas, il faut préciser les caractéristiques des beans / POJO (local / distribué, session / évenementiel, stateful / stateless, etc). Un lien peut être implanté par une relation JEE, ou bien par conservation de référence de bean.

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (waffle ou autre)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Diapos de votre présentation de conception'''''.

'''''L16. Diapos de votre présentation finale'''''.

'''''L17. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à créer un wiki qui regroupera l'ensemble de vos documentations. Cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer une organisation github ou bitbucket. Ajouter les membres du projet eCOM à l'organisation. Créer plusieurs projets pour les différents parties. Activer les watchs. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des EJB (session et entity beans, annotations JAX-RS, [[Swagger]]). L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl, [[Swagger]] UI, jmeter, .... Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et consommateur) et exécuter certaines requêtes avec des garanties transactionnelles. Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]] pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, Oracle, HSQL ...) (non répliquée)
# Mise en place de 2 containers base de données (MySQL, Oracle, HSQL ...) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion asynchrone et transactionnelle de l'envoi des courriels via [[JMS]] et des EJBTimer (voir http://ecom.ow2.org/xwiki/bin/view/Main/fremail)
** Gestion asynchrone et transactionnelle de l'envoi de SMS via [[JMS]] et des EJBTimer ([[ECOM/SMSProviders|fournisseurs SMS]])

* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec [[Apache Jackrabbit]]
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Suivi du ''click stream'' avec des Filters en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Intégration de [[Memcached]]
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST.
** Utilisation de services tiers via leurs APIs (voir le catalogue de [[Mashape]])
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Gestion d'un ''cloud'' privé avec [[OpenStack]] avec [[Fuel]]
** Gestion d'un [[CaaS]] Docker privé avec [[Kubernete]] ou [[Docker Swarm]]
** Conditionnement de l'application mobile avec [[Apache Cordova]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers ([[AxiMAG]] par exemple).

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google)
* Performances (résultat du injection de charge avec [[Apache JMeter]], [[Gatling]], OW2 CLIF, BlazeMeter.com) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Supervision des VMs du système déployé avec un de ces systèmes : [[Telegraf]] + [[InfluxDB]] + [[Grafana]].
* Script "basique" pour le Rolling update (Blue-Green Deployment) des composants (applications et intergiciels).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom (utiliser [https://hub.docker.com/_/glassfish/ Glassfish]).
* Préparation d'images [[Docker]]
* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[CoreOS]] ou [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits
===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [https://glassfish.java.net/docs/4.0/administration-guide.pdf Guide d'administration de Glassfish 4]
* [http://docs.oracle.com/javaee/7/tutorial/doc/ Tutorial JavaEE 7 ] ([https://svn.java.net/svn/javaeetutorial~svn/ sources des exemples])
* [http://docs.oracle.com/javaee/7/api/ API JavaEE 7]
* [https://java.net/projects/javaee-spec/pages/Home Java EE Platform Specification]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* [[Bootstrap]]

===Quelques livres et technologies===

REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* [http://www.apress.com/9781430246268 Antonio Goncalves, Beginning JavaEE 7, APress, 2013], ([https://github.com/agoncal/agoncal-book-javaee7 examples] pour [[Glassfish]] 4)
* [https://www.packtpub.com/application-development/java-ee-7-developer-handbook Peter A. Pilgrim, Java EE 7 Developer Handbook, Packt, 2013, ISBN 139781849687942 ]
* [http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book Mick Knutson, Java EE6 Cookbook for securing, tuning, and extending enterprise applications, Packt Publishing, June 2012]
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* [http://www.manning.com/panda2/ Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, March 2014, ISBN: 9781935182993], ([http://www.manning.com/panda2/EJB3iA_2E_SourceCode.zip source code of examples])
* [http://shop.oreilly.com/product/9780596158033.do Andrew Lee Rubinger, Bill Burke, Enterprise JavaBeans 3.1, 6th Edition, O'Reilly Media, Final Release Date: September 2010, Pages]
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[AngularJS]]====
* Brad Green, Shyam Seshadri, AngularJS, Pub OReilly http://shop.oreilly.com/product/0636920028055.do ([https://github.com/shyamseshadri/angularjs-book source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2017-12-12T09:18:40Z

Sybille.Caffiau: /* Soutenance de fin de projet */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* TR : Thomas Ropras (thomas.ropars@imag.fr)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système

==Groupes et sujets==
===Groupes eCOM-RICM 2017-2018===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 19/09 à 8h.
====Groupe 1 ====
*AMODRU-FAVIN Hugo
*CHAMBONNET Simon
*FU Qianqian
*GAMBRO Antoine
*RIVOAL Alice
[[ECOM RICM5 Groupe1 2017|Fiche de suivi]]

====Groupe 2 ====
*ALLARD Estelle
*COCHINHO Louis
*DELISE Antoine
*GUERRY Lucas
*ROCHER Lambert
[[ECOM RICM5 Groupe2 2017|Fiche de suivi]]

====Groupe 3 ====
*BECHER Hervé
*DALLE Oriane
*GEOURJON Anthony
*LACHARTRE Denis
*SAVARY Rémi
[[ECOM RICM5 Groupe3 2017|Fiche de suivi]]

====Groupe 4 ====
*BOISADAM Antoine
*DEREYMEZ Maxime
*LEMAIRE Timothée
*LESAGE Lucas
*ZENNOUCHE Douria
[[ECOM RICM5 Groupe4 2017|Fiche de suivi]]

====Groupe 5 ====
*BONHOURE Gilles
*FERNANDES DE ALMEIDA Héloïse
*MARCHAND Charles
*MOREAU Gwenaël
*VIAL-GRELIER Aymeric
*ZEGAOUI Taquyeddine (arrivée début octobre)
[[ECOM RICM5 Groupe5 2017|Fiche de suivi]]

====Groupe 6 ====
*AUBERTIN Alicia
*BROCHIER Aymeric
*NASSIK Ahmed Amine
*ODIEVRE Boris
*TURRIN Vincent
[[ECOM RICM5 Groupe6 2017|Fiche de suivi]]

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et TR).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 19/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2017.pdf|transparents]]), CM Outils de suivi de projet + JSP 3h00 [http://lig-membres.imag.fr/donsez/cours/http-ecom.pdf HTTP] & [[Media:RestfulServices.pdf|REST]] (DD) (F018)
* 19/09 15h45-18h30 : JavaEE [https://github.com/donsez/javaee7-angular-swagger-docker app JavaEE de démo] [http://lig-membres.imag.fr/donsez/cours/javaee-ejb.pdf Cours JavaEE EJB](DD) Install [[JavaEE]] ([[Docker]] et [[Wildfly]]) Tutoriel EJB, Tutoriel Servlet/JSP/[[REST]]/WS/Filter/Docker ([[https://github.com/donsez/javaee7-angular-swagger-docker|lien]]) et [[JHipster]] pour le groupe "Gestion de courses sportives" (F202, F204). Vous pouvez générer le boilerplate de votre application avec des générateurs tel que http://www.generjee.com/.

* 26/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P257)
* 26/09 15h45-18h30 : Travail en autonomie (F202, F204)

* 03/10 8h00-12h15 : Travail en autonomie (F201,202)
* 03/10 15h45-18h30 : Travail en autonomie (F202, F204)

* 10/10 8h00-12h15 : Audit 1 (F316) et travail en autonomie (F203)
* 10/10 15h45-18h30 : Tests de robustesse (charges) (DD) (F203)

* 17/10 8h00-12h15 : Travail en autonomie (F203, F217)
* 17/10 15h45-18h30 : Travail en autonomie (F202, F204)

* 24/10 8h00-12h15 : Travail en autonomie (F203, F217)
* 24/10 15h45-18h30 : Travail en autonomie (F202, F204)

* 07/11 8h00-12h15 : Soutenance 2 (F109) et travail en autonomie (F203)
* 07/11 15h45-18h30 : Test utilisateur (SC) (F116)

* 14/11 8h00-12h15 : Travail encadré (TR) (F216, F217)
* 14/11 15h45-18h30 : Travail en autonomie (F202, F204)

* 28/11 8h00-12h15 : Travail encadré (TR) (F216, F217)
* 28/11 15h45-18h30 : Travail en autonomie (F202, F204)

* 05/12 8h00-12h15 : Travail en autonomie (F202, F204)
* 05/12 15h45-18h30 : Travail encadré (TR) (F216, F217)

* 12/12 8h00-12h15 : Travail encadré (TR) (F216, F217)

* 19/12 8h00-12h15 : Soutenances finales (F201, F217)
* 19/12 15h45-18h30 : Soutenances finales (F201, F212)

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie JEE.
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]], le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 10 octobre 2017
* audit 2 (conception) : le 07 novembre 2017
* soutenance de fin de projet le 19 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.

===Soutenance 1 ===
*Salle : F316
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- groupe 6

- groupe 3

- groupe 1

- groupe 2

- groupe 4

- groupe 5

''''' Contenu :'''''

Pour la partie GL
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Soutenance 2 ===
*Salle : F109
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL : point sur
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Choix technologiques

Pour la partie Système
* Architecture systeme du service
* Nombre de Beans (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 : 8h

- groupe 1 : 8h30

- groupe 5 : 9h

- groupe 2 : 9h45

- groupe 4 : 10h15

- groupe 3 : 10h45

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle :
* Durée totale : 30 min
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''
- 8h : groupe 1
- 8h35 : groupe 3
- 9h10 : groupe 5
- 15h45 : groupe 4
- 16h20 : groupe 6
- 16h55 : groupe 2

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 30 minutes par soutenance pour : votre présentation et les questions. Au bout de 15 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et TR pour demande d'accord du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Deux rapports doivent être rédigés pour la partie Système : un document de conception système et un document d'évaluation système. Ces documents doivent être accessibles depuis le wiki (ils peuvent même être directement édités sur le wiki).

Vous pouvez ajouter les livrables que vous jugez utiles pour présenter le travail que vous avez réalisé. Pour ces livrables : numérotez les

===Rendus===
Chaque livrable est numéroté (détails du livrable ci-dessous) LX, sous une forme à respecter. Certains ont une date de rendu à respecter. Ci-dessous le résumé de ces contraintes :
*L2 : 09/10 minuit : Wiki
*L3 : 09/10 minuit : Wiki
*L4 : 06/11 minuit : Wiki
*L5 : ?
*L6 : 06/11 minuit : Wiki
*L7 : 09/10 minuit : Wiki
*L8 : en continu : Wiki
*L9 : en continu : Wiki
*L10 : 18/12 minuit : Lien Git sur Wiki
*L11 : 18/12 minuit : Lien sur Wiki
*L12 : 19/12 lors du passage
*L13 : 18/12 minuit : Lien Git sur Wiki
*L14 : 18/12 minuit : Lien Git sur Wiki
*L15 : 08/11 lors du passage
*L16 : 19/12 lors du passage
*L17 : 19/12 lors du passage : Tableaux complétés et imprimés
*L18 : 10/10 lors du passage

===Contenu===
'''''L1. Composition des groupes et sujet'''''.
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation JEE : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement JEE. Un composant peut être implanté par un programme Java externe (client léger / client lourd JEE), par un servlet, par un bean ou par un objet POJO. Dans ces derniers cas, il faut préciser les caractéristiques des beans / POJO (local / distribué, session / évenementiel, stateful / stateless, etc). Un lien peut être implanté par une relation JEE, ou bien par conservation de référence de bean.

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (waffle ou autre)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Diapos de votre présentation de conception'''''.

'''''L16. Diapos de votre présentation finale'''''.

'''''L17. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à créer un wiki qui regroupera l'ensemble de vos documentations. Cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer une organisation github ou bitbucket. Ajouter les membres du projet eCOM à l'organisation. Créer plusieurs projets pour les différents parties. Activer les watchs. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des EJB (session et entity beans, annotations JAX-RS, [[Swagger]]). L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl, [[Swagger]] UI, jmeter, .... Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et consommateur) et exécuter certaines requêtes avec des garanties transactionnelles. Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]] pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, Oracle, HSQL ...) (non répliquée)
# Mise en place de 2 containers base de données (MySQL, Oracle, HSQL ...) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion asynchrone et transactionnelle de l'envoi des courriels via [[JMS]] et des EJBTimer (voir http://ecom.ow2.org/xwiki/bin/view/Main/fremail)
** Gestion asynchrone et transactionnelle de l'envoi de SMS via [[JMS]] et des EJBTimer ([[ECOM/SMSProviders|fournisseurs SMS]])

* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec [[Apache Jackrabbit]]
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Suivi du ''click stream'' avec des Filters en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Intégration de [[Memcached]]
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST.
** Utilisation de services tiers via leurs APIs (voir le catalogue de [[Mashape]])
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Gestion d'un ''cloud'' privé avec [[OpenStack]] avec [[Fuel]]
** Gestion d'un [[CaaS]] Docker privé avec [[Kubernete]] ou [[Docker Swarm]]
** Conditionnement de l'application mobile avec [[Apache Cordova]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers ([[AxiMAG]] par exemple).

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google)
* Performances (résultat du injection de charge avec [[Apache JMeter]], [[Gatling]], OW2 CLIF, BlazeMeter.com) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Supervision des VMs du système déployé avec un de ces systèmes : [[Telegraf]] + [[InfluxDB]] + [[Grafana]].
* Script "basique" pour le Rolling update (Blue-Green Deployment) des composants (applications et intergiciels).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom (utiliser [https://hub.docker.com/_/glassfish/ Glassfish]).
* Préparation d'images [[Docker]]
* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[CoreOS]] ou [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits
===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [https://glassfish.java.net/docs/4.0/administration-guide.pdf Guide d'administration de Glassfish 4]
* [http://docs.oracle.com/javaee/7/tutorial/doc/ Tutorial JavaEE 7 ] ([https://svn.java.net/svn/javaeetutorial~svn/ sources des exemples])
* [http://docs.oracle.com/javaee/7/api/ API JavaEE 7]
* [https://java.net/projects/javaee-spec/pages/Home Java EE Platform Specification]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* [[Bootstrap]]

===Quelques livres et technologies===

REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* [http://www.apress.com/9781430246268 Antonio Goncalves, Beginning JavaEE 7, APress, 2013], ([https://github.com/agoncal/agoncal-book-javaee7 examples] pour [[Glassfish]] 4)
* [https://www.packtpub.com/application-development/java-ee-7-developer-handbook Peter A. Pilgrim, Java EE 7 Developer Handbook, Packt, 2013, ISBN 139781849687942 ]
* [http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book Mick Knutson, Java EE6 Cookbook for securing, tuning, and extending enterprise applications, Packt Publishing, June 2012]
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* [http://www.manning.com/panda2/ Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, March 2014, ISBN: 9781935182993], ([http://www.manning.com/panda2/EJB3iA_2E_SourceCode.zip source code of examples])
* [http://shop.oreilly.com/product/9780596158033.do Andrew Lee Rubinger, Bill Burke, Enterprise JavaBeans 3.1, 6th Edition, O'Reilly Media, Final Release Date: September 2010, Pages]
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[AngularJS]]====
* Brad Green, Shyam Seshadri, AngularJS, Pub OReilly http://shop.oreilly.com/product/0636920028055.do ([https://github.com/shyamseshadri/angularjs-book source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-M2PGI

2017-11-10T09:05:14Z

Sybille.Caffiau: /* M2PGI (Classique) */

Le projet eCOM consiste à concevoir et développer une application de commerce électronique. [[ECOM|suite ...]]

=Étapes du projet=
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Le projet se conclut par une soutenance finale pour chaque partie (IHM et système).

==Conduite de projet==
Le projet eCOM est très court en durée. Il est préconisé d'utiliser la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe.

===Critères d'évaluation===
La conduite du projet sera principalement évaluée en fonction des critères suivants :
* vous devez choisir un Scrum Master (unique ou tournant) : vous devez justifier votre choix
* durée du sprint (idem : vous devez justifier votre choix)
Sur ces 2 premiers critères, vous n'en changez pas !!!

Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à créer un wiki qui regroupera l'ensemble de vos documentations. Cela doit être une documentation Agile !!!!

Un point de bonus pour ceux qui réussiront à mettre en place des "poker planning".
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

==Partie IHM==

===Etapes et documents demandés===
Le détail sur l'organisation et l'évaluation du travail concernant les spécifications du site sera communiqué lors des premières séances de cours. Liste des Livrables et date de rendu pour les M2PGI Alternants :

* Livrable 1 : par email, membres du groupe et brève description du sujet (un seul groupe OK)

====[[Audit 1 :]]====
* L2.1 : Description des profils
* L2.2 : Questionnaire profils (OPT-ALT)
* L3.1 : Scénarios
* L3.2 : Analyse de la concurrence (OPT-ALT)
* L3.3 : Questionnaire sur l'utilisation (OPT-ALT)
* L4 : Modèles de tâches (Audit 2 pour ALT)
* L5 : Fonctionnalités
* L6.1 : Objectifs pour chaque version (priorités de développement)

====[[Audit 2 :]]====
* Mise à jour de L2 à L6.1
* L7.1 : Architecture (OPT-ALT)
* L7.2 : Base de données (OPT-ALT)
* L7.3 : IHM Abstraite
* L7.4 : Maquettes
* L6.2 : Objectifs pour les versions suivantes
* L8 : Démo de V0

====[[Audit 3 (Soutenances) :]]====
* Mise à jour de L7.3 (correction des erreurs)
* L9 : Rapport d'évaluation experte (imprimé pour la soutenance)
* L10 : Démonstration finale
* L11 : Diapos de votre présentation (version numérique à laquelle l'enseignant a accès au moment de votre passage)

OPT signifie que le livrable est optionnel soit parce qu'il ne s'applique pas à tous les groupes, soit parce qu'il ne peut qu'apporter une plus value à votre projet (points en plus mais pas en moins au moment de l'attribution de la note).
Lorsque ce n'est pas précisé, c'est à vous de choisir le mode présentation (écrit, schéma...) des informations du livrable

===Critères d'évaluation===
La partie IHM du projet sera principalement évaluée en fonction des critères suivants :
* Conformité de l'IHM concrète et abstraite avec le modèle de tâches
* Couverture fonctionnelle de l'application et robustesse au regard des priorités que vous avez retenues
* Qualité ergonomique au regard des principes vus en cours
* Rigueur de la démarche

La note est obtenue par l'évaluation tout au long du projet elle est composée de :
* Les besoins (3 pts) : informations sur les besoins que vous allez prendre en compte (livrables et audit 1)
* La conception (5 pts) : proposition de solution pour répondre aux besoins (livrables et audit 2)
* L'évaluation (3 pts) : évaluation de votre (ou vos) solution(s) (livrable et soutenance finale)
* Présentations (3 pts) : qualité des présentations (documents, email et slides de soutenance finale)
* Développement (6 pts) : qualité et quantité du code (démo et code)

Les notes des membres du groupe peuvent être différentes en fonction du travail fourni et constaté par l'enseignant.

==Partie Système==
La partie Système est axée sur deux étapes successives.
===Première étape===
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des EJB (session et entity beans).

Il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants. Il est également recommandé de limiter le premier prototype à un sous-ensemble des spécifications fonctionnelles, à la fois assez vaste pour couvrir les principales difficultés techniques et assez léger pour respecter les délais imposés.

À ce stade, l'application est seulement accessible par l'intermédiaire d'un "client lourd" (programme java offrant une console en mode texte). En particulier, il n'est pas demandé, pour cette première étape, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux interfaces (administrateur et consommateur) et exécuter les requêtes avec des garanties transactionnelles.

Une présentation/démonstration du prototype V1 sera réalisée à la fin de l'étape n°1.
===Deuxième étape===
La seconde étape consiste à compléter le premier prototype avec les objectifs suivants :
* ajout des beans nécessaires pour couvrir l'ensemble des spécifications fonctionnelles ;
* développement d'une interface Web basée sur le modèle MVC ;
* rédaction des documents demandés (voir ci-dessous) ;
* modification de la configuration de déploiement : (1) client (lourd/léger) distant, (2) base de données externe (MySQL, Oracle, HSQL ...) et éventuellement distante ;
* ajout éventuel de fonctionnalités non prioritaires.

Une présentation d'une mini-maquette d'interface web aura lieu au milieu de l'étape n°2.

Remarque : Aucune des phases du projet ne nécessite le développement d'un client lourd en mode graphique (SWT ...).
===Documents demandés===
Deux rapports doivent être rédigés pour la partie Système : un document de conception système et un document d'évaluation système.

====Document de conception système====
Le dossier de conception système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation JEE : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement JEE. Un composant peut être implanté par un programme Java externe (client léger / client lourd JEE), par un servlet, par un bean ou par un objet POJO. Dans ces derniers cas, il faut préciser les caractéristiques des beans / POJO (local / distribué, session / évenementiel, stateful / stateless, etc). Un lien peut être implanté par une relation JEE, ou bien par conservation de référence de bean.

====Document d'évaluation système====

Le rapport final système du projet ECOM a pour but de préciser l’état d’avancement de votre application ECOM.

Le rapport final système doit préciser :
* L’état de chaque composant : non réalisé, réalisé, réalisé et validé
* Les fonctions réalisées, réalisées et testées, et celles restant à réaliser
* Les propriétés non fonctionnelles garanties par votre réalisation, et celles restant à considérer pour finaliser votre application
* Le temps consacré à la conception système
* Le temps consacré au développement système
* Les principales difficultés rencontrées
===Critères d'évaluation===
La partie système du projet sera principalement évaluée en fonction des critères suivants :
* Conformité aux spécifications de l'application et aux consignes données dans le cadre du projet
* Respect des échéances pour les différentes étapes du projet (y compris pour les prototypes intermédiaires et les documents)
* Qualité de l'architecture de l'application
* Qualité et robustesse du code applicatif
* Compréhension des principaux concepts de la technologie JEE
* Rigueur de la démarche de conception
* Qualité des présentations/soutenances
En complément, les aspects suivants seront également considérés :
* Méthodologie de test
* Déploiement et retrait de l'application sur/de la plateforme cloud (Azure) avec [http://roboconf.net/ Roboconf] ([http://roboconf.net/en/user-guide/lamp-example-part-1.html voir l'exemple avec LAMP])
* Préparation d'images de VMs avec [[Kameleon]]
* Performances (résultat du injection de charge avec [[Apache JMeter]] ou OW2 CLIF)
* Supervision du système déployé avec des sondes [[Nagios]] ou [[Shinken]] conditionnées dans les VMs à déployer.
* Utilisation (optionnelle) de technologies/APIs/frameworks avancés

==Consignes pour la soutenance==
===Consignes spécifiques pour les soutenances IHM===
Durée totale : 20 minutes
* tous les livrables doivent être consultable par l'enseignant (en ligne ou ayant été préalablement envoyés)
* votre passage doit contenir une présentation globale du projet, le processus de conception (illustré), des évaluations, le bilan (point de vue IHM) et une démo PRÉPARÉE
* arrivez avec l'application démarée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* prévoyez 5 minutes de questions lors de votre passage

Ordre de passage (27/09)
* 11h15 : Pokemon
* 11h40 : Bungalow
* 12h05 : Pizza
* 12h30 : Hotel

===Consignes spécifiques pour les soutenances Système===
* Apportez un exemplaire du dossier d'évaluation système (déposé la veille sur Moodle) lors de la soutenance. Il n'est pas nécessaire d'apporter un exemplaire du dossier de conception système.
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure avec le service développé.
* Prévovez environ 30 minutes pour la présentation/démo/questions. Utilisez des transparents pour présenter votre projet.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances Windows Azure.
* Conditionnez le projet final sous la forme d’une archive (zip ou tar.gz) après avoir inclus la documentation (dans un repertoire /main/site). Utilisez la convention de nommage suivante : ecom_final_1213-X.zip où X correspond au nom du projet.
* Déposez immédiatement après la soutenance (et en aucun cas après le 20 décembre) l'archive sur Moodle.
* le rapport de charge (benchmark) doit être (MUST) fourni dans la documentation.
* le rapport sur les métriques logicielles doit être (MUST) fourni dans la documentation.

=Organisation 2017-2018=

==Planning==
===M2PGI (Alternant)===
'''Equipe pédagogique:''' Noël de Palma (NdP), Vincent Lesne (VL), Sybille Caffiau (SC), Sebastien Chassand-Barrioz (SCB), Ibrahim Safiedinne (FR)

'''Dates Importantes:'''
*Soutenances (IHM + système) : 9h-17h, le 27 septembre
*Remise du dossier de conception système : le 27 septembre (lors de votre passage)
*Remise du dossier d'évaluation système : le 27 septembre (lors de votre passage)

*01 sept 09h-12h F022, F319, Boot Projet/ JEE (NDP)
*01 sept 14h-17h F319, Boot Projet/ JEE (NDP)
*04 sept 09h-12h F118, cours Agile (VL)
*04 sept 14h-17h F118, cours IHM (SC)
*05 sept 09h-12h F118, cours angular (SCB) (+TP F217)
*05 sept 14h-17h F118, cours angular (SCB) (+TP F217)
*06 sept 09h-12h F118, cours Agile (VL)
*06 sept 14h-17h F217, point Syst. (NDP)
*07 sept 09h-12h Libre service
*07 sept 14h-17h F118, cours Cloud (IS)
*08 sept 09h-12h F201, Point Syst. (SCB)
*08 sept 14h-17h F201, audit agile (VL)
*11 sept 09h-12h Libre service
*11 sept 14h-17h F217, point Syst. (IS)
*12 sept 09h-12h Libre Service
*12 sept 14h-17h Libre Service
*13 sept 09h-12h Libre Service
*13 sept 14h-17h F217, point Syst. (NDP)
*14 sept 09h-12h Libre Service
*14 sept 14h-17h Libre Service
*15 sept 09h-12h F214, point Syst. (SCB)
*15 sept 14h-17h F201, audit agile (VL)
*18 sept 09h-12h Libre Service
*18 sept 14h-17h F211, point Syst. (IS/NDP)
*19 sept 09h-12h Libre Service
*19 sept 14h-17h Libre Service
*20 sept 09h-12h F217 point Syst (IS)
*20 sept 14h-17h Libre Service
*21 sept 09h-12h Libre Service
*21 sept 14h-17h Libre Service
*22 sept 09h-12h Libre Service
*22 sept 14h-17h F211, point Syst. (SCB) + audit agile (VL)
*27 sept 09h-12h Soutenances
*27 sept 14h-17h Soutenances

===M2PGI (Classique)===
'''Equipe pédagogique:''' Noël de Palma (NdP), Vincent Lesne (VL), Sybille Caffiau (SC), Sebastien Chassand-Barrioz (SCB), Ibrahim Safiedinne (FR)

'''Dates Importantes:'''
Vendredi 29 sept. : Début des cours

* 29 sept 9h-12h F114, Boot Projet/ JEE (NDP)
* 29 sept 14h-17h F319, point systeme (NDP)
* 06 oct 09h-12h F114, cours Agile (VL)
* 06 oct 14h-17h F319, cours IHM (SC)
* 13 oct 9h-12h F215, cours Cloud (IS)
* 13 oct 14h-17h F319, cours angular (SCB) +(TP F204)
* 20 oct 9h-12h TP F215, point systeme (NDP) et TD F114 audit Agile (VL)
* 20 oct 14h-17h TD F319/TP F204, cours angular (SCB)
* 27 oct 9h-12h TP F215/TD F114, point système (SCB, NDP)
* 27 oct 14h-17h TD F204, cours Agile (VL)
* 10 nov 9h-12h TD F114 audit2 Agile (VL)
* 10 nov 14h-17h TP F204/TD F319 point système (SCB, IS)
* 17 nov 9h-12h TP F215/TD F114 point système (SCB, NDP).
* 17 nov 14h-17 TDF319 cours ergonomie des IHM + Libre service (TP F204)
* 24 nov 9h-12h TP F215/TD F114, Libre service
* 24 nov 14h-17h TP F204/TD F319 Point système Cl&Alt (IS).
* 01 dec 9h-12h Libre Service
* 01 dec 14h-17h TP F204/TD 319 point systeme (SCB, IS, NDP)
* 08 dec 9h-12h Libre Service
* 08 dec 14-17h TP F204 audit Agile (VL) et point système (IS)
* 15 dec 9h-12h TP F215/TD F114 libre service
* 15 dec 14h-17h TP F204/TD F319 point system (SCB)
* 18 dec-22 dec semaine bloquée libre service

Le 22/12 soutenances tte la journée F215/F216

==Groupes==
===M2PGI Apprenti===

===M2PGI Classique===
Consigne pour la constitution des groupes : Les étudiants ayant choisis l'option multimobile doivent se mettre ensemble. Ils doivent constituer des groupes de 4/5 afin d'avoir en tout 4 groupes (de M2 PGI classiques)

==Soutenance==
===M2PGI Apprenti===

===M2PGI Classique===

IMPERATIF
* le projet doit être (MUST) géré selon la méthode Scrum : le Scrum Master devra présenter le déroulement du projet.
* le serveur JavaEE doit être (MUST) hébergé sur une instance de VM.
* un rapport de charge (benchmark) doit être (MUST) fourni : les outils JMeter ou Clif peuvent être utilisés.
* un rapport sur les métriques logicielles doit être (MUST) fourni : l'outil Sonar peut être utilisé.

'''Ordre de passage :'''
* Respectez l'ordre établi
* Faites attention au temps. Vous disposez de 45 minutes par soutenance pour : votre présentation, la démo et les questions

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Squelette du projet==
[http://dl.dropbox.com/u/66952950/ecom-maven.zip ecom-maven.zip] Inaccessible

==Doc utiles==
* [http://wiki.easybeans.org/xwiki/bin/view/Main/Documentation Documentation Easybeans (conteneur EJB3 utilisé par Jonas)]
* [http://docs.oracle.com/javaee/6/tutorial/doc/ Tutorial JavaEE 6 ]
* [http://netbeans.org/kb/67/javaee/ejb30.html Tutorial NetBean et JEE ]
* [http://docs.oracle.com/javaee/6/api/ API JavaEE 6]
* [https://java.net/projects/javaee-spec/pages/Home Spécifications JavaEE 6]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* [http://jonas.ow2.org/JONAS_5_1_2/doc/doc-en/html/getting_started_guide.html#id1316973 Glossaire]
* [http://www.easybeans.net/xwiki/bin/download/Main/Documentation/ejb3-annotations.pdf Aide mémoire pour les annotations EJB3 ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* Questionnaire pour site web : [[Media:Questionnaire copy.pdf]]
* Questionnaire SUS (évaluation satisfaction) : [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]

===Quelques livres===
REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
* Java EE6 Cookbook for securing, tuning, and extending enterprise applications: http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* Debu Panda, Reza Rahman, Derek Lane, EJB 3 in Action, Pub Mannings, 2007, http://www.manning.com/panda/
* Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, Pub Mannings, 2011, http://www.manning.com/panda2/

ECOM RICM5 Groupe3 2017

2017-11-07T10:09:32Z

Sybille.Caffiau: /* Sprint 11 : du 28 Novembre au 5 Décembre (prévisions) */

Cette page wiki a pour but de détailler l'avancement du travail sur le projet eCOM du groupe 3 de la promotion 2017-2018 de RICM.
Le projet eCOM a pour but de développer une application de commerce en ligne par groupe de 5 étudiants. Il regroupe une partie Système ainsi qu'une partie IHM qui seront toutes les deux détaillées sur cette page.

=Résumé du projet=

Notre projet de eCOM s'appelle ''MySpectacle''. Le but est de mettre en oeuvre un site internet servant à réserver en ligne des places de spectacle. Notre site doit proposer toute une panoplie de spectacles que l'utilisateur doit pouvoir trier en fonction de ce qu'il souhaite voir, du lieu, de la date...

[https://github.com/ECOM-MySpectacle Organisation github du projet]

=L'équipe=

Pour mener à bien ce projet l'équipe est composée de :

*BECHER Hervé : Développeur (Spécialité sécurité)
*DALLE Oriane : Scrum Master
*GEOURJON Anthony : Chef de projet, Lead Developer (Spécialiste [[OpenShift]], [[Docker]]).
*LACHARTRE Denis : Développeur Frontend (JSP, Twitter Bootstrap)
*SAVARY Rémi : Développeur ([[JavaEE]], [[Wildfly]])

=Ressources =

*L2 : [[Media:DCS_Myspectacle.pdf | DCS‎]]
*L9 : [[ECOM RICM5 Groupe3 2017 Journal|Planning]]
*L18 : [[Media:Soutenance_10_Octobre_MySpectacle.pdf | Slide audit 1]]

=Les tâches prioritaires =

Voici les tâches que nous souhaitons implementer en premier lieux :

*Permettre à l'utilisateur de consulter toutes les offres de spectacle
*Permettre à l'utilisateur de réaliser une recherche large (avec une seule contrainte)
*Permettre à l'utilisateur de réaliser une recherche affinée (avec plusieurs paramètres)
*Permettre à l'utilisateur de connaître le nombre de places restantes pour le spectacle
*Permettre à l'utilisateur de connaître le nombre de places restantes dans les différentes zones de la salle
*Permettre à l'utilisateur de gérer son panier (Ajouter des places et/ou en enlever)
*Permettre à l'utilisateur de payer en ligne
*Permettre à l'utilisateur de choisir son mode de récupération des billets

=Partie IHM=

Cette partie a pour but de décrire l'aspect de l'application web, elle détaillera l'approche utilisée afin de développer notre interface. On y trouvera pour qui elle est développée, dans quel but et dans quel contexte.

==Les utilisateurs visés==

*[https://docs.google.com/forms/d/e/1FAIpQLSdZej9hLfvwITRwdplvJAMUJKID21N54CgXEBFlnxc5Bh2SiQ/viewform Lien vers notre questionnaire ]

*L3 : [[media:Réponse_sondage_myspectacle.pdf | Toutes les réponses au sondage]]

== Analyse des données ==

Ici nous allons reprendre les point du sondages qui nous ont parut intéressant pour le projet

===Fréquence de commande de billet ===

[[File: Ecom_Frequence_Myspectacle.png‎ |500px]]

Une grande partie des utilisateur ne commande que peu souvent de billet en ligne. Ce fait montre que l'utilisateur ne va pas venir régulièrement passer des commande en ligne, il n'y aura donc pas d'apprentissage au fur et à mesure des utilisations. Il faut donc que notre interface soit fluide et intuitive.

===Plateformes utilisés ===

[[File: Ecom_plateforme.png‎‎ |500px]]

On voit très clairement que les utilisateurs préfère utiliser leur ordinateur que d'autres plateformes pour passer des commande de billet en ligne.

===Temps passé sur un site de billetterie en ligne ===

[[File: Ecom_temps_myspectacle.png |500px]]

La aussi on voit très clairement que les utilisateurs passent le moins de temps possible pour passer leur commande. Cela peut provenir du fait qu'ils savent déjà quel spectacle ils souhaitent aller voir. Il faut donc encore une fois que notre interface de recherche soit clair et efficace pour permettre aux utilisateurs de trouver leur bonheur au plus vite.
Pour les utilisateurs qui souhaitent prendre plus de temps pour chercher un spectacle il faut aussi leurs laisser une possibilité de recherche plus large.

===Point essentiel d'un site de billetterie en ligne ===

[[File: Ecom_preference_myspectacle.png |500px]]

Enfin on voit sur ces résultats que les utilisateurs attendent beaucoup de l'interface de recherche ainsi que de la possibilité de modifier leur commande et payer en ligne. Ils sont moins intéresser par les propositions de spectacles à venir.

== Analyse de l'existant ==

Afin de mieux appréhender l'interface utilisateur de notre application nous avons regardé ce que font les sites existants actuels. Dans un premier temps nous avons fait une analyse site par site afin d'y identifier les differences. Nous sommes arrivés à la conclusion qu'ils sont tous articuler de la même manière. Nous allons faire un résumé des points relevés :

*La page d'accueil met en avant les spectacles en cours. On y retrouve différentes catégories comme ''Coup de cœur'', ''Top vente'' ou encore ''Actualité'', ''A ne pas manquer''
*On retrouve sur chaque page d'accueil une bar de recherche (''plus ou moins élaboré'') ainsi qu'une bar permettant de choisir une catégorie, les categories peuvent être le type de spectacle ou le type d’événement.
**Les bars de recherches peuvent être simple, comme un moteur de recherche, et l'ajout de filtre se fait par la suite
**On peut aussi trouver directement un encadré permettant de faire une recherche détaillée dès la page d'accueil

==Arbre de tâches==
[[File:Arbre_de_tache_Myspectacle.jpg|800px|center|thumb|Arbre de tâches]]

==Cas d'utilisation==

Voici les différents cas d'utilisation au quel nous avons pensés

[[File:Ecom-ricm5-g3-2017-use-case-search.png|800px|center|thumb|Recherche]]
[[File:Ecom-ricm5-g3-2017-use-case-booking.png|800px|center|thumb|Réservation et paiement]]
[[File:Ecom-ricm5-g3-2017-use-case-basket.png|800px|center|thumb|Gestion du panier]]

==Maquette==

Nous avons réalisés les maquettes des différentes pages du sites que nous allons développé

L4 :
{|style="margin: 0 auto;"
|[[File:Maquette1_myspectacle.jpg|200px|thumb|Maquette de la page d'accueil]]
|[[File:Maquette2_myspectacle.jpg|200px|thumb|Maquette de la page de recherche]]
|[[File:Maquette3_myspectacle.jpg|200px|thumb|Maquette de la page spectacle]]
|[[File:Maquette4_myspectacle.jpg|200px|thumb|Maquette du panier]]
|[[File:Maquette5_myspectacle.png|200px|thumb|Maquette des billets déjà payés]]
|[[File:Maquette6_myspectacle.png|200px|thumb|Maquette de la page de connexion]]
|}

=Partie système=

Cette partie aura pour but de détaillé notre avancé d'un point de vue technique et d'exposer les technologies utilisés. On y trouvera aussi l'architecture du projet et les problèmes rencontrés.

==Architecture du projet==

[[File:ricm5-g3-2017-archi.png|800px|center|thumb|Architecture]]

=SCRUM=

Cette partie à pour but de presenter le travail effectué chaque semaine par l'équipe

==Sprint 1 : du 19 septembre au 25 Septembre ==

*Découverte du sujet
*Définition des rôles
*Rédaction des différentes tâches à réaliser
*Brainstorming autour des technologies à utiliser durant le projet
*Liste de tâches à effectuer

===Rétrospective Sprint 1 ===

Nous avons pris connaissance du sujet et des attentes du site. Nous avons fais un brainstorming et les idées retenus ont été validés par tout le monde. Le brainstorming à aussi permis de mettre plusieurs idées pour d’éventuelles extensions. Nous avons pu mesurer l'ampleur du travail à réaliser et des technologies à maîtriser puis utiliser.

==Sprint 2 : du 26 septembre au 3 Octobre ==

*Commencement de la redaction du Dossier de Conception Système (DCS)
*Préparation d'un questionnaire d'évaluation des besoins
*Réalisation d'un arbre de tâches
*Début de mise en place de l'architecture du projet
*Réalisation de l’architecture de la base de données
*Création d'un diagramme de cas d'utilisation
*Début d'analyse de l'existant

===Rétrospective sprint 2 ===

Bonne répartition des tâches, chacun à su faire sa part de travail. Globalement le travail à bien avancé sauf le DCS qui s'est révélé plus complexe et long que prévue à rédiger.

==Sprint 3 : du 4 Octobre au 9 Octobre ==

*Finition du diagramme de cas d'utilisation
*Elaboration du Dossier de Conception Système (DCS)
*Analyse du questionnaire
*Analyse de l'existant
*Préparation de la première présentation

===Rétrospective sprint 3 ===

L’analyse du questionnaire nous a permis de bien comprendre les attentes des utilisateurs et d'affiner nos idées sur le fonctionnement du site. Grâce à cela nous avons pu bien avancer la partie conception.

==Sprint 4 : du 10 Octobre au 16 Octobre ==

*Réunion de groupe post-soutenance
*Définition d'un planning détaillé pour le client
*Définition claire des rôles pour la suite du développement -> séparation en un binôme front-end, un autre back-end et un développeur plus autonome qui gérera le déploiement et l'administration des outils tout en aidant les binômes si besoin
*Choix d'une charte graphique pour le front-end
*Essai de mise en place l’intégration continue
*Réalisation des schémas système (''architecture et diagramme de classe'')

===Rétrospective sprint 4 ===

Avec la soutenance, ce sprint à été moins intense avec notamment beaucoup d'autoformation et la fin de la conception.

==Sprint 5 : du 17 Octobre au 23 Octobre ==

*Premier embryon d'application fonctionnelle
*Génération squelette projet avec Generjee
*Front-end
**Page d’accueil
**Réalisation d’éléments fixes de l'IHM (header, navbar, footer)

===Rétrospective sprint 5 ===

Generjee a été un peu difficile à prendre en main. Il y a vraiment peu de documentation. Le code généré est un peu obscure car il y a énormément de classes et les liens entre elles sont parfois peu évidents.

==Sprint 6 : du 24 Octobre au 30 Octobre ==

*Back-end
**Développement des fonctions d'insertions de l'API
**Insertions du jeu de données dans le système
*Formation AngularJS
*Déploiement continu
**Intégration circleci https://circleci.com/gh/ECOM-MySpectacle
**Hébergement dockerfile :
**Déploiement AWS
https://github.com/ECOM-MySpectacle/docker-MySpectacle

https://hub.docker.com/r/geourjoa/docker-myspectacle/

===Rétrospective sprint 6===

Le déploiement continu à connu divers retard lié à des problèmes sur AWS et le manque de doc sur Circle CI

==Sprint 7 : du 31 Octobre au 6 Novembre (Prévisions) ==

*Soutenance 2
**Préparation soutenance
**Slides
*Back-end
** A définir, la gestion de panier étant passé du coté du font-end
*Front-end
**Gestion panier
**Première version du front-end

==Sprint 8 : du 7 Novembre au 13 Novembre (prévisions) ==

*Soutenance 2
**Discussion post-soutenance et
*Back-end
**Réservation spectacle fonctionnels
**Ecriture des tests unitaires
*Front-end
**IHM de recherche et de sélection de spectacle
**Correction de l'IHM en fonction des retours de la soutenance

==Sprint 9 : du 14 Novembre au 20 Novembre (prévisions) ==

*Mise en place du serveur de mail
*Développement des fonctions liées au mail
*Tests fonctionnels
*Front-end
**version 2

==Sprint 10 : du 21 Novembre au 28 Novembre (prévisions) ==

*Back-end
**Paiement à la banque fonctionnelle
**Génération et envoi des mails fonctionnels

==Sprint 12 : du 28 Novembre au 5 Décembre (prévisions) ==

*Mise en place du proxy HAProxy
*Mise en place d'outils de monitoring
**Grafana
**InfluxDB
**Telegraph

==Sprint 13 : du 6 Décembre au 12 Décembre (prévisions) ==

==Sprint 14 : du 12 Décembre au 19 Décembre (prévisions) ==

*Soutenance finale
**Préparation soutenance
**Slides

ECOM-1FO

2017-11-07T08:40:22Z

Sybille.Caffiau: /* Contenu */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* TR : Thomas Ropras (thomas.ropars@imag.fr)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système

==Groupes et sujets==
===Groupes eCOM-RICM 2017-2018===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 19/09 à 8h.
====Groupe 1 ====
*AMODRU-FAVIN Hugo
*CHAMBONNET Simon
*FU Qianqian
*GAMBRO Antoine
*RIVOAL Alice
[[ECOM RICM5 Groupe1 2017|Fiche de suivi]]

====Groupe 2 ====
*ALLARD Estelle
*COCHINHO Louis
*DELISE Antoine
*GUERRY Lucas
*ROCHER Lambert
[[ECOM RICM5 Groupe2 2017|Fiche de suivi]]

====Groupe 3 ====
*BECHER Hervé
*DALLE Oriane
*GEOURJON Anthony
*LACHARTRE Denis
*SAVARY Rémi
[[ECOM RICM5 Groupe3 2017|Fiche de suivi]]

====Groupe 4 ====
*BOISADAM Antoine
*DEREYMEZ Maxime
*LEMAIRE Timothée
*LESAGE Lucas
*ZENNOUCHE Douria
[[ECOM RICM5 Groupe4 2017|Fiche de suivi]]

====Groupe 5 ====
*BONHOURE Gilles
*FERNANDES DE ALMEIDA Héloïse
*MARCHAND Charles
*MOREAU Gwenaël
*VIAL-GRELIER Aymeric
*ZEGAOUI Taquyeddine (arrivée début octobre)
[[ECOM RICM5 Groupe5 2017|Fiche de suivi]]

====Groupe 6 ====
*AUBERTIN Alicia
*BROCHIER Aymeric
*NASSIK Ahmed Amine
*ODIEVRE Boris
*TURRIN Vincent
[[ECOM RICM5 Groupe6 2017|Fiche de suivi]]

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et TR).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 19/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2017.pdf|transparents]]), CM Outils de suivi de projet + JSP 3h00 [http://lig-membres.imag.fr/donsez/cours/http-ecom.pdf HTTP] & [[Media:RestfulServices.pdf|REST]] (DD) (F018)
* 19/09 15h45-18h30 : JavaEE [https://github.com/donsez/javaee7-angular-swagger-docker app JavaEE de démo] [http://lig-membres.imag.fr/donsez/cours/javaee-ejb.pdf Cours JavaEE EJB](DD) Install [[JavaEE]] ([[Docker]] et [[Wildfly]]) Tutoriel EJB, Tutoriel Servlet/JSP/[[REST]]/WS/Filter/Docker ([[https://github.com/donsez/javaee7-angular-swagger-docker|lien]]) et [[JHipster]] pour le groupe "Gestion de courses sportives" (F202, F204). Vous pouvez générer le boilerplate de votre application avec des générateurs tel que http://www.generjee.com/.

* 26/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P257)
* 26/09 15h45-18h30 : Travail en autonomie (F202, F204)

* 03/10 8h00-12h15 : Travail en autonomie (F201,202)
* 03/10 15h45-18h30 : Travail en autonomie (F202, F204)

* 10/10 8h00-12h15 : Audit 1 (F316) et travail en autonomie (F203)
* 10/10 15h45-18h30 : Tests de robustesse (charges) (DD) (F203)

* 17/10 8h00-12h15 : Travail en autonomie (F203, F217)
* 17/10 15h45-18h30 : Travail en autonomie (F202, F204)

* 24/10 8h00-12h15 : Travail en autonomie (F203, F217)
* 24/10 15h45-18h30 : Travail en autonomie (F202, F204)

* 07/11 8h00-12h15 : Soutenance 2 (F109) et travail en autonomie (F203)
* 07/11 15h45-18h30 : Test utilisateur (SC) (F116)

* 14/11 8h00-12h15 : Travail encadré (TR) (F216, F217)
* 14/11 15h45-18h30 : Travail en autonomie (F202, F204)

* 28/11 8h00-12h15 : Travail encadré (TR) (F216, F217)
* 28/11 15h45-18h30 : Travail en autonomie (F202, F204)

* 05/12 8h00-12h15 : Travail en autonomie (F202, F204)
* 05/12 15h45-18h30 : Travail encadré (TR) (F216, F217)

* 12/12 8h00-12h15 : Travail encadré (TR) (F216, F217)

* 19/12 8h00-12h15 : Soutenances finales (F201, F217)
* 19/12 15h45-18h30 : Soutenances finales (F201, F212)

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie JEE.
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]], le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 10 octobre 2017
* audit 2 (conception) : le 07 novembre 2017
* soutenance de fin de projet le 19 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.

===Soutenance 1 ===
*Salle : F316
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- groupe 6

- groupe 3

- groupe 1

- groupe 2

- groupe 4

- groupe 5

''''' Contenu :'''''

Pour la partie GL
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Soutenance 2 ===
*Salle : F109
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL : point sur
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Choix technologiques

Pour la partie Système
* Architecture systeme du service
* Nombre de Beans (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 : 8h

- groupe 1 : 8h30

- groupe 5 : 9h

- groupe 2 : 9h45

- groupe 4 : 10h15

- groupe 3 : 10h45

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle :
* Durée totale :
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 35 minutes par soutenance pour : votre présentation et les questions. Au bout de 20 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et TR pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Deux rapports doivent être rédigés pour la partie Système : un document de conception système et un document d'évaluation système. Ces documents doivent être accessibles depuis le wiki (ils peuvent même être directement édités sur le wiki).

Vous pouvez ajouter les livrables que vous jugez utiles pour présenter le travail que vous avez réalisé. Pour ces livrables : numérotez les

===Rendus===
Chaque livrable est numéroté (détails du livrable ci-dessous) LX, sous une forme à respecter. Certains ont une date de rendu à respecter. Ci-dessous le résumé de ces contraintes :
*L2 : 09/10 minuit : Wiki
*L3 : 09/10 minuit : Wiki
*L4 : 06/11 minuit : Wiki
*L5 : ?
*L6 : 06/11 minuit : Wiki
*L7 : 09/10 minuit : Wiki
*L8 : en continu : Wiki
*L9 : en continu : Wiki
*L10 : 18/12 minuit : Lien Git sur Wiki
*L11 : 18/12 minuit : Lien sur Wiki
*L12 : 19/12 lors du passage
*L13 : 18/12 minuit : Lien Git sur Wiki
*L14 : 18/12 minuit : Lien Git sur Wiki
*L15 : 08/11 lors du passage
*L16 : 19/12 lors du passage
*L17 : 19/12 lors du passage : Tableaux complétés et imprimés
*L18 : 10/10 lors du passage

===Contenu===
'''''L1. Composition des groupes et sujet'''''.
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation JEE : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement JEE. Un composant peut être implanté par un programme Java externe (client léger / client lourd JEE), par un servlet, par un bean ou par un objet POJO. Dans ces derniers cas, il faut préciser les caractéristiques des beans / POJO (local / distribué, session / évenementiel, stateful / stateless, etc). Un lien peut être implanté par une relation JEE, ou bien par conservation de référence de bean.

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (waffle ou autre)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)
Le journal doit être nominatif. Chaque membre de projet doit gérer son propre journal. Il fera l'objet d'une évaluation personnelle.

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L9).

'''''L15. Diapos de votre présentation de conception'''''.

'''''L16. Diapos de votre présentation finale'''''.

'''''L17. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à créer un wiki qui regroupera l'ensemble de vos documentations. Cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer une organisation github ou bitbucket. Ajouter les membres du projet eCOM à l'organisation. Créer plusieurs projets pour les différents parties. Activer les watchs. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des EJB (session et entity beans, annotations JAX-RS, [[Swagger]]). L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl, [[Swagger]] UI, jmeter, .... Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et consommateur) et exécuter certaines requêtes avec des garanties transactionnelles. Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]] pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, Oracle, HSQL ...) (non répliquée)
# Mise en place de 2 containers base de données (MySQL, Oracle, HSQL ...) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion asynchrone et transactionnelle de l'envoi des courriels via [[JMS]] et des EJBTimer (voir http://ecom.ow2.org/xwiki/bin/view/Main/fremail)
** Gestion asynchrone et transactionnelle de l'envoi de SMS via [[JMS]] et des EJBTimer ([[ECOM/SMSProviders|fournisseurs SMS]])

* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec [[Apache Jackrabbit]]
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Suivi du ''click stream'' avec des Filters en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Intégration de [[Memcached]]
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST.
** Utilisation de services tiers via leurs APIs (voir le catalogue de [[Mashape]])
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Gestion d'un ''cloud'' privé avec [[OpenStack]] avec [[Fuel]]
** Gestion d'un [[CaaS]] Docker privé avec [[Kubernete]] ou [[Docker Swarm]]
** Conditionnement de l'application mobile avec [[Apache Cordova]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers ([[AxiMAG]] par exemple).

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google)
* Performances (résultat du injection de charge avec [[Apache JMeter]], [[Gatling]], OW2 CLIF, BlazeMeter.com) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Supervision des VMs du système déployé avec un de ces systèmes : [[Telegraf]] + [[InfluxDB]] + [[Grafana]].
* Script "basique" pour le Rolling update (Blue-Green Deployment) des composants (applications et intergiciels).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom (utiliser [https://hub.docker.com/_/glassfish/ Glassfish]).
* Préparation d'images [[Docker]]
* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[CoreOS]] ou [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits
===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [https://glassfish.java.net/docs/4.0/administration-guide.pdf Guide d'administration de Glassfish 4]
* [http://docs.oracle.com/javaee/7/tutorial/doc/ Tutorial JavaEE 7 ] ([https://svn.java.net/svn/javaeetutorial~svn/ sources des exemples])
* [http://docs.oracle.com/javaee/7/api/ API JavaEE 7]
* [https://java.net/projects/javaee-spec/pages/Home Java EE Platform Specification]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* [[Bootstrap]]

===Quelques livres et technologies===

REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* [http://www.apress.com/9781430246268 Antonio Goncalves, Beginning JavaEE 7, APress, 2013], ([https://github.com/agoncal/agoncal-book-javaee7 examples] pour [[Glassfish]] 4)
* [https://www.packtpub.com/application-development/java-ee-7-developer-handbook Peter A. Pilgrim, Java EE 7 Developer Handbook, Packt, 2013, ISBN 139781849687942 ]
* [http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book Mick Knutson, Java EE6 Cookbook for securing, tuning, and extending enterprise applications, Packt Publishing, June 2012]
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* [http://www.manning.com/panda2/ Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, March 2014, ISBN: 9781935182993], ([http://www.manning.com/panda2/EJB3iA_2E_SourceCode.zip source code of examples])
* [http://shop.oreilly.com/product/9780596158033.do Andrew Lee Rubinger, Bill Burke, Enterprise JavaBeans 3.1, 6th Edition, O'Reilly Media, Final Release Date: September 2010, Pages]
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[AngularJS]]====
* Brad Green, Shyam Seshadri, AngularJS, Pub OReilly http://shop.oreilly.com/product/0636920028055.do ([https://github.com/shyamseshadri/angularjs-book source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

ECOM-1FO

2017-11-03T05:00:55Z

Sybille.Caffiau: /* Soutenances */

Le projet eCOM consiste à concevoir et développer une application d’échange en ligne (commerce électronique, échanges de services…). [[ECOM|suite ...]]

=Organisation=
==Aide à la lecture du document==
===Acronymes===
'''Les enseignants :'''
* DD : Didier Donsez (didier.donsez@imag.fr)
* SC : Sybille Caffiau (sybille.caffiau@imag.fr)
* TR : Thomas Ropras (thomas.ropars@imag.fr)
'''Les réalisations :'''
* DCS : Dossier de Conception Système
* SAS : Schéma d'Architecture Système

==Groupes et sujets==
===Groupes eCOM-RICM 2017-2018===
Les groupes sont imposés par les enseignants et seront donnés lors de la première séance. Ils ne seront définitifs que le mardi 19/09 à 8h.
====Groupe 1 ====
*AMODRU-FAVIN Hugo
*CHAMBONNET Simon
*FU Qianqian
*GAMBRO Antoine
*RIVOAL Alice
[[ECOM RICM5 Groupe1 2017|Fiche de suivi]]

====Groupe 2 ====
*ALLARD Estelle
*COCHINHO Louis
*DELISE Antoine
*GUERRY Lucas
*ROCHER Lambert
[[ECOM RICM5 Groupe2 2017|Fiche de suivi]]

====Groupe 3 ====
*BECHER Hervé
*DALLE Oriane
*GEOURJON Anthony
*LACHARTRE Denis
*SAVARY Rémi
[[ECOM RICM5 Groupe3 2017|Fiche de suivi]]

====Groupe 4 ====
*BOISADAM Antoine
*DEREYMEZ Maxime
*LEMAIRE Timothée
*LESAGE Lucas
*ZENNOUCHE Douria
[[ECOM RICM5 Groupe4 2017|Fiche de suivi]]

====Groupe 5 ====
*BONHOURE Gilles
*FERNANDES DE ALMEIDA Héloïse
*MARCHAND Charles
*MOREAU Gwenaël
*VIAL-GRELIER Aymeric
*ZEGAOUI Taquyeddine (arrivée début octobre)
[[ECOM RICM5 Groupe5 2017|Fiche de suivi]]

====Groupe 6 ====
*AUBERTIN Alicia
*BROCHIER Aymeric
*NASSIK Ahmed Amine
*ODIEVRE Boris
*TURRIN Vincent
[[ECOM RICM5 Groupe6 2017|Fiche de suivi]]

===Groupes eCOM-RICM Années précédentes===
* [[Groupes eCOM-RICM 2015-2016]]
* [[Groupes eCOM-RICM 2014-2015]]

==Planning des séances==
La partie IHM et la partie Système sont menées en parallèle pendant toute la durée du projet. Pendant toutes les séances vous travaillerez en groupe, il est donc obligatoire pour tous les étudiants d'être présents à toutes les séances. Celles-ci sont composées :
* du cours (CM)
* du travail encadré (TD) : séance pendant lequel l'enseignant vous accompagnera pour la réalisation d'une étape de votre projet
* du travail en autonomie : séance réservée au travail d'ECOM pendant laquelle vous travaillez entre étudiants
* de permanences : séances pendant lesquelles vous pouvez demander l'aide d'un enseignant pour vous aidez à avancer. Ces séances sont également l'occasion pour vos enseignants de faire le point avec vous sur votre avancé, vous devez donc IMPERATIVEMENT signaler votre lieu de travail si vous n'êtes pas dans les salles prévues par ADE (par email à SC et TR).

An cas d’incohérence de planning avec ADE ; suivre ADE.
* 19/09 8h00-12h15 : Introduction 1h00(DD+SC) ([[Media:presentationEcomSeance1-2017.pdf|transparents]]), CM Outils de suivi de projet + JSP 3h00 [http://lig-membres.imag.fr/donsez/cours/http-ecom.pdf HTTP] & [[Media:RestfulServices.pdf|REST]] (DD) (F018)
* 19/09 15h45-18h30 : JavaEE [https://github.com/donsez/javaee7-angular-swagger-docker app JavaEE de démo] [http://lig-membres.imag.fr/donsez/cours/javaee-ejb.pdf Cours JavaEE EJB](DD) Install [[JavaEE]] ([[Docker]] et [[Wildfly]]) Tutoriel EJB, Tutoriel Servlet/JSP/[[REST]]/WS/Filter/Docker ([[https://github.com/donsez/javaee7-angular-swagger-docker|lien]]) et [[JHipster]] pour le groupe "Gestion de courses sportives" (F202, F204). Vous pouvez générer le boilerplate de votre application avec des générateurs tel que http://www.generjee.com/.

* 26/09 8h00-12h15 : Des scénarios aux spécifications IHM (SC) (P257)
* 26/09 15h45-18h30 : Travail en autonomie (F202, F204)

* 03/10 8h00-12h15 : Travail en autonomie (F201,202)
* 03/10 15h45-18h30 : Travail en autonomie (F202, F204)

* 10/10 8h00-12h15 : Audit 1 (F316) et travail en autonomie (F203)
* 10/10 15h45-18h30 : Tests de robustesse (charges) (DD) (F203)

* 17/10 8h00-12h15 : Travail en autonomie (F203, F217)
* 17/10 15h45-18h30 : Travail en autonomie (F202, F204)

* 24/10 8h00-12h15 : Travail en autonomie (F203, F217)
* 24/10 15h45-18h30 : Travail en autonomie (F202, F204)

* 07/11 8h00-12h15 : Soutenance 2 (F109) et travail en autonomie (F203)
* 07/11 15h45-18h30 : Test utilisateur (SC) (F116)

* 14/11 8h00-12h15 : Travail encadré (TR) (F216, F217)
* 14/11 15h45-18h30 : Travail en autonomie (F202, F204)

* 28/11 8h00-12h15 : Travail encadré (TR) (F216, F217)
* 28/11 15h45-18h30 : Travail en autonomie (F202, F204)

* 05/12 8h00-12h15 : Travail en autonomie (F202, F204)
* 05/12 15h45-18h30 : Travail encadré (TR) (F216, F217)

* 12/12 8h00-12h15 : Travail encadré (TR) (F216, F217)

* 19/12 8h00-12h15 : Soutenances finales (F201, F217)
* 19/12 15h45-18h30 : Soutenances finales (F201, F212)

==Modalités d’évaluation==
La note d’ECOM est obtenue par l’addition de notes obtenues tout au long de la réalisation du projet, elle peut être différente pour chaque membre du groupe en fonction du travail fourni et constaté par les enseignants. Attention : elle repose sur la '''qualité''' du travail fourni autant que sur la quantité.
*présentation soutenance conception (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*présentation soutenance finale (3 pts) : note affectée sur la présentation (qualité des slides, discours...), les réponses aux questions
*conception (5 pts) : note obtenue à partir des livrables de conception, de la prise en compte des remarques faites par les enseignants pendant la soutenance de conception, du travail fourni (et observé) et du contenu de la soutenance de conception
*développement (5 pts) : note obtenue à partir de la qualité et quantité du code réalisé, la démo de la soutenance finale. En particulier, seront observés, la qualité de l'architecture de l'application, la qualité et robustesse du code et la mise en place des principaux concepts de la technologie JEE.
*suivi de projet (4 pts) : cette note est obtenue par rapport aux livrables (qualité, livraison dans les délais...), la mise en place et bonne utilisation des outils collaboratifs, l'intégration continue, [[Continuous Delivery|Livraison en continue]], le contenu de la soutenance finale

==Soutenances==

Trois soutenances sont prévues (2 audits et 1 soutenance finale) :
* audit 1 (exigences, besoins client) : le 10 octobre 2017
* audit 2 (conception) : le 07 novembre 2017
* soutenance de fin de projet le 19 Décembre 2017
Dans les trois cas, les soutenances doivent présenter les parties GL, Système et IHM.

===Soutenance 1 ===
*Salle : F316
*Durée totale : 30 min par groupe (max 20 minutes de présentation et ensuite les questions des enseignants représentant les clients)
*Utilisez des transparents pour présenter votre projet.

* ordre de passage :

- groupe 6

- groupe 3

- groupe 1

- groupe 2

- groupe 4

- groupe 5

''''' Contenu :'''''

Pour la partie GL
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (envisagé)
* Choix technologiques

Besoins pour clients, avec en particulier (mais non exhaustive) :
* Résultats de l’analyse de l’existant
* Utilisateurs cibles, contexte d’utilisation et objectifs utilisateurs (ie objectifs de l’IHM)

===Soutenance 2 ===
*Salle : F109
*Durée totale : 25 min
*Utilisez des transparents pour présenter votre projet.

Vous devez présenter les étapes de conception réalisées et les résultats (choix techniques…). De plus, nous vous rappelons que pour le dimanche minuit, vous devez avoir rendu accessibles les livrables.

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''

Pour la partie GL : point sur
* Organisation de l'équipe (roles, ...)
* Méthodologie de travail
* Planning (modifications par rapport à ce que vous aviez prévu jusqu'à maintenant et le planning futur)
* Choix technologiques

Pour la partie Système
* Architecture systeme du service
* Nombre de Beans (diagramme de classe, type, ...)
* Extensions réalisées et envisagées
* Etat d'avancement dans les développements

Pour la partie IHM
* Maquettes et squelette du site (pour la plateforme cible)
* Charte graphique

Une démonstration (rapide) de votre application telle qu'elle est (v0 ou v1 en fonction des groupes)

'''''Ordre de passage :'''''

- groupe 6 : 8h

- groupe 1 : 8h30

- groupe 5 : 9h

- groupe 2 : 9h45

- groupe 4 : 10h15

- groupe 3 : 10h45

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 25 minutes par soutenance pour : votre présentation et les questions.
Vous devrez gérer le temps. Les remarques (d’amélioration) qui seront faites pendant cette soutenance par les enseignants devront être prises en compte pour la version finale (pris en compte dans la note finale).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC et DD pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

===Soutenance de fin de projet ===

* Salle :
* Durée totale :
* Utilisez des transparents pour présenter votre projet. Lors de votre passage vous devez présenter une démo PRÉPARÉE.

Arrivez avec l'application démarrée (on ne perd pas de temps) et 1 ou 2 scénarios (de test)
* Préparez vous 30 minutes avant votre soutenance pour démarrer les instances Windows Azure (ou autre plateforme de Cloud de votre choix) avec le service développé.
* Les démonstrations peuvent être faites sur vos machines personnelles cependant le service eCOM doit IMPERATIVEMENT s'exécuter sur une ou plusieurs instances de machines virtuelles sur le Cloud de votre choix
* Vous devez avoir tous les documents demandés (accessibles en ligne et/ou imprimés)
* Vous devez fournir au début de votre passage les fiches d'auto-évaluation complétées (version papier)

'''''Contenu attendu dans votre présentation( à avoir au minimum dans vos slides) :'''''
* une présentation globale du projet
* le processus de conception (illustré)
* la démonstration de votre application
* des évaluations
* le bilan (pédagogique ET du projet/individuel ET groupe)
* le temps consacré à la conception
* le temps consacré au développement
* les principales difficultés rencontrées

'''''Ordre de passage :'''''

Respectez l'ordre établi.
Faites attention au temps. Vous disposez de 35 minutes par soutenance pour : votre présentation et les questions. Au bout de 20 minutes de présentation vous serez interrompus pour être interrogés.
Les questions peuvent être posées nominativement (c'est à dire que la personne qui doit répondre est désignée par l'enseignant).

ATTENTION : Si vous voulez modifier l'un des plannings, vous devez :
* trouver un autre groupe avec qui échanger
* vous assurer que tous les membres de ce groupe acceptent l'échange
* envoyer un mail à SC, DD et TR pour informer du changement (avec le chef de projet de l'autre groupe en copie)
Les modifications ne sont acceptées que jusqu'au dimanche précédent la soutenance.

==Livrables==
Deux rapports doivent être rédigés pour la partie Système : un document de conception système et un document d'évaluation système. Ces documents doivent être accessibles depuis le wiki (ils peuvent même être directement édités sur le wiki).

Vous pouvez ajouter les livrables que vous jugez utiles pour présenter le travail que vous avez réalisé. Pour ces livrables : numérotez les

===Rendus===
Chaque livrable est numéroté (détails du livrable ci-dessous) LX, sous une forme à respecter. Certains ont une date de rendu à respecter. Ci-dessous le résumé de ces contraintes :
*L2 : 09/10 minuit : Wiki
*L3 : 09/10 minuit : Wiki
*L4 : 06/11 minuit : Wiki
*L5 : ?
*L6 : 06/11 minuit : Wiki
*L7 : 09/10 minuit : Wiki
*L8 : en continu : Wiki
*L9 : en continu : Wiki
*L10 : 18/12 minuit : Lien Git sur Wiki
*L11 : 18/12 minuit : Lien sur Wiki
*L12 : 19/12 lors du passage
*L13 : 18/12 minuit : Lien Git sur Wiki
*L14 : 18/12 minuit : Lien Git sur Wiki
*L15 : 08/11 lors du passage
*L16 : 19/12 lors du passage
*L17 : 19/12 lors du passage : Tableaux complétés et imprimés
*L18 : 10/10 lors du passage

===Contenu===
'''''L1. Composition des groupes et sujet'''''.
Le sujet doit être validé par vos enseignants dès le premier jour du projet. Envoyez une description dans un corps de mail à DD et SC. Cette description doit contenir :
* les membres du projet
* le nom du chef de projet
* le nom du scrum master
* les rôles envisagés par chaque membre
* le titre du sujet
un paragraphe descriptif du sujet dans lequel est particulièrement explicité l'adéquation du sujet et les requis (quelques lignes)

'''''L2. Dossier de conception Système'''''.
Le Dossier de Conception Système (DCS) a pour but de permettre à toute personne de connaitre les principaux composants JEE de votre application ECOM. Cette connaissance doit pouvoir être acquise rapidement, sans avoir à entrer dans les détails de l'implémentation. Le DCS doit donc être de taille relativement limitée (5 à 10 pages, 20 pages au grand maximum).
Le DCS est centré sur un schéma d'architecture système (SAS). Pour chaque composant et lien du SAS, le DCS doit fournir :
* Une description fonctionnelle : La description fonctionnelle d'un composant fait apparaître les attributs qui le composent, ainsi que les méthodes qu'il fournit. Attributs et méthodes seront associés à une courte description. Les besoins liées à la persistence ou aux aspects transactionnels peuvent également être explicités.
* Une description d'implantation JEE : La description d'implantation décrit l'implantation du composant ou du lien dans l'environnement JEE. Un composant peut être implanté par un programme Java externe (client léger / client lourd JEE), par un servlet, par un bean ou par un objet POJO. Dans ces derniers cas, il faut préciser les caractéristiques des beans / POJO (local / distribué, session / évenementiel, stateful / stateless, etc). Un lien peut être implanté par une relation JEE, ou bien par conservation de référence de bean.

Le dossier de conception système doit être disponibles depuis votre page wiki.

'''''L3. Analyse des besoins'''''.
Questionnaire et son analyse pour définir les besoins utilisateurs que doit satisfaire votre application.

'''''L4.Maquette'''''.

'''''L5.SRS'''''.

'''''L6.Diagramme UML'''''.

'''''L7.Modèle de tâches'''''.

'''''L8.Scrum (waffle ou autre)'''''.
*(Ils peuvent si vous le souhaiter être directement édités sur le wiki)
* Le rapport de charge (benchmark) doit être (MUST) disponible sur le wiki.
* Le rapport sur les métriques logicielles doit être (MUST) disponible sur le wiki.

'''''L9.Journal'''''.
Détaillez l'affectation des taches effectuées ainsi le temps estimé et le temps effectif pour chaque tache et son état (Réalisée, Reportée, Abandonnée, ...)

'''''L10.Dépôt Git'''''.
Votre code source doit être accessible en ligne avec un lien depuis votre fiche de suivi sur le wiki.

'''''L11.Application en ligne'''''.

'''''L12. Evaluation de l'IHM réalisée'''''.
cf cours IHM [[Media:Cours2015-2016RICM.pdf]]

Evaluation utilisateur : [[media:System-Usability-ScaleLogicielComplet.pdf]]
et/ou
experte : [[media:EvalEfficacite.pdf]], [[Media:Annexe1-HeuristiqueNielsen.pdf]]

'''''L13. Evaluation de la qualité du projet'''''.
* Nombre de lignes de code (outil CLOC à minima)
* Métriques de qualité du code ([http://www.sonarqube.org/ SonarQute], ...)

'''''L14. Evaluation économique du projet'''''.
* Utilisez les temps effectifs des taches renseignées dans le journal.
* Utilisez le coût du travail d'un ingénieur débutant.
* Comparez votre coût à l'évaluation [[COCOMO]] de votre projet (utiliser les valeurs de L13).

'''''L15. Diapos de votre présentation de conception'''''.

'''''L16. Diapos de votre présentation finale'''''.

'''''L17. Auto evaluation'''''.
Système : [[Media:FicheEval20162017-ECOM.doc]]

'''''L18. Diapos de votre présentation client'''''.

=Réalisations attendues=
==Conduite et suivi de projet==
Le projet eCOM est très court en durée. Vous utiliserez la méthodologie [[Scrum]] pour la conduite du projet dans chaque groupe. Vous pouvez vous inspirer de la méthode [[Lean Startup]] pour livrer rapidement votre application. Vous devez choisir un Scrum Master (unique ou tournant) : justifiez votre choix et la durée du sprint (justifiez votre choix).
Vous devez prévoir :
* product backlog
* sprint backlog
* sprint planning
* démos
* rétrospectives

Pensez à créer un wiki qui regroupera l'ensemble de vos documentations. Cela doit être une documentation Agile !!!!

(May) mettre en place des "poker planning"
[[File:20121002 141359.jpg|center|400px|PokerPlanningECOM2013]]

Ces 2 premiers critères sont fixes !!!

Selon les principes de la méthodologie Agile, vous devez composer votre travail en fonctionnalités. Chacune fera l’objet d’une conception (système et IHM) et d’un développement. Conception ET développement constituent l’ensemble des réalisations attendues.

==Réalisations système==
===Conception système===
La conception système est composée de deux réalisations principales :
le modèle de donnée : il est vivement conseillé de définir le modèle de données aussi tôt que possible et d"en discuter avec les enseignants.
le schéma d'architecture système (SAS) : ce schéma doit faire apparaître les composants qui vont constituer l'application, ainsi que les liens entre les beans. Un lien depuis un composant A vers un (ou plusieurs) composant(s) B signifie qu'une interaction peut avoir lieu depuis A vers B. Un lien peut être monovalué ou multivalué, monodirectionnel ou multidirectionnel.

===Développement système===
Pour chaque fonctionnalités conçues, le développement système sera réalisé en deux étapes.
====Les étapes====
Etape 0 :
Créer une organisation github ou bitbucket. Ajouter les membres du projet eCOM à l'organisation. Créer plusieurs projets pour les différents parties. Activer les watchs. Ajouter les webhooks utiles.

Etape 1 :
La première consiste à définir le cœur de l'application, c'est-à-dire le modèle de données et la logique métier, puis à réaliser un premier prototype qui démontre une bonne maîtrise des EJB (session et entity beans, annotations JAX-RS, [[Swagger]]). L'application RESTful est seulement accessible par l'intermédiaire de clients type cUrl, [[Swagger]] UI, jmeter, .... Il n'est pas demandé, de réaliser une interface web pour interagir avec l'application. L'application doit cependant offrir deux modes d’utilisation (administrateur et consommateur) et exécuter certaines requêtes avec des garanties transactionnelles. Votre machine virtuelle doit être sécurisée (Security Group et/or [[UFW]] pour les ports exposés). Evitez de vous faire rançonner comme un binôme de la promo 2016-2017 (voir ci-dessous, la rançon d'une BD [[MongoDB]]).

<pre>
$ db.PLEASE_READ_ME.find()
{
"_id" : ObjectId("58a7287db7dc324adb249fdf"),
"info" : "Don't panic. Your DB is in safety and backed up (check logs).
To restore send 0.1 BTC and email with your server ip or domain name. Each 48 hours we erase all the data.",
"amount" : "0.1 BTC",
"data_we_have" : {
"local" : [ "startup_log" ],
"first_database" : [ "users", "preferences" ],
"MyAppXXX" : [ "emails" ]
},
"Bitcoin Address" : "1NSz9TRBGKHKFdjdjH2Gme3LwDi5",
"email" : "xxxxx@xxxx.org"
}
</pre>

Etape 2 :
La seconde étape consiste à compléter le premier prototype (étape 1) avec les objectifs suivants :
* Développement d'une interface Web basée sur le modèle MVC (SPA ou non) ;
* Modification de la configuration de déploiement pour la haute disponibilité (HA) :
# Mise en place d'un container base de données externe (MySQL, Oracle, HSQL ...) (non répliquée)
# Mise en place de 2 containers base de données (MySQL, Oracle, HSQL ...) en cluster ([http://assets.en.oreilly.com/1/event/2/MySQL%20Replication%20Tutorial%20Presentation%202.pdf réplication])
# Mise en place de 2 containers ''frontends'' load balancer [[HAProxy]] en mode SSL terminaison ([[HAProxy#Configuration_en_SSL_Terminaison|instructions]])
* Amélioration des fonctionnalités. En particulier, considérez les points suivants :
** Renseignement de la [[Privacy policy guidelines|notice relative à la protection de la vie privée]].
** Gestion de la concurrence et de la reprise sur panne avec des transactions ACID
** Gestion asynchrone et transactionnelle de l'envoi des courriels via [[JMS]] et des EJBTimer (voir http://ecom.ow2.org/xwiki/bin/view/Main/fremail)
** Gestion asynchrone et transactionnelle de l'envoi de SMS via [[JMS]] et des EJBTimer ([[ECOM/SMSProviders|fournisseurs SMS]])

* Ajout éventuel de fonctionnalités non prioritaires. De façon facultative, vous pourrez ajouter au prototype précédent quelques unes des fonctionnalités suivantes :
** Gestion de l'internationalisation (i18n) des applications web et mobiles. ''Remarque : vous pouvez utiliser les principes et outils appris dans l'UE Communication Langagière.''
** Gestion des contenus multimedia (photos, videos, docs ...) avec [[Apache Jackrabbit]]
** Stockage externalisé des contenus multimedia par des [[Content Delivery Network]]s ([[Amazon S3]], Azure, Akamaï ...)
** Suivi du ''click stream'' avec des Filters en vue d'une analyse ''[[Big Data]]'' avec [[Spark]] (''Click Analytics'', [https://github.com/pmerienne/iterative-cf Recommender System]).
** Intégration de [[Memcached]]
** Gestion rudimentaire d'une interface vocale avec un serveur vocal [[EA2012-Serveux Vocaux|VoiceXML]].
** Utilisation de [[OAuth2]] ou [[OpenID]] pour le login et l'accès aux API REST.
** Utilisation de services tiers via leurs APIs (voir le catalogue de [[Mashape]])
** Chat avec un opérateur du helpdesk (texte et/ou audio avec [[WebRTC]])
** Gestion d'un ''cloud'' privé avec [[OpenStack]] avec [[Fuel]]
** Gestion d'un [[CaaS]] Docker privé avec [[Kubernete]] ou [[Docker Swarm]]
** Conditionnement de l'application mobile avec [[Apache Cordova]]
** Traduction automatique et à la volée des champs des produits (nom, description, commentaires et avis) en fonction de la langue de l'usager, au moyen d'un service tiers ([[AxiMAG]] par exemple).

Remarque: certaines fonctionnalités sont assez indépendantes du noyau du projet : elles peuvent être mis en place dès le départ de l'étape 1.

====Le déploiement en continu====
Dès le démarrage, votre projet devra être géré selon les principes du ''[[DevOps]]'' : chaque version devra être déployé sur votre infrastructure de production en minimum de temps et sans interuption de services. Vous devez mettre en place des procédures de mise à jour des artifacts de l'application en mode rolling update et fast rollback ([http://martinfowler.com/bliki/BlueGreenDeployment.html lien]).

Remarques pour la mise en ligne :
NE COMMITEZ JAMAIS vos credentials Cloud (AWS, Azure, Google ...) DANS UN DEPOT PUBLIC !!!!!

Votre compte serait utilisé pour créer plusieurs centaines de VMs et vous serez lourdement facturés ([http://readwrite.com/2014/04/15/amazon-web-services-hack-bitcoin-miners-github bitcoins], DDoD, ...) !

Vous devez obligatoirement mettre en place les points suivants dès le démarrage du projet :
* Déploiement et retrait de l'application sur/de la plateforme cloud publique ou privée (UFR, Amazon, Azure, Google)
* Performances (résultat du injection de charge avec [[Apache JMeter]], [[Gatling]], OW2 CLIF, BlazeMeter.com) : Astuce: utiliser les images [[Docker]].
* Reprise sur panne simple et alerte des ''ops'' avec [[Monit]] (ie relance simple du serveur en cas de "plantage").
* Supervision des VMs du système déployé avec un de ces systèmes : [[Telegraf]] + [[InfluxDB]] + [[Grafana]].
* Script "basique" pour le Rolling update (Blue-Green Deployment) des composants (applications et intergiciels).
* Script "basique" pour le Fast forward (en cas de panne des composants dernièrement mis à jour).

Vous devez optionnellement mettre en place les points suivants:
* Déploiement avec [[Docker]] (dockerfile et docker-compose) pour l'application eCom (utiliser [https://hub.docker.com/_/glassfish/ Glassfish]).
* Préparation d'images [[Docker]]
* Injection de pannes avec [[Netflix Simian Army]]
* Déploiement de l'application eCOM distribuée sur plusieurs VM [[CoreOS]] ou [[Ubuntu Core]] avec [[Vagrant]] et VirtualBox, Azure, Amazon EC2, [[Google's Compute Engine]] ...
* Supervision des VMs du système déployé avec un de ces systèmes : [[Nagios]], [[Shinken]], [[Icinga]], [[Filter]]s, [[Tomcat Valve]]s, [[Glimpse]], [[Ganglia]], [[Elasticsearch]] + [[ElastAlert]], [[Hawkular]] ...
* Validation des services REST avec [[Swagger]]

==Réalisations IHM==
===Conception===
La conception de la partie IHM du projet sera principalement composée :
* Des modèles (tâches, IHMA)
* De la charte graphique
* De l'explication des choix de conception faits
===Développement===
Vous êtes libres des technologies à utiliser pour le développement de la partie IHM de l'application. Cependant, vous devez être capable de justifier vos choix. La partie IHM doit être distincte du noyau fonctionnel. Les codes de la partie présentation et du contenu de l'IHM doivent également être séparés. Veuillez aux noms que vous attribuerez. Les "zones" définies dans vos IHMA doivent être facilement identifiables dans le code que vous réalisez (ex : ID des DIV).

L'IHM des utilisateurs différents peut être gérée différemment. Par exemple, l'IHM de l'administrateur de l'application peut être une Interface en ligne de commande (pour l'initialisation du catalogue du service, l'ajout de nouveaux produits). Vous pouvez utiliser l'interface EJB facade directement ou bien une interface [[RESTful]] en utilisant directement [[Curl]]).

=Documentation=
==Transparents de cours==

* Cours JEE/EJB(NDP) [[Media:EJB-ECOM2010.pdf]]
* Cours JEE tiers presentation (SCB) : [https://dl.dropboxusercontent.com/u/9706615/JEE_tiers_presentation.pdf url]
* Cours GWT (SCB) : [https://dl.dropboxusercontent.com/u/9706615/cours_GWT.pdf url]
* Cours maven (DD) : [http://membres-liglab.imag.fr/donsez/cours/maven.pdf url]
* Cours versionning (DD) : [http://membres-liglab.imag.fr/donsez/cours/version.pdf url]
* Cours subversion (DD) : [http://membres-liglab.imag.fr/donsez/cours/subversion.pdf url]
* Cours forge (DD) : [http://membres-liglab.imag.fr/donsez/cours/forge.pdf url]
* Cours http (DD) : [http://membres-liglab.imag.fr/donsez/cours/http.pdf url]
* Cours servlet (DD) : [http://membres-liglab.imag.fr/donsez/cours/servletjsp.pdf url]
* Cours IHM (SC) : [[Media:ECOMCours2017-2018.pdf]]
* Annexe Cours IHM (SC) : [[Media:Annexe1-HeuristiqueNielsen.pdf]], [[Media:Annexe2-KMADe.pdf]], [[Media:Annexe3-Placement.pdf]], [[Media:Annnexe4-Accesssibilité.pdf]]

==Doc utiles==
* [http://lig-membres.imag.fr/donsez/cours/eaumlrel.pdf Transformation UML vers Relationnel]
* [https://glassfish.java.net/docs/4.0/administration-guide.pdf Guide d'administration de Glassfish 4]
* [http://docs.oracle.com/javaee/7/tutorial/doc/ Tutorial JavaEE 7 ] ([https://svn.java.net/svn/javaeetutorial~svn/ sources des exemples])
* [http://docs.oracle.com/javaee/7/api/ API JavaEE 7]
* [https://java.net/projects/javaee-spec/pages/Home Java EE Platform Specification]
* [http://www.theserverside.com/news/thread.tss?thread_id=55191 JPA implementation patterns ]
* Présentation sur le Cloud Computing : http://erods.liglab.fr/icar2013/programme.html
* Documentation et Training Kit sur Windows Azure : http://www.microsoft.com/en-us/download/details.aspx?id=8396
* Documentation de [http://roboconf.net/en Roboconf]
** Exemple avec LAMP http://roboconf.net/en/user-guide/lamp-example-part-1.html
http://proton.inrialpes.fr/~depalma/ecom/liens/liens.html
* [[Bootstrap]]

===Quelques livres et technologies===

REMARQUE: les livres sur JavaEE se periment très vite avec l'évolution de la spécification
====JavaEE====
* [http://shop.oreilly.com/product/0636920030614.do Arun Gupta, Java EE 7 Essentials, Enterprise Developer Handbook, O'Reilly Media, August 2013] ([https://github.com/javaee-samples/javaee7-samples + 200 exemples de projets Maven])
* [http://www.apress.com/9781430246268 Antonio Goncalves, Beginning JavaEE 7, APress, 2013], ([https://github.com/agoncal/agoncal-book-javaee7 examples] pour [[Glassfish]] 4)
* [https://www.packtpub.com/application-development/java-ee-7-developer-handbook Peter A. Pilgrim, Java EE 7 Developer Handbook, Packt, 2013, ISBN 139781849687942 ]
* [http://www.packtpub.com/java-ee6-securing-tuning-extending-enterprise-applications-cookbook/book Mick Knutson, Java EE6 Cookbook for securing, tuning, and extending enterprise applications, Packt Publishing, June 2012]
* Holly Cummins and Timothy Ward, Enterprise OSGi in Action, March, 2013, 400 pages, ISBN: 9781617290138, http://www.manning.com/cummins/ ([http://www.manning.com/cummins/EOSGI_sample_ch02.pdf chapitre 2], [http://www.manning.com/cummins/EOSGI_sample_ch10.pdf chapitre 10])
* [http://www.manning.com/panda2/ Debu Panda, Reza Rahman, Ryan Cuprak, and Michael Remijan, EJB 3 in Action, Second Edition, March 2014, ISBN: 9781935182993], ([http://www.manning.com/panda2/EJB3iA_2E_SourceCode.zip source code of examples])
* [http://shop.oreilly.com/product/9780596158033.do Andrew Lee Rubinger, Bill Burke, Enterprise JavaBeans 3.1, 6th Edition, O'Reilly Media, Final Release Date: September 2010, Pages]
* Building, Packaging, and Distributing Java EE Applications in 2017 https://dzone.com/articles/building-packaging-and-distributing-java-ee-apps-in-2017-part-2

====REST====
* The RESTful CookBook, How to do stuff RESTful, http://restcookbook.com
* [http://shop.oreilly.com/product/0636920028925.do Bill Burke, RESTful Java with JAX-RS 2.0, 2nd Edition, Designing and Developing Distributed Web Services, Publisher: O'Reilly Media, Final Release Date: November 2013] ([https://github.com/oreillymedia/restful_java_jax-rs_2_0 source code of examples])

===Web===
====[[Responsive Web Design]]====
* Matthew Carver, The Responsive Web, Manning, October 2014, ISBN: 9781617291241 http://www.manning.com/carver/ ([http://www.manning.com/carver/TRWSourceCode.zip source code])

====[[AngularJS]]====
* Brad Green, Shyam Seshadri, AngularJS, Pub OReilly http://shop.oreilly.com/product/0636920028055.do ([https://github.com/shyamseshadri/angularjs-book source code])

====[[Bootstrap]]====
* Jake Spurlock, Bootstrap, Responsive Web Development, Pub: O'Reilly Media, http://shop.oreilly.com/product/0636920027867.do ([https://github.com/whyisjake/Bootstrap source code])

====[[Ember]]====

====Tests unitaires====
* [[Selenium]]

====Intégration en Continue====
* [[Jenkins]]

====Continuous Delivery====
* https://continuousdelivery.com/

====Misc====
* Eric Ries, The [[Lean Startup]], http://theleanstartup.com/

====Questionnaires pour les sites web====
* [[Media:Questionnaire copy.pdf]]

====Evaluations des interfaces====
*[[Media:Evaluation Heuristiques Nielsen.pdf]]
* [http://blocnotes.iergo.fr/concevoir/les-outils/sus-pour-system-usability-scale/]
*[[Media:System-Usability-ScaleLogicielComplet.pdf]]

===Organisation===
* [[Trello]]
* [[Slack]]
* [[Waffle.io]]

File:ECOMCours2017-2018.pdf

2017-11-01T18:42:05Z

Sybille.Caffiau: Sybille.Caffiau uploaded a new version of "File:ECOMCours2017-2018.pdf"

File:Evaluation Heuristiques Nielsen.pdf

2017-11-01T18:34:20Z

Sybille.Caffiau: