لماذا AI للأعمال؟

# حاسبة ROI لمشاريع AI في الأعمال
# استخدامها: حدّد المهام والوقت والتكاليف، واحصل على تقييم ROI

from dataclasses import dataclass, field
from typing import Optional
import json

@dataclass
class AITask:
    """مهمة يمكن أتمتتها بـ AI"""
    name: str
    hours_per_week: float          # وقت الإنسان حالياً
    hourly_cost_sar: float         # تكلفة ساعة العمل (ريال)
    ai_time_reduction: float       # نسبة التوفير (0.0-1.0)
    ai_tool_monthly_cost: float    # تكلفة الأداة شهرياً (ريال)
    quality_improvement: float     # تحسين الجودة (0.0-1.0)
    implementation_hours: float    # وقت التطبيق (ساعات)

@dataclass
class BusinessAIROI:
    """حاسبة ROI شاملة لمشاريع AI"""
    company_name: str
    tasks: list[AITask] = field(default_factory=list)

    def add_task(self, task: AITask) -> None:
        self.tasks.append(task)

    def calculate_roi(self, months: int = 12) -> dict:
        """حساب ROI التفصيلي"""
        results = {
            "company": self.company_name,
            "period_months": months,
            "tasks": [],
            "summary": {}
        }

        total_investment = 0
        total_savings = 0
        total_hours_saved_weekly = 0

        for task in self.tasks:
            # التوفير الشهري
            weekly_savings_sar = (
                task.hours_per_week
                * task.ai_time_reduction
                * task.hourly_cost_sar
            )
            monthly_savings_sar = weekly_savings_sar * 4.33

            # التكلفة الإجمالية
            implementation_cost = task.implementation_hours * task.hourly_cost_sar
            tool_cost_total = task.ai_tool_monthly_cost * months
            total_cost = implementation_cost + tool_cost_total

            # الأرباح على فترة التحليل
            total_benefit = monthly_savings_sar * months
            net_roi = total_benefit - total_cost
            roi_percent = ((total_benefit - total_cost) / total_cost * 100) if total_cost > 0 else float("inf")

            # فترة الاسترداد
            monthly_net = monthly_savings_sar - task.ai_tool_monthly_cost
            payback_months = implementation_cost / monthly_net if monthly_net > 0 else float("inf")

            hours_saved_weekly = task.hours_per_week * task.ai_time_reduction
            total_hours_saved_weekly += hours_saved_weekly

            task_result = {
                "task": task.name,
                "hours_saved_weekly": round(hours_saved_weekly, 1),
                "monthly_savings_sar": round(monthly_savings_sar),
                "total_investment_sar": round(total_cost),
                "net_roi_sar": round(net_roi),
                "roi_percent": round(roi_percent, 1),
                "payback_months": round(payback_months, 1) if payback_months != float("inf") else "N/A",
                "quality_boost": f"{task.quality_improvement*100:.0f}%",
            }
            results["tasks"].append(task_result)
            total_investment += total_cost
            total_savings += total_benefit

        total_net = total_savings - total_investment
        total_roi = ((total_savings - total_investment) / total_investment * 100) if total_investment > 0 else 0

        results["summary"] = {
            "total_investment_sar": round(total_investment),
            "total_savings_sar": round(total_savings),
            "net_gain_sar": round(total_net),
            "overall_roi_percent": round(total_roi, 1),
            "hours_saved_weekly": round(total_hours_saved_weekly, 1),
            "hours_saved_yearly": round(total_hours_saved_weekly * 52, 1),
            "verdict": (
                "ممتاز - وفّر فوراً" if total_roi > 200
                else "جيد - وفّر خلال السنة" if total_roi > 50
                else "متوسط - يحتاج دراسة" if total_roi > 0
                else "غير مجدٍ حالياً"
            )
        }
        return results

    def print_report(self, months: int = 12) -> None:
        """طباعة تقرير ROI منسق"""
        data = self.calculate_roi(months)

        print("=" * 60)
        print(f"تقرير ROI للذكاء الاصطناعي — {data['company']}")
        print(f"فترة التحليل: {months} شهر")
        print("=" * 60)

        print("\nتفاصيل المهام:")
        print(f"{'المهمة':25s} | {'توفير/أسبوع':12s} | {'ROI%':8s} | {'استرداد':8s}")
        print("-" * 65)

        for t in data["tasks"]:
            print(
                f"{t['task'][:25]:25s} | "
                f"{t['hours_saved_weekly']:4.1f} ساعة     | "
                f"{t['roi_percent']:7.1f}% | "
                f"{str(t['payback_months']):7s} شهر"
            )

        s = data["summary"]
        print("\n" + "=" * 60)
        print("ملخص:")
        print(f"  إجمالي الاستثمار : {s['total_investment_sar']:>10,} ريال")
        print(f"  إجمالي التوفير   : {s['total_savings_sar']:>10,} ريال")
        print(f"  صافي الربح       : {s['net_gain_sar']:>10,} ريال")
        print(f"  ROI الكلي        : {s['overall_roi_percent']:>10.1f}%")
        print(f"  ساعات موفّرة/أسبوع: {s['hours_saved_weekly']:>10.1f} ساعة")
        print(f"  ساعات موفّرة/سنة : {s['hours_saved_yearly']:>10.1f} ساعة")
        print(f"\n  الحكم: {s['verdict']}")


# ─────────────────────────────────────────
# مثال عملي: شركة تجارة إلكترونية
# ─────────────────────────────────────────
calc = BusinessAIROI("متجر الرقمي للإلكترونيات")

calc.add_task(AITask(
    name="الرد على استفسارات العملاء",
    hours_per_week=20,
    hourly_cost_sar=75,
    ai_time_reduction=0.7,
    ai_tool_monthly_cost=150,
    quality_improvement=0.3,
    implementation_hours=10,
))

calc.add_task(AITask(
    name="كتابة وصف المنتجات",
    hours_per_week=8,
    hourly_cost_sar=60,
    ai_time_reduction=0.85,
    ai_tool_monthly_cost=100,
    quality_improvement=0.4,
    implementation_hours=5,
))

calc.add_task(AITask(
    name="منشورات سوشيال ميديا",
    hours_per_week=6,
    hourly_cost_sar=80,
    ai_time_reduction=0.6,
    ai_tool_monthly_cost=80,
    quality_improvement=0.25,
    implementation_hours=8,
))

calc.add_task(AITask(
    name="تلخيص تقارير المبيعات",
    hours_per_week=3,
    hourly_cost_sar=100,
    ai_time_reduction=0.9,
    ai_tool_monthly_cost=50,
    quality_improvement=0.5,
    implementation_hours=4,
))

calc.print_report(months=12)