# English to Darija Translation API 🌐
> Application web de traduction automatique de l'anglais vers le dialecte marocain (Darija) utilisant l'API Gemini de Google.
## 📋 Table des Matières
- Aperçu
- Architecture
- Fonctionnalités
- Prérequis
- Installation
- Configuration
- Utilisation
- Structure du Projet
- API Documentation
- Technologies
- Développement
- Déploiement
- Contribuer
## 🎯 Aperçu
Cette application permet de traduire du texte anglais vers le dialecte marocain (Darija) en temps réel. Elle utilise l'API Gemini 1.5 Flash de Google pour effectuer les traductions et est construite avec Jakarta EE et déployée sur WildFly.
### Caractéristiques principales
- ✅ Traduction instantanée Anglais → Darija
- ✅ Interface web intuitive avec style WhatsApp
- ✅ Système de cache côté client (session PHP)
- ✅ API RESTful pour intégration facile
- ✅ Architecture client-serveur découplée
## 🏗️ Architecture
```
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ │ │ │ │ │
│ Client Web │ ◄────► │ Backend API │ ◄────► │ Google Gemini │
│ (PHP + CSS) │ HTTP │ (Jakarta EE) │ HTTPS │ API 1.5 Flash │
│ │ │ │ │ │
└─────────────────┘ └──────────────────┘ └─────────────────┘
```
### Composants
1. **Frontend** : Interface PHP avec CSS personnalisé
2. **Backend** : API REST Jakarta EE sur WildFly
3. **Service IA** : Google Gemini pour la traduction
## ✨ Fonctionnalités
### Interface Utilisateur
- 💬 Interface type chat (style WhatsApp)
- 🎨 Design moderne et responsive
- 📝 Zone de texte pour saisie anglaise
- 💾 Historique des traductions dans la session
- ⚡ Traduction en temps réel
### Backend
- 🔌 API RESTful avec JAX-RS
- 🔄 Intégration Google Gemini AI
- 📊 Gestion des erreurs robuste
- 🚀 Performance optimisée
## 📦 Prérequis
### Logiciels Requis
```bash
Java JDK 17 ou sup …