# Faza 4: CRM Ekstenzije za Kupce i B2B Integracija (Isključivo Medusa UI) ## 4.1. Svrha i Ciljevi Faze Za poslovanje sa ugostiteljima (HoReCa sektor - restorani, hoteli, kafići) potrebno je evidentirati specifične B2B podatke: - Naziv pravnog lica / firme - PIB / OIB / PDV broj - Status B2B verifikacije (`pending`, `verified`, `rejected`) - Interne bilješke prodajnog agenta (dogovoreni rabati, kontakt na lokaciji, itd.) Kako se ne bi mijenjale osnovne tabele baze podataka ili pisala custom rješenja, ovi podaci se pohranjuju u standardno Medusino polje `metadata` na entitetu `Customer`. > [!IMPORTANT] > **Strogo pravilo za Admin UI:** Zabranjeno je uvođenje bilo kakvih nestandardnih ili izmišljenih UI komponenti i stilova. Widget se gradi **isključivo** pomoću zvaničnih komponenti iz paketa `@medusajs/ui` (`Container`, `Heading`, `Text`, `Badge`, `Button`, `Input`, `Textarea`, `Select`, `toast`) i `@medusajs/admin-sdk`, prateći zvanične semantičke klase Medusa dizajn sistema (`text-ui-fg-subtle`, `divide-ui-border-base`). --- ## 4.2. Arhitektura Admin SDK Klijenta U Medusa v2 admin ekstenzijama **nikada se ne koristi obični `fetch()`**, jer ne posjeduje administratorske sesijske kolačiće i autorizacijska zaglavlja. Koristi se zvanični `@medusajs/js-sdk`. Kreirajte datoteku `apps/backend/src/admin/lib/client.ts`: ```typescript import Medusa from "@medusajs/js-sdk" export const sdk = new Medusa({ baseUrl: import.meta.env.VITE_BACKEND_URL || "/", debug: import.meta.env.DEV, auth: { type: "session", }, }) ``` --- ## 4.3. Implementacija CRM Widgeta na Stranici Kupca Widget se injektuje u zonu detalja kupca (`customer.details`). Koristi ugrađene Medusa UI komponente i `@tanstack/react-query` za perzistenciju i osvježavanje keša. Kreirajte datoteku `apps/backend/src/admin/widgets/customer-crm-widget.tsx`: ```tsx import { defineWidgetConfig } from "@medusajs/admin-sdk" import { DetailWidgetProps, HttpTypes } from "@medusajs/framework/types" import { Container, Heading, Text, Button, Input, Textarea, Select, Badge, toast, } from "@medusajs/ui" import { useMutation, useQueryClient } from "@tanstack/react-query" import { useState } from "react" import { sdk } from "../lib/client" type CustomerMetadata = { pib?: string company_name?: string verification_status?: "pending" | "verified" | "rejected" agent_notes?: string } const CustomerCrmWidget = ({ data: customer }: DetailWidgetProps) => { const queryClient = useQueryClient() const metadata = (customer.metadata || {}) as CustomerMetadata // Lokalno stanje forme inicijalizovano iz postojećeg metadata objekta const [companyName, setCompanyName] = useState(metadata.company_name || "") const [pib, setPib] = useState(metadata.pib || "") const [status, setStatus] = useState(metadata.verification_status || "pending") const [notes, setNotes] = useState(metadata.agent_notes || "") // Zvanična Medusa SDK mutacija za ažuriranje kupca const updateCustomerMutation = useMutation({ mutationFn: async () => { return await sdk.admin.customer.update(customer.id, { metadata: { ...customer.metadata, company_name: companyName, pib: pib, verification_status: status, agent_notes: notes, }, }) }, onSuccess: () => { // Osvježavanje podataka kupca u dashboardu queryClient.invalidateQueries({ queryKey: ["customer", customer.id] }) toast.success("Uspjeh", { description: "B2B CRM podaci kupca su uspješno ažurirani.", }) }, onError: (err: any) => { toast.error("Greška", { description: err.message || "Došlo je do greške pri ažuriranju podataka.", }) }, }) // Boja bedža u skladu sa Medusa UI statusnim bojama const getBadgeColor = (st: string) => { switch (st) { case "verified": return "green" case "rejected": return "red" default: return "orange" } } return ( {/* Zaglavlje sekcije */}
B2B / CRM Podaci o Kupcu Podaci o pravnom licu, status verifikacije za veleprodajne cijene i interne bilješke agenta.
{status.toUpperCase()}
{/* Forma sa poljima */}
Naziv Pravnog Lica / Firme setCompanyName(e.target.value)} placeholder="Npr. Hotel Dubrovnik d.o.o." />
PIB / OIB / PDV Broj setPib(e.target.value)} placeholder="Npr. 12345678901" />
Status B2B Verifikacije
Interne Bilješke Agenta (CRM)