First comit
This commit is contained in:
Johan
151
README.md
Normal file
151
README.md
Normal file
@@ -0,0 +1,151 @@
|
||||
# TP - Videotheque
|
||||
|
||||
L'objectif est de mettre en pratique les concepts modernes d'Angular, notamment les **Signals**, pour construire une petite application de gestion de films.
|
||||
|
||||
Vous partirez d'une base de code existante qui inclut déjà toute la configuration de l'application et les services de communication avec les APIs (REST et GraphQL).
|
||||
|
||||
Votre mission sera de compléter la logique des composants pour rendre l'application fonctionnelle.
|
||||
|
||||
## Objectifs Pédagogiques
|
||||
|
||||
À la fin de ce TP, vous saurez :
|
||||
|
||||
1. **Consommer des Observables** et les transformer en **Signals** avec `toSignal`.
|
||||
2. Gérer l'état d'un composant (données, chargement, erreur) à l'aide d'un **Signal** unique.
|
||||
3. Utiliser des **Signals `computed`** pour dériver des données de l'état principal.
|
||||
4. Déclencher des appels asynchrones et gérer leurs cycles de vie avec `effect`.
|
||||
5. Interagir avec des services pour récupérer et envoyer des données.
|
||||
6. Utiliser la nouvelle syntaxe de template (`@if`, `@for`) pour afficher des données réactives.
|
||||
7. Mettre en place et gérer un **formulaire réactif** dans un contexte moderne.
|
||||
|
||||
## Installation
|
||||
|
||||
1. Ouvrir le projet sous WebStorm.
|
||||
2. Ouvrir un terminal dans WebStorm.
|
||||
3. Lancer la commande `npm install` pour installer les dépendances.
|
||||
4. Lancer la commande `ng serve` pour démarrer le serveur de développement.
|
||||
5. Ouvrir le navigateur à l'adresse `http://localhost:4200/`.
|
||||
|
||||
Note : les services APIs (fournis séparément) doivent être en cours d'exécution.
|
||||
|
||||
## Votre mission
|
||||
|
||||
Votre travail consistera à chercher les commentaires `// TODO:` dans les fichiers du dossier `src/app/features/movie` et à implémenter la logique manquante.
|
||||
|
||||
Voici un aperçu de la navigation entre les fonctionnalités que vous allez construire :
|
||||
|
||||
```mermaid
|
||||
graph TD
|
||||
A["Liste des films /"] -->|Clic sur un film| B["Détail du film /detail/:id"]
|
||||
A -->|"Clic Ajouter"| C["Formulaire ajout /add"]
|
||||
C -->|Sauvegarde réussie| B
|
||||
```
|
||||
|
||||
### Étape 1 : afficher la liste des films
|
||||
|
||||
Le premier objectif est d'afficher la liste des films sur la page d'accueil.
|
||||
|
||||
**Fichiers à modifier :**
|
||||
* `src/app/features/movie/movie-list/movie-list.component.ts`
|
||||
* `src/app/features/movie/movie-list/movie-list.component.html`
|
||||
|
||||
**Instructions :**
|
||||
1. Dans le `component.ts`, utilisez `toSignal` pour transformer le flux de données provenant de `MovieApiService` en un signal.
|
||||
2. Dans le `component.html`, utilisez une boucle `@for` pour itérer sur le signal de films et afficher chaque film dans la liste.
|
||||
|
||||
**Logique attendue pour l'étape 1 :**
|
||||
|
||||
```mermaid
|
||||
graph TD
|
||||
subgraph Service
|
||||
A[MovieApiService.getMovies] -- "Renvoie Observable<Movie[]>" --> B
|
||||
end
|
||||
subgraph Component
|
||||
B[toSignal] -- "Transforme en Signal<Movie[]>" --> C[filmsSignal]
|
||||
end
|
||||
subgraph Template
|
||||
C -- "Utilisé par" --> D["@for (film of filmsSignal())"]
|
||||
end
|
||||
```
|
||||
|
||||
### Étape 2 : afficher le détail d'un film
|
||||
|
||||
Quand un utilisateur clique sur un film, il doit voir une page de détail avec les informations du film et une analyse générée par une IA (simulée par une API GraphQL plus lente).
|
||||
|
||||
**Fichiers à modifier :**
|
||||
* `src/app/features/movie/movie-detail/movie-detail.component.ts`
|
||||
* `src/app/features/movie/movie-detail/movie-detail.component.html`
|
||||
|
||||
**Instructions :**
|
||||
1. Dans le `component.ts`, complétez les signaux `computed` pour extraire les données (film, analyse, état de chargement) du signal d'état principal `state`.
|
||||
2. Complétez la méthode `fetchData` pour mettre à jour le signal `state` dans les callbacks `next` et `error` des deux appels API.
|
||||
3. Dans le `component.html`, utilisez des blocs `@if` pour gérer les états de chargement et afficher les données des signaux que vous venez de créer.
|
||||
|
||||
**Logique attendue pour l'étape 2 :**
|
||||
|
||||
```mermaid
|
||||
graph TD
|
||||
A["Paramètre de route :id"] -->|Déclenche| B[fetchData]
|
||||
B -->|Met à jour| E["state.set({loading: true})"]
|
||||
|
||||
subgraph "Appels API parallèles"
|
||||
B -->|Appel 1| C["movieApiService.getMovie(id)"]
|
||||
B -->|Appel 2| D["movieApiService.getAnalysis(id)"]
|
||||
end
|
||||
|
||||
subgraph "Mises à jour du signal 'state'"
|
||||
C -- "next" --> F["state.set({data: movie})"]
|
||||
D -- "next" --> G["state.set({analysis: analysis})"]
|
||||
C -- "error" --> H["state.set({error: err})"]
|
||||
D -- "error" --> H
|
||||
end
|
||||
|
||||
subgraph "Consommation dans le template"
|
||||
I["Signal state"] --> J["Computed film"]
|
||||
I --> K["Computed analysis"]
|
||||
I --> L["Computed loading"]
|
||||
M["Template @if"] -- "Lit" --> J
|
||||
M -- "Lit" --> K
|
||||
M -- "Lit" --> L
|
||||
end
|
||||
```
|
||||
|
||||
-----
|
||||
|
||||
### Étape 3 : Créer le formulaire d'ajout
|
||||
|
||||
Enfin, vous allez rendre le formulaire de création de film fonctionnel.
|
||||
|
||||
**Fichiers à modifier :**
|
||||
* `src/app/features/movie/movie-form/movie-form.component.ts`
|
||||
* `src/app/features/movie/movie-form/movie-form.component.html`
|
||||
|
||||
**Instructions :**
|
||||
1. Dans le `component.ts`, utilisez `toSignal` pour récupérer les listes de genres et de participants nécessaires pour les listes déroulantes du formulaire.
|
||||
2. Créez un signal `isSaving` pour suivre l'état de la soumission du formulaire.
|
||||
3. Implémentez la logique de la méthode `saveMovie` pour appeler le service, mettre à jour le signal `isSaving`, et naviguer vers la page du film nouvellement créé en cas de succès.
|
||||
4. Dans le `component.html`, liez les contrôles de formulaire, gérez l'événement `(ngSubmit)` et utilisez le signal `isSaving` pour afficher un message de chargement et désactiver le bouton de soumission.
|
||||
|
||||
**Logique attendue pour l'étape 3 :**
|
||||
|
||||
```mermaid
|
||||
graph TD
|
||||
A["Utilisateur clique Sauvegarder"] -->|Déclenche| B["(ngSubmit)"]
|
||||
B --> C[saveMovie]
|
||||
C --> D["isSaving.set true"]
|
||||
C --> E["movieApiService.save formValue"]
|
||||
|
||||
subgraph Résultat de l'appel
|
||||
E -- "Succès" --> F["isSaving.set false"]
|
||||
F --> G["Navigation vers détail du film"]
|
||||
E -- "Erreur" --> H["isSaving.set false"]
|
||||
H --> I[Affichage erreur]
|
||||
end
|
||||
|
||||
subgraph "Liaison Template"
|
||||
J["Bouton disabled"] -- "Lié à" --> K["Signal isSaving"]
|
||||
L["Spinner de chargement"] -- "Lié à" --> K
|
||||
end
|
||||
```
|
||||
|
||||
Bon courage !
|
||||
Reference in New Issue
Block a user