6a4a619261
- update `IFNEX_File_Map.md` to include new migrations and models from phases 2 and 3 - update `IFNEX_Phase0_Checklist.md` to reflect completed status of phase 0 and progress on subsequent phases - add `IFNEX_Roadmap.md` to outline project milestones and future development stages
198 lines
7.9 KiB
Markdown
198 lines
7.9 KiB
Markdown
# نقشه راه پروژه 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.
|