# 📋 بستهٔ به‌روزرسانی مستندات IFNEX (فاز ۳.۱۱)

تاریخ: ۱۴۰۴/۰۸/۱۱
نسخه: docs-update-3.11

---

## 🎯 هدف

به‌روزرسانی همهٔ فایل‌های مستنداتی پروژه IFNEX تا وضعیت واقعی فاز ۳.۱۱ را
منعکس کنند. مستندات قبلی در فاز ۳.۶/۳.۷ متوقف شده بودند و چند فایل گمراه‌کننده
بودند.

---

## 📦 تغییرات این بسته

### فایل‌های به‌روزرسانی‌شده (۹ فایل)

| # | فایل | تغییر کلیدی |
|---|------|------------|
| ۱ | `README.md` | badge فاز ۳.۶→۳.۱۱، آمار صحیح، banner «فاز ۴/۵ = آینده»، رفرنس به `UAT-3.11.md` و `RATE_IMPORTER.md` |
| ۲ | `AGENT.md` | bump 1.5→1.6، افزودن فازهای 3.8 تا 3.11، دستورات جدید، آمار صحیح، رفع رفرنس `DEPLOYMENT.md`→`RATE_IMPORTER.md` |
| ۳ | `DEPLOYMENT_HANDOFF.md` | bump 1.0→1.1، افزودن §2.9 (smoke-test post-deploy)، آیتم جدید در چک‌لیست نهایی |
| ۴ | `04_Laravel/README.md` | badge فاز ۳.۶→۳.۱۱، آمار (۱۶→۱۹ Resources، ۲۲→۳۱ models، ۴۰→۶۲ migrations)، افزودن ۳ دستور جدید، CurrencySeeder |
| ۵ | `01_Documents/IFNEX_Roadmap.md` | جدول وضعیت با فازهای 3.7 تا 3.11، آمار به‌روز، دامنه‌های تولید صحیح |
| ۶ | `01_Documents/IFNEX_Pro_Backlog.md` | **حذف «دفترچه آدرس» از Pro** (تحویل در فاز 3.9)، به‌روزرسانی تاریخ |
| ۷ | `01_Documents/IFNEX_File_Map.md` | (تغییرات cosmetic — آمار به‌روز) |
| ۸ | `01_Documents/IFNEX_Commercial_Model.md` | (تغییرات cosmetic — یادداشت «Delivered in current version») |
| ۹ | `01_Documents/IFNEX_ADR.md` | (تغییرات cosmetic — یادداشت وضعیت ADR-009) |

### فایل‌های جدید (۱ فایل)

| # | فایل | محتوا |
|---|------|------|
| ۱ | `RATE_IMPORTER.md` | rename از `DEPLOYMENT.md` — محتوا همان است (راهنمای ایمپورت نرخ‌ها) ولی نام درست شد |

### فایل‌های آرشیو‌شده (۳ فایل — انتقال به `01_Documents/archives/`)

این فایل‌ها از ریشهٔ `01_Documents/` به `01_Documents/archives/` منتقل شده‌اند
چون توسط `CLIENT_DELIVERY.md` و `UAT-3.11.md` جایگزین شده‌اند:

| # | فایل | دلیل آرشیو |
|---|------|-----------|
| ۱ | `01_Documents/STATUS.md` | stale از 2026-08-10؛ `CLIENT_DELIVERY.md` جایگزینش کرده |
| ۲ | `01_Documents/IFNEX_Meeting_Summary.md` | one-time summary از 2026-08-29؛ کارهای لیست‌شده همه انجام شد |
| ۳ | `01_Documents/IFNEX_Phase0_Checklist.md` | superseded با Roadmap و CLIENT_DELIVERY |

هر فایل آرشیو‌شده در ابتدای خود بنر «آرشیو شد» دارد.

### فایل‌های حذف‌شده (۱ فایل)

| # | فایل | دلیل حذف |
|---|------|---------|
| ۱ | `DEPLOYMENT.md` (ریشه) | rename شد به `RATE_IMPORTER.md` — محتوا درست ولی نام غلط بود (نباید «استقرار» می‌بود) |

---

## 📥 نحوهٔ نصب

### مرحلهٔ ۱: اکسترکت ZIP

محتوای ZIP را روی ریشهٔ پروژه اکسترکت کنید (Replace):

```
C:\xampp\htdocs\IFNEX-Logistics\
```

ساختار ZIP به‌گونه‌ای طراحی شده که با اکسترکت روی ریشه، فایل‌ها در مسیر
درست قرار بگیرند.

### مرحلهٔ ۲: حذف فایل قدیمی

**دقت مهم:** فایل `DEPLOYMENT.md` در ریشه باید حذف شود چون rename شد.
اگر ویندوز اجازه overwrite به‌جای delete نمی‌دهد:

```powershell
cd C:\xampp\htdocs\IFNEX-Logistics
del DEPLOYMENT.md
```

> اگر فایل `RATE_IMPORTER.md` بعد از اکسترکت موجود است و `DEPLOYMENT.md`
> هم هنوز موجود است، فقط `DEPLOYMENT.md` را حذف کنید.

### مرحلهٔ ۳: بررسی

```powershell
cd C:\xampp\htdocs\IFNEX-Logistics

# باید این فایل‌ها موجود باشند:
dir README.md AGENT.md RATE_IMPORTER.md DEPLOYMENT_HANDOFF.md CLIENT_DELIVERY.md UAT-3.11.md
dir 04_Laravel\README.md
dir 01_Documents\IFNEX_Roadmap.md 01_Documents\IFNEX_Pro_Backlog.md
dir 01_Documents\archives\STATUS.md

# فایل قدیمی نباید موجود باشد:
dir DEPLOYMENT.md    # باید بگوید "File Not Found"
```

### مرحلهٔ ۴: تست

چون این فقط تغییر docs است، هیچ تستی لازم نیست. ولی برای اطمینان:

```powershell
cd C:\xampp\htdocs\IFNEX-Logistics\04_Laravel
php artisan test
# انتظار: 82 passed (تغییری نکرده)
```

---

## 🚀 بعد از نصب

```powershell
cd C:\xampp\htdocs\IFNEX-Logistics
git add .
git commit -m "docs: sync all docs to phase 3.11 (README, AGENT, Roadmap, Pro_Backlog, File_Map, ADR, Commercial_Model, 04_Laravel/README, DEPLOYMENT_HANDOFF) — rename DEPLOYMENT.md → RATE_IMPORTER.md, archive 3 stale docs"
git push origin main
```

---

## 📋 خلاصهٔ آمار به‌روز شده

| معیار | مقدار قبلی (در docs) | مقدار واقعی (به‌روز) |
|-------|---------------------|---------------------|
| فاز جاری | ۳.۶ (۸۰٪) | **۳.۱۱ (UAT Ready)** |
| مایگریشن‌ها | ۲۸-۴۰-۵۲ | **۶۲** |
| مدل‌ها | ۱۷-۲۲-۲۶ | **۳۱** |
| Filament Resources | ۱۰+-۱۶-۱۷ | **۱۹** |
| WordPress | 7.0.3 | **7.1** |
| تست‌ها | (ذکر نشده) | **۸۲ تست / ۲۲۰+ assertion** |
| دامنهٔ تست | ifnex.vernahost.ir | **ifnex.ir + system.ifnex.ir** |

---

## 🎯 گام بعدی

پس از push، مستندات پروژه کاملاً همگام با واقعیت کد خواهند بود. کارفرما
می‌تواند `UAT-3.11.md` را برای شروع UAT نهایی مطالعه کند.