f1eb6b179c
Update project documentation to reflect the transition to Laravel 11, Filament 3.3, and the new 4-phase roadmap. - Mark `PRD_v2.md` as deprecated and provide guidance on official sources (`Phase0_Proposal.docx`, `STATUS.md`). - Update `Project_Roadmap.md` to reflect the current 4-phase structure and Phase 0 progress. - Revise `04_Laravel/README.md` with detailed setup instructions, package lists, and directory structure. - Update root `README.md` with versioning, technology stack details, and improved project structure overview.
5.4 KiB
5.4 KiB
⚠️ هشدار: این سند قدیمی است و با نقشهی راه جدید (۴ فازی) تناقض دارد.
وضعیت: این سند بهطور کامل منسوخ شده و جزو مرجع رسمی پروژه نیست. مرجع اصلی:
Phase0_Proposal.docxوSTATUS.mdوIFNEX_Phase0_Checklist.mdتاریخ آخرین بهروزرسانی: 2026-08-04🔴 قانون طلایی: هرگاه بین این سند و اسناد جدید تناقض دیدی، به
STATUS.mdوPhase0_Proposal.docxاعتماد کن.این فایل فقط برای فهمیدن تاریخچه تصمیمات نگه داشته شده است. از آن برای پیادهسازی استفاده نکنید.
نقشه راه و چکلیست پروژه IFNEX (Task List)
⚠️ این فایل ۳ فازی دارد. پروژه حالا ۴ فازی است. برای چکلیست دقیق و بهروز،
IFNEX_Phase0_Checklist.mdرا بخوانید.
فاز ۰: بنیان داده + وبسایت + ترکینگ دستی + مهاجرت دادههای تاریخی (در حال اجرا)
زیرساخت و دیتابیس
- نصب لاراول ۱۱ و آمادهسازی محیط لوکال
- طراحی و ساخت Migration ها (۷ جدول اصلی)
- ساخت مدلهای (Models) لاراول + ۶ Enum
- سیدر (Seeder) کشورها (۲۳۲ کشور با ۴ زون)
- سیدر System Settings (VAT 9%, packing 100000 IRR)
- سیدر Super Admin User
پنل مدیریت (فیلمنت)
- نصب و تنظیمات اولیه فیلمنت 3.3
- ساخت Resource برای کشورها
- ساخت Resource برای shipments
- ساخت Resource برای تعرفهها (با ۱۰ zone + enum type/direction)
- ساخت Resource برای shipment_items
- RelationManagers برای CarrierMappings و TrackingEvents
- SettingsPage برای System Settings
ماژولهای دیتای پایه
- ماژول ایمپورت اکسل تعرفهها (۴۰۴ رکورد import شد)
- ماژول ایمپورت اکسل سفارشات قدیمی (شیت List) — ۱ رکورد موفق (بلاک: فایل اکسل فرمول دارد)
- فرم تنظیمات نرخ ارز و ضریب سود (نظام پولی)
منطق تجاری (Business Logic)
- موتور محاسبه قیمت (PriceCalculatorService)
- تست موتور قیمتگذاری در پنل ادمین
ارتباطات و API
- تنظیمات CORS در لاراول ۱۱
- ساخت 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)
- ساخت داشبورد مالی ساده در پنل ادمین (سود و زیان خالص)
- فرم نظرسنجی و رضایت مشتری
- ساخت پنل کاربری مشتریان در وردپرس (لیست سفارشات، بارنامهها)