info tech

Routes

• /filterUnits -> route que le Front utilise pour récupérer les paires de données à convertir

• /convert -> route pour que le Front utilise pour envoyer le nombre d'unités à convertir et récupérer le résultat du calcul -> route pour que le Back utilise pour récupérer le nombre d'unités à convertir (voire la nature des unités à convertir et le sens de conversion) et envoyer le résultat du calcul

Formats des données échangées entre Front et Back

US1

POST /convert

Données à envoyer

{
  "valueToConvert": 4
}

Données retournées

{
  "result": 0,0005
}

US2

POST /convert

Données à envoyer dans le BODY

{
  "inUnit": "m2",
  "outUnit": "hectare",
  "valueToConvert": 5
}

Données retournées

{
    "result": {
        "convertedValue": 0.8
    }
}

US3

GET /filterUnits

{
    "result": [
        {
            "inUnit": "m2",
            "outUnit": "hectare"
        },
        {
            "inUnit": "kW",
            "outUnit": "kgCo2"
        }
    ]
}

US4

GET /unit

{
    "result": [
        {
            "unit": "m2",
            "definition": "uyguygugiugi",
            "source": "ezaerazerztre"
        },
        {
           "unit": "hectare",
           "definition": "uyguygugiugi",
           "source": "ezaerazerztre"
        }
    ]
}

US5

Requete

GET /unit/1

Response Body

{
    "result": [
        {
            "id": "1"
            "symbole": "unité actuelle",
            "definition": "definition actuelle",
            "source": "www.source-actuelle.com"
        }
    ]
}

POST/unit/1

{
    "unit": [
        {
            "id": "1"
            "symbole": "nouvelle unité",
            "definition": "nouvelle definition",
            "source": "www.source-nouvelle.com"
        }
    ]
}

Tests

Back

User Story	Test
US1	tester si la donnée récupérée est bien une string (inUnit et outUnit)
US3	tester si la donnée récupérée est bien une donnée présente dans la BDD (couple d'unités inUnit et outUnit)
US1 - US2 - US3	tester si le contenu de chaque requête est correctement récupéré
US1 - US2 - US3	tester si chaque donnée récupérée n'est pas vide
US1 - US2 - US3	tester si la donnée récupérée est bien un nombre (valueToConvert)
US1 - US2 - US3	tester si la donnée récupérée est bien un nombre positif (valueToConvert)
US1 - US2 - US3	tester si les données récupérées sont bien un couple valide d'unités à convertir (inUnit et outUnit)

Front

User Story	Test
US1 - US2 - US3	tester si 200 <= code réponse de l'API < 400