ADAMANT Payment v1.0 — منصة موجهة نحو العملات المشفرة للدفع والاشتراكات وإدارة التراخيص

ADAMANT Payment (adamant-payment) هو عنصر بنية تحتية جديد ضمن نظام ADAMANT الإيكوسيستم، ومخصص أيضًا لأي منتج يحتاج إلى نموذج عمل مدمج بالعملات المشفرة دون الحاجة لدمج خدمات متعددة من أطراف خارجية. يحل هذا الحل محل النهج القديم adamant-client-auth من خلال منصة حديثة محايدة بالنسبة للمنتج: تشمل المصادقة، الفوترة، المدفوعات المشفرة، الاشتراكات، إدارة التراخيص، بوابة المستخدم، ولوحة التحكم الإدارية، كلها ضمن حل واحد يمكن استضافته ذاتيًا.

أول هدف للتكامل هو اشتراك واجهة المستخدم الخاصة بـ ADAMANT Tradebot (السيناريو B): يقوم المستخدمون بشراء اشتراك أو تجربة عبر adamant-payment، ويحصلون على رمز ترخيص محدود النطاق، ثم يتصل البوت تلقائيًا بالخادم الوسيط العام للوصول إلى واجهة المستخدم. لا يقتصر هذا النظام على Tradebot فقط — بل تم تصميمه كمنتج مستقل يمكن استخدامه مع البوتات، ومنتجات SaaS، والتطبيقات المكتبية، وخدمات Web3.

العمارة والنقاط القوية الرئيسية

تم بناء النظام منذ البداية لدعم المدفوعات بالعملات المشفرة، وليس كإضافة ثانوية. وهو مناسب بشكل طبيعي للمشاريع في مجال Web3، وبوتات التداول، ومنتجات SaaS، والبرمجيات المباعة لجمهور عالمي. تشمل الدعم الأولي للدفع عملة البيتكوين (عبر BTCPay Server) وعملة ADM (بشكل أصلي، باستخدام عناوين إيداع فريدة ومراقبة السلاسل)، مع مزود تجريبي للتجربة. تضمن الويب هوكس (Webhooks) المُعدة كـ idempotent، وقيم externalId/txid الفريدة، صحة المعاملات — حيث تُصدر التراخيص أو تُمدّد عند تسوية الدفع.

تُجمع المصادقة، الفوترة، المدفوعات المشفرة، الاشتراكات، إدارة التراخيص، بوابة المستخدم، ولوحة التحكم الإدارية في حل واحد، مما يلغي الحاجة إلى دمج عدة خدمات من أطراف خارجية. يمكن للمنصة إصدار التراخيص تلقائيًا بعد الدفع، وإدارة تواريخ الانتهاء، والاشتراكات، والخطط، وحق الوصول إلى المنتج. تتحقق التطبيقات الخارجية من صحة التراخيص عبر واجهة برمجة التطبيقات REST تحت المسار /v1/...، مما يمكن المنتجات من التحقق من حالة الترخيص، وصلاحية الاشتراك، ووصول المستخدم برمجيًا.

يمكن للمستخدمين تسجيل الدخول باستخدام حساب بريد إلكتروني تقليدي، أو عبر المصادقة المشفرة باستخدام محفظة ADM أو ETH (SIWE). وهذا مفيد بشكل خاص لمستخدمي Web3، حيث يمكن للمنصة العمل دون الحاجة إلى هوية تعتمد على البريد الإلكتروني. تدعم الجلسات باستخدام JWT مع ملفات تعريف ارتباط للتحديث (refresh cookies) التطبيقات المستندة إلى المتصفح.

تُطرح الحل مع واجهة للمستخدم ولوحة تحكم إدارية. يدير العملاء المدفوعات، التراخيص، والاشتراكات؛ بينما يدير مالكو المنتجات المستخدمين، الطلبات، الخطط، وحقوق الوصول. تدعم لوحة التحكم الإدارية التحقق الثنائي ADM وETH، وTurnstile captcha، وحظر حسب IP أو البصمة الرقمية (fingerprint)، وتسجيل التدقيق (audit logging). في بيئة الإنتاج، تعمل لوحة التحكم على نطاق منفصل.

