Tüm blog yazıları
Mühendislik · Headless Odoo·Midvex Mühendislik··8 dk okuma

Odoo Website’ten Headless Odoo’ya: Varsco için Kendi API Modülümüzü Yazıp Next.js Vitrin Nasıl Kurduk?

Varsco’yu (varsco.com) neden Odoo’nun yerleşik Website modülünden çıkardık, Odoo 19 için varsco_content_api modülünü nasıl yazdık ve Next.js vitrini ile B2B portalını sunucu tarafı BFF proxy arkasında nasıl çalıştırdık?

Odoo 19Headless CommerceNext.jsCustom API AddonB2B Portal
Odoo Website’ten Headless Odoo’ya: Varsco için Kendi API Modülümüzü Yazıp Next.js Vitrin Nasıl Kurduk?

Odoo’nun yerleşik Website modülü Varsco’da neden tıkandı?

Varsco (VARS Su Ürünleri); su ürünleri ithalatı, dağıtım, fiyatlandırma, stok, CRM ve gümrük operasyonlarının tamamını Odoo 19 Enterprise içinde yönetiyor. İlk aşamada mağazayı Odoo’nun kendi Website / eCommerce modülünde tutmak pratik görünüyordu.

Ancak on dilli uluslararası bir ihracat vitrini ve müşteriye özel B2B portalı gerektiğinde üç yapısal sınır ortaya çıktı:

  • Birbirine bağlı hız ve erişilebilirlik: On dilli kataloğu doğrudan QWeb şablonlarından sunmak, sitenin TTFB ve Core Web Vitals performansını ERP sunucu yüküne bağlar.
  • Kayıt sisteminin internete açılması: Halka açık web sitesini aynı Odoo sunucusunda çalıştırmak, tedarikçi fiyatları ve gümrük belgelerini tutan veritabanını doğrudan internete maruz bırakır.
  • Ayrı CMS’e veri kopyalama tuzağı: Ürünleri WordPress veya harici bir CMS’e kopyalamak fiyat, stok ve B2B iskontolar için iki ayrı doğruluk kaynağı yaratır.

Mimari karar: Odoo tek doğruluk kaynağı, Next.js vitrin katmanı

Odoo’yu değiştirmek yerine sunum katmanını tamamen ayırdık. Odoo 19 özel ağda tek kayıt sistemi olarak kalırken, Next.js uygulaması statik/ISR katalog sayfalarını ve sunucu tarafında render edilen B2B portal sayfalarını sunuyor.

Tarayıcı hiçbir zaman doğrudan Odoo ile konuşmaz; her istek sunucu tarafındaki Backend-for-Frontend (BFF) katmanından geçer. Bu kural CORS karmaşasını bitirir, API token’larını sunucuda tutar ve Odoo oturumlarını HttpOnly çerezlerde izole eder.

Kendi Odoo API modülümüz: varsco_content_api

Frontend’e ham XML-RPC veya JSON-RPC açmak kırılgan ve güvensizdir. Bunun yerine Odoo 19 için `/api/v1` sözleşmesi sunan `varsco_content_api` modülünü yazdık:

  • `GET /api/v1/catalog/products`: Çok dilli başlıkları, SEO meta verilerini, kategorileri ve stok durumunu tek bir optimize sorguda döner.
  • `POST /api/v1/leads`: UTM parametreleri, dil ve kaynak sayfa bilgisini doğrudan `crm.lead` alanlarına eşler.
  • `POST /api/v1/auth/login` ve `/portal/*`: Müşteri siparişlerini, teslimat adreslerini ve `midvex_customs_op` gümrük belgelerini oturum bazlı sunar.
  • `POST /api/v1/checkout`: Taslak `sale.order` oluşturur ve `midvex_sale_payment_link` ile Odoo ödeme portalına yönlendirerek frontend’i PCI kapsamı dışında tutar.
Odoo 19 Controller Yapısı (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="tr_TR", 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 ile ISR önbellekleme ve BFF katmanı

Next.js tarafında halka açık katalog sayfaları `revalidate: 300` ve Odoo ürün güncelleme webhook’u ile çalışan isteğe bağlı `/api/revalidate` mekanizmasını kullanır. Kimlik doğrulamalı B2B portal sayfaları ise `no-store` ile her istekte canlı ERP verisini çeker.

Next.js Sunucu Tarafı BFF İsteğitypescript
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();
}

Üretimde ne değişti?

Frontend geliştirme hızı ERP kararlılığından tamamen ayrıştı. Next.js tarafında arayüz, çok dilli SEO ve JSON-LD iyileştirmeleri Odoo modüllerine dokunmadan yayına alınabiliyor; `varsco_content_api` ise yeni projeler için yeniden kullanılabilir bir çekirdek katmana dönüştü.

Temel mühendislik çıkarımları

  • Tarayıcıya ham Odoo XML-RPC/JSON-RPC açmayın; özel bir Odoo modülünde versiyonlu `/api/v1` sözleşmesi tanımlayın.
  • Tüm istekleri Next.js BFF proxy üzerinden geçirerek Odoo’yu halka açık internetten izole edin.
  • Halka açık katalogda ISR + webhook yenileme, B2B portalda ise oturum bazlı SSR kullanın.
  • Ödeme adımını Odoo ödeme linkine devrederek frontend’i PCI kapsamı dışında tutun.

Odoo önüne hızlı bir Next.js vitrin mi kurmak istiyorsunuz?

ERP verinizi kopyalamadan özel Odoo API modülleri, B2B portalları ve headless Next.js mağazalar geliştiriyoruz.