Archop Ultimate

Application de gestion de panier d'achat avec une architecture n-tiers.

Architecture

Le projet est divisé en 3 modules :

• persistence : Gestion de la persistance des données (entités et repositories)
• business : Logique métier (services et DTOs)
• presentation : API REST (contrôleurs)

Prérequis

• Java 21
• Maven
• PostgreSQL 16.6
• Base de données archop créée sur le port 5432

Configuration de la base de données

La base de données doit être configurée avec :

• URL : jdbc:postgresql://localhost:5432/archop

Installation

1. Cloner le repository :

git clone [URL_DU_REPO]
cd archop_ultimate

2. Compiler le projet :

mvn clean install

3. Lancer l'application :

cd presentation
mvn spring-boot:run

API REST

Produits

• Lister tous les produits

  curl http://localhost:8080/api/products

• Créer un produit

  curl -X POST -H "Content-Type: application/json" \
     -d '{"name":"Produit", "description":"Description", "sellingPrice":99.99, "purchasePrice": 69.99}' \
     http://localhost:8080/api/products

• Voir un produit

  curl http://localhost:8080/api/products/{id}

Panier

• Voir le panier

  curl http://localhost:8080/api/cart

• Ajouter au panier

  curl -X POST "http://localhost:8080/api/cart/items?productId={id}&quantity={quantité}"

• Supprimer du panier

  curl -X DELETE "http://localhost:8080/api/cart/items/{productId}"

• Voir le total du panier

  curl http://localhost:8080/api/cart/total

• Valider le panier

  curl -X POST "http://localhost:8080/api/cart/checkout"

Collection Postman

Produits

GET /api/products

• Method: GET
• URL: http://localhost:8080/api/products
• Description: Récupère la liste de tous les produits

POST /api/products

• Method: POST
• URL: http://localhost:8080/api/products
• Headers:

  Content-Type: application/json
  

• Body (raw JSON):

  {
    "name": "Produit Test",
    "description": "Description du produit",
    "sellingPrice": 99.99,
    "purchasePrice": 69.99
  }

GET /api/products/{id}

• Method: GET
• URL: http://localhost:8080/api/products/{id}
• Description: Récupère un produit par son ID

Panier

GET /api/cart

• Method: GET
• URL: http://localhost:8080/api/cart
• Description: Affiche le contenu du panier

POST /api/cart/items

• Method: POST
• URL: http://localhost:8080/api/cart/items
• Params:
  • productId: ID du produit (number)
  • quantity: Quantité désirée (number)
• Example: http://localhost:8080/api/cart/items?productId=1&quantity=2

DELETE /api/cart/items/{productId}

• Method: DELETE
• URL: http://localhost:8080/api/cart/items/{productId}
• Description: Supprime un produit du panier

GET /api/cart/total

• Method: GET
• URL: http://localhost:8080/api/cart/total
• Description: Calcule le total du panier

POST /api/cart/checkout

• Method: POST
• URL: http://localhost:8080/api/cart/checkout
• Description: Valide le panier et le vide

Variables d'environnement Postman suggérées

• baseUrl: http://localhost:8080
• apiPrefix: /api

Fonctionnalités

• ✅ Affichage des produits
• ✅ Interface d'ajout/modification/suppression de produits
• ✅ Ajout des produits dans un panier
• ✅ Validation du panier avec suppression de son contenu
• ✅ Base de données PostgreSQL pour les produits
• ✅ Architecture n-tiers
• ✅ Utilisation d'un ORM (Hibernate/JPA)

Technologies utilisées

• Spring Boot 3.4.2
• Spring Data JPA
• PostgreSQL
• Maven
• JUnit
• Lombok