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.
95 lines
5.4 KiB
Markdown
95 lines
5.4 KiB
Markdown
# ⚠️ هشدار: این سند قدیمی است و با نقشهی راه جدید (۴ فازی) تناقض دارد.
|
||
|
||
> **وضعیت:** این سند بهطور کامل **منسوخ** شده و جزو مرجع رسمی پروژه **نیست**.
|
||
> **مرجع اصلی:** `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)
|
||
- [ ] ساخت داشبورد مالی ساده در پنل ادمین (سود و زیان خالص)
|
||
- [ ] فرم نظرسنجی و رضایت مشتری
|
||
- [ ] ساخت پنل کاربری مشتریان در وردپرس (لیست سفارشات، بارنامهها)
|