Upload 2 files

modules/utils/arabic_charts_optimized.py

@@ -0,0 +1,374 @@
+# -*- coding: utf-8 -*-
+"""
+وحدة تحسين عرض النصوص العربية في الرسوم البيانية
+
+هذا الملف يحتوي على دوال مساعدة لتحسين عرض النصوص العربية في الرسوم البيانية
+باستخدام مكتبات arabic-reshaper و python-bidi مع خطوط عربية احترافية.
+"""
+
+import arabic_reshaper
+from bidi.algorithm import get_display
+import matplotlib.pyplot as plt
+import matplotlib.font_manager as fm
+import plotly.graph_objects as go
+import plotly.express as px
+import numpy as np
+import os
+import sys
+from arabic_font_config import ArabicFontManager, get_display_arabic, setup_arabic_fonts
+
+# الحصول على أفضل خط عربي متاح
+font_manager = ArabicFontManager()
+BEST_ARABIC_FONT = font_manager.get_best_font()
+
+def create_risk_matrix_plotly(risk_levels=None, width=450, height=450, font_family=BEST_ARABIC_FONT):
+    """
+    إنشاء مصفوفة المخاطر باستخدام Plotly مع دعم اللغة العربية
+    
+    المعلمات:
+        risk_levels: مصفوفة مستويات المخاطر (اختياري)
+        width: عرض الرسم البياني
+        height: ارتفاع الرسم البياني
+        font_family: عائلة الخط المستخدمة
+        
+    العوائد:
+        كائن الرسم البياني Plotly Figure
+    """
+    # بيانات مصفوفة المخاطر الافتراضية إذا لم يتم توفيرها
+    if risk_levels is None:
+        risk_levels = np.array([
+            [1, 2, 3],
+            [2, 4, 6],
+            [3, 6, 9]
+        ])
+    
+    # إنشاء مصفوفة المخاطر باستخدام Plotly
+    fig = go.Figure()
+    
+    # تحديد الألوان
+    colorscale = [
+        [0, '#1a9850'],      # أخضر داكن (مخاطر منخفضة)
+        [0.3, '#91cf60'],    # أخضر فاتح
+        [0.5, '#ffffbf'],    # أصفر
+        [0.7, '#fc8d59'],    # برتقالي
+        [1, '#d73027']       # أحمر (مخاطر عالية)
+    ]
+    
+    # إنشاء مصفوفة المخاطر
+    fig.add_trace(go.Heatmap(
+        z=risk_levels,
+        x=[get_display_arabic('منخفض'), get_display_arabic('متوسط'), get_display_arabic('عالي')],
+        y=[get_display_arabic('منخفضة'), get_display_arabic('متوسطة'), get_display_arabic('عالية')],
+        text=risk_levels,
+        texttemplate="%{text}",
+        textfont={"size":20},
+        colorscale=colorscale,
+        showscale=True,
+        colorbar=dict(
+            title=get_display_arabic("درجة الخطورة"),
+            tickfont=dict(size=12),
+        )
+    ))
+    
+    # تخصيص الرسم البياني
+    fig.update_layout(
+        title=get_display_arabic("مصفوفة المخاطر"),
+        height=height,
+        width=width,
+        margin=dict(l=50, r=50, t=50, b=50),
+        xaxis=dict(
+            title=get_display_arabic("التأثير"),
+            tickfont=dict(size=12),
+        ),
+        yaxis=dict(
+            title=get_display_arabic("الاحتمالية"),
+            tickfont=dict(size=12),
+        ),
+        font=dict(
+            family=font_family,
+            size=14
+        )
+    )
+    
+    return fig
+
+def create_pie_chart_plotly(labels, values, title="توزيع البيانات", width=400, height=380, font_family=BEST_ARABIC_FONT):
+    """
+    إنشاء مخطط دائري باستخدام Plotly مع دعم اللغة العربية
+    
+    المعلمات:
+        labels: تسميات البيانات
+        values: قيم البيانات
+        title: عنوان الرسم البياني
+        width: عرض الرسم البياني
+        height: ارتفاع الرسم البياني
+        font_family: عائلة الخط المستخدمة
+        
+    العوائد:
+        كائن الرسم البياني Plotly Figure
+    """
+    # تحويل التسميات إلى العرض الصحيح للعربية
+    arabic_labels = [get_display_arabic(label) for label in labels]
+    
+    # إنشاء المخطط الدائري
+    fig = go.Figure()
+    
+    # تحديد الألوان
+    colors = ['#1f77b4', '#ff7f0e', '#2ca02c', '#d62728', '#9467bd', '#8c564b']
+    
+    fig.add_trace(go.Pie(
+        labels=arabic_labels,
+        values=values,
+        textinfo='percent',
+        insidetextorientation='radial',
+        marker=dict(colors=colors[:len(labels)]),
+        hole=0.4,
+        textfont=dict(
+            family=font_family,
+            size=14
+        )
+    ))
+    
+    # تخصيص الرسم البياني
+    fig.update_layout(
+        title=get_display_arabic(title),
+        height=height,
+        width=width,
+        margin=dict(l=0, r=0, t=40, b=0),
+        font=dict(
+            family=font_family,
+            size=14
+        ),
+        legend=dict(
+            orientation="h",
+            yanchor="bottom",
+            y=-0.2,
+            xanchor="center",
+            x=0.5,
+            font=dict(
+                family=font_family,
+                size=12
+            )
+        )
+    )
+    
+    return fig
+
+def create_bar_chart_plotly(x_data, y_data, x_title="الفئات", y_title="القيم", title="رسم بياني شريطي", width=450, height=400, font_family=BEST_ARABIC_FONT):
+    """
+    إنشاء رسم بياني شريطي باستخدام Plotly مع دعم اللغة العربية
+    
+    المعلمات:
+        x_data: بيانات المحور الأفقي
+        y_data: بيانات المحور الرأسي
+        x_title: عنوان المحور الأفقي
+        y_title: عنوان المحور الرأسي
+        title: عنوان الرسم البياني
+        width: عرض الرسم البياني
+        height: ارتفاع الرسم البياني
+        font_family: عائلة الخط المستخدمة
+        
+    العوائد:
+        كائن الرسم البياني Plotly Figure
+    """
+    # تحويل بيانات المحور الأفقي إلى العرض الصحيح للعربية إذا كانت نصية
+    if isinstance(x_data[0], str):
+        x_data = [get_display_arabic(x) for x in x_data]
+    
+    # إنشاء الرسم البياني الشريطي
+    fig = go.Figure()
+    
+    fig.add_trace(go.Bar(
+        x=x_data,
+        y=y_data,
+        marker_color='#1f77b4',
+        text=y_data,
+        textposition='auto',
+        textfont=dict(
+            family=font_family,
+            size=12
+        )
+    ))
+    
+    # تخصيص الرسم البياني
+    fig.update_layout(
+        title=get_display_arabic(title),
+        height=height,
+        width=width,
+        margin=dict(l=50, r=50, t=50, b=50),
+        xaxis=dict(
+            title=get_display_arabic(x_title),
+            tickfont=dict(
+                family=font_family,
+                size=12
+            ),
+        ),
+        yaxis=dict(
+            title=get_display_arabic(y_title),
+            tickfont=dict(
+                family=font_family,
+                size=12
+            ),
+        ),
+        font=dict(
+            family=font_family,
+            size=14
+        )
+    )
+    
+    return fig
+
+def create_line_chart_plotly(x_data, y_data, x_title="الزمن", y_title="القيم", title="رسم بياني خطي", width=450, height=400, font_family=BEST_ARABIC_FONT):
+    """
+    إنشاء رسم بياني خطي باستخدام Plotly مع دعم اللغة العربية
+    
+    المعلمات:
+        x_data: بيانات المحور الأفقي
+        y_data: بيانات المحور الرأسي
+        x_title: عنوان المحور الأفقي
+        y_title: عنوان المحور الرأسي
+        title: عنوان الرسم البياني
+        width: عرض الرسم البياني
+        height: ارتفاع الرسم البياني
+        font_family: عائلة الخط المستخدمة
+        
+    العوائد:
+        كائن الرسم البياني Plotly Figure
+    """
+    # تحويل بيانات المحور الأفقي إلى العرض الصحيح للعربية إذا كانت نصية
+    if isinstance(x_data[0], str):
+        x_data = [get_display_arabic(x) for x in x_data]
+    
+    # إنشاء الرسم البياني الخطي
+    fig = go.Figure()
+    
+    fig.add_trace(go.Scatter(
+        x=x_data,
+        y=y_data,
+        mode='lines+markers',
+        marker=dict(size=8),
+        line=dict(width=2)
+    ))
+    
+    # تخصيص الرسم البياني
+    fig.update_layout(
+        title=get_display_arabic(title),
+        height=height,
+        width=width,
+        margin=dict(l=50, r=50, t=50, b=50),
+        xaxis=dict(
+            title=get_display_arabic(x_title),
+            tickfont=dict(
+                family=font_family,
+                size=12
+            ),
+        ),
+        yaxis=dict(
+            title=get_display_arabic(y_title),
+            tickfont=dict(
+                family=font_family,
+                size=12
+            ),
+        ),
+        font=dict(
+            family=font_family,
+            size=14
+        )
+    )
+    
+    return fig
+
+def create_risk_matrix_matplotlib(risk_levels=None, figsize=(6, 5), font_family=BEST_ARABIC_FONT):
+    """
+    إنشاء مصفوفة المخاطر باستخدام Matplotlib مع دعم اللغة العربية
+    
+    المعلمات:
+        risk_levels: مصفوفة مستويات المخاطر (اختياري)
+        figsize: حجم الشكل (العرض، الارتفاع) بالإنش
+        font_family: عائلة الخط المستخدمة
+        
+    العوائد:
+        كائن الرسم البياني Matplotlib Figure
+    """
+    # إعداد الخطوط العربية
+    setup_arabic_fonts(font_family)
+    
+    # بيانات مصفوفة المخاطر الافتراضية إذا لم يتم توفيرها
+    if risk_levels is None:
+        risk_levels = np.array([
+            [1, 2, 3],
+            [2, 4, 6],
+            [3, 6, 9]
+        ])
+    
+    # إنشاء الشكل والمحاور
+    fig, ax = plt.subplots(figsize=figsize)
+    
+    # تحديد الألوان
+    cmap = plt.cm.get_cmap('RdYlGn_r')
+    
+    # إنشاء مصفوفة المخاطر
+    im = ax.imshow(risk_levels, cmap=cmap)
+    
+    # إضافة النصوص إلى الخلايا
+    for i in range(len(risk_levels)):
+        for j in range(len(risk_levels[0])):
+            ax.text(j, i, risk_levels[i, j], ha='center', va='center', color='white', fontsize=14, fontfamily=font_family)
+    
+    # تعيين العناوين والتسميات
+    ax.set_title(get_display_arabic("مصفوفة المخاطر"), fontsize=16, fontfamily=font_family)
+    ax.set_xlabel(get_display_arabic("التأثير"), fontsize=14, fontfamily=font_family)
+    ax.set_ylabel(get_display_arabic("الاحتمالية"), fontsize=14, fontfamily=font_family)
+    
+    # تعيين تسميات المحاور
+    ax.set_xticks(np.arange(len(risk_levels[0])))
+    ax.set_yticks(np.arange(len(risk_levels)))
+    ax.set_xticklabels([get_display_arabic(label) for label in ['منخفض', 'متوسط', 'عالي']], fontfamily=font_family)
+    ax.set_yticklabels([get_display_arabic(label) for label in ['منخفضة', 'متوسطة', 'عالية']], fontfamily=font_family)
+    
+    # إضافة شريط الألوان
+    cbar = fig.colorbar(im)
+    cbar.set_label(get_display_arabic("درجة الخطورة"), fontsize=14, fontfamily=font_family)
+    
+    # تنسيق الشكل
+    plt.tight_layout()
+    
+    return fig
+
+# اختبار الدوال إذا تم تشغيل الملف مباشرة
+if __name__ == "__main__":
+    # طباعة الخط العربي المستخدم
+    print(f"الخط العربي المستخدم: {BEST_ARABIC_FONT}")
+    
+    # اختبار مصفوفة المخاطر باستخدام Plotly
+    risk_matrix = create_risk_matrix_plotly()
+    risk_matrix.write_image("risk_matrix_optimized.png")
+    print("تم إنشاء مصفوفة المخاطر باستخدام Plotly")
+    
+    # اختبار المخطط الدائري باستخدام Plotly
+    labels = ["المنتجات المحلية", "الخدمات المحلية", "القوى العاملة المحلية", "غير محلي"]
+    values = [40, 20, 30, 10]
+    pie_chart = create_pie_chart_plotly(labels, values, "توزيع المحتوى المحلي")
+    pie_chart.write_image("pie_chart_optimized.png")
+    print("تم إنشاء المخطط الدائري باستخدام Plotly")
+    
+    # اختبار الرسم البياني الشريطي باستخدام Plotly
+    x_data = ["الربع الأول", "الربع الثاني", "الربع الثالث", "الربع الرابع"]
+    y_data = [20, 35, 25, 40]
+    bar_chart = create_bar_chart_plotly(x_data, y_data, "الفترة", "المبيعات", "مبيعات السنة")
+    bar_chart.write_image("bar_chart_optimized.png")
+    print("تم إنشاء الرسم البياني الشريطي باستخدام Plotly")
+    
+    # اختبار الرسم البياني الخطي باستخدام Plotly
+    x_data = ["يناير", "فبراير", "مارس", "أبريل", "مايو", "يونيو"]
+    y_data = [10, 15, 13, 17, 20, 25]
+    line_chart = create_line_chart_plotly(x_data, y_data, "الشهر", "الإيرادات", "إيرادات النصف الأول")
+    line_chart.write_image("line_chart_optimized.png")
+    print("تم إنشاء الرسم البياني الخطي باستخدام Plotly")
+    
+    # اختبار مصفوفة المخاطر باستخدام Matplotlib
+    risk_matrix_mpl = create_risk_matrix_matplotlib()
+    plt.savefig("risk_matrix_matplotlib_optimized.png", dpi=150)
+    print("تم إنشاء مصفوفة المخاطر باستخدام Matplotlib")
+    
+    print("تم إنشاء جميع الرسوم البيانية بنجاح!")

