Différences

Ci-dessous, les différences entre deux révisions de la page.

--- eadl:bloc3:dev_av:td1 [2025/09/16 15:52] – créée jcheron
+++ eadl:bloc3:dev_av:td1 [2025/09/16 20:22] (Version actuelle) – [Spécifications] jcheron
@@ Ligne 1: / Ligne 1: @@
-====== Séance 1 ======
+====== 1 - Initialisation et structuration de projet ======
-Initialisation et structuration de projet
+Séance 1 (4h)
+===== API E-commerce - Architecture =====
+<WRAP round bloc info>
+**IA : avec modération**
+  * Générative : uniquement pour correction/débogage, amélioration, aucune soumission de TAF
+  * Assistant de codage, type copilot : avec contrôle des productions
+</WRAP>
+==== Stack technique ====
+  * Spring Boot 3+
+  * Base de données : H2 (fichier)
+  * JPA (Hibernate)
+  * Build : Maven
+  * Tests : JUnit 5
+  * GitHub classRoom
+==== Spécifications ====
+Mise en place d'une API REST pour la gestion des utilisateurs, des produits et des commandes, utilisable dans le cadre d'une application web e-commerce générique.
+=== End points ===
+== Users ==
+<sxh;gutter:false>
+POST /users - Créer un utilisateur
+GET /users/{id} - Récupérer un utilisateur
+GET /users/{id}/recommendations - Produits recommandés pour l'utilisateur
+</sxh>
+== Products ==
+<sxh;gutter:false>
+POST /products - Créer un produit
+GET /products/{id} - Récupérer un produit
+PUT /products/{id}/stock - Mettre à jour le stock
+GET /products - Lister les produits (avec filtres optionnels)
+</sxh>
+== Orders ==
+<sxh;gutter:false>
+POST /orders - Créer une commande
+GET /orders/{id} - Récupérer une commande
+GET /users/{userId}/orders - Historique des commandes d'un user
+</sxh>
+=== Modèle de données ===
+<html><div class="imageB"></html>
+<uml>
+@startuml
+package "Domain Models" {
+    class User {
+        - UUID id
+        - String name
+        - String email
+    }
+    class Product {
+        - UUID id
+        - String name
+        - BigDecimal price
+        - Integer stock
+    }
+    class Category {
+        - UUID id
+        - String name
+        - String description
+    }
+    class Order {
+        - UUID id
+        - BigDecimal totalAmount
+        - OrderStatus status
+        - LocalDateTime createdAt
+    }
+    class OrderItem {
+        - UUID id
+        - Integer quantity
+        - BigDecimal unitPrice
+    }
+    enum OrderStatus {
+        PENDING
+        CONFIRMED
+        SHIPPED
+        DELIVERED
+        CANCELLED
+    }
+}
+' Relations avec cardinalités
+Order "1" *-- "1..*" OrderItem : contains
+Order "0..*" --> "1" User : belongsTo
+OrderItem "0..*" --> "1" Product : references
+User "0..*" --> "0..1" Category : prefers
+Product "0..*" --> "1" Category : belongsTo
+@enduml
+</uml>
+<html></div></html>
+=== Données exemple ===
+== User ==
+<sxh json;gutter:false>
+{
+  "id": "550e8400-e29b-41d4-a716-446655440001",
+  "name": "Alice Martin",
+  "email": "alice.martin@example.com",
+  "preferredCategoryIds": [
+    "550e8400-e29b-41d4-a716-446655440010",
+    "550e8400-e29b-41d4-a716-446655440011"
+  ]
+}
+</sxh>
+== Product ==
+<sxh json;gutter:false>
+{
+  "id": "550e8400-e29b-41d4-a716-446655440020",
+  "name": "iPhone 15 Pro",
+  "price": 1199.99,
+  "stock": 25,
+  "categoryId": "550e8400-e29b-41d4-a716-446655440010"
+}
+</sxh>
+== Order ==
+<sxh json;gutter:false>
+{
+  "id": "550e8400-e29b-41d4-a716-446655440030",
+  "userId": "550e8400-e29b-41d4-a716-446655440001",
+  "items": [
+    {
+      "id": "550e8400-e29b-41d4-a716-446655440040",
+      "productId": "550e8400-e29b-41d4-a716-446655440020",
+      "quantity": 2,
+      "unitPrice": 1199.99
+    }
+  ],
+  "totalAmount": 2399.98,
+  "status": "CONFIRMED",
+  "createdAt": "2024-01-15T14:30:00Z"
+}
+</sxh>
+== Order item ==
+<sxh json;gutter:false>
+{
+  "id": "550e8400-e29b-41d4-a716-446655440040",
+  "productId": "550e8400-e29b-41d4-a716-446655440020",
+  "quantity": 2,
+  "unitPrice": 1199.99
+}
+</sxh>
+== Category ==
+<sxh json;gutter:false>
+{
+  "id": "550e8400-e29b-41d4-a716-446655440010",
+  "name": "Electronics",
+  "description": "Electronic devices and accessories"
+}
+</sxh>
+=== Attendus ===
+== Architecture ==
+  * Séparation couche métier/applicative :
+  * Controllers (API REST)
+  * Services (logique métier)
+  * Repositories (accès données)
+  * DTOs pour les échanges API
+  * Entities pour le domaine métier
+== Tests ==
+  * Tests unitaires sur les services principaux
+  * Tests d'intégration basiques des controllers
+== CI/CD ==
+  * GitHub Actions : exécution tests sur push/PR
+  * Pas de déploiement (tests uniquement)
+<WRAP round bloc todo>
+== Priorités (4h) ==
+  * Entities : User, Product, Category
+  * CRUD Product + tests unitaires/intégration
+  * Pipeline CI/CD fonctionnel
+</WRAP>
+<WRAP round bloc info>
+  * Privilégier la qualité
+  * Toutes les bonnes initiatives sont les bienvenues
+</WRAP>