# نقشه راه پروژه IFNEX

> **آخرین بروزرسانی:** 2026-08-29  
> **توسعه‌دهنده:** VernaSoft Group — Kazem Alghasi

---

## خلاصه وضعیت

| فاز | عنوان | وضعیت | درصد |
|------|-------|--------|------|
| فاز ۰ | پایه و زیرساخت | تکمیل شده | 100% |
| فاز ۱ | پنل مشتری وردپرس | تکمیل شده | 100% |
| فاز ۲ | پرداخت و کیف پول | تکمیل شده | 100% |
| فاز ۳ | یکپارچه‌سازی و بهبود | در دست اقدام | 60% |
| فاز ۴ (آینده) | سیستم نمایندگی | مطالعاتی | 0% |

---

## فاز ۰ — پایه و زیرساخت ✅

**هدف:** ساخت زیرساخت API لاراول + پنل ادمین Filament + ترکینگ دستی

### انجام شده:
- دیتابیس کامل با ۴ زون مجزا + ۳ نوع سرویس
- Model ها با Enum casts و روابط کامل
- Seeders کشورها و تنظیمات
- API ترکینگ (`GET /api/v1/track/{awb}`)
- API قیمت‌گذاری (`POST /api/v1/calculate`)
- پنل Filament: Country, Shipment, ShippingRate Resources
- RelationManagers: TrackingEvents, CarrierMappings, Items
- صفحات سفارشی: Settings, PriceTest, ImportRates
- مهاجرت ۳۹۵۰ رکورد تاریخی
- ایمپورت/اکسپورت نرخ‌ها (Excel)

---

## فاز ۱ — پنل مشتری وردپرس ✅

**هدف:** ثبت سفارش، لیست سفارشات، جزئیات و رهگیری در سایت وردپرس

### انجام شده:
- Bridge Auth (وردپرس → لاراول بدون رمز عبور)
- شورت‌کدهای وردپرس: فرم سفارش چند مرحله‌ای، لیست سفارشات، جزئیات، پرداخت
- دشبورد جامع مشتری (داشبورد، سفارشات، کیف پول، تراکنش‌ها، اعلان‌ها، رهگیری، پروفایل)
- API مشتری: پروفایل، کشورها، سفارشات، لغو
- قالب سفارشی IFNEX برای وردپرس

---

## فاز ۲ — پرداخت و کیف پول ✅

**هدف:** سیستم پرداخت آنلاین و کیف پول

### انجام شده:
- جدول کیف پول و تراکنش‌ها
- API کیف پول (موجودی، تراکنش‌ها)
- پرداخت از کیف پول و درگاه بانکی
- Mock Gateway (شبیه‌سازی درگاه)
- سیستم ارز (Currency CRUD)
- Multi-package (بسته‌های چندگانه مرسوله)
- تاریخچه تغییرات وضعیت (ShipmentStatusHistory)
- نوتیفیکیشن دیتابیس (ادمین و مشتری)

---

## فاز ۳ — یکپارچه‌سازی و بهبود 🔄

**هدف:** اصلاحات کارفرما، بهبود UI/UX، استانداردسازی

### انجام شده (۱۷ مورد کارفرما):
1. رفع اکشن‌های PDF در ViewShipment
2. رفع ShippingRatesImport
3. رفع تصاویر PDF (asset بجای public_path)
4. ستون‌های جدید جدول Shipment
5. Packages Repeater در فرم
6. changeStatus به عنوان bulkAction
7. afterSave hook نوتیفیکیشن
8. Currency CRUD
9. فیلد source در TrackingEvents
10. ImportRatesPage (دکمه‌ها + template)
11. استایل تراکنش‌های وردپرس
12. هشدار آدرس انگلیسی
13. نوتیفیکیشن پنل کاربری وردپرس

### باقی‌مانده:
- [ ] سیستم نمایندگی (طرح مطالعاتی آماده)
- [ ] مستندات API (OpenAPI/Swagger)
- [ ] راهنمای اپراتور
- [ ] تست‌های واحد و Integration
- [ ] بهبود سئو وب‌سایت وردپرس

