first

DEPLOYMENT_ENHANCED.md

@@ -1,330 +1,176 @@
-# Enhanced Deployment Guide
+# Deployment Guide for Enhanced DOCX to PDF Converter
 
-## Prerequisites
+## System Requirements
 
-- Ubuntu 20.04+ or compatible Linux distribution
-- Docker Engine 20.10+
+- Docker 20.10+
 - Docker Compose 1.29+
-- Minimum 4GB RAM (8GB recommended)
-- Minimum 20GB free disk space
+- 4GB+ RAM recommended
+- 2+ CPU cores recommended
 
-## System Package Installation
+## Deployment Options
 
-### Core Dependencies
+### 1. Docker Deployment (Recommended)
 
-```bash
-# Update package repositories
-sudo apt-get update
-
-# Install system dependencies
-sudo apt-get install -y \
-    python3 \
-    python3-pip \
-    libreoffice \
-    libreoffice-writer \
-    libreoffice-l10n-ar \
-    fonts-liberation \
-    fonts-liberation2 \
-    fonts-dejavu \
-    fonts-dejavu-core \
-    fonts-dejavu-extra \
-    fonts-croscore \
-    fonts-noto-core \
-    fonts-noto-ui-core \
-    fonts-noto-mono \
-    fonts-noto-color-emoji \
-    fonts-opensymbol \
-    fonts-freefont-ttf \
-    fontconfig \
-    wget \
-    curl \
-    unzip \
-    locales
-```
-
-### Locale Configuration
-
-```bash
-# Generate Arabic locale
-sudo locale-gen ar_SA.UTF-8
-
-# Update locale settings
-sudo update-locale LANG=ar_SA.UTF-8 LC_ALL=ar_SA.UTF-8
-```
-
-## Font Configuration
-
-### Enhanced Arabic Font Support
-
-The application includes automatic font installation for optimal Arabic text rendering:
-
-```bash
-# Make font installation script executable
-chmod +x arabic_fonts_setup.sh
-
-# Run font installation
-./arabic_fonts_setup.sh
-```
+1. **Build and run with Docker Compose:**
+   ```bash
+   docker-compose up --build -d
+   ```
 
-This script installs:
-- **Amiri**: Professional Arabic font with excellent readability
-- **Scheherazade New**: Unicode-compliant Arabic font with extensive character support
+2. **Access the service:**
+   - API: http://localhost:8000
+   - API Documentation: http://localhost:8000/docs
 
-### Font Cache Update
+3. **View logs:**
+   ```bash
+   docker-compose logs -f
+   ```
 
-```bash
-# Update system font cache
-sudo fc-cache -fv
+4. **Stop the service:**
+   ```bash
+   docker-compose down
+   ```
 
-# Verify font installation
-fc-list | grep -i "amiri\|scheherazade"
-```
+### 2. Manual Deployment
 
-## Python Environment Setup
+1. **Install system dependencies:**
+   ```bash
+   # Ubuntu/Debian
+   sudo apt-get update
+   sudo apt-get install -y python3 python3-pip libreoffice libreoffice-writer
+   
+   # Install Arabic fonts
+   sudo apt-get install -y fonts-noto-core fonts-noto-kufi-arabic fonts-amiri fonts-scheherazade-new
+   ```
 
-### Virtual Environment (Recommended)
+2. **Install Python dependencies:**
+   ```bash
+   pip3 install -r requirements.txt
+   ```
 
-```bash
-# Create virtual environment
-python3 -m venv venv
+3. **Run the application:**
+   ```bash
+   python3 src/api/app.py
+   ```
 
-# Activate virtual environment
-source venv/bin/activate
+## Configuration
 
-# Install Python dependencies
-pip install -r requirements.txt
-```
+### Environment Variables
 
-### Direct Installation
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `PORT` | Application port | 8000 |
+| `MAX_FILE_SIZE` | Maximum file size in bytes | 52428800 (50MB) |
+| `MAX_CONVERSION_TIME` | Conversion timeout in seconds | 120 |
+| `TEMP_DIR` | Temporary directory for conversions | /tmp/conversions |
+| `CORS_ORIGINS` | CORS allowed origins | * |
+| `CORS_CREDENTIALS` | CORS credentials support | true |
 
+### Example with custom configuration:
 ```bash
-# Install Python packages
-pip3 install --no-cache-dir -r requirements.txt
-```
-
-## Docker Deployment
-
-### Docker Compose Configuration
-
-The provided `docker-compose.yml` includes optimized settings:
-
-```yaml
-version: '3.8'
-
-services:
-  docx-to-pdf-arabic:
-    build: .
-    container_name: docx-pdf-converter-arabic
-    ports:
-      - "7860:7860"
-    environment:
-      - LANG=ar_SA.UTF-8
-      - LC_ALL=ar_SA.UTF-8
-      - PYTHONUNBUFFERED=1
-      - TEMP_DIR=/tmp/conversions
-      - STATIC_DIR=/app/static
-    volumes:
-      - ./static:/app/static
-      - ./conversions:/tmp/conversions
-    restart: unless-stopped
-    healthcheck:
-      test: ["CMD", "curl", "-f", "http://localhost:7860/health"]
-      interval: 30s
-      timeout: 10s
-      retries: 3
-      start_period: 40s
+PORT=8080 MAX_FILE_SIZE=104857600 docker-compose up
 ```
 
-### Building and Running
-
-```bash
-# Build and start services
-docker-compose up -d --build
-
-# View logs
-docker-compose logs -f
+## Health Checks
 
-# Stop services
-docker-compose down
+The service provides a health check endpoint at `/health` which returns:
+```json
+{
+  "status": "healthy",
+  "version": "2.0.0"
+}
 ```
 
-## Configuration Options
-
-### Environment Variables
+Docker health checks are configured in the docker-compose.yml file.
 
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `STATIC_DIR` | `/app/static` | Directory for storing converted PDFs |
-| `TEMP_DIR` | `/tmp/conversions` | Temporary directory for processing |
-| `MAX_FILE_SIZE` | `52428800` | Maximum file size in bytes (50MB) |
-| `MAX_CONVERSION_TIME` | `120` | Conversion timeout in seconds |
-| `CORS_ORIGINS` | `*` | Allowed CORS origins |
-| `LANG` | `ar_SA.UTF-8` | System language |
-| `LC_ALL` | `ar_SA.UTF-8` | Locale settings |
+## Scaling
 
-### Volume Mounts
+For high-traffic environments:
 
-For persistent storage:
-- `/app/static`: Converted PDF files
-- `/tmp/conversions`: Temporary processing files
+1. **Increase worker count in Docker:**
+   ```yaml
+   # In docker-compose.yml
+   environment:
+     - WORKERS=8
+   ```
 
-## Health Monitoring
+2. **Use a reverse proxy like NGINX for load balancing**
 
-### Built-in Health Check
+3. **Consider using Kubernetes for orchestration**
 
-```bash
-# Check application health
-curl -f http://localhost:7860/health
+## Monitoring
 
-# Expected response
-{"status": "healthy", "version": "2.0.0"}
-```
+The application logs to stdout/stderr and includes:
 
-### Docker Health Status
+- Request logging
+- Conversion success/failure tracking
+- Error details
+- Performance metrics
 
-```bash
-# Check container health
-docker inspect --format='{{json .State.Health}}' docx-pdf-converter-arabic
-```
-
-## Performance Optimization
+## Backup and Recovery
 
-### Resource Allocation
+- Converted files are stored in the `conversions` directory
+- This directory is mounted as a volume in Docker
+- Regularly backup this directory for persistence
 
-For production deployments:
+## Troubleshooting
 
-```yaml
-deploy:
-  resources:
-    limits:
-      memory: 2G
-      cpus: '1.0'
-    reservations:
-      memory: 1G
-      cpus: '0.5'
-```
+### Common Issues
 
-### Conversion Optimization
+1. **LibreOffice not found:**
+   - Ensure LibreOffice is installed in the container/host
+   - Check PATH environment variable
 
-The application automatically optimizes conversions:
-- Parallel processing for batch operations
-- Memory-efficient temporary file handling
-- Automatic cleanup of temporary files
-- Timeout management for long-running conversions
+2. **Font issues with Arabic text:**
+   - Verify Arabic fonts are installed
+   - Check font cache with `fc-list | grep -i arabic`
 
-## Security Considerations
+3. **Large file timeouts:**
+   - Increase `MAX_CONVERSION_TIME` environment variable
+   - Consider preprocessing large documents
 
-### File Validation
+4. **Memory issues:**
+   - Allocate more RAM to Docker/container
+   - Monitor memory usage with `docker stats`
 
-- MIME type verification
-- File extension validation
-- Size limit enforcement
-- Path traversal prevention
-
-### Container Security
+### Logs
 
+View application logs:
 ```bash
-# Run with limited capabilities
-docker run --cap-drop=ALL --read-only --tmpfs /tmp docx-pdf-converter
+docker-compose logs docx-to-pdf-enhanced
 ```
 
-## Backup and Recovery
-
-### Data Backup
-
-```bash
-# Backup converted files
-tar -czf static-backup-$(date +%Y%m%d).tar.gz static/
-
-# Backup configuration
-tar -czf config-backup-$(date +%Y%m%d).tar.gz docker-compose.yml .env
-```
+## Security Considerations
 
-### Data Recovery
+1. **File Validation:**
+   - Files are validated for type and size
+   - Only DOCX files are accepted
 
-```bash
-# Restore converted files
-tar -xzf static-backup-*.tar.gz
+2. **Resource Limits:**
+   - File size limits prevent abuse
+   - Conversion timeouts prevent resource exhaustion
 
-# Restore configuration
-tar -xzf config-backup-*.tar.gz
-```
+3. **Container Security:**
+   - Run with minimal privileges
+   - Keep base images updated
 
-## Troubleshooting
+4. **CORS Configuration:**
+   - Configure `CORS_ORIGINS` appropriately for production
+   - Don't use "*" in production environments
 
-### Common Issues
+## Updating the Application
 
-1. **Font Rendering Problems**
+1. **Pull latest changes:**
    ```bash
-   # Reinstall fonts
-   ./arabic_fonts_setup.sh
-   sudo fc-cache -fv
+   git pull origin main
    ```
 
-2. **LibreOffice Failures**
+2. **Rebuild and restart:**
    ```bash
-   # Check LibreOffice installation
-   libreoffice --version
-   
-   # Test conversion
-   libreoffice --headless --convert-to pdf --outdir /tmp test.docx
+   docker-compose down
+   docker-compose up --build -d
    ```
 
-3. **Permission Errors**
+3. **Verify the update:**
    ```bash
