README.md 2.81 KB
Newer Older
jeremy.gobet's avatar
jeremy.gobet committed
1
2
# Travail Pratique

3
**Ceci est le projet exemple** pour la réalisation du travail pratique (TP) et le dépôt Git de référence pour les étudiants. Il sera complété au fur et à mesure des notions enseignées pendant le cours.
jeremy.gobet's avatar
jeremy.gobet committed
4
5
6

## Informations pour les étudiants

7
**Le fork de ce repository doit contenir votre projet pour les cours qui sera évalué sur la partie frontend pour le cours Applications Web et la partie backend pour le cours Architectures Web. Pour la marche à suivre veuillez vour référer au document nommé STUDENTS.md**
jeremy.gobet's avatar
jeremy.gobet committed
8

9
10
11
les critère d'évaluations sont explicités ici: https://gitedu.hesge.ch/jeremy.gobet/app-et-archi-web

La suite contient la documentation du projet exemple que vous devez adapter et compléter pour le votre.
jeremy.gobet's avatar
jeremy.gobet committed
12
13
14
15
16

---

## Description du projet

17
Ce projet est une application Web permettant à l'utilisateur de consulter les blagues de Chuck Norris, de voter pour ses blagues préférées et de consulter les blagues les plus appréciées par la communauté.
jeremy.gobet's avatar
jeremy.gobet committed
18
19
20

### Réccupérer le projet

21
22
23
Le projet est disponible sur l'hébergement Git (gitedu.hesge.ch).

Cloner le projet localement avec la commande git suivante:
jeremy.gobet's avatar
jeremy.gobet committed
24
25
26
27
28
29
30
31

`git clone ssh://git@ssh.hesge.ch:10572/jeremy.gobet/app-et-archi-web-tp-2020.git`

### Structure

Le projet contiens deux dossiers:

- **frontend**: Contient le site public
32
- **backend**: Contient le serveur Node
jeremy.gobet's avatar
jeremy.gobet committed
33
34
35
36
37
38
39
40
41
42
43
44
45

### Démarrer le serveur

La partie public est servie par le serveur sur Node. Vous devez avoir Node installé sur votre machine pour démarrer cette application Web.

Accédez au dossier contenant le serveur Node

`cd backend/`

Installez les dépendances

`npm install`

jeremy.gobet's avatar
jeremy.gobet committed
46
Démarrez le serveur Node
jeremy.gobet's avatar
jeremy.gobet committed
47
48
49
50
51

`node server.js`

Vous pouvez ensuite visualisez le site en local sur un navigateur: **localhost:8080**

jeremy.gobet's avatar
jeremy.gobet committed
52
53
54
55
### Stopper le server

Pour stopper le serveur Node, utilisez la commande **CTRL + C**

jeremy.gobet's avatar
jeremy.gobet committed
56
57
58
59
60
61
62
63
### Architecture du projet

(à définir)

### Fonctionnalités

Voici la liste des fonctionnalités de l'Application Web:

64
65
66
67
68
- Réccupération des blagues sur l'API [api.icndb.com] (non-implémenté)
- Réccupération des dernières blagues publiées (non-implémenté)
- Like/Unlike des blagues (non-implémenté)
- Réccupération des blagues les plus appréciées par la communautée (non-implémenté)
- Réccupération des blagues appréciées par un utilisateur (non-implémenté)
jeremy.gobet's avatar
jeremy.gobet committed
69

70
L'application ne dispose pas d'une persistance de données. Une fois le serveur stoppé, toutes les données sont perdues.
jeremy.gobet's avatar
jeremy.gobet committed
71

72
Une authentification sans mot de passe permet l'identification de l'utilisateur via l'utilisation de son adresse e-mail.
jeremy.gobet's avatar
jeremy.gobet committed
73
74
75

### Contact

76
77
78
79
80
81
82
83
84
85
86
87
88
89
#### Assistant

- Identifiant: @michael.minelli
- Mail: michael.minelli@hesge.ch

#### Applications Web

- Identifiant: @jeremy.gobet
- Mail: jeremy.gobet@hesge.ch

#### Architectures Web

- Identifiant: @stephane.malandai
- Mail: stephane.malandain@hesge.ch