Projet TAF - Frontend et Backend

Ce dépôt est spécifiquement conçu pour gérer le frontend et le backend de l'application TAF (Test Automation Framework). Il contient une application complète avec une interface utilisateur Vue.js et une API Spring Boot, ainsi que deux systèmes de base de données (MySQL et MongoDB).

📋 Table des matières

• Projet TAF - Frontend et Backend
  • 📋 Table des matières
  • 🎯 À propos du projet
  • 🏗️ Architecture
  • 📦 Prérequis
    • Pour Docker Compose (recommandé)
    • Pour l'installation manuelle
  • 🚀 Installation et démarrage
    • Avec Docker Compose (recommandé)
    • Installation manuelle
      • Backend
      • Frontend
  • ⚙️ Configuration
    • Configuration des bases de données
    • Configuration Frontend
  • 📝 Notes

🎯 À propos du projet

Ce dépôt contient :

• Frontend : Application Vue.js 3 avec TypeScript, Vite, TailwindCSS et Shadcn-vue
• Backend : API REST Spring Boot 3.2.0 avec Java 17
• Bases de données :
  • MySQL 8.0 : Base de données relationnelle principale
  • MongoDB 7 : Base de données NoSQL pour le dashboard

🏗️ Architecture

┌─────────────┐
│   Frontend  │ (Vue.js - Port 5173)
│  (Port 5173)│
└──────┬──────┘
       │
       │ HTTP
       │
┌──────▼──────┐
│   Backend   │ (Spring Boot - Port 8085)
│ (Port 8085) │
└──┬──────────┘
   │
   ├─────────────┐
   │             │
┌──▼──┐      ┌──▼────┐
│MySQL│      │MongoDB│
│3306 │      │ 27017 │
└─────┘      └───────┘

📦 Prérequis

Pour Docker Compose (recommandé)

• Docker (version 20.10 ou supérieure)
• Docker Compose (version 2.0 ou supérieure)

Pour l'installation manuelle

• Backend :
  • Java 17 ou supérieur
  • Maven 3.8 ou supérieur
• Frontend :
  • Node.js 20.19.0 ou supérieur (ou 22.12.0+)
  • npm

🚀 Installation et démarrage

Avec Docker Compose (recommandé)

Cette méthode est la plus simple et permet de démarrer tous les services en une seule commande.

1. Cloner le dépôt (si ce n'est pas déjà fait) :

git clone https://github.com/Automated-Test-Framework/equipe-1
cd equipe-1

2. Démarrer tous les services :

docker-compose up -d

Cette commande va :

• Construire les images Docker pour le frontend et le backend
• Démarrer MySQL et MongoDB
• Démarrer le backend Spring Boot
• Démarrer le frontend Vue.js

3. Vérifier que tous les services sont démarrés :

docker-compose ps

4. Accéder à l'application :

   • Frontend : http://localhost:5173
   • Backend API : http://localhost:8085
   • Swagger UI : http://localhost:8085/swagger-ui.html

5. Arrêter les services :

docker-compose down

1. Arrêter et supprimer les volumes (⚠️ supprime les données) :

docker-compose down -v

Installation manuelle

Backend

1. Naviguer vers le dossier backend :

cd backend

2. Configurer les bases de données :

   • Démarrer MySQL et MongoDB (via Docker Compose ou installation locale)
   • Modifier src/main/resources/application-local.yml avec vos paramètres de connexion

3. Compiler et démarrer :

# Installer les dépendances et compiler
mvn clean install

# Démarrer l'application
mvn spring-boot:run

Le backend sera accessible sur http://localhost:8085

Frontend

1. Naviguer vers le dossier frontend :

cd frontend

2. Installer les dépendances :

npm install

3. Démarrer le serveur de développement :

npm run dev

Le frontend sera accessible sur http://localhost:5173

⚙️ Configuration

Configuration des bases de données

MySQL (dans docker-compose.yml) :

• Port : 3306
• Base de données : tafdb
• Utilisateur : tafuser
• Mot de passe : tafpassword

MongoDB (dans docker-compose.yml) :

• Port : 27017
• Base de données : tafdb

Configuration Frontend

Le frontend peut être configuré via les variables d'environnement Vite :

• VITE_API_URL : URL de l'API backend (par défaut : http://localhost:8085)

📝 Notes

• Ce dépôt est spécifiquement conçu pour gérer le frontend et le backend de l'application TAF
• Les bases de données sont persistées dans des volumes Docker
• En cas de problème, vérifiez les logs avec docker-compose logs