hesabix/ArcWOC
Watch
1
0
Fork
You've already forked ArcWOC
 0
Code Issues Pull requests Projects Releases 17 Packages Wiki Activity Actions
ArcWOC/CHANGELOG.md
Babak Alizadeh 11e8f522d3 Release 4.10.0: safe disconnect and change-business cleanup 
Add a dedicated disconnect flow that truncates mappings/queue, clears
business-scoped IDs (shipping/fee/warehouse/bank), bridge token, sync
meta, and best-effort Hesabix Woo bridge settings. Change-business and
setup-complete now require this cleanup so reconnecting to a new
business cannot reuse stale links. Also expose delete-data-on-uninstall
in settings.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-22 16:03:06 +00:00

13 KiB
Executable file
Raw Permalink Blame History

Changelog

تمام تغییرات مهم در این پروژه در این فایل مستند می‌شود.

[4.10.0] - 2026-09-22

Added

  • قطع اتصال امن از حسابیکس با پاکسازی نگاشت‌ها، صف، شناسه‌های وابسته به کسب‌وکار، متای همگام‌سازی و توکن پل
  • جریان «تغییر کسب‌وکار» با قطع اتصال خودکار قبل از ویزارد راه‌اندازی مجدد
  • گزینهٔ «حذف داده‌ها هنگام Uninstall» در تب سایر
  • پاکسازی بهترین‌تلاش تنظیمات پل ووکامرس در کسب‌وکار قبلی حسابیکس هنگام قطع اتصال

Fixed

  • تعویض کسب‌وکار دیگر نگاشت‌ها و شناسه‌های کالای حمل/کارمزد کسب‌وکار قبلی را برای اتصال جدید باقی نمی‌گذارد
  • Uninstall اکنون در صورت فعال بودن گزینه، متای همگام‌سازی و cron کشش موجودی را هم پاک می‌کند

[4.9.3] - 2026-08-06

Fixed

  • فهرست مشتریان پل REST همیشه خالی بود: WC_Customer_Query در ووکامرس جدید وجود ندارد؛ کوئری با WP_User_Query و نقش‌های customer/subscriber جایگزین شد
  • جلوگیری از کش شدن پاسخ‌های پل توسط LiteSpeed با هدر X-LiteSpeed-Cache-Control: no-cache
  • شمارش مشتریان در گزارش خلاصه هم‌راستا با نقش‌های همگام‌سازی افزونه

[4.9.2] - 2026-08-04

Fixed

  • نمایش سود با واحد ارز فاکتور حسابیکس (مثلاً ریال ایران) به‌جای قالب‌بندی اشتباه با ارز ووکامرس (تومان)

[4.9.1] - 2026-08-04

Fixed

  • خواندن سود از data.item در پاسخ GET فاکتور (قبلاً به‌اشتباه صفر ذخیره می‌شد)

Added

  • هشدار در متاباکس وقتی بهای تمام‌شده صفر است و سود نمایشی برابر فروش است

[4.9.0] - 2026-08-04

Added

  • نمایش سود فاکتور حسابیکس در فهرست سفارش‌های افزونه و متاباکس ویرایش سفارش ووکامرس
  • دریافت خودکار سود پس از همگام‌سازی موفق فاکتور؛ دکمهٔ تازه‌سازی تکی و دسته‌ای
  • بنر دعوت به فعال‌سازی لایسنس افزونهٔ رسمی ووکامرس در بازار حسابیکس (پنهان هنگام لایسنس فعال)
  • یادآوری فعال‌سازی پل وردپرس وقتی لایسنس هست ولی پل آماده نیست
  • کش وضعیت لایسنس بازار افزونه با امکان بررسی مجدد و پنهان‌سازی موقت بنر

[4.8.2] - 2026-08-04

Fixed

  • بارگذاری خالی لیست حساب بانکی و صندوق در تنظیمات: درخواست با take=500 از سقف QueryInfo API (حداکثر ۱۰۰) رد می‌شد و افزونه بدون پیام خطا لیست خالی نشان می‌داد
  • نمایش پیام خطای API برای بانک/صندوق/انبار به‌جای موفقیت خاموش با لیست خالی
  • پاک‌سازی خودکار شناسه بانک/صندوق پیش‌فرض که به کسب‌وکار فعلی تعلق ندارد (جلوگیری از ثبت دریافت روی حساب کسب‌وکار دیگر)

[4.7.2] - 2026-07-25

Fixed

  • همگام‌سازی خودکار محصولات متغیر: واریانت‌ها به‌صورت کالاهای جداگانه ارسال می‌شوند؛ والد دیگر به‌عنوان محصول ساده ساخته نمی‌شود
  • هوک‌های ایجاد/به‌روزرسانی واریانت (woocommerce_new/update_product_variation) برای همگام‌سازی تکی واریانت
  • آرگومان‌های اشتباه lazy-sync واریانت هنگام ساخت فاکتور از سفارش
  • باگ $cref تعریف‌نشده در مسیر bulk-upsert کالا که نگاشت پاسخ API را خراب می‌کرد
  • حذف نگاشت‌های واریانت هنگام حذف محصول والد یا خود واریانت