-   # Fix directory permissions
-   sudo chmod 777 static/
-   sudo chmod 777 conversions/
-   ```
-
-### Log Analysis
-
-```bash
-# View application logs
-docker-compose logs docx-to-pdf-arabic
-
-# Filter error messages
-docker-compose logs docx-to-pdf-arabic | grep -i error
-```
-
-## Maintenance
-
-### Regular Updates
-
-```bash
-# Update system packages
-sudo apt-get update && sudo apt-get upgrade
-
-# Update Docker images
-docker-compose pull
-docker-compose up -d --build
-```
-
-### Font Updates
-
-```bash
-# Update Arabic fonts
-./arabic_fonts_setup.sh
-sudo fc-cache -fv
-```
-
-## Scaling Options
-
-### Horizontal Scaling
-
-For high-volume deployments:
-
-```yaml
-version: '3.8'
-
-services:
-  docx-to-pdf-arabic:
-    build: .
-    deploy:
-      replicas: 3
-    # ... other configuration
-```
-
-### Load Balancing
-
-Use nginx or similar for load distribution across multiple instances.
+   curl http://localhost:8000/health
+   ```

DEPLOYMENT_GUIDE.md

@@ -1,216 +1,217 @@
-# Deployment Guide
-
-## System Requirements
-
-- Ubuntu 20.04 or later (recommended)
-- Docker and Docker Compose
-- Minimum 2GB RAM
-- Minimum 20GB disk space
-
-## Installation Steps
-
-### 1. Install System Dependencies
-
-```bash
-# Update package list
-sudo apt-get update
-
-# Install core system dependencies
-sudo apt-get install -y \
-    python3 \
-    python3-pip \
-    libreoffice \
-    libreoffice-writer \
-    libreoffice-l10n-ar \
-    fonts-liberation \
-    fonts-liberation2 \
-    fonts-dejavu \
-    fonts-dejavu-core \
-    fonts-dejavu-extra \
-    fonts-croscore \
-    fonts-noto-core \
-    fonts-noto-ui-core \
-    fonts-noto-mono \
-    fonts-noto-color-emoji \
-    fonts-opensymbol \
-    fonts-freefont-ttf \
-    fontconfig \
-    wget \
-    curl \
-    unzip \
-    locales
-```
-
-### 2. Generate Arabic Locale
-
-```bash
-sudo locale-gen ar_SA.UTF-8
-```
-
-### 3. Install Python Dependencies
-
-```bash
-pip3 install -r requirements.txt
+# 🚀 دليل النشر - محول DOCX إلى PDF للعربية
+
+## 📋 خيارات النشر
+
+### 1. 🌐 Hugging Face Spaces (الموصى به)
+
+#### الخطوات:
+1. **إنشاء Space جديد:**
+   - اذهب إلى [Hugging Face Spaces](https://huggingface.co/spaces)
+   - اضغط "Create new Space"
+   - اختر "Gradio" كـ SDK
+   - اختر اسم للـ Space
+
+2. **رفع الملفات:**
+   ```bash
+   git clone https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME
+   cd YOUR_SPACE_NAME
+   
+   # نسخ الملفات المطلوبة
+   cp /path/to/your/project/app.py .
+   cp /path/to/your/project/requirements.txt .
+   cp /path/to/your/project/packages.txt .
+   cp /path/to/your/project/README.md .
+   
+   # رفع التغييرات
+   git add .
+   git commit -m "Add Arabic DOCX to PDF converter"
+   git push
+   ```
+
+3. **التحقق من النشر:**
+   - انتظر بناء الـ Space (5-10 دقائق)
+   - تحقق من السجلات للتأكد من تثبيت الخطوط العربية
+   - اختبر التحويل بملف عربي بسيط
+
+#### المزايا:
+- ✅ مجاني ومتاح 24/7
+- ✅ تثبيت تلقائي للتبعيات
+- ✅ واجهة ويب جاهزة
+- ✅ مشاركة سهلة عبر الرابط
+
+### 2. 🐳 Docker (للتشغيل المحلي)
+
+#### الخطوات:
+```bash
+# بناء الصورة
+docker build -t docx-pdf-arabic .
+
+# تشغيل الحاوية
+docker run -p 7860:7860 docx-pdf-arabic
+
+# أو استخدام docker-compose
+docker-compose up -d
 ```
 
-### 4. Setup Arabic Fonts
+#### المزايا:
+- ✅ بيئة معزولة ومستقرة
+- ✅ سهولة النشر على خوادم مختلفة
+- ✅ تحكم كامل في البيئة
 
-The application includes a script to automatically download and install additional Arabic fonts:
+### 3. 🖥️ التشغيل المحلي المباشر
 
+#### الخطوات:
 ```bash
-chmod +x arabic_fonts_setup.sh
-./arabic_fonts_setup.sh
-```
-
-This script will install:
-- Amiri font (excellent for Traditional Arabic)
-- Scheherazade New font (designed for Arabic script)
+# تثبيت التبعيات النظام (Ubuntu/Debian)
+sudo apt-get update
+sudo apt-get install libreoffice libreoffice-writer \
+  fonts-liberation fonts-dejavu fonts-noto fontconfig
 
-### 5. Update Font Cache
+# تثبيت التبعيات Python
+pip install -r requirements.txt
 
-```bash
-fc-cache -fv
+# تشغيل التطبيق
+python run_local.py
 ```
 
-### 6. Verify Installation
+#### المزايا:
+- ✅ أداء أسرع
+- ✅ تحكم كامل في النظام
+- ✅ سهولة التطوير والاختبار
 
-Check that Arabic fonts are properly installed:
+## 🔧 إعدادات التحسين
 
-```bash
-fc-list | grep -i "arabic\|amiri\|scheherazade"
-```
+### لـ Hugging Face Spaces:
 
-## Docker Deployment
+1. **تحسين packages.txt:**
+   ```
+   libreoffice
+   libreoffice-writer
+   libreoffice-l10n-ar
+   fonts-noto-naskh
+   fonts-amiri
+   fontconfig
+   ```
 
-### Using Docker Compose (Recommended)
+2. **تحسين requirements.txt:**
+   ```
+   gradio==4.20.0
+   ```
 
-1. Build and start the containers:
+3. **إعدادات README.md:**
+   - تأكد من وجود YAML frontmatter صحيح
+   - اضبط sdk_version على النسخة الصحيحة
 
-```bash
-docker-compose up -d
-```
+### للخوادم المخصصة:
 
-2. Access the application at `http://localhost:7860`
+1. **تحسين الذاكرة:**
+   ```bash
+   export JAVA_OPTS="-Xmx2g"
+   export SAL_DISABLE_OPENCL=1
+   ```
 
-### Manual Docker Build
+2. **تحسين الخطوط:**
+   ```bash
+   fc-cache -fv
+   fc-list | grep -i arabic
+   ```
 
-1. Build the Docker image:
+## 🧪 اختبار النشر
 
+### 1. اختبار أساسي:
 ```bash
-docker build -t docx-pdf-converter .
+python test_conversion.py
 ```
 
-2. Run the container:
-
+### 2. اختبار الخطوط العربية:
 ```bash
-docker run -p 7860:7860 docx-pdf-converter
+fc-list | grep -i "amiri\|noto.*arabic"
 ```
 
-## Configuration
-
-### Environment Variables
-
-- `STATIC_DIR` - Directory for storing converted PDFs (default: /app/static)
-- `TEMP_DIR` - Temporary directory for processing (default: /tmp/conversions)
-- `MAX_FILE_SIZE` - Maximum file size in bytes (default: 52428800)
-- `MAX_CONVERSION_TIME` - Conversion timeout in seconds (default: 120)
-
-### Volume Mounts
-
-For persistent storage of converted files:
-
-```yaml
-volumes:
-  - ./static:/app/static
-  - ./conversions:/tmp/conversions
-```
-
-## Troubleshooting
-
-### Common Issues
-
-1. **Font rendering issues**: Ensure all Arabic fonts are properly installed and font cache is updated
-2. **LibreOffice startup failures**: Check that LibreOffice is properly installed and configured
-3. **Permission errors**: Ensure directories have proper write permissions
-
-### Checking Font Installation
-
+### 3. اختبار LibreOffice:
 ```bash
-# List all available Arabic fonts
-fc-list :lang=ar
-
-# Check specific font
-fc-match "Amiri"
+libreoffice --headless --convert-to pdf test.docx
 ```
 
-### LibreOffice Validation
+## 🔍 استكشاف أخطاء النشر
 
+### مشكلة: LibreOffice لا يعمل
+**الحل:**
 ```bash
-# Check LibreOffice version
+# تحقق من التثبيت
 libreoffice --version
 
-# Test headless conversion
-libreoffice --headless --convert-to pdf --outdir /tmp test.docx
+# إعادة تثبيت
+sudo apt-get remove --purge libreoffice*
+sudo apt-get install libreoffice libreoffice-writer
 ```
 
-## Performance Tuning
-
-### Resource Limits
+### مشكلة: الخطوط العربية مفقودة
+**الحل:**
+```bash
+# تثبيت خطوط إضافية
+sudo apt-get install fonts-noto-naskh fonts-amiri
 
-For production deployments, consider setting resource limits:
+# تحديث cache
+sudo fc-cache -fv
 
-```yaml
-deploy:
-  resources:
-    limits:
-      memory: 1G
-      cpus: '0.5'
+# التحقق
+fc-list | grep -i arabic
 ```
 
-### Health Checks
-
-The Docker image includes built-in health checks:
+### مشكلة: أخطاء الذاكرة
+**الحل:**
+```bash
+# زيادة حد الذاكرة
+export JAVA_OPTS="-Xmx4g"
 
-```yaml
-healthcheck:
-  test: ["CMD", "curl", "-f", "http://localhost:7860/health"]
-  interval: 30s
-  timeout: 10s
-  retries: 3
+# تعطيل OpenCL
+export SAL_DISABLE_OPENCL=1
 ```
 
-## Updating the Application
+### مشكلة: بطء التحويل
+**الحل:**
+- قلل حجم الملفات المدخلة
+- استخدم خادم بمواصفات أعلى
+- فعل التخزين المؤقت
 
-1. Pull the latest code:
-
-```bash
-git pull origin main
-```
+## 📊 مراقبة الأداء
 
-2. Rebuild Docker images:
+### مؤشرات مهمة:
+- وقت التحويل (يجب أن يكون < 30 ثانية للملفات العادية)
+- استخدام الذاكرة (يجب أن يكون < 2GB)
+- معدل نجاح التحويل (يجب أن يكون > 95%)
 
+### أدوات المراقبة:
 ```bash
-docker-compose build
-```
+# مراقبة الذاكرة
+htop
 
-3. Restart services:
+# مراقبة العمليات
+ps aux | grep libreoffice
 
-```bash
-docker-compose up -d
+# مراقبة السجلات
+tail -f /var/log/syslog
 ```
 
-## Backup and Recovery
+## 🔒 الأمان
 
-### Backup Converted Files
+### إعدادات الأمان:
+1. تحديد حجم الملفات المرفوعة (< 50MB)
+2. تنظيف الملفات المؤقتة تلقائياً
+3. تحديد وقت انتهاء للعمليات (timeout)
+4. منع تنفيذ الكود الضار في الملفات
 
-```bash
-# Backup static directory containing converted PDFs
-tar -czf static-backup-$(date +%Y%m%d).tar.gz static/
-```
+### أفضل الممارسات:
+- استخدم HTTPS دائماً
+- فعل rate limiting
+- راقب استخدام الموارد
+- احتفظ بنسخ احتياطية من الإعدادات
 
