من موقع Odoo إلى Headless Odoo: كتابة وحدة API مخصصة لخدمة متجر Next.js (دراسة حالة Varsco)
لماذا نقلنا Varsco من وحدة Website المدمجة في Odoo، وكيف طوّرنا إضافة varsco_content_api على Odoo 19 لتشغيل متجر Next.js وبوابة B2B خلف خادم BFF.

لماذا واجهت وحدة Website في Odoo حدودًا مع Varsco؟
تدير شركة Varsco عمليات الاستيراد والتوزيع والتسعير والمخزون وCRM والجمارك داخل Odoo 19 Enterprise. ومع التوسع إلى متجر بعشر لغات وبوابة عملاء B2B ظهرت ثلاثة تحديات رئيسية:
- ارتباط سرعة الموقع بأحمال الـ ERP: عرض كتالوج بعشر لغات عبر قوالب QWeb يربط سرعة الصفحات بحمل الخادم الداخلي.
- تعريض قاعدة بيانات الـ ERP للإنترنت العام: تشغيل الواجهة العامة على نفس خادم Odoo يوسّع سطح المخاطر.
- ازدواجية البيانات في أنظمة CMS منفصلة: نسخ المنتجات إلى نظام آخر يخلق مصدرين متضاربين للأسعار والمخزون.
المعمارية: Odoo مصدر الحقيقة، وNext.js طبقة العرض
فصلنا طبقة العرض بالكامل مع بقاء Odoo 19 في الشبكة الخاصة كمصدر وحيد للحقيقة، بينما يتولى Next.js تقديم الكتالوج العام عبر ISR وبوابة B2B عبر SSR.
لا يتصل المتصفح مباشرة بـ Odoo أبدًا؛ تمر جميع الطلبات عبر طبقة Backend-for-Frontend (BFF) على الخادم للحفاظ على رموز API وجلسات HttpOnly بأمان.
بناء إضافة API مخصصة: varsco_content_api
بدل كشف XML-RPC الخام للواجهة الأمامية، أنشأنا إضافة `varsco_content_api` بعقد `/api/v1` موثّق:
- `GET /api/v1/catalog/products`: إرجاع بيانات المنتجات والـ SEO وحالة المخزون في استجابة واحدة محسّنة.
- `POST /api/v1/leads`: ربط طلبات العملاء بمعاملات UTM واللغة مباشرة مع حقول `crm.lead`.
- `POST /api/v1/auth/login` و`/portal/*`: مصادقة بوابة العملاء وعرض الطلبات ووثائق الجمارك (`midvex_customs_op`).
- `POST /api/v1/checkout`: إنشاء مسودة طلب في Odoo وإعادة التوجيه إلى بوابة الدفع دون إدخال الواجهة في نطاق PCI.
class CatalogController(http.Controller):
@http.route("/api/v1/catalog/products", type="http", auth="public", methods=["GET"], csrf=False)
def list_products(self, lang="en_US", page=1, limit=24, **kw):
_verify_bearer_token(request.httprequest.headers.get("Authorization"))
env = request.env(context=dict(request.env.context, lang=lang))
domain = [("website_published", "=", True), ("sale_ok", "=", True)]
products = env["product.template"].sudo().search(domain, limit=int(limit), offset=(int(page) - 1) * int(limit))
return _json_response({"items": [_serialize_product(p) for p in products], "page": int(page)})تقديم واجهة Next.js عبر ISR وطبقة BFF
تستخدم صفحات الكتالوج العامة في Next.js إعادة التحقق التدريجي (`revalidate: 300`) مع Webhook لتحديث الكاش عند تعديل المنتجات في Odoo، بينما تجلب صفحات بوابة B2B البيانات مباشرة لكل طلب.
export async function fetchOdooCatalog(lang: string, page = 1) {
const res = await fetch(
`${process.env.ODOO_INTERNAL_URL}/api/v1/catalog/products?lang=${lang}&page=${page}`,
{
headers: { Authorization: `Bearer ${process.env.ODOO_API_TOKEN}` },
next: { revalidate: 300, tags: ["odoo-catalog"] },
},
);
if (!res.ok) throw new Error(`Odoo API error: ${res.status}`);
return res.json();
}أبرز الدروس الهندسية
- تجنبوا كشف XML-RPC/JSON-RPC الخام للمتصفح؛ ابنوا عقد `/api/v1` في إضافة Odoo مخصصة.
- اعزلوا خادم Odoo خلف طبقة BFF في Next.js لحماية الرموز السرية وجلسات المستخدمين.
- اعتمدوا ISR للكتالوج العام وSSR لكل طلب في بوابات B2B.
هل تريدون بناء واجهة Next.js سريعة فوق Odoo؟
نطوّر إضافات API مخصصة لـ Odoo وبوابات B2B ومتاجر Next.js بدون ازدواجية بيانات الـ ERP.