نظام تسعير شرائح الألمنيوم

نظام لتسعير شرائح الألمنيوم والإكسسوارات والمكائن. يحفظ كل الأسعار في قاعدة بيانات، ويرسل التحديثات إلى أنظمة أخرى عبر Webhooks، ويرتبط بـ WhatsApp Cloud API، وفيه حاسبة يطلب منها العميل عرض سعر.

التشغيل السريع على جهازك (بدون أوامر)

1. ثبّت Node.js (النسخة LTS) من https://nodejs.org، ثم أعد تشغيل الجهاز.
2. نزّل المشروع من GitHub: زر Code الأخضر ← Download ZIP، ثم فك الضغط عن الملف.
3. افتح المجلد وانقر نقرتين على ملف التشغيل المناسب لجهازك:
   • ويندوز: start-windows.bat
   • ماك: start-mac.command. إذا ظهرت رسالة أمان: انقر عليه بالزر الأيمن ← Open ← Open.
4. في المرة الأولى ينتظر دقيقة لتثبيت الحزم، ثم يفتح المتصفح على لوحة الإدارة تلقائياً.
5. كلمة سر لوحة الإدارة تظهر في النافذة السوداء، وتجدها أيضاً في ملف .env داخل المجلد.

اترك النافذة السوداء مفتوحة ما دمت تستخدم النظام، وأغلقها لإيقافه.

• حاسبة العملاء (بدون كلمة مرور): http://localhost:3000
• لوحة الإدارة (بكلمة مرور): http://localhost:3000/admin

المكونات

الجزء	المسار	الوظيفة
لوحة الإدارة	/admin (public/admin.html)	بكلمة مرور: حاسبة التسعير والوزن، المنتجات، أسعار الشراء، بوابات الشتر، الطلبات، الربط
حاسبة بوابة الشتر	/ (public/calculator.html)	يختار العميل المقاس ونوع البوابة والسماكة واللون وفئة كل إكسسوار، ويرى السعر مع التركيب حسب ولايته
طلب مستلزمات	/materials.html	شراء شرائح وإكسسوارات بالكمية
الخادم	src/server.js	واجهة REST (Node.js + Express)
قاعدة البيانات	data/aluminum.db	SQLite مدمجة في Node، لا تحتاج تثبيت خادم قاعدة بيانات
المساعد الذكي	src/agent.js	محادثة واتساب بنموذج Claude، والأسعار من أدوات النظام
ملف PDF	src/pdf.js	عرض سعر عربي بخط Noto Naskh Arabic (رخصة OFL في assets/fonts)

التشغيل

يحتاج Node.js بإصدار 22.13 أو أحدث.

npm install
cp .env.example .env      # ثم عدّل ADMIN_TOKEN
npm start

• حاسبة العملاء: http://localhost:3000
• لوحة الإدارة: http://localhost:3000/admin — كلمة المرور هي قيمة ADMIN_TOKEN في ملف .env.
• الاختبارات: npm test

لو فتحت public/admin.html مباشرة بدون الخادم، ستعمل حاسبة التسعير والوزن كما كانت بالقيم الافتراضية، لكن لن يُحفظ أي شيء.

كيف يُحسب السعر

• الشرائح (طريقة LME): نفس معادلة الحاسبة الأصلية. تكلفة المتر = (LME + المصنعية) ÷ 1000 × الوزن × سعر الصرف، ويضاف الصبغ إذا كانت الشريحة مصبوغة.
• الإكسسوارات والمكائن (طريقة يدوية): التكلفة هي آخر سعر شراء مسجّل.
• سعر البيع = التكلفة × (1 + نسبة الربح). نسبة الربح تؤخذ من المنتج نفسه، أو من الإعدادات إذا تركتها فارغة. ويمكن تحديد سعر بيع ثابت بدلاً من ذلك.
• عرض السعر: المجموع + ضريبة القيمة المضافة (VAT) على المجموع.
• الطلب بالمقاسات: العرض × الارتفاع × عدد الأبواب × 13 = الأمتار الطولية المطلوبة من الشرائح (الرقم 13 قابل للتعديل من الإعدادات).

السماكات في «حاسبة التسعير» و«حاسبة الوزن»: تُعدَّل من بطاقة «السماكات ووزن المتر» في تبويب «حاسبة التسعير».

• لكل سماكة تفاصيل (مثل «شريحة نابكو 1.1 ملم») والسماكة بالملم (اختيارية) ووزن المتر الطولي بالكيلوجرام (مثل 0.63 أو 0.839).
• تُحفظ في قاعدة البيانات، وتظهر في قائمتي الحاسبتين.
• لا تؤثر على أسعار حاسبة العملاء، لأن للعملاء أسعار المتر المربع في تبويب «بوابات الشتر».

