MIDVEX
همه مقالات وبلاگ
مهندسی · اودو بدون سر (Headless)·تیم مهندسی Midvex··8 دقیقه مطالعه

از وب‌سایت اودو تا Headless Odoo: نوشتن ماژول API اختصاصی برای فروشگاه Next.js در پروژه Varsco

چرا وب‌سایت Varsco را از ماژول داخلی Website اودو جدا کردیم، چگونه ماژول varsco_content_api را برای اودو ۱۹ نوشتیم و چطور ویترین Next.js و پورتال B2B را پشت یک لایه امن BFF اجرا کردیم.

Odoo 19Headless CommerceNext.jsCustom API AddonB2B Portal
از وب‌سایت اودو تا Headless Odoo: نوشتن ماژول API اختصاصی برای فروشگاه Next.js در پروژه Varsco

چرا ماژول داخلی Website اودو در Varsco به بن‌بست رسید؟

شرکت Varsco تمامی عملیات واردات، توزیع، قیمت‌گذاری، موجودی، CRM و اسناد گمرکی خود را در Odoo 19 Enterprise مدیریت می‌کند. در ابتدا استفاده از ماژول داخلی وب‌سایت اودو ساده به نظر می‌رسید، اما با نیاز به ویترین ۱۰ زبانه و پورتال B2B سه محدودیت جدی ظاهر شد:

  • وابستگی سرعت سایت به بار پردازشی ERP: رندر کاتالوگ ۱۰ زبانه با قالب‌های QWeb باعث می‌شود سرعت وب‌سایت مستقیماً تحت تأثیر پردازش‌های سنگین انبار و حسابداری قرار بگیرد.
  • قرار گرفتن دیتابیس حیاتی ERP در معرض اینترنت عمومی: اجرای وب‌سایت عمومی روی همان سرور اودو سطح حمله را افزایش می‌دهد.
  • تکرار داده در CMS جداگانه: همگام‌سازی محصولات با یک سیستم دیگر دو منبع حقیقت برای قیمت و موجودی ایجاد می‌کند.

معماری انتخابی: اودو منبع حقیقت، Next.js لایه نمایش

به‌جای جایگزینی اودو، لایه نمایش را جدا کردیم. اودو ۱۹ در شبکه خصوصی باقی می‌ماند و اپلیکیشن Next.js صفحات عمومی کاتالوگ را با ISR و پورتال B2B را به‌صورت Server-Side رندر می‌کند.

مرورگر هرگز مستقیماً با اودو ارتباط نمی‌گیرد؛ تمام درخواست‌ها از طریق لایه Backend-for-Frontend (BFF) عبور می‌کنند و کوکی‌های نشست به‌صورت HttpOnly نگهداری می‌شوند.

ماژول API اختصاصی: varsco_content_api

به‌جای باز کردن XML-RPC خام به سمت فرانت‌اند، ماژول `varsco_content_api` را با قرارداد `/api/v1` نوشتیم:

  • `GET /api/v1/catalog/products`: بازگرداندن اطلاعات محصول، متادیتای سئو و وضعیت موجودی در یک پاسخ بهینه.
  • `POST /api/v1/leads`: ثبت سرنخ‌ها با پارامترهای UTM و زبان صفحه روی فیلدهای واقعی `crm.lead`.
  • `POST /api/v1/auth/login` و `/portal/*`: احراز هویت پورتال و نمایش سفارش‌ها و اسناد گمرکی (`midvex_customs_op`).
  • `POST /api/v1/checkout`: ساخت پیش‌نویس سفارش و هدایت به درگاه پرداخت اودو بدون درگیر کردن فرانت‌اند با محدوده PCI.
نمونه کنترلر اودو ۱۹ (varsco_content_api)python
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` و وب‌هوک `/api/revalidate` کش می‌شوند و صفحات پورتال B2B با `no-store` به‌صورت لحظه‌ای از اودو خوانده می‌شوند.

درخواست سمت سرور در Next.jstypescript
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 اختصاصی با قرارداد `/api/v1` بنویسید.
  • اودو را پشت لایه BFF در Next.js نگه دارید تا توکن‌ها و شبکه داخلی ERP محافظت شوند.
  • برای کاتالوگ عمومی از ISR و وب‌هوک بازسازی کش، و برای پورتال B2B از SSR لحظه‌ای استفاده کنید.

می‌خواهید یک فروشگاه سریع Next.js روی اودو بسازید؟

ما ماژول‌های API اختصاصی اودو، پورتال B2B و ویترین‌های Headless Next.js را بدون تکرار داده پیاده‌سازی می‌کنیم.