sohan-salehnia/CONTEXT.md

Sohan Salehnia Website Context

Project

• Persian RTL storefront clone of sohansalehnia.com (سوهان صالح نیا).
• Next.js 16 App Router, React 19, TypeScript, Tailwind 4, src/app.
• Language: fa, direction: rtl.
• Local images: public/images. Fonts: public/fonts.

Meshkee API

• Docs: https://api.meshkee.com/docs/website
• API base: https://api.meshkee.com/api/v1
• Tenant domain: sohansalehnia.com (TENANT_DOMAIN in src/lib/meshkee.ts, src/lib/config.ts)
• All public fetches go through src/lib/meshkee.ts. Authenticated calls go through src/app/api/* + src/lib/meshkee-server.ts.
• Tenant id is 32 (Salehnia Sohan / salehnia-sohan). Enabled modules: products, blog, finance.

Auth / account

• Guest login/user icon → https://customer.sohansalehnia.com
• Logged-in header shows {name} عزیز with dropdown: پروفایل من, خروج, and مدیریت وبسایت if admin.
• Profile: https://customer.sohansalehnia.com/profile
• Admin dashboard: https://business.sohansalehnia.com via /api/auth/handoff
• Session: src/lib/session.tsx + shared cookies in src/lib/shared-auth-cookie.ts
• Favicon: GET /tenants/sohansalehnia.com/website/favicon. If faviconUrl is empty, fall back to /images/logo.png.

Routes

Path	Source
/	static homepage clone
/aboutus	static about
/contactus	static contact (form still local)
/products	GET /tenants/{domain}/products
/products/[id]/[slug]	product by id + technical-info + comments + similar
/articles	GET /tenants/{domain}/blogs
/articles/[id]/[slug]	blog by id + comments

Product detail: lightbox gallery, hover zoom, tabs (توضیحات / اطلاعات فنی / دیدگاه‌ها). Comments require login; guests see a login box.

SEO + sitemap

• Do not add public/sitemap.xml or public/robots.txt (nginx proxies both to Meshkee API).
• Live sitemap is an index: /sitemap.xml → /sitemap-main.xml + /sitemap-products.xml.
• Static pages: GET /meshkee/sitemap-config.json (generated at build from app routes).
• Generator: scripts/generate-sitemap-config.mjs → src/lib/sitemap-config.generated.json
• Run manually: npm run generate:sitemap-config
• Excludes api, meshkee, admin, auth, login, checkout, cart, account
• Blog / product details are not listed in sitemap-config (Meshkee XML covers CMS URLs)
• After deploy: business dashboard → Website → Settings → Sync sitemap config (needed for static pages)

Canonical URL shapes

Meshkee defaults — omit templates unless customized. This site customizes blog to /articles:

• Product: /products/{id}/{nameFaSlug} → GET /tenants/{domain}/products/by-id/{id}
• Category: /products/category/{id}/{nameFaSlug} (not built; catalog empty)
• Blog: /articles/{id}/{titleSlug} → GET /tenants/{domain}/blogs/by-id/{id} (templates.blog in sitemap-config)
• Portfolio: not built
• Slugify (src/lib/slugify.ts): Farsi letters kept, spaces → -, strip other punctuation. Do not use legacy DB slug in public URLs.

On-page SEO

• Helper: src/lib/seo.ts (pageMetadata, unique absolute <title>, clipped meta description ~158 chars, canonical, OG)
• Homepage title is unique (سوهان صالح نیا | تولید و عرضه سوهان سنتی قم) and does not rely on the Next.js default
• Exactly one visible H1 per page (PageHeader wraps kicker + gold title; homepage H1 is the product-types row). Do not use sr-only H1.
• H2/H3 for real sections (feature block, why-us, similar/related, comments)
• Prefer CMS nameFa / title / summary / descriptionHtml for product and article metadata
• Content images have meaningful alt (CMS title when available). Decorative pattern uses alt=""
• src/app/not-found.tsx: unique title + one H1, noindex

Brand

Token	Value
Primary	#706C01
Gold	#868215
Page	#F9F9F9
Heading	#4B4B4B
Muted	#5E5E5E

Notes

• Products and blogs may be empty until published in Meshkee.
• Do not invent Meshkee endpoints. Product specs use .../products/by-id/{id}/technical-info (join form.fields[].id ↔ values[].fieldId).
• Keep CONTEXT.md updated when routes, brand tokens, or data sources change.