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

چرا ماژول داخلی 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.
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` بهصورت لحظهای از اودو خوانده میشوند.
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 را بدون تکرار داده پیادهسازی میکنیم.