Skip to content

Latest commit

 

History

History
99 lines (62 loc) · 2.81 KB

README.md

File metadata and controls

99 lines (62 loc) · 2.81 KB

Ta BMW

Objet

Ce projet est un site de e-commerce de voitures BMW.

  • Il permet de visualiser les voitures disponibles, de les filtrer, de les ajouter au panier et de passer commande.
  • Il permet à un client de mettre sa voiture en vente et de la vendre à un garage BMW.
  • Il est possible de prendre des RDV pour des réparations ou des essais de voitures en fonction de la disponibilité des garages.

Librairies / Frameworks utilisées

Le projet inclut les fonctionnalités suivantes :

  • Front: usage de Vue.JS

  • Bundling :

    • Configuration vite personnalisée basée sur SWC incluant un serveur de développement avec hot reload
  • Authentification :

    • Inscription avec Token JWT
    • Validation par email
  • Tests unitaires :

    • Jest et testing-library installés et préconfigurés
    • Cypress test fonctionnels
  • Intégration à l'API :

    • Création de service d'appel API avec Axios
  • Formulaires :

    • Gestion des formulaires avec FormKit
    • Validation déclarative du formulaire par schéma via yup
  • Routage :

    • Routing côté navigateur avec Vue Router
    • Prise en charge des routes protégées
  • Autres :

    • Vuex pour la gestion d'état global
    • TailwindCSS pour le style
  • Environment :

API

Api platform utilise un swagger pour la documentation et le testing de l'api.

Comment initialiser le projet et l'utiliser

  1. Cloner le projet

    Faire un clone du projet git pour initialiser le repo du projet.

  2. Configurer les variables d'environnement

    Dans le dossier 'vuejs-starter', créer un fichier '.env.local' et y renseigner les variables d'environnement suivantes :

     VITE_API_URL=https://localhost/
     VITE_ALLOW_ORIGIN=https://localhost/
     VITE_JAWGS_API_KEY={Your_Own_Token}

    Pour obtenir un token Jawg, vous pouvez vous rendre sur le site suivant : Jawg IO

  3. Configurer Prettier

    Vérifier qu'une extension Prettier est installée sur l'IDE, l'installer le cas échéant https://prettier.io/docs/en/editors.html

  4. Installer les dépendances et démarrer le projet

Dans un terminal, se placer dans le dossier 'vuejs-starter' et exécuter les commandes suivantes :

 make build
 make start

Dans une autre fenetre du terminal, ouvrir le dossier 'api-platform-starter' et exécuter les commandes suivantes :

 make build
 make jwt
 make start
 make migrate 
 make fixtures-purge