Alireza HassaniandCursor
9e2dc2c61d
Connect homepage slots and specials, switch catalog to store-items, add the customer-portal mini-cart and account menu, and publish the static-image slot catalog. Co-authored-by: Cursor <cursoragent@cursor.com>
97 lines
4.7 KiB
Markdown
97 lines
4.7 KiB
Markdown
# 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.
|