dcorya/CONTEXT.md

Dcorya — AI context

Persian RTL decorative home-goods storefront for dcorya.com (دکوریا). Next.js App Router.

Meshkee API

• Docs: https://api.meshkee.com/docs/website
• OpenAPI: https://api.meshkee.com/docs/website/openapi.json
• Base: https://api.meshkee.com/api/v1
• Tenant domain: dcorya.com (WEBSITE_DOMAIN in src/lib/meshkee.ts)
• Customer portal: https://customer.dcorya.com
• Public reads: /tenants/{domain}/... (no auth). Cart: /businesses/{businessId}/... + Bearer JWT.
• Do not invent CMS, upload, or dashboard APIs.

Stack

• Next.js 16 (App Router) + React 19 + TypeScript + Tailwind CSS v4
• output: "standalone" in next.config.ts (required for Meshkee websites VM deploy)
• Helpers: src/lib/meshkee.ts, static images: src/lib/static-images.ts

Routes

Path	Source
/	Homepage + static image slots + 3 store-special carousels
/products	Product catalog
/products/[id]/[slug]	Product details
/products/category/[id]/[slug]	Category listing
/blog, /blog/[id]/[slug]	Blog
/about, /contact, /cart, /purchaseguide, /satisfaction	Static / form pages
/meshkee/static-image-slots	Slot catalog for the dashboard Refresh button
/meshkee/sitemap-config.json	Sitemap config

Static image slots

Homepage images: GET /tenants/{domain}/website/static-images?pageKey=home.
Catalog: GET /meshkee/static-image-slots → STATIC_IMAGE_SLOTS in src/lib/static-images.ts.

key	kind	itemCount	UI section	aspectRatio
slider	list	null	Hero full-bleed	1920:1100
categories	list	null	ProductCategories icons	1:1
two-banner-below-slider	list	2	BannerRow	2:1
second-categories	list	null	ConsoleCategories	1:1
about-us-image	single	1	AboutDcorya photo	4:3

Rules:

• url → <img src>; linkUrl → wrap in <a> / Link
• Use titleFa → Persian label, titleEn → English subtitle, subtext when the original UI shows them
• Empty/fail → keep current local placeholders under /public/images/
• Use slot.aspectRatio from the API (catalog fallback if missing)
• If a slot’s CSS size or aspect ratio changes during development, update STATIC_IMAGE_SLOTS in the same change — Meshkee reads the catalog as the source of truth

Local fallbacks

• Slider: /images/slide-1.jpg … slide-4.jpg
• Categories: /images/cat-*.png
• Banners: /images/banner-1.png, /images/console-cat-4.jpg
• Second categories: /images/console-cat-*.png|jpg
• About: /images/product-2.jpg

Auth / account menu

• Login / user icon → https://customer.dcorya.com (CUSTOMER_PORTAL_URL)
• Detect session from parent-domain cookies meshkee_customer_access_token / meshkee_customer_refresh_token (storefront only reads; customer dashboard writes)
• Logged in: show {name} عزیز with dropdown پروفایل من, خروج, and if website admin مدیریت وبسایت
• Admin handoff: POST /api/auth/handoff → https://business.dcorya.com?handoff=…
• Admin = super_admin or membership on this business (isOwner / teamRole)
• Favicon: GET /tenants/{domain}/website/favicon → faviconUrl / logoUrl, else /images/logo.png

Shopping cart (mini-cart only)

• Header cart icon + quantity badge + popup (lines, qty, remove, total, ادامه خرید)
• Guest cart key meshkee-guest-cart in localStorage + parent-domain cookie
• Line id = storeItemVariantId; price = discountedPrice ?? price
• Continue → customer.dcorya.com/checkout/cart?guestCart=… (or login redirect when logged out)
• Do not build storefront /cart, checkout, or call /businesses/.../cart

Catalog

• Listings / carousels / search: GET /tenants/{domain}/store-items (not /products list)
• Detail still uses GET /products/by-id/{id} for description/gallery/comments + store-items/by-product/{id} for variants
• Mega menu on محصولات: categories level 1–2. Links: /products/category/{id}/{slug}
• Product card: shared ProductCard (1:1 image, object-cover); no price → تماس بگیرید

Homepage product carousels

GET /tenants/{domain}/store-specials (source mirrors specialProductsSource). Shared card: ProductCard (1:1 image box, object-contain).

key	eyebrow	placement
new-collection	NEW ARRIVALS	After categories
special-sale	SPECIAL SALE	After console categories
our-handmades	HANDCRAFTED	After about (muted bg)

Empty special items → local placeholders (new-collection also tries latest products first). Title comes from the special when set.