gitmodir110/ifnex
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
c54530d8da
ifnex/CLIENT_DELIVERY.md
Kazem Alghasi 40cb104a86 chore(docs): update project documentation and repository maintenance 
Update core project documentation to reflect recent architectural changes,
security implementations, and deployment requirements. This includes
refining the status tracking system and cleaning up the repository.

- Update `AGENT.md` and `STATUS.md` to establish `AGENT.md` as the primary
  source of truth for project state and contracts.
- Add `CLIENT_DELIVERY.md` as the definitive checklist for customer
  delivery status.
- Update `DEPLOYMENT.md` with new production domain information,
  storage linking instructions, and secure disk configuration for
  commitment forms.
- Update `README.md` with current migration/model counts and link to
  the new delivery checklist.
- Update `.gitignore` to exclude local AI tools and Postman workspaces.
- Remove obsolete `IFNEX-Logistics.zip` and `IFNEX_DEPRECATED_FILES_NOTICE.md`.
- Fix typos in `DEPLOYMENT.md` deployment scripts.
2026-10-03 06:21:10 +03:30

12 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

🔧 به‌روزرسانی 2026-10-03: چرخه تعهدنامه به‌صورت End-to-End تست و تأیید شد — دانلود قالب توسط مشتری (پروکسی وردپرس با توکن)، آپلود فایل امضاشده، تأیید/رد توسط ادمین در Filament همراه با اعلان دیتابیسی به مشتری، و نمایش وضعیت (تأیید شده / رد شده + دلیل رد) در پورتال مشتری. دانلود امن فایل‌ها در پنل ادمین از طریق روت‌های admin.commitment-forms.* از دیسک secure انجام می‌شود. حلقه باقی‌مانده این فلو: تست پرداخت (Wallet / Online) پس از تأیید تعهدنامه‌ها.

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: d6f9ce5 (بازبینی 2026-10-03 — شامل مدیریت کامل تعهدنامه‌ها در پنل ادمین: دانلود امن، تأیید/رد، اعلان مشتری)

Source Repository:

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

Notes

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

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