# سیستم مدیریت نتایج جنگ - war.json

این سیستم برای ذخیره و مدیریت نتایج جنگ‌ها با گزارش‌های تفصیلی کامل در بازی طراحی شده است.

## فایل‌های مربوطه:
- `Data/war.json` - فایل ذخیره اطلاعات جنگ‌ها
- `war.php` - کلاس اصلی WarSystem

## ویژگی‌های جدید:
- ✅ ذخیره گزارش تفصیلی کامل هر جنگ
- ✅ نمایش تاریخچه جنگ‌ها در منوی اصلی
- ✅ آمار دقیق تسلیحات اعزام شده، اصابت کرده و رهگیری شده
- ✅ نمایش خلاصه آخرین جنگ در منوی اصلی جنگ
- ✅ امکان مشاهده جزئیات کامل آخرین جنگ

## ساختار فایل war.json:

```json
{
    "last_updated": "تاریخ آخرین به‌روزرسانی",
    "active_wars": {
        "user_id": {
            "attacker_id": "آیدی مهاجم",
            "target_id": "آیدی هدف", 
            "attack_power": "قدرت حمله",
            "start_time": "زمان شروع",
            "completion_time": "زمان پایان",
            "attack_plan": "برنامه حمله",
            "battle_report": "گزارش نبرد",
            "cost": "هزینه جنگ",
            "status": "in_progress"
        }
    },
    "completed_wars": {
        "user_id": {
            // همین ساختار + نتایج اضافی
            "result": "victory/defeat",
            "spoils": "غنائم به دست آمده",
            "battle_details": "جزئیات نبرد"
        }
    },
    "war_history": {
        "user_id_timestamp": {
            // تاریخچه کامل جنگ‌ها
        }
    }
}
```

## نحوه کارکرد:

### 1. شروع جنگ:
- هنگام تأیید حمله در `confirmAttack()`, اطلاعات جنگ در `active_wars` ذخیره می‌شود
- `saveActiveWar()` فراخوانی می‌شود

### 2. تکمیل جنگ:
- پس از 1 دقیقه، `autoCompleteAttack()` نتایج را محاسبه می‌کند
- `moveWarToCompleted()` جنگ را از `active_wars` به `completed_wars` انتقال می‌دهد
- جنگ به `war_history` نیز اضافه می‌شود

### 3. نمایش نتایج:
- هنگام بروزرسانی، `refreshAllWarStatus()` ابتدا `completed_wars` را چک می‌کند
- اگر جنگ تکمیل شده وجود داشته باشد، `showLastWarResult()` نتایج کامل را نمایش می‌دهد

### 4. پاک کردن نتایج:
- کاربر می‌تواند با دکمه "پاک کردن گزارش" نتایج را حذف کند
- `clearLastWarResult()` جنگ را از `completed_wars` حذف می‌کند

### 5. تاریخچه جنگ‌ها:
- در منوی اصلی جنگ، خلاصه آخرین جنگ نمایش داده می‌شود
- دکمه "📚 تاریخچه جنگ‌ها" لیست آخرین 5 جنگ را نمایش می‌دهد
- امکان مشاهده جزئیات کامل هر جنگ با گزارش تفصیلی

## مزایای این سیستم:

1. **پایداری**: نتایج در فایل محفوظ می‌ماند حتی اگر سرور restart شود
2. **سرعت**: کاربر بعد از 1 دقیقه با یک کلیک نتایج کامل را می‌بیند  
3. **تاریخچه**: تمام جنگ‌ها در war_history نگهداری می‌شوند
4. **مدیریت حافظه**: فقط 100 جنگ اخیر نگه داری می‌شود

## توابع اصلی:

- `readWarData()` - خواندن فایل war.json
- `saveWarData()` - نوشتن فایل war.json  
- `saveActiveWar()` - ذخیره جنگ فعال
- `moveWarToCompleted()` - انتقال به تکمیل شده با گزارش کامل
- `getLastCompletedWar()` - دریافت آخرین جنگ
- `getLastWarSummary()` - دریافت خلاصه آخرین جنگ
- `showLastWarResult()` - نمایش نتایج
- `showWarHistory()` - نمایش تاریخچه جنگ‌ها
- `showLastWarDetails()` - نمایش جزئیات کامل آخرین جنگ
- `clearCompletedWar()` - پاک کردن نتایج

## گزارش تفصیلی شامل:

```json
"battle_details": {
    "attacker_name": "نام مهاجم",
    "target_name": "نام هدف", 
    "attacker_country": "کشور مهاجم",
    "target_country": "کشور هدف",
    "initial_attack_power": "قدرت اولیه حمله",
    "final_attack_power": "قدرت نهایی حمله", 
    "defense_power": "قدرت دفاع",
    "battle_duration": "مدت زمان جنگ",
    "attack_cost": "هزینه حمله",
    "battle_result_text": "نتیجه متنی",
    "battle_date": "تاریخ جنگ",
    "full_message": "پیام کامل نتیجه",
    "detailed_statistics": {
        "total_weapons_launched": "کل تسلیحات اعزام شده",
        "total_weapons_hit": "تسلیحات اصابت کرده", 
        "total_weapons_intercepted": "تسلیحات رهگیری شده",
        "overall_success_rate": "نرخ موفقیت کل",
        "damage_dealt": "صدمه وارد شده",
        "resources_gained": "منابع به دست آمده"
    }
}
```

## استفاده:

کاربر پس از 1 دقیقه روی دکمه "🔄 بروزرسانی وضعیت" کلیک می‌کند و تمام اطلاعات و نتایج جنگ نمایش داده می‌شود.