Changed

  • sync_product برای محصول متغیر همهٔ فرزندان را گسترش می‌دهد؛ محصول متغیر خالی دیگر به‌عنوان ساده ارسال نمی‌شود
  • پاک‌سازی نگاشت محلی یتیم «والد متغیر به‌عنوان ساده» هنگام همگام‌سازی صحیح واریانت‌ها (با ثبت در رجیستری برای پاک‌سازی بعدی)

Added

  • ابزار پاک‌سازی امن کالاهای یتیم والد متغیر در صفحهٔ محصولات (اسکن، پیش‌نمایش، حذف استفاده‌نشده / غیرفعال‌سازی در-استفاده)
  • رجیستری محلی hesabix_v2_orphan_parent_products برای نگهداشت شناسهٔ کالاهای یتیم پس از قطع نگاشت
  • API حسابیکس: GET /products/business/{id}/{product_id}/usage-check
  • تقویت گارد حذف کالا برای اسناد هزینه/درآمد کالا و قطعات تعمیر

[4.7.1] - 2026-07-21

Fixed

  • جلوگیری از همگام‌سازی محصولات پیش‌نویس (از جمله کپی/داپلیکیت منتشرنشده) به حسابیکس
  • رفع فریز شدن نام محصول پس از کپی→تغییرنام→انتشار در سیاست حسابداری‌محور (نام اکنون در به‌روزرسانی همگام می‌شود)

Changed

  • سیاست حسابداری‌محور: هویت فروشگاهی (name) از ووکامرس همگام می‌شود؛ قیمت خرید و داده‌های مالی همچنان محافظت می‌شوند
  • همگام‌سازی خودکار و دسته‌ای فقط وضعیت‌های مجاز (پیش‌فرض: publish) را پوشش می‌دهند

Added

  • فیلتر واقعی hesabix_v2_should_sync_product و hesabix_v2_syncable_product_statuses
  • لاگ رد شدن همگام‌سازی به‌خاطر وضعیت/فیلتر و فیلدهای ارسال‌شده در به‌روزرسانی

[4.7.0] - 2026-07-19

Fixed

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

Added

  • سیاست‌های همگام‌سازی محصول: ایمپورت اولیه، حسابداری‌محور (پیش‌فرض)، فروشگاه زنده، پیشرفته
  • تنظیمات جزئی‌تر برای نام، توضیحات و بارکد در حالت پیشرفته
  • کلاس Hesabix_V2_Product_Sync_Payload برای تفکیک CREATE/UPDATE

Changed

  • قیمت خرید (base_purchase_price) دیگر از ووکامرس به حسابیکس ارسال نمی‌شود
  • فیلتر hesabix_v2_product_data در مسیر sync واقعاً اعمال می‌شود

[2.0.0] - 2024-12-05

🎉 Added - موارد جدید

معماری

  • ✨ ساختار کاملاً جدید با معماری Layered
  • ✨ جداسازی کامل از نسخه V1 (جداول، options، کلاس‌ها)
  • ✨ پشتیبانی از نصب همزمان با نسخه قدیمی

احراز هویت

  • ✨ استفاده از Personal API Keys به جای API Key ساده
  • ✨ پشتیبانی از Bearer Token Authentication
  • ✨ Setup Wizard برای راه‌اندازی آسان و سریع
  • ✨ مدیریت چندین API Key
  • ✨ IP Whitelist Support

API Integration

  • ✨ اتصال کامل به API V2 حسابیکس
  • ✨ پشتیبانی از تمام RESTful endpoints جدید
  • ✨ Headers استاندارد (Authorization, X-Business-ID, X-Fiscal-Year-ID)
  • ✨ Error handling پیشرفته
  • ✨ Timeout management

Database

  • ✨ جدول wp_hesabix_v2 با ساختار بهبود یافته
  • ✨ جدول wp_hesabix_v2_sync_log برای لاگ‌گیری
  • ✨ جدول wp_hesabix_v2_queue برای صف پردازش
  • ✨ پشتیبانی از چندین Business در یک نصب
  • ✨ ذخیره metadata برای هر mapping
  • ✨ ردیابی sync_status و retry_count

همگام‌سازی

  • ✨ Sync Service جدید با معماری تمیز
  • ✨ Batch/Bulk sync برای عملیات گروهی
  • ✨ Queue System برای پردازش background
  • ✨ Retry mechanism با exponential backoff
  • ✨ پشتیبانی کامل از Product Variations
  • ✨ همگام‌سازی خودکار محصولات، مشتریان و سفارشات

