# đČđŠ Darija Translator - English to Moroccan Arabic Translation Service
**đ„ VidĂ©o de dĂ©monstration :**
drive.google.com
A complete AI-powered translation system for converting English text to Moroccan Arabic (Darija) dialect, featuring a secure REST API, web client, and Chrome extension.
## đ Table of Contents
- Features
- Architecture
- Technologies
- Prerequisites
- Installation
- Configuration
- Usage
- API Documentation
- Security
- Clients
- Screenshots
- Contributing
- License
- Contact
## âš Features
### REST API
- â
RESTful web service built with JAX-RS (Jersey)
- â
AI-powered translation using Google Gemini API
- â
Jakarta Authentication with Basic Auth
- â
Role-based access control (USER, ADMIN)
- â
Password hashing with SHA-256 and salt
- â
JSON request/response format
- â
CORS support for cross-origin requests
### PHP Web Client
- â
Modern, responsive user interface
- â
Real-time character counter
- â
Translation history with local storage
- â
Copy to clipboard functionality
- â
Service health monitoring
- â
Error handling with user-friendly messages
### Chrome Extension
- â
Manifest V3 compliance
- â
Side Panel API integration
- â
Context menu for selected text translation
- â
Persistent translation history
- â
One-click translation from toolbar
- â
Works on any webpage
## đïž Architecture
```
âââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ
â CLIENTS â
ââââââââââââââââŹâââââââââââââââââââŹâââââââââââââââââââââââââââ€
â Web Client â Chrome Extension â Postman/cURL â
â (PHP) â (Manifest V3) â (API Testing) â
ââââââââŹââââââââŽâââââââââŹââââââââââŽâââââââââââŹââââââââââââââââ
â â â
â HTTP Requests with Basic Auth â
â â â
âââââââââââââââââââŒââââââââââââââââââââââ
â
âŒ
ââââââââââââââââââââââââââââââââ
â âŠ