# 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:
```
ββββββββββββββββββ β¦