Data Mapping

  • ✨ Mapper Classes تخصصی
  • ✨ تبدیل خودکار فرمت V1 به V2
  • ✨ Validation پیشرفته
  • ✨ Custom Fields برای داده‌های اضافی
  • ✨ پشتیبانی از Guest Customers

لاگ‌گیری

  • ✨ Log Service پیشرفته با 4 سطح (info, warning, error, debug)
  • ✨ لاگ فایلی روزانه
  • ✨ لاگ دیتابیس برای query سریع
  • ✨ Debug Mode کامل
  • ✨ پاکسازی خودکار لاگ‌های قدیمی
  • ✨ ذخیره request/response برای debug
  • ✨ محاسبه execution time

رابط کاربری

  • ✨ Dashboard جدید با آمار لحظه‌ای
  • ✨ صفحه تنظیمات پیشرفته
  • ✨ صفحه همگام‌سازی با امکان bulk operations
  • ✨ Logs Viewer با فیلتر
  • ✨ Migration Tool
  • ✨ RTL و فارسی کامل

مستندات

  • ✨ README.md جامع
  • ✨ INSTALLATION.md با راهنمای گام به گام
  • ✨ DEVELOPER_GUIDE.md برای توسعه‌دهندگان
  • ✨ TECHNICAL_COMPARISON.md
  • ✨ Comments کامل در کد

امنیت

  • ✨ Nonce verification در تمام فرم‌ها
  • ✨ Input sanitization کامل
  • ✨ Output escaping
  • ✨ Prepared statements
  • ✨ محافظت از لاگ‌ها با .htaccess
  • ✨ CSRF Protection

عملکرد

  • ✨ بهینه‌سازی Query ها
  • ✨ استفاده از Indexes در جداول
  • ✨ Lazy loading
  • ✨ Caching (آماده برای پیاده‌سازی)

🔄 Changed - تغییرات

API Calls

  • 🔄 تغییر از POST /api/commodity/mod به POST /v1/products/business/{id}
  • 🔄 تغییر از POST /hooks/modify/person به POST /v1/persons/businesses/{id}/persons/create
  • 🔄 تغییر از POST /api/sell/v2/mod به POST /v1/invoices/business/{id}

Data Format

  • 🔄 name → name_fa, name_en
  • 🔄 priceSell → sell_price
  • 🔄 barcodes → barcode
  • 🔄 NodeFamily → category_id
  • 🔄 Tag → custom_fields
  • 🔄 ContactCode → person_id
  • 🔄 Response format: {Success, Result} → {success, data}

Options

  • 🔄 hesabix_* → hesabix_v2_*
  • 🔄 ساختار options از flat به nested (JSON)

کلاس‌ها

  • 🔄 نام‌گذاری: Hesabix_* → Hesabix_V2_*

❌ Removed - موارد حذف شده

  • ❌ وابستگی به API V1
  • ❌ استفاده از API-KEY header ساده
  • ❌ فیلدهای فارسی در API (shenasemeli, codeeghtesadi, ...)

🐛 Fixed - رفع مشکلات

  • 🐛 مشکل همگام‌سازی همزمان چند محصول
  • 🐛 خطای timeout در bulk operations
  • 🐛 مشکل character encoding در نام‌های فارسی
  • 🐛 مشکل variations بدون SKU

🔒 Security

  • 🔒 تمام ورودی‌ها sanitize می‌شوند
  • 🔒 استفاده از Prepared Statements
  • 🔒 Nonce verification در همه جا
  • 🔒 محافظت از لاگ‌ها

[1.0.4] - قبلی (نسخه قدیمی)

آخرین نسخه V1 قبل از شروع توسعه V2

🔮 Planned - برنامه‌های آینده

[2.1.0] - Q1 2025

  • Webhook Support برای همگام‌سازی دوطرفه
  • Real-time sync با WebSocket
  • پشتیبانی از WooCommerce Subscriptions
  • پشتیبانی از Multi-Currency
  • گزارش‌های پیشرفته
  • Export/Import تنظیمات

[2.2.0] - Q2 2025

  • WP-CLI Commands
  • REST API برای اتصال اپلیکیشن‌های شخص ثالث
  • GraphQL Support
  • Advanced Caching
  • Redis Support

[3.0.0] - Q3 2025

  • بازنویسی کامل با PHP 8.2+
  • استفاده از Composer
  • Unit Tests کامل
  • CI/CD Pipeline
  • Docker Support

🤝 مشارکت

برای مشارکت در توسعه:

  1. Fork کنید
  2. Feature branch ایجاد کنید
  3. Commit های واضح بزنید
  4. Pull Request ارسال کنید

📄 Versioning

این پروژه از Semantic Versioning استفاده می‌کند:

  • MAJOR: تغییرات breaking
  • MINOR: قابلیت‌های جدید backward-compatible
  • PATCH: رفع باگ backward-compatible

تاریخ به‌روزرسانی: 2024-12-05
نگهدارنده: Hesabix Team