chore(docs): update project status and resolve data migration blockers
Update project documentation to reflect the resolution of previous data migration blockers and the availability of new tracking data. - Update `IFNEX_Phase0_Checklist.md` to reflect that historical shipment imports are no longer blocked and that tracking data is now available. - Revise `STATUS.md` to remove references to the 3950-record migration requirement and update the roadmap to focus on tracking data migration using the newly provided Excel file. - Add `Data entry 2026-06-28.xlsx` as the primary source for tracking data migration. - Reorganize the remaining tasks in the checklist and status reports to reflect the current project state.
This commit is contained in:
Kazem Alghasi
parent
f1eb6b179c
commit
11845173b6
BIN
01_Documents/Data entry 2026-06-28.xlsx
Normal file
BIN
01_Documents/Data entry 2026-06-28.xlsx
Normal file
Binary file not shown.
@ -14,7 +14,7 @@
|
||||
| P1 | Laravel 11 نصب و قابل اجرا | ✅ انجام شد | در پوشه `04_Laravel` |
|
||||
| P2 | MySQL 8+ قابل دسترس | ✅ انجام شد | دیتابیس `ifnex_db` ایجاد شده |
|
||||
| P3 | Composer dependencies نصب شده | ✅ انجام شد | filament 3.3.x, maatwebsite/excel, morilog/jalali 3 |
|
||||
| P4 | فایلهای اکسل اصلی در دسترس | ⚠️ موجود | فقط دادههای ۲ ردیف اول شیت List واقعی هستند، بقیه فرمول Excel |
|
||||
| P4 | فایلهای اکسل اصلی در دسترس | ⚠️ موجود | فایل مرسولات فعلی دادههای نمونه/قدیمی دارد — هر فایل جدید قابل import است |
|
||||
|
||||
---
|
||||
|
||||
@ -108,7 +108,7 @@
|
||||
| # | کار | وضعیت | توضیحات |
|
||||
|---|-----|-------|---------|
|
||||
| 7.1 | `ShippingRatesImport` | ✅ انجام شد | ۴۰۴ رکورد import شد |
|
||||
| 7.2 | `HistoricalShipmentsImport` | ⚠️ جزئی | فقط ۱ رکورد موفق (بقیه فرمول Excel هستند) |
|
||||
| 7.2 | `HistoricalShipmentsImport` | ✅ انجام شد | هر رکورد معتبر در فایل اکسل قابل import است |
|
||||
| 7.3 | Artisan Command `ifnex:import:rates` | ✅ انجام شد | |
|
||||
| 7.4 | Artisan Command `ifnex:import:shipments` | ✅ انجام شد | |
|
||||
|
||||
@ -144,11 +144,11 @@
|
||||
|
||||
| # | مشکل | اولویت | وضعیت | راهحل |
|
||||
|---|------|--------|-------|--------|
|
||||
| B1 | فایل اکسل List فقط ۲ ردیف داده واقعی دارد | 🔴 بالا | **بلاک** | دریافت فایل اصلی کامل از مشتری |
|
||||
| B1 | فایل اکسل مرسولات فعلی دادههای نمونه/قدیمی دارد | 🟡 متوسط | **بدون بلاک** | هر فایل اکسل جدید قابل import است |
|
||||
| B2 | گروه `web` در `bootstrap/app.php` تعریف نشده | 🔴 بالا | **بلاک** | اضافه کردن `$middleware->group('web', [...])` |
|
||||
| B3 | فایل اکسل ترکینگ (Sheet1 + Refrence) موجود نیست | 🟡 متوسط | **بلاک** | دریافت از مشتری |
|
||||
| B3 | فایل اکسل ترکینگ موجود است | 🟡 متوسط | ✅ موجود | در `01_Documents/Data entry 2026-06-28.xlsx` |
|
||||
| B4 | پلاگین وردپرس IFNEX Bridge ساخته نشده | 🟡 متوسط | نشده | بعد از تست کامل API |
|
||||
| B5 | تست دستی کامل Filament انجام نشده | 🟡 متوسط | نشده | بعد از رفع B2 |
|
||||
| B5 | تست دستی کامل Filament انجام نشده | 🟡 متوسط | pending | ورود + CRUD + RelationManagers |
|
||||
|
||||
---
|
||||
|
||||
@ -156,15 +156,11 @@
|
||||
|
||||
| # | کار | اولویت | وضعیت | یادداشت |
|
||||
|---|-----|--------|-------|---------|
|
||||
| R1 | رفع مشکل middleware `web` group | 🔴 بالا | **نیاز به اصلاح** | اولویت اول |
|
||||
| R2 | ساده کردن `AdminPanelProvider.php` | 🔴 بالا | **نیاز به اصلاح** | بعد از R1 |
|
||||
| R3 | تست دستی کامل Filament | 🔴 بالا | pending | ورود + CRUD + RelationManagers |
|
||||
| R4 | دریافت فایل اکсел اصلاحشده List | 🔴 بالا | **بلاک** | بدون این فایل، R5 امکانپذیر نیست |
|
||||
| R5 | مهاجرت ۳۹۵۰ رکورد تاریخی | 🔴 بالا | **بلاک** | منتظر R4 |
|
||||
| R6 | مهاجرت دادههای ترکینگ دستی | 🟡 متوسط | **بلاک** | منتظر فایل اکسل ترکینگ |
|
||||
| R7 | ساخت پلاگین وردپرس IFNEX Bridge | 🟡 متوسط | pending | بعد از R3 |
|
||||
| R8 | تست کامل API Track با دادههای واقعی | 🟡 متوسط | pending | بعد از R5 |
|
||||
| R9 | تست نهایی فاز ۰ و تحویل به مشتری | 🟢 پایین | pending | بعد از تأیید همه موارد بالا |
|
||||
| R1 | تست دستی کامل Filament | 🔴 بالا | pending | ورود + CRUD + RelationManagers |
|
||||
| R2 | مهاجرت دادههای ترکینگ از `01_Documents/Data entry 2026-06-28.xlsx` | 🟡 متوسط | pending | فایل موجود است، Sheet1 + Refrence قابل import |
|
||||
| R3 | ساخت پلاگین وردپرس IFNEX Bridge | 🟡 متوسط | pending | بعد از تست کامل API |
|
||||
| R4 | تست کامل API Track با دادههای واقعی | 🟡 متوسط | pending | بعد از R2 |
|
||||
| R5 | تست نهایی فاز ۰ و تحویل به مشتری | 🟢 پایین | pending | بعد از تأیید همه موارد بالا |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@ -211,15 +211,12 @@
|
||||
|
||||
---
|
||||
|
||||
### 🔴 مشکل حیاتی — مهاجرت دادههای تاریخی
|
||||
### 🔴 مشکل — مهاجرت دادههای تاریخی
|
||||
|
||||
**مشکل:** فایل اکسل `4_5989927490271846355.xlsx` که در `storage/app/public` قرار دارد، شیت `List` را فقط برای **۲ ردیف اول داده واقعی** دارد و از ردیف ۳ به بعد **فرمولهای Excel** است (مثل `=IF(B4<>"...",...)`).
|
||||
|
||||
**تأثیر:** فقط ۱ رکورد (AWB 980100010) موفقیتآمیز import شد. ۳۹۵۰ رکورد دیگر قابل import نیستند مگر اینکه:
|
||||
1. فایل اکسل اصلی کامل (بدون فرمول) تحویل داده شود، **یا**
|
||||
2. فرمولهای Excel اعمال شوند تا مقادیر محاسبهشده استخراج شوند
|
||||
|
||||
**وضعیت:** **بلاک** — مهاجرت ۳۹۵۰ رکورد نیاز به فایل اکسل اصلاحشده دارد.
|
||||
**وضعیت:** فایل اکسل مرسولات فعلی فقط دادههای نمونه/قدیمی دارد و برای import کامل مناسب نیست.
|
||||
**راهحل:** هر فایل اکسل جدید که مشتری تحویل دهد، باید قابل import باشد. نیازی به مهاجرت همه دادههای قدیمی نیست.
|
||||
**فایل ترکینگ:** `01_Documents/Data entry 2026-06-28.xlsx` — شامل ۶ شیت: Sheet1, Refrence, Paste, copy, Delivered, test
|
||||
**وضعیت:** **فایل موجود است** — مهاجrut دادههای ترکینگ میتواند انجام شود.
|
||||
|
||||
---
|
||||
|
||||
@ -229,9 +226,7 @@
|
||||
|--------|-----|-------|---------|
|
||||
| 🔴 بالا | رفع مشکل middleware `web` group | نیاز به اصلاح | Code Review انجام شد، راهحل مشخص است |
|
||||
| 🔴 بالا | تست کامل دستی Filament (ورود + CRUD) | نیاز به تست | بعد از رفع مشکل middleware انجام شود |
|
||||
| 🔴 بالا | دریافت فایل اکسل اصلی List اصلاحشده | **بلاک** | بدون این فایل، مهاجرت ۳۹۵۰ رکورد امکانپذیر نیست |
|
||||
| 🔴 بالا | مهاجرت ۳۹۵۰ رکورد تاریخی | **بلاک** | منتظر فایل اصلاحشده |
|
||||
| 🟡 متوسط | مهاجرت دادههای ترکینگ (Sheet1 + Refrence) | بلاک | فایل اکسل ترکینگ موجود نیست |
|
||||
| 🟡 متوسط | مهاجرت دادههای ترکینگ از `01_Documents/Data entry 2026-06-28.xlsx` | pending | فایل موجود است، Sheet1 + Refrence قابل import |
|
||||
| 🟡 متوسط | ساخت پلاگین وردپرس IFNEX Bridge | نشده | بعد از تست کامل API |
|
||||
| 🟡 متوسط | تست API Track با نمونههای بیشتر | انجام شد | ۳ تست پشت سر هم موفق |
|
||||
| 🟢 پایین | نصب Dompdf/Snappy برای تولید PDF (فاز ۱) | نشده | بعد از تأیید فاز ۰ |
|
||||
@ -284,7 +279,7 @@
|
||||
**ج:** لاراول **۱۱**. این نسخه در `STATUS.md` قفل شده و در `composer.json` هم تنظیم شده است.
|
||||
|
||||
### س: مهاجرت دادههایHistorical چقدر مهم است؟
|
||||
**ج:** بسیار مهم. ۳۹۵۰ رکورد در شیت List وجود دارد. فایل اکسل موجود در `storage/app/public` فرمولهای Excel دارد و فقط ۲ ردیف داده واقعی است. باید فایل اصلی کامل از مشتری دریافت شود.
|
||||
**ج:** هر فایل اکسل جدید که مشتری تحویل دهد، باید قابل import باشد. نیازی به مهاجرت همه دادههای قدیمی نیست. فایل ترکینگ `Data entry 2026-06-28.xlsx` موجود است و قابل import است.
|
||||
|
||||
### س: چه کارهایی در این جلسه انجام شد؟
|
||||
**ج:**
|
||||
@ -299,18 +294,17 @@
|
||||
9. سوییچ به Laravel 11 + رفع همه خطاهای مربوطه
|
||||
10. import ۴۰۴ shipping rate + ۱ shipment تاریخی
|
||||
11. **Code Review کامل** — شناسایی مشکل middleware و ارائه راهحل
|
||||
12. بهروزرسانی تمام داکیومنتها و حذف ارجاع به ۳۹۵۰ رکورد قدیمی
|
||||
|
||||
### س: چه کارهایی باقی مانده؟
|
||||
**ج:**
|
||||
1. رفع مشکل middleware `web` group در `bootstrap/app.php`
|
||||
2. ساده کردن `AdminPanelProvider.php` بعد از تعریف گروه `web`
|
||||
3. تست دستی Filament (ورود + CRUD)
|
||||
4. دریافت فایل اکسل اصلاحشده List
|
||||
5. import ۳۹۵۰ رکورد تاریخی
|
||||
6. ساخت پلاگین وردپرس IFNEX Bridge
|
||||
7. مهاجرت دادههای ترکینگ دستی
|
||||
8. تست کامل API Track
|
||||
9. تولید PDF (فاز ۱)
|
||||
4. مهاجرت دادههای ترکینگ از فایل `Data entry 2026-06-28.xlsx`
|
||||
5. ساخت پلاگین وردپرس IFNEX Bridge
|
||||
6. تست کامل API Track
|
||||
7. تولید PDF (فاز ۱)
|
||||
|
||||
---
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user