أكدلي Akadli-AI

البدء السريع للمطورين ولوكلاء الذكاء الاصطناعي

للمطورين البرمجيين

1. تثبيت الحزم الأساسية ومحول المتجر

pnpm add @akadli/core @akadli/dz-geo @akadli/provider-shopify

2. استقبال الطلب، إطلاق المكالمة الصوتية وتحديث المتجر

import { ShopifyProvider } from "@akadli/provider-shopify";
import { handleFinalizeOrderToolCall, buildElevenAgentsDynamicVariables } from "@akadli/core";

const provider = new ShopifyProvider();

// 1. التحقق من توقيع Webhook وتحليل بيانات الطلبية وفق تقسيم الـ 69 ولاية
const isValid = await provider.verifyWebhook(headers, rawBody, process.env.SHOPIFY_WEBHOOK_SECRET!);
const order = await provider.parseWebhookOrder(JSON.parse(rawBody));

// 2. بناء المتغيرات الديناميكية للمكالمة الصوتية بالدارجة (currentVariant، الولاية، الهاتف)
const promptVars = buildElevenAgentsDynamicVariables(order);

// 3. استقبال قرار العميل من أداة ElevenLabs وتحديث بيانات المتجر فوراً
const result = await handleFinalizeOrderToolCall(
  {
    orderId: order.orderId,
    status: "CONFIRMED", // أو "MODIFIED" لتعديل المقاس أو البلدية أو "REFUSED"
    reasonOrNotes: "تم تأكيد الطلبية بالدارجة عبر مكالمة ElevenAgents الصوتية"
  },
  provider,
  { shopDomain: process.env.SHOPIFY_SHOP_DOMAIN!, accessToken: process.env.SHOPIFY_ACCESS_TOKEN! },
  order.constraints
);

لوكلاء الذكاء الاصطناعي (AI Coding Agents)

ملفات السياق الفوري للوكلاء

زوّد وكيل البرمجة بالذكاء الاصطناعي (Cursor, Antigravity, Claude Code, GitHub Copilot) بكامل سياق المشروع بضغطة واحدة:

• الملخص الهندسي: https://akadli.me/llms.txt
• السياق البرمجي الكامل والشامل: https://akadli.me/llms-full.txt

نص التوجيه المباشر (Prompt) للوكيل

انسخ هذا التوجيه مباشرة داخل بيئة وكيل الذكاء الاصطناعي لديك:

أنت تقوم بربط محرك تأكيد طلبيات الدفع عند الاستلام بالجزائر Akadli-AI.
احصل على السياق الكامل من https://akadli.me/llms-full.txt والتزم بالمعايير التالية:
1. استخدام @akadli/adapter-contract لنموذج StandardizedDzOrder و FinalizedOrderDecision.
2. مطابقة العناوين حصرياً مع التقسيم الإداري 2026 (69 ولاية) باستخدام @akadli/dz-geo.
3. استخدام @akadli/core لبناء متغيرات ElevenAgents وتشغيل handleFinalizeOrderToolCall.
4. وسوم المتجر يجب أن تكون حصرياً: akadli-confirmed و akadli-modified و akadli-refused و akadli-variant-{variant}.
5. يجب أن تبدأ ملاحظات الطلب ببادئة [Akadli-AI].
6. لا تخترع حالات جديدة، بل استخدم فقط CONFIRMED أو REFUSED أو MODIFIED.

---

المزايا المعمارية الرئيسية

التقسيم الإداري 2026 (69 ولاية و 1708 بلدية)

قاعدة بيانات رسمية كاملة مع دعم البحث الذكي غير الدقيق بالعربية والفرنسية والعربيزي. تشمل الولايات المستحدثة (من 59 إلى 69 مثل بريكة وبوسعادة وبئر العاتر ومسعد).

إدارة المكالمات الصوتية بـ ElevenAgents

جسر صوتي بدون حالة (Stateless) عبر WebRTC و SIP. يولد متغيرات التعليمات بالدارجة الجزائرية بدقة ويتحقق برمجياً من قرارات العميل عبر دوال الخادم.

محولات جاهزة لمنصات التجارة الإلكترونية

تكامل مباشر مع Shopify و YouCan و WooCommerce و Google Sheets ومتاجر SetShop و JustSell ونظام إدارة طلبيات COD الجزائري Tassyir.

بيئة تجارب محلية عبر Wi-Fi (@akadli/playground)

منصة اختبار تفاعلية متكاملة تشمل لوحة تحكم مكتبية للمدير (/admin) وهاتف افتراضي تفاعلي (/phone) للاختبار المباشر بالهاتف عبر الشبكة المحلية.

---

الحزم والوحدات البرمجية

الوحدة	الحزمة	الوصف	الدليل
العقود البرمجية	@akadli/adapter-contract	نماذج البيانات القياسية ومخططات Zod وواجهة المحولات	التفاصيل
الجغرافيا والهاتف	@akadli/dz-geo	التقسيم الإداري 2026 (69 ولاية و 1708 بلدية) وتطبيع هواتف 213+	التفاصيل
المحرك الصوتي	@akadli/core	متغيرات الموجهات وتنسيق قرارات المكالمات الصوتية	التفاصيل
Shopify	@akadli/provider-shopify	التحقق المشفر، معالجة الولاية وتحديثات الطلبات	الدليل
YouCan	@akadli/provider-youcan	استخراج حقول الشراء بصفحة واحدة وتحديث الحالات	الدليل
WooCommerce	@akadli/provider-woocommerce	واجهة REST v3 وتطبيع رموز DZ-XX وإضافات الدفع	الدليل
Google Sheets	@akadli/provider-gsheets	جسر الربط لصفحات الهبوط وجداول Google Sheets	الدليل
Tassyir ERP	@akadli/provider-tassyir	واجهة تسيير (2026-10) وتوقيعات Ed25519 ومسار OAuth	الدليل