ZouhirAamrani/Translator-English---Darija-
Domain:
natural language processingRecord type:
softwaretools
Creator:
Zou
Host:
# 🇲🇦 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 │
│ │ │
└─────────────────┼─────────────────────┘
│
▼
┌──────────────────────────────┐
│ …