-### Restore Backup
+## 📞 الدعم
 
-```bash
-# Restore static directory
-tar -xzf static-backup-*.tar.gz
-```
+إذا واجهت مشاكل في النشر:
+1. تحقق من السجلات أولاً
+2. تأكد من تثبيت جميع التبعيات
+3. اختبر على بيئة محلية أولاً
+4. راجع دليل استكشاف الأخطاء أعلاه

DOCKER_TROUBLESHOOTING.md

@@ -1,201 +0,0 @@
-# Docker Build Troubleshooting Guide
-
-This document provides solutions for common issues encountered when building the Docker image for the Enhanced DOCX to PDF Converter.
-
-## Common Build Errors and Solutions
-
-### 1. Package Not Found Errors
-
-**Error Message:**
-```
-E: Package 'libreoffice-help-ar' has no installation candidate
-E: Unable to locate package fonts-noto-naskh
-E: Unable to locate package fonts-noto-kufi-arabic
-E: Unable to locate package fonts-amiri
-E: Unable to locate package fonts-scheherazade-new
-```
-
-**Solution:**
-These packages are not available in the Ubuntu 22.04 repository. The Dockerfile has been updated to:
-1. Remove unavailable packages
-2. Install Arabic fonts manually via the `install_arabic_fonts.sh` script
-
-### 2. Font Installation Failures
-
-**Error Message:**
-```
-Failed to download <font-name>
-```
-
-**Solution:**
-The font installation script includes error handling with `|| true` to continue even if some fonts fail to download. This ensures the build process continues and the application remains functional with the available fonts.
-
-### 3. Network Timeout During Font Downloads
-
-**Error Message:**
-```
-wget: unable to resolve host address
-curl: (6) Could not resolve host
-```
-
-**Solution:**
-The font installation script includes:
-- Timeout settings (`--timeout=30`)
-- Retry attempts (`--tries=2` or `--retry 2`)
-- Fallback to alternative download methods (curl if wget fails)
-
-### 4. Permission Denied Errors
-
-**Error Message:**
-```
-chmod: cannot access 'install_arabic_fonts.sh': Permission denied
-```
-
-**Solution:**
-Ensure the script has execute permissions:
-```dockerfile
-RUN chmod +x install_arabic_fonts.sh && \
-    ./install_arabic_fonts.sh || true
-```
-
-### 5. Font Cache Update Failures
-
-**Error Message:**
-```
-fc-cache: command not found
-```
-
-**Solution:**
-Ensure `fontconfig` package is installed:
-```dockerfile
-RUN apt-get update && apt-get install -y \
-    fontconfig \
-    # other packages...
-```
-
-## Dockerfile Best Practices Implemented
-
-### 1. Minimal Base Image
-Using `ubuntu:22.04` for stability and security.
-
-### 2. Efficient Package Installation
-Combining multiple `apt-get install` commands to reduce layers:
-```dockerfile
-RUN apt-get update && apt-get install -y \
-    package1 \
-    package2 \
-    package3 \
-    && rm -rf /var/lib/apt/lists/*
-```
-
-### 3. Proper Cleanup
-Removing apt cache after installation to reduce image size:
-```dockerfile
-&& rm -rf /var/lib/apt/lists/*
-```
-
-### 4. Error Handling
-Using `|| true` to prevent build failures from non-critical steps:
-```dockerfile
-RUN ./install_arabic_fonts.sh || true
-```
-
-### 5. Correct Working Directory
-Setting working directory early in the Dockerfile:
-```dockerfile
-WORKDIR /app
-```
-
-## Manual Font Installation Process
-
-The `install_arabic_fonts.sh` script performs the following steps:
-
-1. Creates font directory: `/usr/share/fonts/truetype/arabic`
-2. Downloads Arabic fonts from reliable sources:
-   - Amiri font
-   - Scheherazade New font
-   - Noto Sans Arabic font
-   - Noto Naskh Arabic font
-3. Extracts and installs font files
-4. Updates font cache with `fc-cache -fv`
-
-## Testing Docker Build Locally
-
-To test the Docker build locally:
-
-```bash
-docker build -t docx-pdf-converter .
-```
-
-To test with no cache (recommended for troubleshooting):
-```bash
-docker build --no-cache -t docx-pdf-converter .
-```
-
-## Hugging Face Spaces Specific Considerations
-
-### 1. Build Time Limits
-Hugging Face Spaces have build time limits. To optimize:
-- Use multi-stage builds if needed
-- Minimize the number of layers
-- Cache dependencies effectively
-
-### 2. Network Restrictions
-Hugging Face build environments may have network restrictions:
-- Use HTTPS for all downloads
-- Include fallback mechanisms
-- Set appropriate timeouts
-
-### 3. Disk Space Limitations
-Monitor image size:
-- Remove unnecessary files after installation
-- Use `.dockerignore` to exclude unnecessary files
-- Consider using smaller base images if needed
-
-## Debugging Build Issues
-
-### 1. Enable Verbose Output
-Add `set -x` to shell scripts for debugging:
-```bash
-#!/bin/bash
-set -x  # Enable verbose output
-```
-
-### 2. Test Individual Commands
-Run commands interactively in a container:
-```bash
-docker run -it ubuntu:22.04 /bin/bash
-```
-
-### 3. Check Available Packages
-List available packages in the build environment:
-```bash
-apt-cache search <package-name>
-apt list --upgradable
-```
-
-## Alternative Solutions
-
-### 1. Using Different Base Images
-If Ubuntu continues to have issues, consider:
-- `debian:stable-slim`
-- `alpine:latest` (with proper package mapping)
-
-### 2. Pre-downloading Fonts
-Include font files directly in the repository to avoid network dependencies during build.
-
-### 3. Using Font Packages from Different Repositories
-Add additional package repositories if needed:
-```dockerfile
-RUN echo "deb http://ppa.launchpad.net/libreoffice/ppa/ubuntu jammy main" > /etc/apt/sources.list.d/libreoffice.list
-```
-
-## Contact Support
-
-If you continue to experience issues:
-1. Check the Hugging Face community forums
-2. Review the build logs carefully
-3. Test the Dockerfile locally first
-4. Contact Hugging Face support with detailed error information
-
-This troubleshooting guide should help resolve most common Docker build issues for the Enhanced DOCX to PDF Converter.

Dockerfile

@@ -1,4 +1,4 @@
-# Dockerfile for DOCX to PDF Converter with Enhanced Arabic Support
+# Dockerfile for Enhanced DOCX to PDF Converter
 FROM ubuntu:22.04
 
 # Set environment variables for Arabic support
@@ -6,15 +6,15 @@ ENV DEBIAN_FRONTEND=noninteractive
 ENV LANG=ar_SA.UTF-8
 ENV LC_ALL=ar_SA.UTF-8
 ENV PYTHONUNBUFFERED=1
-ENV STATIC_DIR=/app/static
 
-# Install system dependencies including available Arabic fonts
+# Install system dependencies including Arabic fonts and Python
 RUN apt-get update && apt-get install -y \
     python3 \
     python3-pip \
     libreoffice \
     libreoffice-writer \
     libreoffice-l10n-ar \
+    libreoffice-help-ar \
     fonts-liberation \
     fonts-liberation2 \
     fonts-dejavu \
@@ -25,8 +25,12 @@ RUN apt-get update && apt-get install -y \
     fonts-noto-ui-core \
     fonts-noto-mono \
     fonts-noto-color-emoji \
+    fonts-noto-naskh \
+    fonts-noto-kufi-arabic \
     fonts-opensymbol \
     fonts-freefont-ttf \
+    fonts-amiri \
+    fonts-scheherazade-new \
     fontconfig \
     wget \
     curl \
@@ -40,33 +44,28 @@ RUN locale-gen ar_SA.UTF-8
 # Set working directory
 WORKDIR /app
 
-# Create necessary directories
-RUN mkdir -p /tmp/libreoffice_conversion && \
-    mkdir -p /app/static && \
-    chmod 777 /app/static
-
 # Copy requirements and install Python dependencies
 COPY requirements.txt .
 RUN pip3 install --no-cache-dir -r requirements.txt
 
 # Copy application files
-COPY app.py .
-COPY arabic_fonts_setup.sh .
-COPY libreoffice_arabic_config.xml .
-
-# Setup additional Arabic fonts
-RUN chmod +x arabic_fonts_setup.sh && \
-    ./arabic_fonts_setup.sh || true
+COPY src/ src/
+COPY arial.ttf .
 
-# Update font cache
+# Setup font configuration
+RUN mkdir -p /usr/share/fonts/truetype/local-arial
+RUN cp arial.ttf /usr/share/fonts/truetype/local-arial/
 RUN fc-cache -fv
 
+# Create necessary directories
+RUN mkdir -p /tmp/conversions
+
 # Expose port
 EXPOSE 7860
 
 # Health check
 HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
-    CMD curl -f http://localhost:7860/ || exit 1
+    CMD curl -f http://localhost:7860/health || exit 1
 
 # Run the application
-CMD ["python3", "app.py"]
+CMD ["python3", "src/api/app.py"]

HUGGINGFACE_DEPLOYMENT.md

@@ -67,12 +67,12 @@ The Space is configured through the README.md file:
 
 ```yaml
 ---
-title: Enhanced DOCX to PDF Converter with Arabic Support
+title: Enhanced DOCX to PDF Converter
 emoji: 📄
 colorFrom: blue
 colorTo: purple
 sdk: docker
-app_file: app.py
+app_file: Dockerfile
 pinned: false
 ---
 ```
@@ -84,7 +84,7 @@ pinned: false
 - **colorFrom**: Gradient start color
 - **colorTo**: Gradient end color
 - **sdk**: Must be "docker" for this application
-- **app_file**: Must point to "app.py" (the main application file)
+- **app_file**: Must point to "Dockerfile"
 - **pinned**: Whether to pin the Space to your profile
 
 ## API Usage
@@ -114,13 +114,6 @@ curl -X POST "https://your-username-your-space-name.hf.space/convert/batch" \
   }'
 ```
 
-### Access Converted PDFs
-Converted PDFs are stored in a static directory and can be accessed directly:
-```bash
-# Access PDF directly via static URL
-https://your-username-your-space-name.hf.space/static/uuid_filename.pdf
-```
-
 ### Health Check
 ```bash
 curl "https://your-username-your-space-name.hf.space/health"
@@ -132,10 +125,9 @@ curl "https://your-username-your-space-name.hf.space/health"
 
 You can set environment variables in your Space settings:
 
-- `STATIC_DIR`: Directory for storing converted PDFs (default: /app/static)
-- `TEMP_DIR`: Temporary directory for conversions (default: /tmp/conversions)
 - `MAX_FILE_SIZE`: Maximum file size in bytes (default: 52428800)
 - `MAX_CONVERSION_TIME`: Conversion timeout in seconds (default: 120)
+- `TEMP_DIR`: Temporary directory for conversions (default: /tmp/conversions)
 
 ### Hardware Upgrade
 
