Kazem Alghasi 6a4a619261 docs: update project documentation and roadmap

- 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

2026-08-28 22:04:01 +03:30

7.9 KiB

Raw Blame History

نقشه راه پروژه 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، استانداردسازی

انجام شده (۱۷ مورد کارفرما):

رفع اکشن‌های PDF در ViewShipment
رفع ShippingRatesImport
رفع تصاویر PDF (asset بجای public_path)
ستون‌های جدید جدول Shipment
Packages Repeater در فرم
changeStatus به عنوان bulkAction
afterSave hook نوتیفیکیشن
Currency CRUD
فیلد source در TrackingEvents
ImportRatesPage (دکمه‌ها + template)
استایل تراکنش‌های وردپرس
هشدار آدرس انگلیسی
نوتیفیکیشن پنل کاربری وردپرس

باقی‌مانده:

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

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

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

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

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

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

جداول دیتابیس پیشنهادی:

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

فازهای پیاده‌سازی:

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

معماری پروژه

┌─────────────────────────────────────────────────┐
│               کاربر نهایی                       │
│          (مرورگر وب / موبایل)                    │
└──────────────────┬──────────────────────────────┘
                   │
        ┌──────────▼──────────┐
        │   وب‌سایت وردپرس    │
        │  (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.

7.9 KiB Raw Blame History Unescape Escape

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

خلاصه وضعیت

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

انجام شده:

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

انجام شده:

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

انجام شده:

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

انجام شده (۱۷ مورد کارفرما):

باقی‌مانده:

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

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

جداول دیتابیس پیشنهادی:

فازهای پیاده‌سازی:

معماری پروژه

تکنولوژی‌ها

محیط‌ها

7.9 KiB

Raw Blame History