# Darija Translator - Chrome Extension & RESTful Web Service
**Darija Translator Pro** is a full-stack web service solution that transforms English text into authentic **Moroccan Darija** using the power of Large Language Models (LLMs). This academic project demonstrates the implementation of a RESTful web service with a modern Chrome extension interface.
> 📚 **Academic Project** - Web Services Course
> 👨🏫 **Instructor**: Pr. El Habib Nfaoui
> 👩🎓 **Developer**: Mazigh Hatim - Master WISD Student
---
## 📺 Project Demonstration
Watch the complete project presentation, including technical demo and code walkthrough:
👉 **Watch Full Presentation (Google Drive)**
---
## 🎯 Project Overview
This project fulfills the requirements of the Web Services course by implementing:
✅ **RESTful Web Service** using JAX-RS API
✅ **LLM Integration** with Groq (Llama 3.3-70b) for intelligent translation
✅ **Chrome Extension** (Manifest V3) with Side Panel API
✅ **PHP Client Application** for web integration
✅ **Security Implementation** using Jakarta Authentication (Basic Auth)
✅ **Multiple Testing Methods** (Postman, SoapUI, cURL)
The service translates English text to Moroccan Darija (الدارجة المغربية) while preserving cultural context and authenticity.
---
## ✨ Features
### Core Features
- 🌐 **Real-time Translation**: English → Moroccan Darija
- 🎨 **Modern UI**: Glassmorphism design (Peach & Mint theme)
- 📝 **Auto-fill**: Automatic text selection detection
- 🔒 **Secure API**: Basic authentication implementation
- 📱 **Side Panel Integration**: Seamless Chrome browsing experience
### Translation Intelligence
- ✅ Exclusive use of Arabic alphabet (الحروف العربية)
- ✅ Authentic Moroccan expressions (`ديال`, `بزاف`, `شنو`, etc.)
- ✅ Avoids Classical Arabic (Fusha) and SMS language
- ✅ Context-aware translation using advanced prompt engineering
---
## 🏗️ Architecture
The project follows a **client-server architecture** with three main components:
```
┌───────────────── …