gitmodir110/ifnex
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
ee86285217
ifnex/CLIENT_DELIVERY.md
Kazem Alghasi ee86285217 docs(delivery): add client delivery checklist
2026-09-24 13:11:26 +03:30

10 KiB
Raw Blame History

IFNEX — Client Delivery Checklist

وضعیت تحویل نسخه فعلی IFNEX به مشتری این فایل فقط برای مدیریت تعهدات، تست و تحویل نسخه فعلی مشتری است و جایگزین AGENT.md یا IFNEX_Roadmap.md نیست.

1. Current Delivery Status

Project: IFNEX Logistics Management System Current Phase: Phase 3.6 — Client Meeting Adjustments Target: Production Delivery to Current Client

Status Legend

  • ✅ Completed
  • 🟡 Implemented — Needs Final Verification
  • ⏳ Pending
  • 🔴 Blocked
  • ❌ Not Implemented

2. Client Requested Features

2.1 Frontend / Landing Page

Hero Tracking Redirect

Requirement: در بخش Hero صفحه اصلی WordPress، گزینه «ردیابی مرسوله» باید کاربر را به صفحه اختصاصی Tracking هدایت کند.

Status: 🟡 Implemented — Needs Final Verification

Files to Review:

  • 03_WordPress/wp-content/themes/ifnex/...
  • 03_WordPress/wp-content/plugins/ifnex-bridge/...

Acceptance Test:

  • کلیک روی CTA
  • Redirect صحیح
  • URL صحیح
  • نمایش صحیح صفحه Tracking
  • تست در حالت Login / Guest در صورت نیاز

2.2 New Order — Multi-Step Form

Step 1 → Step 2

Requirement: پس از تکمیل مرحله اول فرم ثبت سفارش، مرحله دوم بدون خطا Load شود.

Status: 🟡 Implemented — Needs Final Verification

Known Historical Issue: بسته‌نبودن یک div در فایل shortcodes.php.

Relevant Files:

  • 03_WordPress/wp-content/plugins/ifnex-bridge/includes/shortcodes.php
  • 03_WordPress/wp-content/plugins/ifnex-bridge/assets/js/ifnex-order-form.js

Acceptance Test:

  • Export
  • Import
  • تغییر بین مراحل
  • Validation
  • Browser Console بدون Error
  • حفظ اطلاعات مراحل قبلی

3. Customer Dashboard / Financial Status

3.1 Customer Balance

Requirement: در Dashboard مشتری، علاوه بر Wallet Balance و Orders، مانده حساب مشتری نیز نمایش داده شود.

فرمول مورد انتظار:

Available Balance / Account Balance = Wallet Balance - Outstanding Approved Obligations

Status: 🟡 Implemented — Needs Final Verification

Acceptance Test:

  • Wallet مثبت
  • بدون بدهی
  • دارای بدهی
  • دارای چند سفارش تأییدشده ولی پرداخت‌نشده
  • نمایش صحیح ارز
  • عدم تبدیل بدهی چندارزی به یک مبلغ ریالی اشتباه

4. Order Approval Before Payment

4.1 General Flow

Required Flow:

Create Order → Pending Approval → Staff Review → Approved → Documents / Commitment Verification → Payment Enabled → Wallet OR Online Payment → Paid → Processed

Requirement: مشتری بلافاصله پس از ثبت سفارش نباید وارد درگاه شود.

Status: 🟡 Implemented — Needs End-to-End Verification

4.2 Export Order

Required Flow:

Create Export Order → Pending Approval → Staff Approval → Documents Available → Customer Downloads Documents → Customer Signs / Fingerprints → Customer Uploads Signed Documents → Staff Verification → Payment Enabled → Wallet / Online Payment → Paid → Shipment Processing

Documents:

  • AWB
  • Invoice
  • Label
  • Commitment Forms
  • Other required documents

Status: 🟡 Implemented — Needs End-to-End Verification

4.3 Import Order

Required Flow:

Create Import Order → Pending Approval → Staff Review → Required Documents → Customer Verification / Upload → Staff Verification → Payment Enabled → Wallet / Online Payment → Paid → Shipment Processing

Status: 🟡 Implemented — Needs Final Verification

5. Employee Checklist

Requirement: برای هر سفارش یک Checklist عملیاتی وجود داشته باشد.

هر Checklist Item باید حداقل شامل موارد زیر باشد:

  • Item
  • Status
  • Required / Optional
  • Completed By
  • Completed At
  • Note
  • Attachment (when needed)

Manager Requirements:

  • مشاهده تمام مراحل
  • مشاهده کارمند انجام‌دهنده
  • مشاهده تاریخ و ساعت
  • مشاهده موارد ناقص
  • امکان گزارش‌گیری
  • امکان شناسایی سفارش‌های مشکل‌دار

Status: ⏳ Pending / Requires Full Workflow Verification

6. Shipment History / Timeline

Requirement: مدیر بتواند تاریخچه کامل هر Shipment را از شروع تا پایان مشاهده کند.

هر تغییر باید تا حد امکان شامل موارد زیر باشد:

  • Previous Status
  • New Status
  • User / Employee
  • Date
  • Time
  • Note

Status: 🟡 Implemented — Needs Final Verification

7. PDF Documents

Required Documents

  • AWB
  • Invoice
  • Label
  • Import Invoice
  • Commitment Documents where applicable