@@ -163,20 +155,6 @@ For processing larger files or handling more concurrent requests, consider upgra
    - Check file size limits
    - Review application logs for conversion errors
 
-### Docker Build Issues
-
-If you encounter package installation errors during the Docker build:
-
-1. **Package Not Found Errors**: The Dockerfile has been updated to remove unavailable packages:
-   - Removed: `libreoffice-help-ar`, `fonts-noto-naskh`, `fonts-noto-kufi-arabic`, `fonts-amiri`, `fonts-scheherazade-new`
-   - These fonts are now installed manually via the `arabic_fonts_setup.sh` script.
-
-2. **Font Installation Failures**: The font installation script includes error handling to continue even if some fonts fail to download.
-
-3. **Network Timeout**: The script includes timeout settings and retry attempts for font downloads.
-
-See [DOCKER_TROUBLESHOOTING.md](DOCKER_TROUBLESHOOTING.md) for detailed troubleshooting steps.
-
 ### Logs and Monitoring
 
 Monitor your Space through:

README.md

@@ -1,104 +1,129 @@
 ---
-title: Enhanced DOCX to PDF Converter with Arabic Support
+title: محول DOCX إلى PDF المتقدم - دقة 99%+ للعربية
 emoji: 📄
-colorFrom: blue
-colorTo: purple
-sdk: docker
+colorFrom: gray
+colorTo: blue
+sdk: gradio
+sdk_version: "4.20.0"
 app_file: app.py
 pinned: false
 ---
 
-# Enhanced DOCX to PDF Converter with Arabic Support
+# 🚀 محول DOCX إلى PDF المتقدم - دقة 99%+ للتنسيق العربي
 
-This enhanced version of the DOCX to PDF converter provides professional API capabilities with improved Arabic language support and better file handling.
+محول من الجيل الجديد مع **تقنيات متقدمة لضمان دقة 99%+ في التنسيق العربي** - يتضمن معالجة مسبقة ذكية، مراقبة لاحقة، وتقارير جودة شاملة.
 
-## Features
+## 🎯 التقنيات المتقدمة الجديدة
 
-- ✅ Perfect DOCX to PDF conversion with formatting preservation
-- ✅ Enhanced Arabic RTL text support
-- ✅ Professional FastAPI-based RESTful API
-- ✅ Static file serving for converted PDFs
-- ✅ Direct URL access to converted PDFs
-- ✅ Inline PDF viewing in browser
-- ✅ Multi-file batch processing
-- ✅ Base64 encoded file support
-- ✅ Comprehensive error handling
-- ✅ Docker containerization support
-- ✅ Health monitoring endpoints
-- ✅ CORS support for web integration
+### 🔧 معالجة DOCX مسبقة ذكية
+- **كشف المشاكل تلقائياً**: يحدد TextBoxes، SmartArt، والأشكال المعقدة
+- **إزالة العناصر المشكلة**: يحول العناصر المشكلة إلى تنسيقات متوافقة
+- **تحسين بنية الجداول**: يصلح الجداول المتداخلة ومشاكل دمج الخلايا
+- **حماية Placeholders**: يضمن بقاء {{name}}, {{date}} في مواضعها الدقيقة
 
-## API Endpoints
+### ⚙️ إعدادات LibreOffice محسنة
+- **70+ معامل تصدير PDF**: تكوين JSON محسن لأقصى جودة
+- **بدون ضغط**: يحافظ على جودة الصور والنصوص الأصلية
+- **تضمين الخطوط**: جميع الخطوط مضمنة للعرض المتسق
+- **إعدادات RTL متخصصة**: تكوين خاص لاتجاه النص العربي
 
-- `POST /convert` - Convert a single DOCX file to PDF
-- `POST /convert/batch` - Convert multiple DOCX files to PDF
-- `GET /static/{filename}` - Access converted PDF files directly
-- `GET /health` - Application health check
-- `GET /docs` - Interactive API documentation
+### 🔍 مراقبة لاحقة بـ PyMuPDF
+- **تحقق من موضع العناصر**: يؤكد أن كل عنصر في الموضع الصحيح
+- **تحقق من الأحرف العربية**: يتحقق من دقة عرض النص RTL
+- **فحص بنية الجداول**: يضمن الحفاظ على تخطيط الجداول
+- **تتبع Placeholders**: يراقب موضع المحتوى الديناميكي
 
-## How It Works
+## ✨ الميزات المحسنة للعربية
 
-1. Upload a DOCX file via the API
-2. The file is converted to PDF using LibreOffice
-3. The converted PDF is stored in a static directory
-4. A direct URL to the PDF is returned
-5. The PDF can be accessed directly via the URL or opened in the browser
+- **🔤 تميز الخطوط**: توافق كامل مع الخطوط العربية (Traditional Arabic→Amiri، Arabic Typesetting→Noto Naskh، Simplified Arabic→Noto Naskh)
+- **📊 كمال الجداول**: يحافظ على المساحة الدقيقة للخلايا والحدود والمحاذاة وتنسيق النص
+- **🖼️ أقصى جودة للصور**: الحفاظ على 600 DPI بدون ضغط مدمر
+- **🌍 دعم العربية RTL**: عرض مثالي للنص من اليمين إلى اليسار مع خطوط Amiri و Noto
+- **🔍 التحقق من الجودة**: تحليل فوري للمستند والتحقق من التحويل
+- **🛠️ تشخيص متقدم**: تحليل شامل للأخطاء مع إرشادات استكشاف الأخطاء المحددة
+- **⚡ أداء محسن**: تكوين LibreOffice محسن للمستندات المعقدة العربية
 
-## Static File Serving
+## 🛠️ حلول المشاكل الشائعة
 
-Converted PDF files are stored in a static directory and served directly via URLs:
-- Files are stored in `/app/static` directory
-- Access via `https://your-domain/static/{filename}`
-- PDFs open inline in the browser by default
+✅ **تم حل المشاكل التالية:**
+- ❌ تراكب النصوص العربية وعدم وجود فراغات كافية
+- ❌ فقدان المحاذاة اليمنى (Right-to-Left) في النص العربي
+- ❌ استبدال الخطوط الأصلية بخطوط غير داعمة للعربية
+- ❌ تشوه الجداول أو اختفاء البنية التنظيمية للوثيقة
+- ❌ تغيير مواقع قوالب التع��ئة الديناميكية (مثل {{name}}, {{date}})
+- ❌ حجم الصفحة أو الهامش غير مناسب للطباعة بشكل مرتب (A4)
 
-## Usage
+## 🚀 Usage
 
-### Web Interface
+1. Upload your `.docx` file
+2. Wait for conversion to complete
+3. Download the generated PDF
 
-Use the provided HTML interface to test the converter:
-1. Open `test_interface.html` in your browser
-2. Select a DOCX file
-3. Click "Convert to PDF"
-4. Click "Open PDF in Browser" to view the converted file
+## 🔧 Technical Excellence
 
-### API Usage
+- **Backend**: Enhanced LibreOffice with maximum quality PDF export settings
+- **Frontend**: Advanced Gradio interface with real-time validation feedback
+- **Font System**: Comprehensive font packages including:
+  - Liberation fonts (Arial/Times/Courier/Calibri/Cambria compatible)
+  - Croscore fonts (Arimo/Tinos/Cousine for additional compatibility)
+  - DejaVu and Noto fonts for international support
+  - Advanced fontconfig with Microsoft font substitution rules
+- **Quality Assurance**: Document structure analysis and PDF validation
+- **Error Handling**: Intelligent error analysis with specific troubleshooting guidance
+- **Environment**: Optimized for Hugging Face Spaces with all dependencies pre-configured
 
-```bash
-# Single file conversion
-curl -X POST -F "file=@document.docx" https://your-domain/convert
+## 📋 Comprehensive Support
 
-# Response will include a direct URL to the PDF:
-# {
-#   "success": true,
-#   "pdf_url": "/static/uuid_filename.pdf",
-#   "message": "Conversion successful"
-# }
+- ✅ **Complex Documents**: Tables, images, mixed fonts, multi-page layouts
+- ✅ **Microsoft Compatibility**: Perfect handling of Calibri, Cambria, Arial, Times New Roman
+- ✅ **International Text**: Arabic RTL, Unicode, special characters
+- ✅ **Large Files**: Documents up to 50MB with unlimited complexity
+- ✅ **Quality Validation**: Real-time analysis ensures perfect conversion results
 
-# Access the PDF directly at: https://your-domain/static/uuid_filename.pdf
-```
+## 🎯 Critical Success Metrics
 
-## Deployment
+✅ **Page Count**: DOCX pages = PDF pages (EXACTLY)
+✅ **Table Text**: Same size, weight, and position
+✅ **Images**: No quality loss, exact positioning
+✅ **Fonts**: Consistent rendering, no size changes
+✅ **Layout**: Zero pixel shifts or reflowing
+✅ **File Size**: Reasonable output without bloat
 
-### Docker Deployment
+## 🏗️ Local Development
 
 ```bash
-docker-compose up -d
+# Install comprehensive system dependencies (Ubuntu/Debian)
+sudo apt-get update
+sudo apt-get install libreoffice libreoffice-writer \
+  fonts-liberation fonts-liberation2 fonts-dejavu fonts-croscore \
+  fonts-noto-core fonts-opensymbol fontconfig
+
+# Update font cache
+sudo fc-cache -fv
+
+# Install Python dependencies
+pip install -r requirements.txt
+
+# Run the app with enhanced formatting preservation
+python app.py
 ```
 
-### Environment Variables
+For Hugging Face Spaces deployment, all system dependencies are automatically installed via the enhanced `packages.txt`.
+
+## 🚀 Implementation Standards
 
-- `STATIC_DIR` - Directory for storing converted PDFs (default: /app/static)
-- `TEMP_DIR` - Temporary directory for processing (default: /tmp/conversions)
-- `MAX_FILE_SIZE` - Maximum file size in bytes (default: 52428800)
-- `MAX_CONVERSION_TIME` - Conversion timeout in seconds (default: 120)
+This converter implements the requirements from `bb.txt` with absolute precision:
 
-## Arabic Language Support
+- **Enhanced Font Packages**: Complete Microsoft-compatible font ecosystem
+- **Optimized LibreOffice Command**: Quality:100, font embedding, layout preservation
+- **Advanced Configuration**: Custom registrymodifications.xcu with font substitution rules
+- **Environment Excellence**: Proper LANG, fontconfig, and LibreOffice user profile setup
+- **Quality Assurance**: Document analysis, PDF validation, and comprehensive error handling
 
-This converter includes enhanced support for Arabic text:
-- Proper RTL text handling
-- Arabic font installation and configuration
-- Font substitution rules for optimal rendering
-- Support for complex Arabic script features
+## 🎯 Final Goal Achievement
 
-## License
+Creates DOCX to PDF conversions so accurate that users cannot tell the difference between the original DOCX and the converted PDF when viewed side by side. **Zero tolerance for formatting deviations.**
+
+---
 
-This project is licensed under the MIT License.
+**Built for Hugging Face Spaces** | Enterprise-Grade • Pixel-Perfect • Uncompromising Quality

