docs(pdf): add technical mapping and implementation notes to templates

Add detailed documentation within AWB, Invoice, and Label PDF templates to map HTML elements to specific Excel cell references and VLOOKUP sources. This includes requirements for fonts, colors, and dimensions to ensure future alignment with official IFNEX branding and Excel templates. Also update project status to reflect completed middleware configuration tasks.
2026-08-04 09:50:53 +03:30 · 2026-08-04 09:50:53 +03:30 · 31d28fbe68
commit 31d28fbe68
parent f330d13620
4 changed files with 100 additions and 2 deletions
--- a/01_Documents/STATUS.md
+++ b/01_Documents/STATUS.md
@ -178,8 +178,8 @@

 | # | فایل | مشکل | وضعیت | راه‌حل |
 |---|------|------|-------|-------|
-| 1 | `bootstrap/app.php` | گروه `web` تعریف نشده | ⚠️ باز | اضافه کردن `$middleware->group('web', [...])` |
-| 2 | `AdminPanelProvider.php` | Middlewareهای طولانی به صورت لیست دستی | ⚠️ بهبودنیاز | استفاده از گروه `web` به جای لیست دستی |
+| 1 | `bootstrap/app.php` | گروه `web` تعریف نشده | ✅ انجام شد | `$middleware->group('web', [...])` اضافه شد |
+| 2 | `AdminPanelProvider.php` | Middlewareهای طولانی به صورت لیست دستی | ✅ انجام شد | استفاده از گروه `web` به جای لیست دستی |
 | 3 | `bootstrap/app.php` | `statefulApi` تعریف نشده | 🟡 آینده | برای احراز هویت SPA در فاز بعد لازم است |

 **توضیح مشکل #1:**
--- a/04_Laravel/resources/views/pdfs/awb.blade.php
+++ b/04_Laravel/resources/views/pdfs/awb.blade.php
@ -1,4 +1,32 @@
 <!DOCTYPE html>
+<!-- 
+    AWB PDF TEMPLATE — TODO: تطبیق نهایی با قالب اکسل
+    
+    Excel Reference: شیت «AWB» در فایل 01KYWGVNKS5TNMN37RV77PCYNZ.xlsx
+    
+    Cell Mapping:
+    - A1: لوگوی IFNEX (image2.png, 169x159px)
+    - C1:D1: «Shipment Waybill»
+    - K11:K12: AWB Number (lookup key)
+    - A6:A13: SHIPPER section
+    - D6:D13: RECEIVER section
+    - A14:A22: SHIPMENT section
+    - D14:D22: PAYMENT section
+    - D24:E24: Shipper Signature line
+    - D28:E28: Track URL
+    
+    VLOOKUP Source: شیت «List» (A3:AD3938)
+    
+    Required Fields:
+    - Shipper: Name, Company, Phone, Email, Address, City, Zip, ID Number
+    - Receiver: Name, Company, Phone, Email, Address, City, Zip
+    - Shipment: Gross Weight, Volumetric Weight, Chargeable Weight, Dimensions, Service Type, Direction, From/To Country, Forwarder, Content
+    - Payment: Shipping Price (AED), Extra Service (IRR), Packing Cost (IRR), Domestic Pickup (IRR), Domestic Delivery (IRR), Warehousing Cost (IRR), Discount (IRR), Total Fee (IRR), Net Dirham (AED)
+    
+    Font: باید فونت رسمی IFNEX استفاده شود (در حال حاضر DejaVu Sans جایگزین شده)
+    Colors: عنوان‌ها نارنجی #f37021، حاشیه‌ها #ddd، پس‌زمینه مالی #f9f9f9
+    Page: A4 Portrait
+-->
 <html lang="fa" dir="rtl">
 <head>
    <meta charset="UTF-8">
--- a/04_Laravel/resources/views/pdfs/invoice.blade.php
+++ b/04_Laravel/resources/views/pdfs/invoice.blade.php
@ -1,4 +1,38 @@
 <!DOCTYPE html>