ملاحظة: الخادم يعيد حساب السعر دائماً عند استلام الطلب، فلا يستطيع أحد تغيير السعر من المتصفح. أسعار الشراء والتكاليف لا تُرسل أبداً إلى صفحة العملاء.

تسجيل أسعار الشراء

من تبويب أسعار الشراء تسجّل كل فاتورة مورد: المنتج، المورد، الكمية، سعر الوحدة، العملة، سعر الصرف، ومصاريف الشحن والجمارك للوحدة.

• التكلفة النهائية للوحدة بالريال = سعر الوحدة × سعر الصرف + المصاريف الإضافية.
• يتحدث سعر الشراء في بطاقة المنتج تلقائياً (يمكنك إلغاء ذلك)، ويُحفظ التغيير في سجل الأسعار الخاص بالمنتج.

عند أول تشغيل تُضاف منتجات تجريبية: 4 أنواع شرائح، و3 إكسسوارات، ومكينتان. الإكسسوارات والمكائن أسعارها تجريبية ومخفية عن العملاء، فعدّل أسعارها ثم فعّل «يظهر في حاسبة العملاء».

Webhooks

من تبويب الربط تضيف رابطاً (مثلاً من n8n أو Make أو Zapier)، فيستقبل طلب POST بصيغة JSON عند كل حدث من هذه الأحداث:

الحدث	متى يُرسل
quote.created	عميل أرسل طلب عرض سعر
quote.status_changed	غيّرت حالة الطلب (تم التواصل، مقبول...)
product.created / product.updated / product.deleted	إضافة منتج أو تعديله أو حذفه
purchase.created	تسجيل سعر شراء جديد
settings.updated	تغيير LME أو سعر الصرف أو الربح...

إذا وضعت مفتاحاً سرياً، يُرفق مع كل طلب الترويسة X-Aluminum-Signature: sha256=<HMAC> لتتحقق أن الطلب قادم من نظامك.

الأمان:

• إدارة الـ Webhooks للمدير العام فقط. الموظف الذي يملك صلاحية «الربط» لا يراها ولا يغيّرها.
• يُقبل فقط رابط http أو https يشير إلى عنوان عام على الإنترنت. تُرفض العناوين الداخلية مثل localhost و127.0.0.1 و192.168.x.x و10.x.x.x وعنوان بيانات السحابة 169.254.169.254. يُفحص الرابط عند الحفظ، ثم مرة أخرى قبل كل إرسال، لأن النطاق قد يتغيّر لاحقاً.
• لا تُتبع إعادة التوجيه (3xx)، بل تُسجَّل خطأً في سجل الإرسال.
• WEBHOOK_ALLOW_PRIVATE_TARGETS=1 يلغي هذا الفحص، وهو للاختبارات والتطوير المحلي فقط. لا تضعه في الإنتاج، فلوحة الإدارة تُظهر تحذيراً أحمر ما دام مفعّلاً.

مثال: تبني في n8n مساراً يبدأ بـ Webhook ← ثم WhatsApp ← ثم Google Sheets، فيصلك كل طلب عرض سعر على واتساب ويُسجَّل في جدول.

الربط المباشر مع WhatsApp Cloud API

1. أنشئ تطبيقاً في Meta for Developers وأضف إليه منتج WhatsApp.
2. انسخ WHATSAPP_TOKEN و WHATSAPP_PHONE_NUMBER_ID إلى ملف .env.
3. اختر كلمة سر واكتبها في WHATSAPP_VERIFY_TOKEN.
4. انسخ App Secret من إعدادات التطبيق في Meta إلى WHATSAPP_APP_SECRET. هذا إلزامي: بدونه تُرفض كل رسائل Meta الواردة (POST) برمز 401، لأن النظام لا يستطيع التأكد أنها من Meta. يُفحص التوقيع X-Hub-Signature-256 على جسم الطلب كما وصل بالضبط.
5. في لوحة Meta، ضع رابط الـ Webhook https://موقعك/webhooks/whatsapp مع نفس كلمة السر، واشترك في حدث messages. خطوة التحقق (GET) تعمل بكلمة السر وحدها، دون App Secret.

هذا الربط مستقل تماماً عن MazBot: تشغيل MazBot لا يحتاج أي متغير من متغيرات WHATSAPP_*.

بعد ذلك يعمل النظام كالتالي:

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