---

## فاز ۴ (آینده) — سیستم نمایندگی 📋

**وضعیت:** طرح مطالعاتی آماده — منتظر تصمیم کارفرما

### مدل‌های پیشنهادی:

| مدل | توضیح | پیچیدگی |
|-----|-------|---------|
| A) کد معرف ساده | هر کاربر یه کد معرف داره، درصدی از سود به معرف میرسه | کم |
| B) نمایندگی کامل | پنل جداگانه، گزارش فروش، کمیسیون | متوسط |
| C) زیرعامل‌دهی | نماینده زیرمجموعه تعریف می‌کنه (چند سطحی) | زیاد |

**پیشنهاد:** شروع با مدل B و امکان ارتقا به C

### جداول دیتابیس پیشنهادی:
- `agents` — اطلاعات نماینده (agent_code, commission_rate, parent_agent_id)
- `agent_customers` — تخصیص مشتریان به نماینده
- `agent_commissions` — محاسبه و پرداخت کمیسیون‌ها

### فازهای پیاده‌سازی:
1. جداول + مدل + ثبت‌نام با کد معرف
2. محاسبه خودکار کمیسیون هنگام ثبت سفارش
3. پنل نماینده در Filament (گزارش‌ها + تسویه)
4. لینک معرف اختصاصی + صفحه لندینگ ثبت‌نام

---

## معماری پروژه

```
┌─────────────────────────────────────────────────┐
│               کاربر نهایی                       │
│          (مرورگر وب / موبایل)                    │
└──────────────────┬──────────────────────────────┘
                   │
        ┌──────────▼──────────┐
        │   وب‌سایت وردپرس    │
        │  (ifnex.vernahost.ir) │
        │                     │
        │  ─ قالب IFNEX       │
        │  ─ پلاگین IFNEX     │
        │    Bridge           │
        │  ─ دشبورد مشتری     │
        │  ─ فرم سفارش        │
        │  ─ صفحه پرداخت      │
        └──────────┬──────────┘
                   │ API (Sanctum/Bridge)
        ┌──────────▼──────────┐
        │   API لاراول        │
        │ (api.ifnex.vernahost) │
        │                     │
        │  ─ قیمت‌گذاری       │
        │  ─ سفارشات مشتری   │
        │  ─ کیف پول          │
        │  ─ پرداخت           │
        │  ─ نوتیفیکیشن        │
        └──────────┬──────────┘
                   │
        ┌──────────▼──────────┐
        │   پنل ادمین Filament │
        │ (api.ifnex.vernahost) │
        │      /panel          │
        │                     │
        │  ─ مرسولات          │
        │  ─ نرخ‌ها           │
        │  ─ کشورها           │
        │  ─ ارزها            │
        │  ─ ترکینگ           │
        │  ─ تنظیمات          │
        └─────────────────────┘
```

---

## تکنولوژی‌ها

| لایه | تکنولوژی |
|------|---------|
| بک‌اند | Laravel 11 + PHP 8.2 |
| پنل ادمین | Filament 3.x |
| فرانت‌اند | WordPress + قالب سفارشی |
| پرداخت | Mock Gateway + آماده برای Zarinpal/IDPay |
| PDF | Dompdf |
| Excel | maatwebsite/excel |
| بارکد | picqer/php-barcode-generator |
| تاریخ | morilog/jalali |
| احراز هویت | Laravel Sanctum + Bridge Auth |
| دیتابیس | MySQL |
| سرور | HestiaCP + SSH |

---

## محیط‌ها

| محیط | دامنه | وضعیت |
|------|-------|--------|
| تست/تولید | api.ifnex.vernahost.ir | فعال |
| تست/تولید | ifnex.vernahost.ir | فعال |
| لوکال | localhost:8000 | توسعه |

---

> 2026 VernaSoft Group. Internal use only.