# ⚠️ هشدار: این سند قدیمی است و با نقشه‌ی راه جدید (۴ فازی) تناقض دارد.

> **وضعیت:** این سند به‌طور کامل **منسوخ** شده و جزو مرجع رسمی پروژه **نیست**.
> **مرجع اصلی:** `Phase0_Proposal.docx` و `STATUS.md` و `IFNEX_Phase0_Checklist.md`
> **تاریخ آخرین به‌روزرسانی:** 2026-08-04
>
> 🔴 **قانون طلایی:** هرگاه بین این سند و اسناد جدید تناقض دیدی، به `STATUS.md` و `Phase0_Proposal.docx` اعتماد کن.
>
> این فایل فقط برای فهمیدن **تاریخچه تصمیمات** نگه داشته شده است. از آن برای پیاده‌سازی استفاده **نکنید**.

---

# نقشه راه و چک‌لیست پروژه IFNEX (Task List)

> ⚠️ این فایل ۳ فازی دارد. پروژه حالا ۴ فازی است. برای چک‌لیست دقیق و به‌روز، `IFNEX_Phase0_Checklist.md` را بخوانید.

---

## فاز ۰: بنیان داده + وب‌سایت + ترکینگ دستی + مهاجرت داده‌های تاریخی (در حال اجرا)

### زیرساخت و دیتابیس
- [x] نصب لاراول ۱۱ و آماده‌سازی محیط لوکال
- [x] طراحی و ساخت Migration ها (۷ جدول اصلی)
- [x] ساخت مدل‌های (Models) لاراول + ۶ Enum
- [x] سیدر (Seeder) کشورها (۲۳۲ کشور با ۴ زون)
- [x] سیدر System Settings (VAT 9%, packing 100000 IRR)
- [x] سیدر Super Admin User

### پنل مدیریت (فیلمنت)
- [x] نصب و تنظیمات اولیه فیلمنت 3.3
- [x] ساخت Resource برای کشورها
- [x] ساخت Resource برای shipments
- [x] ساخت Resource برای تعرفه‌ها (با ۱۰ zone + enum type/direction)
- [x] ساخت Resource برای shipment_items
- [x] RelationManagers برای CarrierMappings و TrackingEvents
- [x] SettingsPage برای System Settings

### ماژول‌های دیتای پایه
- [x] ماژول ایمپورت اکسل تعرفه‌ها (۴۰۴ رکورد import شد)
- [x] ماژول ایمپورت اکسل سفارشات قدیمی (شیت List) — ۱ رکورد موفق (بلاک: فایل اکسل فرمول دارد)
- [x] فرم تنظیمات نرخ ارز و ضریب سود (نظام پولی)

### منطق تجاری (Business Logic)
- [x] موتور محاسبه قیمت (PriceCalculatorService)
- [ ] تست موتور قیمت‌گذاری در پنل ادمین

### ارتباطات و API
- [x] تنظیمات CORS در لاراول ۱۱
- [x] ساخت API ترکینگ (`GET /api/v1/track/{awb_no}`)
- [ ] ساخت API استعلام قیمت (`POST /api/calculate-price`) — فاز ۱
- [ ] ساخت پلاگین اختصاصی در وردپرس — فاز ۰/۱
- [ ] ساخت شورت‌کد فرم رهگیری در وردپرس — فاز ۰/۱

### اسناد و فرم‌ها (بخش GUI)
- [ ] ساخت بارنامه PDF (Waybill) دقیقاً مشابه شیت AWB اکسل — فاز ۱
- [ ] ساخت فاکتور PDF (Invoice) مشابه شیت INVOICE اکسل — فاز ۱
- [ ] ساخت لیبل چاپی PDF (Label) مشابه شیت label اکسل — فاز ۱
- [ ] فرم رهگیری اولیه در وردپرس (استایل دارک مود با تایم‌لاین) — فاز ۰/۱
- [ ] اتصال فرم رهگیری به API لاراول — فاز ۰/۱

---

## فاز ۱: موتور قیمت‌گذاری کامل + ثبت سفارش آنلاین + تولید PDFها (در صف)

- [ ] موتور قیمت‌گذاری کامل (PriceCalculatorService) — نوشته شد، نیاز به تست با داده‌های واقعی
- [ ] جدول `shipping_rates` با نرخ‌های Import/Export — ۴۰۴ رکورد import شد
- [ ] فرم ثبت سفارش آنلاین با ۹ ردیف کالای گمرکی
- [ ] تولید PDF: AWB، INVOICE، Label مطابق قالب اکسل
- [ ] ماژول ایمپورت اکسل تعرفه‌ها
- [ ] صفحه استعلام قیمت واقعی

---

## فاز ۲: اتوماسیون مالی و رقابت‌پذیری (در صف)

- [ ] اتصال به درگاه پرداخت (مثل زرین‌پال)
- [ ] ایجاد جدول کیف پول (wallets) و تراکنش‌ها (transactions)
- [ ] شارژ اعتبار آنلاین توسط کاربر
- [ ] شارژ اعتبار دستی توسط ادمین (تایید واریز تلفنی)
- [ ] کرون‌جاب (Cron Job) برای بروزرسانی روزانه نرخ ارز از API
- [ ] سیستم کوپن و تخفیف‌ها
- [ ] فرمول محاسبه قیمت رقبا و نمایش جدول مقایسه‌ای به کاربر

---

## فاز ۳: رهگیری زنده و عملیات (Operations) (در صف)

- [ ] راه‌اندازی سرور VPS خارج از کشور (پل ارتباطی)
- [ ] اتصال به API رهگیری (پیشنهاد: TrackingMore)
- [ ] ایجاد سیستم دریافت وب‌هوک (Webhook) از سرویس رهگیری
- [ ] مپ کردن کدهای رهگیری (کد IFNEX به کد DHL/FedEx)
- [ ] ساخت داشبورد مالی ساده در پنل ادمین (سود و زیان خالص)
- [ ] فرم نظرسنجی و رضایت مشتری
- [ ] ساخت پنل کاربری مشتریان در وردپرس (لیست سفارشات، بارنامه‌ها)