+<!-- 
+    INVOICE PDF TEMPLATE — TODO: تطبیق نهایی با قالب اکسل
+    
+    Excel Reference: شیت «INVOICE + label» در فایل 01KYWGVNKS5TNMN37RV77PCYNZ.xlsx
+    
+    Cell Mapping:
+    - B1: «INVOICE»
+    - E2:F2: DATE
+    - F3: INVOICE NO (AWB number, lookup key)
+    - A4:B9: SHIPPER info (Name, Company, Contact, Address, City/Zip, Email)
+    - A10:B16: CONSIGNEE info
+    - A18:F18: Content description
+    - A20:F20: Items table headers (NO, DESCRIPTION, H.S. Code, QUANTITY, UNIT PRICE, TOTAL IN USD)
+    - A21:F29: 9 item rows (VLOOKUP from List sheet)
+    - C30:F30: TOTAL INVOICE AMOUNT IN USD
+    - A31:B32: Weight & Dimension
+    - A34:B34: REASON FOR EXPORT
+    - A36:F36: Legal declaration
+    - F40:F45: AWB echo, Weight, Origin/Destination country
+    
+    VLOOKUP Source: شیت «List» (A3:CH3938)
+    
+    Required Fields:
+    - Shipper: Name, Company, Contact, Address, City/Zip, Email
+    - Consignee: Name, Company, Contact, Address, City/Zip, Email
+    - Content: Description, Reason for Export
+    - Items: up to 9 rows (Description, HS Code, Quantity, Unit Price, Total USD)
+    - Shipment: Weight, Volumetric Weight, Dimensions, Service, Direction
+    - Total Invoice Amount in USD
+    
+    Font: باید فونت رسمی IFNEX استفاده شود
+    Colors: عنوان‌ها نارنجی #f37021، جدول‌ها با حاشیه #ddd
+    Page: A4 Portrait
+-->
 <html lang="fa" dir="rtl">
 <head>
    <meta charset="UTF-8">
--- a/04_Laravel/resources/views/pdfs/label.blade.php
+++ b/04_Laravel/resources/views/pdfs/label.blade.php
@ -1,4 +1,40 @@
 <!DOCTYPE html>
+<!-- 
+    LABEL PDF TEMPLATE — TODO: تطبیق نهایی با قالب اکسل
+    
+    Excel Reference: شیت «label» در فایل 01KYWGVNKS5TNMN37RV77PCYNZ.xlsx
+    
+    Cell Mapping:
+    - C1: AWB number echo
+    - C3: AWB Number (lookup key)
+    - J2: Weight in KG
+    - J3: Weight echo
+    - A2:B2: Gross Weight
+    - A4: W*L*H formula
+    - J4: Origin Country
+    - J5: Destination Country
+    - J7: Destination Country Code
+    - A7:B7: Volumetric Weight
+    
+    VLOOKUP Source: شیت «List»
+    
+    Required Fields:
+    - AWB Number ( prominently displayed )
+    - Shipper: Name, Company, Phone, Address
+    - Receiver: Name, Company, Phone, Address
+    - Shipment: Gross Weight, Volumetric Weight, Dimensions, From/To Country
+    
+    Current Implementation: A4 size for laser printer + sticker paper
+    Original Template: Compact thermal label format
+    
+    TODO: اگر اندازه لیبل کوچک‌تر (مثل 100x150mm) نیاز است، صفحه‌بندی را تغییر دهید.
+    TODO: فونت و اندازه متن را طبق پرینتر لیبل‌زن تنظیم کنید.
+    TODO: در صورت نیاز به بارکد/QR، کتابخانه بارکد اضافه کنید.
+    
+    Font: باید فونت رسمی IFNEX استفاده شود
+    Colors: لوگو نارنجی #f37021
+    Page: فعلی A4 Portrait — قابل تغییر به اندازه سفارشی
+-->
 <html lang="fa" dir="rtl">
 <head>
    <meta charset="UTF-8">