adamant-payment لا يرتبط بـ ADAMANT Messenger أو بأي تطبيق معين. يتوفر دعم العلامة البيضاء عبر متغيرات البيئة BRAND_*، ويستخدم نموذج البيانات أسماء منتجات عامة (generic product slugs). على عكس Stripe، Paddle، Lemon Squeezy، أو حلول الترخيص التقليدية، يمكن تكييفه حسب قواعدك الخاصة، وتدفقات الدفع بالعملات المشفرة، ونماذج التسعير، والمنتجات. يتم نشره على البنية التحتية الخاصة بك (PostgreSQL، Node.js) مع تحكم كامل على المستخدمين، منطق الدفع، التراخيص، وبيانات العمل. يُوفر Docker Compose إعدادات Postgres، دون وجود تبعيات إلزامية على خدمات سحابية SaaS.

نطاق الإصدار v1.0

يغطي الإصدار v1.0 التدفق الأساسي للتحصيل: تسجيل المستخدم، الدفع، تسليم الوصول، تجديد الاشتراك، الإدارة، والتكامل مع المنتج. تدعم المصادقة رمز الرسالة عبر ADM، Ethereum (SIWE)، والبريد الإلكتروني مع كلمة المرور. تشمل الفوترة كتالوجًا، وتجربة مدتها 14 يومًا (مرة واحدة لكل زوج وزوج تداول على مستوى العالم)، وتراخيص مدفوعة، ترويجية، ويدوية، مع إعادة تحميل فورية لملف config/ للخطط وأكواد العروض. توفر لوحة التحكم الإدارية إحصائيات، إدارة الحسابات، التراخيص، الفواتير، وعرض محافظ ADM/BTC، مع مصادقة عبر مفتاح API و2FA اختياري. تغطي الترجمة الدولية الإنجليزية والروسية عند الإطلاق، مع دعم قابل للتوسيع للترجمة في packages/shared.

يستخدم تكنولوجيا تعتمد على pnpm مع Turborepo، Fastify 5، Prisma، PostgreSQL، وReact 18 (Vite). يتم تشغيل CI على GitHub Actions ويشمل التثبيت، إنشاء Prisma، البناء، التدقيق (lint)، والتحقق من الأنواع.

متطلبات المنتج والتكامل

الحياد تجاه المنتج هو متطلب أساسي: لا توجد علامات تجارية مدمجة مسبقًا مثل Tradebot أو ADAMANT في قواعد البيانات؛ كل شيء قابل للتكوين حسب التثبيت. نطاق الترخيص هو ترخيص واحد لكل بورصة وزوج، مع تجربة واحدة لكل نطاق على مستوى العالم. تضمن المصادقة متعددة الهوية أن ADM وETH والبريد الإلكتروني تعمل معًا. تتطلب أمان المشغل أن تعمل لوحة التحكم الإدارية على نطاق منفصل في بيئة الإنتاج، مع مفتاح API، 2FA اختياري، captcha، حظر، وسجل تدقيق.

بالنسبة للتكامل ضمن النظام الإيكوسيستم، تقوم خدمة Relay الخاصة بواجهة المستخدم الخاصة بـ Tradebot (السيناريو B) بالتحقق من التراخيص عبر واجهة برمجة تطبيقات adamant-payment، حيث يستخدم البوت نموذج اتصال خارجي. يستهلك API الخاص بـ Tradebot على الفرع refactor/new-webui-api التحقق من الترخيص، وتُوفر واجهة المستخدم الخاصة بـ Tradebot على الفرع refactor/new-stack واجهة المستخدم العامة وخادم الوسيط. يمكن إضافة PaymentProvider جديد (مثلًا، سلاسل إضافية) دون الحاجة لإعادة كتابة النواة الخاصة بالفوترة.

معايير الإصدار

سيتم نشر الإصدار v1.0.0 ووسمه كإصدار على GitHub. يجب أن تكون حالة CI نظيفة على الفرع dev وعلى طلب الدمج (PR) للإصدار إلى الفرع main. تغطي الوثائق المصادقة، الفوترة، المدفوعات، أمان الإدارة، العلامة التجارية، قاعدة البيانات، وإعداد BTCPay. تشمل اختبارات التشغيل (smoke tests) تدفقات المصادقة، المطالبة بالتجربة، عملية الدفع إلى الترخيص، لوحات التحكم، ونقطة التحقق من صحة الترخيص.

خارطة العمل بعد v1

تشمل المهام المخطط لها أتمتة تجديد الاشتراك (يُنشئ BTCPay فواتير فقط؛ بينما يكون منطق التجديد ضمن adamant-payment)، ومزودي دفع إضافيين، وسلاسل جديدة، وتوثيق OpenAPI للواجهة العامة، وتكاملات منتجات طرف ثالث خارج Tradebot.

تتبع الإصدار: Adamant-im/adamant-payment#1.