modules/utils/arabic_font_config.py

@@ -0,0 +1,271 @@
+# -*- coding: utf-8 -*-
+"""
+وحدة تكوين الخطوط العربية
+
+هذا الملف يحتوي على أدوات لتكوين وإدارة الخطوط العربية للرسوم البيانية
+"""
+
+import os
+import sys
+import matplotlib.font_manager as fm
+import matplotlib.pyplot as plt
+import arabic_reshaper
+from bidi.algorithm import get_display
+import json
+import glob
+
+class ArabicFontManager:
+    """مدير الخطوط العربية للرسوم البيانية"""
+    
+    def __init__(self):
+        """تهيئة مدير الخطوط العربية"""
+        # قائمة بمسارات الخطوط العربية المعروفة
+        self.known_font_paths = {
+            'Amiri': '/usr/share/fonts/truetype/hosny-amiri/',
+            'Lateef': '/usr/share/fonts/truetype/sil/',
+            'Scheherazade': '/usr/share/fonts/truetype/sil/',
+            'KACST': '/usr/share/fonts/truetype/kacst/',
+            'Noto Naskh Arabic': '/usr/share/fonts/truetype/noto/',
+            'Harmattan': '/usr/share/fonts/truetype/sil/',
+            'Alkalami': '/usr/share/fonts/truetype/sil/'
+        }
+        
+        # قائمة بالخطوط العربية المتاحة
+        self.available_fonts = {}
+        
+        # البحث عن الخطوط العربية المتاحة
+        self.scan_available_fonts()
+    
+    def scan_available_fonts(self):
+        """البحث عن الخطوط العربية المتاحة في النظام"""
+        # مسح المسارات المعروفة
+        for font_family, font_path in self.known_font_paths.items():
+            if os.path.exists(font_path):
+                font_files = []
+                # البحث عن ملفات الخطوط في المسار
+                for font_file in os.listdir(font_path):
+                    if font_file.endswith('.ttf') or font_file.endswith('.otf'):
+                        full_path = os.path.join(font_path, font_file)
+                        font_files.append(full_path)
+                
+                if font_files:
+                    self.available_fonts[font_family] = font_files
+        
+        # البحث في المسارات الإضافية
+        additional_paths = [
+            '/usr/share/fonts/',
+            '/usr/local/share/fonts/',
+            os.path.expanduser('~/.fonts/')
+        ]
+        
+        # استخدام قائمة الخطوط المتاحة في matplotlib
+        font_list = fm.findSystemFonts()
+        arabic_fonts = []
+        
+        # البحث عن الخطوط العربية
+        for font_path in font_list:
+            try:
+                font_name = os.path.basename(font_path).split('.')[0]
+                if 'arab' in font_name.lower() or 'naskh' in font_name.lower() or 'kufi' in font_name.lower():
+                    if font_name not in self.available_fonts:
+                        self.available_fonts[font_name] = []
+                    self.available_fonts[font_name].append(font_path)
+            except Exception as e:
+                print(f"خطأ في معالجة الخط {font_path}: {e}")
+    
+    def configure_matplotlib(self, preferred_font=None):
+        """
+        تكوين matplotlib لاستخدام الخطوط العربية
+        
+        المعلمات:
+            preferred_font: اسم الخط المفضل (اختياري)
+        
+        العوائد:
+            قائمة بأسماء الخطوط العربية المتاحة
+        """
+        # تحديد الخط المفضل
+        if preferred_font and preferred_font in self.available_fonts:
+            primary_font = preferred_font
+        elif 'NotoNaskhArabic-Regular' in self.available_fonts:
+            primary_font = 'NotoNaskhArabic-Regular'
+        elif 'NotoSansArabic-Regular' in self.available_fonts:
+            primary_font = 'NotoSansArabic-Regular'
+        elif len(self.available_fonts) > 0:
+            primary_font = list(self.available_fonts.keys())[0]
+        else:
+            primary_font = 'sans-serif'
+        
+        # تكوين الخط الافتراضي
+        font_list = [primary_font] + list(self.available_fonts.keys()) + ['sans-serif']
+        plt.rcParams['font.family'] = ', '.join(font_list)
+        
+        return list(self.available_fonts.keys())
+    
+    def get_font_list(self):
+        """
+        الحصول على قائمة بالخطوط العربية المتاحة
+        
+        العوائد:
+            قائمة بأسماء الخطوط العربية المتاحة
+        """
+        return list(self.available_fonts.keys())
+    
+    def get_best_font(self):
+        """
+        الحصول على أفضل خط عربي متاح
+        
+        العوائد:
+            اسم أفضل خط عربي متاح
+        """
+        preferred_fonts = [
+            'NotoNaskhArabic-Regular', 
+            'NotoSansArabic-Regular', 
+            'Amiri', 
+            'Scheherazade', 
+            'Lateef', 
+            'KACST'
+        ]
+        
+        for font in preferred_fonts:
+            if font in self.available_fonts:
+                return font
+        
+        if len(self.available_fonts) > 0:
+            return list(self.available_fonts.keys())[0]
+        
+        return 'sans-serif'
+    
+    def save_font_config(self, config_file='arabic_font_config.json'):
+        """
+        حفظ تكوين الخطوط العربية إلى ملف
+        
+        المعلمات:
+            config_file: اسم ملف التكوين
+        """
+        config = {
+            'available_fonts': {k: v for k, v in self.available_fonts.items()},
+            'best_font': self.get_best_font()
+        }
+        
+        with open(config_file, 'w', encoding='utf-8') as f:
+            json.dump(config, f, ensure_ascii=False, indent=4)
+    
+    def load_font_config(self, config_file='arabic_font_config.json'):
+        """
+        تحميل تكوين الخطوط العربية من ملف
+        
+        المعلمات:
+            config_file: اسم ملف التكوين
+        
+        العوائد:
+            True إذا تم تحميل التكوين بنجاح، False خلاف ذلك
+        """
+        if not os.path.exists(config_file):
+            return False
+        
+        try:
+            with open(config_file, 'r', encoding='utf-8') as f:
+                config = json.load(f)
+            
+            if 'available_fonts' in config:
+                self.available_fonts = config['available_fonts']
+                return True
+        except Exception as e:
+            print(f"خطأ في تحميل ملف التكوين: {e}")
+        
+        return False
+
+def get_display_arabic(text):
+    """
+    تحويل النص العربي للعرض الصحيح في الرسوم البيانية
+    
+    المعلمات:
+        text: النص العربي المراد تحويله
+        
+    العوائد:
+        النص بعد المعالجة للعرض الصحيح
+    """
+    # التحقق من أن النص ليس فارغًا
+    if not text:
+        return text
+    
+    # تشكيل النص العربي وتحويله للعرض الصحيح
+    try:
+        reshaped_text = arabic_reshaper.reshape(text)
+        bidi_text = get_display(reshaped_text)
+        return bidi_text
+    except Exception as e:
+        print(f"خطأ في معالجة النص العربي: {e}")
+        return text
+
+def setup_arabic_fonts(preferred_font=None):
+    """
+    إعداد الخطوط العربية لاستخدامها في matplotlib
+    
+    المعلمات:
+        preferred_font: اسم الخط المفضل (اختياري)
+    
+    العوائد:
+        قائمة بأسماء الخطوط العربية المتاحة
+    """
+    font_manager = ArabicFontManager()
+    return font_manager.configure_matplotlib(preferred_font)
+
+def test_arabic_fonts():
+    """
+    اختبار الخطوط العربية المتاحة
+    
+    هذه الدالة تقوم بإنشاء رسم بياني لاختبار الخطوط العربية المتاحة
+    """
+    # إنشاء مدير الخطوط العربية
+    font_manager = ArabicFontManager()
+    available_fonts = font_manager.configure_matplotlib()
+    
+    if not available_fonts:
+        print("لا توجد خطوط عربية متاحة!")
+        return
+    
+    # نص الاختبار
+    test_text = "هذا نص عربي لاختبار الخطوط: أبجد هوز حطي كلمن"
+    
+    # اختيار عدد محدود من الخطوط للاختبار
+    test_fonts = available_fonts[:5] if len(available_fonts) > 5 else available_fonts
+    
+    # إنشاء رسم بياني لكل خط
+    fig, axes = plt.subplots(len(test_fonts), 1, figsize=(10, len(test_fonts) * 1.5))
+    
+    if len(test_fonts) == 1:
+        axes = [axes]
+    
+    for i, font in enumerate(test_fonts):
+        axes[i].text(0.5, 0.5, get_display_arabic(test_text), 
+                    fontfamily=font, fontsize=14, ha='center', va='center')
+        axes[i].set_title(f"Font: {font}", fontsize=10)
+        axes[i].axis('off')
+    
+    plt.tight_layout()
+    plt.savefig("arabic_fonts_test.png", dpi=150)
+    print(f"تم إنشاء صورة اختبار الخطوط العربية: arabic_fonts_test.png")
+
+# اختبار الوحدة إذا تم تشغيل الملف مباشرة
+if __name__ == "__main__":
+    # إنشاء مدير الخطوط العربية
+    font_manager = ArabicFontManager()
+    
+    # البحث عن الخطوط العربية المتاحة
+    available_fonts = font_manager.get_font_list()
+    
+    print("الخطوط العربية المتاحة:")
+    for font in available_fonts:
+        print(f"  - {font}")
+    
+    # حفظ تكوين الخطوط العربية
+    font_manager.save_font_config()
+    
+    # اختبار الخطوط العربية
+    try:
+        test_arabic_fonts()
+    except Exception as e:
+        print(f"خطأ في اختبار الخطوط العربية: {e}")
+        
+    print("أفضل خط عربي متاح:", font_manager.get_best_font())