UPDATE_HF_SPACE.md

@@ -1,125 +0,0 @@
-# Updating Your Hugging Face Space
-
-This document provides instructions for updating your deployed Hugging Face Space with the latest fixes.
-
-## Prerequisites
-
-1. Your Hugging Face Space is already deployed
-2. You have write access to the Space repository
-3. Git is installed on your local machine
-
-## Update Steps
-
-### 1. Clone Your Space Repository
-
-If you haven't already cloned your Space repository:
-
-```bash
-git clone https://huggingface.co/spaces/your-username/your-space-name
-cd your-space-name
-```
-
-If you already have a local clone, make sure it's up to date:
-
-```bash
-cd your-space-name
-git pull
-```
-
-### 2. Update Files
-
-Copy the updated files from this project to your Space repository:
-
-```bash
-# From this project directory, copy all files to your Space repository
-cp -r /path/to/enhanced-docx-to-pdf/* /path/to/your/space/repository/
-```
-
-Alternatively, you can selectively copy the updated files:
-
-```bash
-# Copy the updated main application file
-cp src/api/main.py /path/to/your/space/repository/src/api/main.py
-
-# Copy any other updated files as needed
-```
-
-### 3. Commit and Push Changes
-
-Add, commit, and push the changes to your Space repository:
-
-```bash
-cd /path/to/your/space/repository
-git add .
-git commit -m "Fix root endpoint and improve web interface"
-git push
-```
-
-### 4. Monitor the Build
-
-1. Go to your Space page on Hugging Face
-2. Click on the "Logs" tab to monitor the build process
-3. Wait for the build to complete successfully
-
-### 5. Verify the Update
-
-Once the build completes:
-
-1. Visit your Space URL: `https://your-username-your-space-name.hf.space`
-2. You should now see the web interface instead of a 404 error
-3. Test the file conversion functionality
-4. Check the API documentation at `/docs`
-
-## What's Fixed
-
-The update includes:
-
-1. **Root Endpoint Fix**: The application now properly serves the web interface at the root path
-2. **Improved Web Interface**: Enhanced user interface with better styling
-3. **Better Error Handling**: More robust error handling for file conversions
-4. **Docker Build Fixes**: Resolved issues with Arabic font installation
-
-## Troubleshooting
-
-### If the Build Fails
-
-1. Check the build logs for specific error messages
-2. Ensure all required files are included in the commit
-3. Verify that the Dockerfile syntax is correct
-
-### If the Application Still Shows 404
-
-1. Confirm that the `templates/index.html` file is present
-2. Check that the root endpoint handler is in `src/api/main.py`
-3. Verify the application logs for any startup errors
-
-### If File Conversion Fails
-
-1. Check the application logs for conversion errors
-2. Ensure the input file is a valid DOCX document
-3. Verify file size limits are not exceeded
-
-## Rollback (If Needed)
-
-If you need to rollback to the previous version:
-
-1. Find the previous commit hash:
-   ```bash
-   git log --oneline
-   ```
-
-2. Reset to the previous commit:
-   ```bash
-   git reset --hard <previous-commit-hash>
-   git push --force
-   ```
-
-## Support
-
-If you continue to experience issues:
-
-1. Check the Hugging Face community forums
-2. Review the application logs carefully
-3. Contact the maintainers with detailed error information
-
-This update should resolve the 404 error and provide a better user experience for your DOCX to PDF conversion Space.

docker-compose.yml

@@ -1,9 +1,9 @@
 version: '3.8'
 
 services:
-  docx-to-pdf-arabic:
+  docx-to-pdf-enhanced:
     build: .
-    container_name: docx-pdf-converter-arabic
+    container_name: docx-pdf-converter-enhanced
     ports:
       - "7860:7860"
     environment:
@@ -11,15 +11,12 @@ services:
       - LC_ALL=ar_SA.UTF-8
       - PYTHONUNBUFFERED=1
       - TEMP_DIR=/tmp/conversions
-      - STATIC_DIR=/app/static
     volumes:
-      # Optional: Mount local directories for testing
-      - ./test_files:/app/test_files:ro
-      - ./test_results:/app/test_results
-      - ./static:/app/static
+      # Mount for persistent storage of conversions
+      - ./conversions:/tmp/conversions
     restart: unless-stopped
     healthcheck:
-      test: ["CMD", "curl", "-f", "http://localhost:7860/"]
+      test: ["CMD", "curl", "-f", "http://localhost:7860/health"]
       interval: 30s
       timeout: 10s
       retries: 3

install_arabic_fonts.sh

@@ -1,82 +0,0 @@
-#!/bin/bash
-
-# Script to install Arabic fonts manually
-set -e
-
-echo "Installing Arabic fonts manually..."
-
-# Create fonts directory
-mkdir -p /usr/share/fonts/truetype/arabic
-
-# Function to download and install font
-download_font() {
-    local url=$1
-    local filename=$2
-    echo "Downloading $filename..."
-    
-    # Try to download with wget
-    if command -v wget >/dev/null 2>&1; then
-        if wget --timeout=30 --tries=2 -q "$url" -O "/tmp/$filename"; then
-            install_font_file "/tmp/$filename"
-            rm -f "/tmp/$filename"
-            return 0
-        fi
-    fi
-    
-    # Try to download with curl if wget failed
-    if command -v curl >/dev/null 2>&1; then
-        if curl --max-time 30 --retry 2 -s -L "$url" -o "/tmp/$filename"; then
-            install_font_file "/tmp/$filename"
-            rm -f "/tmp/$filename"
-            return 0
-        fi
-    fi
-    
-    echo "Failed to download $filename"
-    return 1
-}
-
-# Function to install font file
-install_font_file() {
-    local filepath=$1
-    
-    if [[ "$filepath" == *.zip ]]; then
-        # Extract zip file
-        if command -v unzip >/dev/null 2>&1; then
-            cd /tmp
-            if unzip -q "$filepath"; then
-                # Find and copy TTF files
-                find . -name "*.ttf" -exec cp {} /usr/share/fonts/truetype/arabic/ \; 2>/dev/null || true
-                # Cleanup
-                rm -rf *.zip */ 2>/dev/null || true
-                echo "Installed fonts from zip file"
-            else
-                echo "Failed to extract zip file"
-            fi
-        else
-            echo "unzip not available"
-        fi
-    else
-        # Copy TTF file directly
-        if cp "$filepath" /usr/share/fonts/truetype/arabic/ 2>/dev/null; then
-            echo "Installed font file"
-        else
-            echo "Failed to copy font file"
-        fi
-    fi
-}
-
-# Download and install various Arabic fonts
-# Continue even if some downloads fail
-set +e
-download_font "https://github.com/aliftype/amiri/releases/download/0.117/Amiri-0.117.zip" "Amiri-0.117.zip" || true
-download_font "https://github.com/silnrsi/font-scheherazade/releases/download/v3.300/ScheherazadeNew-3.300.zip" "ScheherazadeNew-3.300.zip" || true
-download_font "https://github.com/notofonts/notofonts.github.io/raw/main/fonts/NotoSansArabic/hinted/ttf/NotoSansArabic-Regular.ttf" "NotoSansArabic-Regular.ttf" || true
-download_font "https://github.com/notofonts/notofonts.github.io/raw/main/fonts/NotoNaskhArabic/hinted/ttf/NotoNaskhArabic-Regular.ttf" "NotoNaskhArabic-Regular.ttf" || true
-set -e
-
-# Update font cache
-echo "Updating font cache..."
-fc-cache -fv || echo "Warning: Failed to update font cache"
-
-echo "Arabic fonts installation completed!"

simple_test.html

@@ -1,225 +0,0 @@
-<!DOCTYPE html>
-<html lang="ar">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>اختبار تحويل DOCX إلى PDF</title>
-    <style>
-        body {
-            font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
-            max-width: 800px;
-            margin: 0 auto;
-            padding: 20px;
-            background-color: #f5f7fa;
-            direction: rtl;
-            text-align: right;
-        }
-        
-        .container {
-            background: white;
-            border-radius: 10px;
-            padding: 30px;
-            box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
-        }
-        
-        h1 {
-            color: #2c3e50;
-            text-align: center;
-        }
-        
-        .form-group {
-            margin-bottom: 20px;
-        }
-        
-        label {
-            display: block;
-            margin-bottom: 8px;
-            font-weight: bold;
-            color: #34495e;
-        }
-        
-        input[type="file"] {
-            width: 100%;
-            padding: 12px;
-            border: 2px dashed #bdc3c7;
-            border-radius: 5px;
-            background-color: #ecf0f1;
-        }
-        
-        button {
-            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
-            color: white;
-            border: none;
-            padding: 12px 24px;
-            border-radius: 5px;
-            cursor: pointer;
-            font-size: 16px;
-            font-weight: bold;
-            width: 100%;
-            transition: transform 0.2s;
-        }
-        
-        button:hover {
-            transform: translateY(-2px);
-        }
-        
-        button:disabled {
-            background: #bdc3c7;
-            cursor: not-allowed;
-            transform: none;
-        }
-        
-        .result {
-            margin-top: 20px;
-            padding: 15px;
-            border-radius: 5px;
-            display: none;
-        }
-        
-        .success {
-            background-color: #d4edda;
-            color: #155724;
-            border: 1px solid #c3e6cb;
-        }
-        
-        .error {
-            background-color: #f8d7da;
-            color: #721c24;
-            border: 1px solid #f5c6cb;
-        }
-        
-        .loading {
-            text-align: center;
-            display: none;
-        }
-        
-        .spinner {
-            border: 4px solid #f3f3f3;
-            border-top: 4px solid #667eea;
-            border-radius: 50%;
-            width: 30px;
-            height: 30px;
-            animation: spin 1s linear infinite;
-            margin: 0 auto 10px;
-        }
-        
-        @keyframes spin {
-            0% { transform: rotate(0deg); }
-            100% { transform: rotate(360deg); }
-        }
-        
-        .instructions {
-            background: #e3f2fd;
-            padding: 15px;
-            border-radius: 5px;
-            margin-top: 20px;
-        }
-    </style>
-</head>
-<body>
-    <div class="container">
-        <h1>اختبار تحويل DOCX إلى PDF</h1>
-        
-        <div class="form-group">
-            <label for="docxFile">اختر ملف DOCX:</label>
-            <input type="file" id="docxFile" accept=".docx" required>
-        </div>
-        
-        <button id="convertBtn" disabled>تحويل إلى PDF</button>
-        
-        <div class="loading" id="loading">
-            <div class="spinner"></div>
-            <p>جاري التحويل... يرجى الانتظار</p>
-        </div>
-        
-        <div class="result success" id="successResult">
-            <h3>تم التحويل بنجاح!</h3>
-            <p>يمكنك تنزيل ملف PDF المحول:</p>
-            <a id="downloadLink" href="#" target="_blank" style="display: inline-block; margin-top: 10px; padding: 10px 20px; background: #27ae60; color: white; text-decoration: none; border-radius: 5px;">تنزيل PDF</a>
-        </div>
-        
-        <div class="result error" id="errorResult">
-            <h3>حدث خطأ</h3>
-            <p id="errorMessage"></p>
-        </div>
-        
-        <div class="instructions">
-            <h3>كيفية الاستخدام:</h3>
-            <ol>
-                <li>اختر ملف DOCX باستخدام الزر أعلاه</li>
-                <li>انقر على زر "تحويل إلى PDF"</li>
-                <li>انتظر حتى يكتمل التحويل</li>
-                <li>انقر على "تنزيل PDF" للحصول على ملفك المحول</li>
-            </ol>
-            <p><strong>ملاحظة:</strong> هذا الواجهة تتصل مباشرة بمساحتك على Hugging Face Space.</p>
-        </div>
-    </div>
-
-    <script>
-        document.getElementById('docxFile').addEventListener('change', function(e) {
-            const file = e.target.files[0];
-            const convertBtn = document.getElementById('convertBtn');
-            
-            if (file && file.name.endsWith('.docx')) {
-                convertBtn.disabled = false;
-            } else {
-                convertBtn.disabled = true;
-                alert('الرجاء اختيار ملف DOCX فقط');
-            }
-        });
-        
-        document.getElementById('convertBtn').addEventListener('click', async function() {
-            const fileInput = document.getElementById('docxFile');
-            const convertBtn = document.getElementById('convertBtn');
-            const loading = document.getElementById('loading');
-            const successResult = document.getElementById('successResult');
-            const errorResult = document.getElementById('errorResult');
-            const errorMessage = document.getElementById('errorMessage');
-            const downloadLink = document.getElementById('downloadLink');
-            
-            // Reset UI
-            successResult.style.display = 'none';
-            errorResult.style.display = 'none';
-            
-            const file = fileInput.files[0];
-            if (!file) {
-                alert('الرجاء اختيار ملف أولاً');
-                return;
-            }
-            
-            // Show loading
-            convertBtn.disabled = true;
-            loading.style.display = 'block';
-            
-            try {
-                // Create FormData
-                const formData = new FormData();
-                formData.append('file', file);
-                
-                // Send request to your Hugging Face Space
-                const response = await fetch('https://fokan-pdf-4.hf.space/convert', {
-                    method: 'POST',
-                    body: formData
-                });
-                
-                const result = await response.json();
-                
-                if (result.success) {
-                    // Show success
-                    loading.style.display = 'none';
-                    successResult.style.display = 'block';
-                    downloadLink.href = 'https://fokan-pdf-4.hf.space' + result.pdf_url;
-                } else {
-                    throw new Error(result.error || 'فشل التحويل');
-                }
-            } catch (error) {
-                loading.style.display = 'none';
-                errorResult.style.display = 'block';
-                errorMessage.textContent = error.message || 'حدث خطأ أثناء التحويل';
-            } finally {
-                convertBtn.disabled = false;
-            }
-        });
-    </script>
-</body>
-</html>

