Alireza HassaniandCursor
e2468a1ba1
Pull landline, cell, and address from Meshkee business-info across footer and contact surfaces, update brand spelling and 14-year messaging, and keep product cards free of placeholder call-to-action pricing. Co-authored-by: Cursor <cursoragent@cursor.com>
71 lines
3.7 KiB
Markdown
71 lines
3.7 KiB
Markdown
@AGENTS.md
|
|
|
|
# Arad Arisman — Meshkee backend integration
|
|
|
|
This site is a Next.js storefront for **aradarisman.com**, backed by the
|
|
Meshkee Website API (`https://api.meshkee.com/api/v1`, docs at
|
|
`https://api.meshkee.com/docs/website`). All backend access goes through
|
|
`src/lib/meshkee.ts` — do not call the API directly from components/pages.
|
|
|
|
- Products (`getProducts`, `getProduct`) and blog posts (`getPosts`,
|
|
`getPost`) are fetched live, tenant-scoped to `TENANT_DOMAIN`
|
|
(`aradarisman.com`). Blog field names (`Post` type) are **inferred** from
|
|
the Product/Category naming convention since no tenant has published
|
|
posts to verify against yet — accessors fall back across plausible field
|
|
names (`postTitle`, `postContent`, etc.). Re-check against a real
|
|
published post once one exists and simplify the fallbacks if the guess
|
|
was wrong.
|
|
- Category tiles are derived from live products (`getCategorySummary`), not
|
|
the raw `/categories` endpoint — that taxonomy has duplicate entries
|
|
sharing the same display name under different ids (backend data-entry
|
|
artifact). The summary merges by name and links to whichever id holds
|
|
the most products under that name.
|
|
- Business contact data (`getBusinessInfo` /
|
|
`getResolvedBusinessContact`) comes from
|
|
`GET /tenants/{domain}/website/business-info` — landline/cell
|
|
(`phoneNumbers`), addresses, emails, social. Footer, contact page,
|
|
and `HomeContactStrip` consume the resolved helper. Empty/failed
|
|
fetches keep the previous hardcoded address and phone fallbacks.
|
|
|
|
## Static image slots (business-managed overrides)
|
|
|
|
`getStaticImageSlots` / `getStaticImageSlot(key)` read
|
|
`/tenants/{domain}/website/static-images` — named slots the business owner
|
|
can fill with their own images from the Meshkee dashboard. Current mapping:
|
|
|
|
| Slot key | Kind | Component | Fallback when empty/unset |
|
|
|-------------------|--------|--------------------|----------------------------------------|
|
|
| `hero-category-icons` | list (duplicatable) | `HeroSlider` boxes | SVG icons + top-level category names |
|
|
| `categories` | list | `CategoryShowcase` | photo cards derived from live product categories |
|
|
| `four-icon-image` | list(4)| `Features` | 4 local icons + authored copy, per-index override |
|
|
| `about-us` | single | `About` | local `hero-2.jpg` |
|
|
| `brands` | list | `Partners` | 6 local partner logos |
|
|
|
|
**Rule: a slot with zero images (or a failed fetch) must never break the
|
|
page — always fall back to the existing local/derived content.**
|
|
`getStaticImageSlots` already swallows fetch errors and returns `[]`.
|
|
|
|
Each `StaticImageItem` carries `url`, optional `titleFa`/`subtext`/
|
|
`linkUrl`, and its own `width`/`height`. Respect `slot.aspectRatio`
|
|
(`"21:9"` etc, via `aspectRatioToCss`) for slot-driven image containers
|
|
instead of hardcoding a Tailwind aspect class — if you resize/recrop a
|
|
*local* fallback image during development, update the corresponding
|
|
component's fallback styling **and** the catalog entry in
|
|
`src/app/meshkee/static-image-slots/route.ts` to match, since slot-driven
|
|
and fallback images render through the same container and must not look
|
|
broken when swapped.
|
|
|
|
### Dashboard catalog (required for Refresh)
|
|
|
|
The Meshkee dashboard **Refresh** button does not invent slots. It imports
|
|
keys from this site:
|
|
|
|
`GET https://aradarisman.com/meshkee/static-image-slots`
|
|
|
|
That route is `src/app/meshkee/static-image-slots/route.ts`. Until it is
|
|
deployed and the dashboard Refresh is clicked, `/tenants/aradarisman.com/website/static-images`
|
|
returns `{ items: [] }` and the storefront correctly shows fallbacks.
|
|
|
|
Do not invent upload/CMS APIs. Owners add images in the Meshkee dashboard
|
|
after Refresh has imported the catalog.
|