Requirement: طراحی PDFها باید تا حد امکان مطابق نمونه‌های Excel / Client Documents باشد.

Important: تطبیق 100٪ پیکسلی ممکن است به دلیل تفاوت موتور PDF با Excel امکان‌پذیر نباشد. هدف، نزدیک‌ترین تطبیق عملی و قابل چاپ است.

Status: 🟡 Requires Final Client Review

Final PDF Acceptance

  • AWB
  • Export Invoice
  • Import Invoice
  • Label
  • Barcode
  • Alignment
  • Typography
  • Page size
  • Printable output

8. Customer Financial Information — Staff / Manager

Requirement: کارمند یا مدیر بتواند با انتخاب یا جستجوی مشتری، اطلاعات مالی کامل او را مشاهده کند.

Required Information

  • Current Balance
  • Receivables / Payables
  • Currency
  • Recent Transactions
  • Recent Orders
  • Order Reference
  • Amount
  • Payment Status
  • Dates
  • Notes

Status: 🟡 Implemented — Needs Final Verification

9. Customer Credit

Requirement: فقط مدیر کل بتواند برای مشتری شناخته‌شده Credit ایجاد یا افزایش دهد.

Important Rule

اگر مشتری:

50 EUR

بدهکار است، بدهی باید به صورت:

50 EUR

ثبت شود و نباید به مبلغ ریالی روز تبدیل و جایگزین شود.

هنگام تسویه ریالی:

  • Original Amount
  • Original Currency
  • Settlement Currency
  • Exchange Rate
  • Exchange Rate Date
  • Settlement Amount
  • Reason / Reference

باید ثبت شود.

Status: ⏳ Multi-Currency Credit Requires Redesign / Final Implementation

10. Bulk Tracking Import

Requirement: امکان Import گروهی آخرین وضعیت Trackingها در پنل مدیریت.

Expected Input: CSV / approved import format

Expected Result:

  • Find Shipment
  • Validate Tracking Number
  • Update Status
  • Register History
  • Record Import Result
  • Report Failed Rows

Status: 🟡 Implemented — Needs Final Verification

11. Admin Editing + Audit Log

Requirement: مدیر بتواند تقریباً همه اطلاعات عملیاتی لازم را ویرایش کند.

Important Rule: تغییرات مدیریتی باید قابل Audit باشند.

Audit Information

  • User
  • Action
  • Model
  • Record
  • Old Value
  • New Value
  • Date
  • Time
  • IP where applicable

Status: 🟡 Implemented — Needs Security / Authorization Verification

12. SMS Integration

Provider: Kavenegar

Required Use Cases

  • Mobile Verification
  • Registration Verification
  • Order Submitted
  • Order Approved
  • Order Rejected
  • Payment Successful
  • Tracking Status Changes
  • Important System Notifications

Status: 🟡 Implemented — Needs Production Configuration / End-to-End Verification

13. Production Hardening

این بخش الزاماً درخواست مستقیم مشتری نیست، اما قبل از تحویل Production باید بررسی شود.

Security

  • Remove / rotate exposed secrets
  • Verify Bridge API Key handling
  • Verify Staff route authorization
  • Verify Admin-only operations
  • Verify File Upload validation
  • Verify document ownership / authorization
  • Verify payment callback security
  • Disable Mock Gateway in Production

Financial Integrity

  • Wallet concurrency protection
  • Payment idempotency
  • Coupon consumption logic
  • Money / currency precision
  • Multi-currency debt integrity

Application

  • Legacy Order Flow review
  • Exception handling
  • Production logging
  • Cache / OPcache configuration
  • Asset versioning

14. End-to-End Acceptance Testing

Customer

  • Register
  • Mobile Verification
  • Login
  • Create Export Order
  • Create Import Order
  • View Order
  • Wait for Approval
  • Receive Documents
  • Download Documents
  • Upload Signed Documents
  • Receive Approval
  • Pay with Wallet
  • Pay Online
  • View Balance
  • View Transactions
  • View Tracking
  • Receive Notifications

Staff

  • View Orders
  • Approve Order
  • Reject Order
  • Upload Commitment
  • Verify Customer Documents
  • Complete Checklist
  • Update Shipment
  • Import Tracking
  • View Customer Financial Status
  • View Customer Orders
  • Review Audit Log

Manager / Super Admin

  • Customer Financial Review
  • Grant Credit
  • Modify Credit
  • Review Audit
  • View Shipment Timeline
  • Edit Operational Data
  • Review Staff Activity

15. Final Delivery Gate

Before Production:

  • All required features implemented
  • All critical bugs fixed
  • Security review completed
  • Payment flow tested
  • Wallet flow tested
  • Export flow tested
  • Import flow tested
  • PDFs approved
  • SMS tested
  • Tracking import tested
  • Backup verified
  • Production environment verified
  • Client UAT completed

16. Delivery Status

Current Status: IN PROGRESS

Next Task: End-to-End Order Flow Review

Last Reviewed Commit: e032fceb34

Source Repository:

https://www.git.vernahost.ir/gitmodir110/ifnex

Notes

این فایل باید در طول تحویل پروژه به‌روزرسانی شود.

این فایل برای وضعیت تحویل مشتری است و نباید تبدیل به مستندات معماری یا Roadmap محصول شود.