src/api/main.py

@@ -16,13 +16,8 @@ from fastapi import FastAPI, File, UploadFile, Form, HTTPException, BackgroundTa
 from fastapi.responses import FileResponse, JSONResponse
 from fastapi.middleware.cors import CORSMiddleware
 from fastapi.staticfiles import StaticFiles
-from fastapi.responses import HTMLResponse
 from pydantic import BaseModel
 
-# Set environment variables for LibreOffice before importing other modules
-os.environ['HOME'] = '/tmp'
-os.environ['USERPROFILE'] = '/tmp'
-
 # Import utility modules
 from src.utils.config import Config
 from src.utils.file_handler import FileHandler
@@ -54,47 +49,18 @@ app.add_middleware(
     allow_headers=Config.CORS_HEADERS,
 )
 
-# Create static directory if it doesn't exist
-os.makedirs(Config.STATIC_DIR, exist_ok=True)
-
-# Mount static files
-app.mount("/static", StaticFiles(directory=Config.STATIC_DIR), name="static")
+# Mount static files if templates directory exists
+if os.path.exists("templates"):
+    app.mount("/static", StaticFiles(directory="templates"), name="static")
 
 # Serve index.html at root if it exists
 if os.path.exists("templates/index.html"):
+    from fastapi.responses import HTMLResponse
+    
     @app.get("/", response_class=HTMLResponse)
     async def read_index():
         with open("templates/index.html", "r", encoding="utf-8") as f:
             return f.read()
-else:
-    @app.get("/", response_class=HTMLResponse)
-    async def read_index():
-        return """
-        <!DOCTYPE html>
-        <html>
-        <head>
-            <title>Enhanced DOCX to PDF Converter</title>
-            <style>
-                body { font-family: Arial, sans-serif; margin: 40px; }
-                .container { max-width: 800px; margin: 0 auto; }
-                h1 { color: #333; }
-                .info { background: #f5f5f5; padding: 20px; border-radius: 5px; }
-                a { color: #007bff; text-decoration: none; }
-                a:hover { text-decoration: underline; }
-            </style>
-        </head>
-        <body>
-            <div class="container">
-                <h1>Enhanced DOCX to PDF Converter</h1>
-                <div class="info">
-                    <p>The API is running successfully!</p>
-                    <p><a href="/docs">View API Documentation</a></p>
-                    <p><a href="/health">Health Check</a></p>
-                </div>
-            </div>
-        </body>
-        </html>
-        """
 
 # Request/Response Models
 class ConversionRequest(BaseModel):
@@ -118,28 +84,12 @@ async def startup_event():
     """Initialize application on startup"""
     logger.info("Starting Enhanced DOCX to PDF Converter...")
     
-    # Set environment variables for LibreOffice
-    os.environ['HOME'] = '/tmp'
-    os.environ['USERPROFILE'] = '/tmp'
-    
     # Validate LibreOffice installation
     if not converter.validate_libreoffice():
         logger.warning("LibreOffice validation failed - conversions may not work")
     
     # Create temp directory if it doesn't exist
-    try:
-        os.makedirs(Config.TEMP_DIR, exist_ok=True)
-        os.chmod(Config.TEMP_DIR, 0o777)
-        logger.info(f"Ensured temp directory exists: {Config.TEMP_DIR}")
-    except Exception as e:
-        logger.error(f"Failed to create temp directory {Config.TEMP_DIR}: {e}")
-    
-    # Create static directory if it doesn't exist
-    try:
-        os.makedirs(Config.STATIC_DIR, exist_ok=True)
-        logger.info(f"Ensured static directory exists: {Config.STATIC_DIR}")
-    except Exception as e:
-        logger.error(f"Failed to create static directory {Config.STATIC_DIR}: {e}")
+    os.makedirs(Config.TEMP_DIR, exist_ok=True)
     
     logger.info("Application started successfully")
 
