Backend Challenge

Introduction

En tant qu’ingénieur logiciel dans l'équipe DZConseil, vous devez fournir une solution backend fiable à nos clients. Votre tâche ici est d'implémenter quelques fonctionnalités pour une api rest comme Airbnb.

Exigences

Nous valorisons une solution propre, simple et efficace.
La solution doit être réalisée avec la dernière version de Laravel et PHP.
Bonne compréhension du fonctionnement du git.
Bonne compréhension des API REST.
Aucun package ne doit être ajouté au code fourni.

Remarques

Le code source doit être poussé en tant qu'une branche git dans ce project.
Votre nom de branche devrait suivre cette forme challenge/nom-prénom.
LE CODE NE DEVRAIT PAS ÊTRE POUSSÉ PAR UNE PULL-REQUEST

Attentes

Ce défi devrait durer environ 4 à 5 heures.
Tous les tests dans votre branche doivent réussir.
Éviter le over-engineering.
Toutes les réponses doivent être en format JSON.

Énoncé du problème

En suivant ce diagramme, nous souhaitons mettre en place une API que nos utilisateurs peuvent utiliser.
Cette API restfull devrait nous permettre de lister, voir, créer, mettre à jour et supprimer une maison.
Les methods qui calcule de couts de réservation calculateCost() & calculateDiscount() devrons être implémentées au niveau du model Listing.

Configuration du projet

Pour obtenir une copie de ce projet sur votre machine, vous devez exécuter la commande suivante :

git clone [email protected]:dzconseil/backend-challenge.git dzconseil-challenge

Vous obtiendrez une copie de ce projet dans un dossier nommé dzconseil-challenge

Maintenant, vous devez créer une nouvelle branche pour commencer à travailler, exécutez la commande suivante :

git checkout -b challenge/nom-prénom challenge

Vous remarquerez que nous vous avons fourni le squelette du projet avec presque tout, y compris (routes, models , migration, factories, controllers, requests, resources, tests) tout ce que vous avez à faire est de remplir la logique manquante et d'exécuter les tests.

Tous les tests de ce projet doivent réussir avant que vous poussiez votre code.

Endpoints

Afficher toutes les maisons

Requête
- URI : /api/listings
- Méthode : GET

Réponse

Statut : 200

Corps :

{
  "data": [
    {
      "id": "28eed9aa-c27d-4217-ab21-ad65ead3a2aa",
      "owner_id": "59f6d752-97cf-414e-a794-42794ac7511a",
      "name": "Warner",
      "slug": "warner",
      "description": "Maecenas ut massa quis augue luctus tincidunt.",
      "adults": 10,
      "children": 2,
      "is_pets_allowed": true,
      "base_price": 95.38,
      "cleaning_fee": 4.33,
      "image_url": null,
      "weekly_discount": 0.13,
      "monthly_discount": 0.23
    },
    {
      "id": "b3a6e269-d0fa-4408-89b1-fe2e48963177",
      "owner_id": "e0b227da-dc6e-402c-8172-9d950ece4707",
      "name": "Burrows White",
      "slug": "burrows-white",
      "description": "Phasellus in felis. Donec semper sapien a libero. Nam dui. ",
      "adults": 9,
      "children": 2,
      "is_pets_allowed": false,
      "base_price": 160.51,
      "cleaning_fee": 31.45,
      "image_url": "storage/1/image.png",
      "weekly_discount": 0.77,
      "monthly_discount": 0.36
    }
  ]
}

⬆ retour au sommet

Afficher une maison

Requête
- URI : /api/listings/:uuid
- Méthode : GET

Réponse

Statut : 200

Corps :

{
  "data": {
    "id": "b3a6e269-d0fa-4408-89b1-fe2e48963177",
    "owner_id": "e0b227da-dc6e-402c-8172-9d950ece4707",
    "name": "Burrows White",
    "slug": "burrows-white",
    "description": "Phasellus in felis. Donec semper sapien a libero. Nam dui. ",
    "adults": 9,
    "children": 2,
    "is_pets_allowed": false,
    "base_price": 160.51,
    "cleaning_fee": 31.45,
    "image_url": "storage/1/image.png",
    "weekly_discount": 0.77,
    "monthly_discount": 0.36,
    "special_prices": [
      {
        "id" : "b7b81974-51b7-4989-bd8d-28450c8466d1",
        "date": "2019-10-12",
        "price": 40.51
      },
      {
        "id" : "d3f39186-319a-4099-988c-a713c09d72b8",
        "date": "2019-10-13",
        "price": 80
      }
    ]
  }
}

⬆ retour au sommet

Créer une nouvelle maison

Requête

URI : /api/listings
Méthode : POST

Corps :

{
  "name": "Black Raven",
  "description": "Morbi porttitor lorem id ligula. Suspendisse ornare consequat lectus. In est risus, auctor sed.",
  "adults": 3,
  "children": 2,
  "is_pets_allowed": 1,
  "base_price": 195.62,
  "cleaning_fee": 95.82,
  "image": <file>,
  "weekly_discount": 0.77,
  "monthly_discount": 0.61
}

Réponse

Statut : 201

Corps :

{
  "data": {
    "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "owner_id": "d701748f-6c54-4b01-90e6-d701748f0822",
    "name": "Black Raven",
    "slug": "black-raven",
    "description": "Morbi porttitor lorem id ligula. Suspendisse ornare consequat lectus. In est risus, auctor sed.",
    "adults": 3,
    "children": 2,
    "is_pets_allowed": true,
    "base_price": 195.62,
    "cleaning_fee": 95.82,
    "image_url": "storage/2/black-raven.jpg",
    "weekly_discount": 0.77,
    "monthly_discount": 0.61
  }
}

⬆ retour au sommet

Mettre à jour une maison

Requête

URI : /api/listings/:uuid
Méthode : PUT

Corps :

{
  "name": "White Raven",
  "description": "Morbi porttitor lorem id ligula",
  "adults": 3,
  "children": 2,
  "is_pets_allowed": true,
  "base_price": 195.62,
  "cleaning_fee": 95.82,
  "image": null,
  "weekly_discount": 0,
  "monthly_discount": 0.61
}

Réponse

Statut : 200

Corps :

{
  "data": {
    "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "owner_id": "d701748f-6c54-4b01-90e6-d701748f0822",
    "name": "White Raven",
    "slug": "white-raven",
    "description": "Morbi porttitor lorem id ligula. Suspendisse ornare consequat lectus. In est risus, auctor sed.",
    "adults": 3,
    "children": 2,
    "is_pets_allowed": true,
    "base_price": 195.62,
    "cleaning_fee": 95.82,
    "image_url": "storage/2/black-raven.jpg",
    "weekly_discount": 0.77,
    "monthly_discount": 0.61
  }
}

⬆ retour au sommet

Supprimer une maison

Requête
- URI : /api/listings/:uuid
- Méthode : DELETE

Réponse

Statut : 200

Corps :

{
  "id": "d290f1ee-6c54-4b01-90e6-d701748f0851"
}

⬆ retour au sommet

Des questions ? Suggestions ? Nous aimons vous répondre : [email protected]

PreviousFrench Version NextFrontend Challenge

Last updated 10 months ago

Was this helpful?