@@ -209,16 +159,8 @@ async def convert_docx(
         if not converter.convert_docx_to_pdf(input_path, output_path):
             raise HTTPException(status_code=500, detail="Conversion failed")
         
-        # Generate a unique filename for the static directory
-        unique_filename = f"{uuid.uuid4()}_{output_filename}"
-        static_file_path = os.path.join(Config.STATIC_DIR, unique_filename)
-        
-        # Move the converted PDF to the static directory
-        import shutil
-        shutil.move(output_path, static_file_path)
-        
-        # Return success response with direct URL to the PDF
-        pdf_url = f"/static/{unique_filename}"
+        # Return success response
+        pdf_url = f"/download/{os.path.basename(temp_dir)}/{output_filename}"
         return ConversionResponse(
             success=True,
             pdf_url=pdf_url,
@@ -231,18 +173,12 @@ async def convert_docx(
         logger.error(f"Conversion error: {e}")
         raise HTTPException(status_code=500, detail=f"Conversion failed: {str(e)}")
     finally:
-        # Cleanup temporary directory
-        if temp_dir and os.path.exists(temp_dir):
-            import shutil
-            try:
-                shutil.rmtree(temp_dir)
-                logger.info(f"Cleaned up temporary directory: {temp_dir}")
-            except Exception as e:
-                logger.error(f"Failed to cleanup directory {temp_dir}: {e}")
+        # Cleanup will be handled by download endpoint or background task
+        pass
 
 @app.get("/download/{temp_id}/{filename}")
 async def download_pdf(temp_id: str, filename: str):
-    """Download converted PDF file with inline content disposition"""
+    """Download converted PDF file"""
     try:
         file_path = f"{Config.TEMP_DIR}/{temp_id}/{filename}"
         
@@ -252,8 +188,7 @@ async def download_pdf(temp_id: str, filename: str):
         return FileResponse(
             path=file_path,
             filename=filename,
-            media_type='application/pdf',
-            headers={"Content-Disposition": "inline"}
+            media_type='application/pdf'
         )
     except HTTPException:
         raise
@@ -299,16 +234,7 @@ async def batch_convert(request: BatchConversionRequest):
             
             # Perform conversion
             if converter.convert_docx_to_pdf(input_path, output_path):
-                # Generate a unique filename for the static directory
-                unique_filename = f"{uuid.uuid4()}_{output_filename}"
-                static_file_path = os.path.join(Config.STATIC_DIR, unique_filename)
-                
-                # Move the converted PDF to the static directory
-                import shutil
-                shutil.move(output_path, static_file_path)
-                
-                # Return success response with direct URL to the PDF
-                pdf_url = f"/static/{unique_filename}"
+                pdf_url = f"/download/{os.path.basename(temp_dir)}/{output_filename}"
                 results.append(ConversionResponse(
                     success=True,
                     pdf_url=pdf_url,
@@ -326,14 +252,5 @@ async def batch_convert(request: BatchConversionRequest):
                 success=False,
                 error=str(e)
             ))
-        finally:
-            # Cleanup temporary directory
-            if 'temp_dir' in locals() and os.path.exists(temp_dir):
-                import shutil
-                try:
-                    shutil.rmtree(temp_dir)
-                    logger.info(f"Cleaned up temporary directory: {temp_dir}")
-                except Exception as cleanup_e:
-                    logger.error(f"Failed to cleanup directory {temp_dir}: {cleanup_e}")
     
     return results

src/utils/config.py

@@ -18,12 +18,8 @@ class Config:
     
     # Conversion settings
     MAX_CONVERSION_TIME = int(os.environ.get("MAX_CONVERSION_TIME", 120))  # 2 minutes
-    # Use /tmp/conversions as it's more likely to be writable in containerized environments
     TEMP_DIR = os.environ.get("TEMP_DIR", "/tmp/conversions")
     
-    # Static files directory for storing converted PDFs
-    STATIC_DIR = os.environ.get("STATIC_DIR", "/app/static")
-    
     # API settings
     API_TITLE = "Enhanced DOCX to PDF Converter"
     API_DESCRIPTION = "Professional API for converting DOCX files to PDF with perfect formatting preservation"

src/utils/converter.py

@@ -25,27 +25,12 @@ class DocumentConverter:
                 logger.error(f"Input file does not exist: {input_path}")
                 return False
             
-            # Get output directory
-            output_dir = os.path.dirname(output_path)
-            
-            # Ensure output directory exists
-            os.makedirs(output_dir, exist_ok=True)
-            
-            # Set environment variables for LibreOffice to avoid user installation issues
-            env = os.environ.copy()
-            env['HOME'] = '/tmp'
-            env['USERPROFILE'] = '/tmp'
-            
             # Use LibreOffice headless mode for conversion
             cmd = [
                 "libreoffice",
                 "--headless",
-                "--norestore",
-                "--nofirststartwizard",
-                "--nologo",
-                "--nolockcheck",
                 "--convert-to", "pdf",
-                "--outdir", output_dir,
+                "--outdir", os.path.dirname(output_path),
                 input_path
             ]
             
@@ -55,21 +40,16 @@ class DocumentConverter:
                 cmd,
                 capture_output=True,
                 text=True,
-                timeout=self.max_conversion_time,
-                env=env
+                timeout=self.max_conversion_time
             )
             
             if result.returncode != 0:
-                logger.error(f"Conversion failed with return code {result.returncode}: {result.stderr}")
+                logger.error(f"Conversion failed: {result.stderr}")
                 return False
                 
             # Check if PDF was created
             if not os.path.exists(output_path):
                 logger.error("PDF file was not created")
-                # List files in output directory for debugging
-                if os.path.exists(output_dir):
-                    files = os.listdir(output_dir)
-                    logger.info(f"Files in output directory: {files}")
                 return False
                 
             logger.info(f"Successfully converted {input_path} to {output_path}")
@@ -93,17 +73,11 @@ class DocumentConverter:
     def validate_libreoffice(self) -> bool:
         """Validate LibreOffice installation"""
         try:
-            # Set environment variables for LibreOffice
-            env = os.environ.copy()
-            env['HOME'] = '/tmp'
-            env['USERPROFILE'] = '/tmp'
-            
             result = subprocess.run(
                 ["libreoffice", "--version"],
                 capture_output=True,
                 text=True,
-                timeout=10,
-                env=env
+                timeout=10
             )
             if result.returncode != 0:
                 logger.error("LibreOffice not found or not working")

src/utils/file_handler.py

@@ -16,37 +16,18 @@ class FileHandler:
     """Handle file operations for the converter"""
     
     def __init__(self, base_temp_dir: str = "/tmp/conversions"):
-        # Use /tmp as fallback since it's more likely to be writable in containerized environments
         self.base_temp_dir = base_temp_dir
-        try:
-            os.makedirs(self.base_temp_dir, exist_ok=True)
-            # Ensure the directory is writable
-            os.chmod(self.base_temp_dir, 0o777)
-        except Exception as e:
-            logger.error(f"Failed to create base temp directory {self.base_temp_dir}: {e}")
-            # Fallback to system temp directory
-            self.base_temp_dir = tempfile.gettempdir()
-            logger.info(f"Falling back to system temp directory: {self.base_temp_dir}")
+        os.makedirs(self.base_temp_dir, exist_ok=True)
     
     def create_temp_directory(self) -> str:
         """Create a temporary directory for file processing"""
         try:
             temp_dir = tempfile.mkdtemp(dir=self.base_temp_dir)
             logger.info(f"Created temporary directory: {temp_dir}")
-            # Ensure the directory is writable
-            os.chmod(temp_dir, 0o777)
             return temp_dir
         except Exception as e:
             logger.error(f"Failed to create temporary directory: {e}")
-            # Try fallback to system temp directory
-            try:
-                temp_dir = tempfile.mkdtemp()
-                os.chmod(temp_dir, 0o777)
-                logger.info(f"Created temporary directory in fallback location: {temp_dir}")
-                return temp_dir
-            except Exception as fallback_e:
-                logger.error(f"Fallback also failed: {fallback_e}")
-                raise
+            raise
     
     def save_uploaded_file(self, temp_dir: str, filename: str, content: bytes) -> str:
         """Save uploaded file to temporary directory"""

test_interface.html

@@ -1,287 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>DOCX to PDF Converter Test</title>
-    <script src="https://cdn.tailwindcss.com"></script>
-    <style>
-        @import url('https://fonts.googleapis.com/css2?family=Tajawal:wght@300;400;500;700&display=swap');
-        
-        body {
-            font-family: 'Tajawal', sans-serif;
-            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
-            min-height: 100vh;
-        }
-        
-        .arabic-text {
-            font-family: 'Tajawal', sans-serif;
-            direction: rtl;
-            text-align: right;
-        }
-        
-        .glow {
-            box-shadow: 0 0 20px rgba(255, 255, 255, 0.2);
-        }
-        
-        .pulse {
-            animation: pulse 2s infinite;
-        }
-        
-        @keyframes pulse {
-            0% { box-shadow: 0 0 0 0 rgba(255, 255, 255, 0.4); }
-            70% { box-shadow: 0 0 0 10px rgba(255, 255, 255, 0); }
-            100% { box-shadow: 0 0 0 0 rgba(255, 255, 255, 0); }
-        }
-    </style>
-</head>
-<body class="bg-gradient-to-br from-blue-50 to-purple-50">
-    <div class="container mx-auto px-4 py-8 max-w-4xl">
-        <!-- Header -->
-        <div class="text-center mb-10">
-            <h1 class="text-4xl font-bold text-white mb-2">DOCX to PDF Converter</h1>
-            <p class="text-blue-100 text-lg">تحويل مستندات Word إلى PDF بسهولة</p>
-        </div>
-        
-        <!-- Main Card -->
-        <div class="bg-white rounded-2xl shadow-xl overflow-hidden glow">
-            <div class="p-8">
-                <!-- Upload Section -->
-                <div class="mb-8">
-                    <h2 class="text-2xl font-bold text-gray-800 mb-4">رفع ملف DOCX</h2>
-                    <p class="text-gray-600 mb-6">اختر ملف DOCX لتحويله إلى PDF</p>
-                    
-                    <div class="border-2 border-dashed border-gray-300 rounded-xl p-8 text-center transition-all hover:border-blue-400 hover:bg-blue-50 cursor-pointer" id="dropZone">
-                        <div class="flex flex-col items-center justify-center">
-                            <svg class="w-12 h-12 text-gray-400 mb-4" fill="none" stroke="currentColor" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
-                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M7 16a4 4 0 01-.88-7.903A5 5 0 1115.9 6L16 6a5 5 0 011 9.9M15 13l-3-3m0 0l-3 3m3-3v12"></path>
-                            </svg>
-                            <p class="text-gray-600 mb-2">اسحب الملف هنا أو انقر للاختيار</p>
-                            <p class="text-gray-400 text-sm">يدعم فقط ملفات DOCX</p>
-                            <input type="file" id="fileInput" class="hidden" accept=".docx">
-                        </div>
-                    </div>
-                    
-                    <div class="mt-4 text-center">
-                        <button id="selectFileBtn" class="bg-blue-500 hover:bg-blue-600 text-white font-medium py-3 px-6 rounded-lg transition-all transform hover:scale-105">
-                            اختيار ملف
-                        </button>
-                    </div>
-                </div>
-                
-                <!-- File Info -->
-                <div id="fileInfo" class="hidden mb-6 p-4 bg-blue-50 rounded-lg border border-blue-200">
-                    <div class="flex items-center">
-                        <svg class="w-5 h-5 text-blue-500 mr-2" fill="none" stroke="currentColor" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
-                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z"></path>
-                        </svg>
-                        <span id="fileName" class="text-blue-800 font-medium"></span>
-                    </div>
-                </div>
-                
-                <!-- Convert Button -->
-                <div class="text-center mb-8">
-                    <button id="convertBtn" class="bg-gradient-to-r from-purple-500 to-indigo-600 hover:from-purple-600 hover:to-indigo-700 text-white font-bold py-4 px-8 rounded-xl text-lg shadow-lg transition-all transform hover:scale-105 disabled:opacity-50 disabled:cursor-not-allowed disabled:transform-none" disabled>
-                        تحويل إلى PDF
-                    </button>
-                </div>
-                
-                <!-- Status Section -->
-                <div id="statusSection" class="hidden">
-                    <div class="flex items-center justify-center mb-4">
-                        <div id="spinner" class="hidden animate-spin rounded-full h-8 w-8 border-b-2 border-purple-600 mr-3"></div>
-                        <h3 id="statusTitle" class="text-xl font-bold text-gray-800"></h3>
-                    </div>
-                    <p id="statusMessage" class="text-center text-gray-600"></p>
-                    
-                    <!-- Result Section -->
-                    <div id="resultSection" class="hidden mt-6 p-6 bg-green-50 rounded-xl border border-green-200">
-                        <div class="text-center">
-                            <svg class="w-12 h-12 text-green-500 mx-auto mb-4" fill="none" stroke="currentColor" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
-                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z"></path>
-                            </svg>
-                            <h4 class="text-xl font-bold text-green-800 mb-2">تم التحويل بنجاح!</h4>
-                            <p class="text-green-600 mb-4">يمكنك الآن فتح ملف PDF المحول</p>
-                            <button id="openPdfBtn" class="inline-block bg-green-500 hover:bg-green-600 text-white font-medium py-3 px-6 rounded-lg transition-all transform hover:scale-105">
-                                فتح PDF في المتصفح
-                            </button>
-                        </div>
-                    </div>
-                    
-                    <!-- Error Section -->
-                    <div id="errorSection" class="hidden mt-6 p-6 bg-red-50 rounded-xl border border-red-200">
-                        <div class="text-center">
-                            <svg class="w-12 h-12 text-red-500 mx-auto mb-4" fill="none" stroke="currentColor" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
-                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 8v4m0 4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"></path>
-                            </svg>
-                            <h4 class="text-xl font-bold text-red-800 mb-2">حدث خطأ</h4>
-                            <p id="errorMessage" class="text-red-600 mb-4"></p>
-                            <button id="retryBtn" class="bg-red-500 hover:bg-red-600 text-white font-medium py-2 px-4 rounded-lg">
-                                المحاولة مرة أخرى
-                            </button>
-                        </div>
-                    </div>
-                </div>
-            </div>
-        </div>
-        
-        <!-- Instructions -->
-        <div class="mt-8 bg-white rounded-2xl shadow-lg p-6">
-            <h3 class="text-xl font-bold text-gray-800 mb-4">كيفية الاستخدام</h3>
-            <ol class="list-decimal list-inside space-y-2 text-gray-600">
-                <li>انقر على زر "اختيار ملف" أو اسحب ملف DOCX إلى المنطقة المخصصة</li>
-                <li>تأكد من أن الملف بصيغة DOCX</li>
-                <li>انقر على زر "تحويل إلى PDF"</li>
-                <li>انتظر حتى يكتمل التحويل</li>
-                <li>انقر على "فتح PDF في المتصفح" لعرض ملفك المحول</li>
-            </ol>
-        </div>
-    </div>
-
-    <script>
-        // DOM Elements
-        const dropZone = document.getElementById('dropZone');
-        const fileInput = document.getElementById('fileInput');
-        const selectFileBtn = document.getElementById('selectFileBtn');
-        const fileInfo = document.getElementById('fileInfo');
-        const fileName = document.getElementById('fileName');
-        const convertBtn = document.getElementById('convertBtn');
-        const statusSection = document.getElementById('statusSection');
-        const statusTitle = document.getElementById('statusTitle');
-        const statusMessage = document.getElementById('statusMessage');
-        const spinner = document.getElementById('spinner');
-        const resultSection = document.getElementById('resultSection');
-        const errorSection = document.getElementById('errorSection');
-        const errorMessage = document.getElementById('errorMessage');
-        const openPdfBtn = document.getElementById('openPdfBtn');
-        const retryBtn = document.getElementById('retryBtn');
-        
-        // Hugging Face Space URL
-        const SPACE_URL = 'https://fokan-pdf-4.hf.space';
-        
-        // Current PDF URL
-        let currentPdfUrl = '';
-        
-        // Event Listeners
-        selectFileBtn.addEventListener('click', () => fileInput.click());
-        fileInput.addEventListener('change', handleFileSelect);
-        dropZone.addEventListener('dragover', handleDragOver);
-        dropZone.addEventListener('drop', handleDrop);
-        convertBtn.addEventListener('click', convertFile);
-        openPdfBtn.addEventListener('click', openPdfInNewTab);
-        retryBtn.addEventListener('click', resetInterface);
-        
-        // Functions
-        function handleFileSelect(e) {
-            const file = e.target.files[0];
-            if (file && file.name.endsWith('.docx')) {
-                displayFileInfo(file);
-            } else {
-                alert('الرجاء اختيار ملف DOCX فقط');
-            }
-        }
-        
-        function handleDragOver(e) {
-            e.preventDefault();
-            e.stopPropagation();
-            dropZone.classList.add('border-blue-400', 'bg-blue-50');
-        }
-        
-        function handleDrop(e) {
-            e.preventDefault();
-            e.stopPropagation();
-            dropZone.classList.remove('border-blue-400', 'bg-blue-50');
-            
-            const file = e.dataTransfer.files[0];
-            if (file && file.name.endsWith('.docx')) {
-                fileInput.files = e.dataTransfer.files;
-                displayFileInfo(file);
-            } else {
-                alert('الرجاء سحب ملف DOCX فقط');
-            }
-        }
-        
-        function displayFileInfo(file) {
-            fileName.textContent = file.name;
-            fileInfo.classList.remove('hidden');
-            convertBtn.disabled = false;
-            convertBtn.classList.remove('disabled:opacity-50', 'disabled:cursor-not-allowed');
-        }
-        
-        async function convertFile() {
-            const file = fileInput.files[0];
-            if (!file) return;
-            
-            // Show loading state
-            showStatus('جاري التحويل...', 'يرجى الانتظار بينما نحول ملفك إلى PDF');
-            spinner.classList.remove('hidden');
-            
-            try {
-                // Prepare form data
-                const formData = new FormData();
-                formData.append('file', file);
-                
-                // Send request to Hugging Face Space
-                const response = await fetch(`${SPACE_URL}/convert`, {
-                    method: 'POST',
-                    body: formData
-                });
-                
-                if (!response.ok) {
-                    throw new Error(`خطأ في الطلب: ${response.status}`);
-                }
-                
-                const result = await response.json();
-                
-                if (result.success) {
-                    // Show success
-                    showResult(result.pdf_url);
-                } else {
-                    throw new Error(result.error || 'فشل التحويل');
-                }
-            } catch (error) {
-                showError(error.message || 'حدث خطأ غير متوقع');
-            }
-        }
-        
-        function showStatus(title, message) {
-            statusTitle.textContent = title;
-            statusMessage.textContent = message;
-            statusSection.classList.remove('hidden');
-            resultSection.classList.add('hidden');
-            errorSection.classList.add('hidden');
-        }
-        
-        function showResult(pdfUrl) {
-            spinner.classList.add('hidden');
-            statusTitle.textContent = 'اكتمل التحويل!';
-            statusMessage.textContent = 'ملفك جاهز للفتح';
-            resultSection.classList.remove('hidden');
-            
-            // Store the PDF URL for opening in new tab
-            currentPdfUrl = SPACE_URL + pdfUrl;
-        }
-        
-        function openPdfInNewTab() {
-            // Open PDF in new tab using window.open with "_blank" target
-            window.open(currentPdfUrl, "_blank");
-        }
-        
-        function showError(message) {
-            spinner.classList.add('hidden');
-            statusTitle.textContent = 'فشل التحويل';
-            errorMessage.textContent = message;
-            errorSection.classList.remove('hidden');
-        }
-        
-        function resetInterface() {
-            statusSection.classList.add('hidden');
-            fileInfo.classList.add('hidden');
-            convertBtn.disabled = true;
-            convertBtn.classList.add('disabled:opacity-50', 'disabled:cursor-not-allowed');
-            fileInput.value = '';
-            currentPdfUrl = '';
-        }
-    </script>
-</body>
-</html>

test_root_endpoint.py

@@ -1,50 +0,0 @@
-#!/usr/bin/env python3
-"""
-Test script to verify the root endpoint is working correctly
-"""
-
-import os
-import sys
-
-def test_root_endpoint():
-    """Test that the root endpoint is properly configured"""
-    print("Testing root endpoint configuration...")
-    
-    # Check if templates directory exists
-    if not os.path.exists("templates"):
-        print("❌ templates directory not found")
-        return False
-    print("✅ templates directory found")
-    
-    # Check if index.html exists
-    if not os.path.exists("templates/index.html"):
-        print("❌ templates/index.html not found")
-        return False
-    print("✅ templates/index.html found")
-    
-    # Check if main.py has the root endpoint handler
-    if not os.path.exists("src/api/main.py"):
-        print("❌ src/api/main.py not found")
-        return False
-    
-    with open("src/api/main.py", "r", encoding="utf-8") as f:
-        content = f.read()
-        
-        # Check for root endpoint handler
-        if "async def read_index():" in content and 'app.get("/",' in content:
-            print("✅ Root endpoint handler found in main.py")
-        else:
-            print("❌ Root endpoint handler not found in main.py")
-            return False
-    
-    print("\n✅ Root endpoint configuration is correct!")
-    print("\nWhen the application is running, you should be able to access:")
-    print("- The web interface at http://localhost:7860/")
-    print("- API documentation at http://localhost:7860/docs")
-    print("- Health check at http://localhost:7860/health")
-    
-    return True
-
-if __name__ == "__main__":
-    success = test_root_endpoint()
-    sys.exit(0 if success else 1)

test_static_serving.py

@@ -1,29 +0,0 @@
-#!/usr/bin/env python3
-"""
-Test script to verify static file serving functionality
-"""
-
-import os
-import requests
-import time
-
-def test_static_file_serving():
-    """Test that static files are served correctly"""
-    # Test URL for the Hugging Face Space
-    base_url = "https://fokan-pdf-4.hf.space"
-    
-    # First, let's check if the static endpoint is accessible
-    try:
-        response = requests.get(f"{base_url}/static/")
-        print(f"Static directory access: {response.status_code}")
-        
-        if response.status_code == 200:
-            print("✅ Static file serving is working")
-        else:
-            print("❌ Static file serving may not be working properly")
-            
-    except Exception as e:
-        print(f"❌ Error testing static file serving: {e}")
-
-if __name__ == "__main__":
-    test_static_file_serving()

validate_dockerfile.py

@@ -1,72 +0,0 @@
-#!/usr/bin/env python3
-"""
-Script to validate Dockerfile syntax and content
-"""
-
-import os
-import re
-
-def validate_dockerfile():
-    """Validate Dockerfile content"""
-    dockerfile_path = "Dockerfile"
-    
-    if not os.path.exists(dockerfile_path):
-        print("❌ Dockerfile not found")
-        return False
-    
-    with open(dockerfile_path, "r") as f:
-        content = f.read()
-    
-    print("🔍 Validating Dockerfile...")
-    
-    # Check for required sections
-    required_patterns = [
-        r"FROM ubuntu:22.04",
-        r"WORKDIR /app",
-        r"COPY requirements.txt",
-        r"pip3 install",
-        r"COPY app.py",
-        r"EXPOSE 7860",
-        r"CMD \["
-    ]
-    
-    for pattern in required_patterns:
-        if not re.search(pattern, content):
-            print(f"❌ Missing required pattern: {pattern}")
-            return False
-        print(f"✅ Found required pattern: {pattern}")
-    
-    # Check for removed packages
-    removed_packages = [
-        r"libreoffice-help-ar",
-        r"fonts-noto-naskh",
-        r"fonts-noto-kufi-arabic",
-        r"fonts-amiri",
-        r"fonts-scheherazade-new"
-    ]
-    
-    for package in removed_packages:
-        if re.search(package, content):
-            print(f"❌ Found removed package: {package}")
-            return False
-        print(f"✅ Confirmed removal of package: {package}")
-    
-    # Check for font installation script
-    if "arabic_fonts_setup.sh" in content:
-        print("✅ Found Arabic font installation script")
-    else:
-        print("❌ Missing Arabic font installation script")
-        return False
-    
-    # Check for proper error handling
-    if "|| true" in content:
-        print("✅ Found error handling with || true")
-    else:
-        print("⚠️  No error handling found (may be OK)")
-    
-    print("\n✅ Dockerfile validation passed!")
-    return True
-
-if __name__ == "__main__":
-    success = validate_dockerfile()
-    exit(0 if success else 1)

verify_minimal.py

@@ -1,63 +0,0 @@
-#!/usr/bin/env python3
-"""
-Verification script for minimal setup
-"""
-
-import os
-import sys
-
-def verify_minimal_setup():
-    """Verify that all required files for minimal setup exist"""
-    print("Verifying minimal setup...")
-    
-    # Essential directories
-    required_dirs = [
-        "src",
-        "src/api",
-        "src/utils",
-        "templates",
-        "conversions"
-    ]
-    
-    # Essential files
-    required_files = [
-        "src/api/main.py",
-        "src/api/app.py",
-        "src/utils/config.py",
-        "src/utils/converter.py",
-        "src/utils/file_handler.py",
-        "templates/index.html",
-        "Dockerfile",
-        "docker-compose.yml",
-        "requirements.txt",
-        "install_arabic_fonts.sh",
-        "arial.ttf",
-        "README.md"
-    ]
-    
-    # Check directories
-    for dir_path in required_dirs:
-        if not os.path.exists(dir_path):
-            print(f"❌ Missing directory: {dir_path}")
-            return False
-        print(f"✅ Found directory: {dir_path}")
-    
-    # Check files
-    for file_path in required_files:
-        if not os.path.exists(file_path):
-            print(f"❌ Missing file: {file_path}")
-            return False
-        print(f"✅ Found file: {file_path}")
-    
-    print("\n✅ Minimal setup verification passed!")
-    print("\nThis setup includes only the essential files needed to run the application:")
-    print("- Core application files (FastAPI + utilities)")
-    print("- Docker configuration")
-    print("- Frontend interface")
-    print("- Required assets and documentation")
-    
-    return True
-
-if __name__ == "__main__":
-    success = verify_minimal_setup()
-    sys.exit(0 if success else 1)