dr-asadian/CONTEXT.md

Dr Asadian — AI / Project Context

Persian RTL rebuild of drasadian.com (مطب پوست، مو و زیبایی دکتر محمد اسدیان، قم). Keep this file current — other AI tools and later prompts read it first.

Source of truth

• Live site being cloned: https://www.drasadian.com/
• Prompt: Meshkee basic-clone then backend (/api/v1/public/ai-prompts/dr-asadian/...)
• Backend / Meshkee Website API: https://api.meshkee.com/docs/website
• OpenAPI: https://api.meshkee.com/docs/website/openapi.json
• Apex domain: drasadian.com (no www / api / customer / business)
• Tenant: GET /tenants/drasadian.com → businessId 31
• Enabled modules: products, blog, finance

Stack

• Next.js 15 (App Router) + React 19 + TypeScript
• Tailwind CSS v4 (@import "tailwindcss" in src/app/globals.css) + custom CSS
• Language: fa, direction: rtl
• Fonts (downloaded from Meshkee CDN into public/fonts/):
  • kalameh (Persian UI: thin / regular / bold / black)
  • a-glitch-in-time (English kickers)

Color palette (from live yoga3 theme CSS)

• Primary / headings / body: #17543E
• Theme gold (links, buttons, accents): #D19C1D (hover #E9B948)
• Mint button: #D5E8E0 on #17543E text
• Footer: #195C46 + public/images/footer/footer-bg.jpg
• Page gray: #F2F2F2
• Cards: #F8F8F8
• Doctor band overlay: #1F6C54
• Muted: #A8A8A8

Routes

Route	Purpose
/	Homepage
/services	خدمات ما (original /services) — hair / skin / other
/about	درباره ما (original /aboutus)
/contact	تماس با ما (original /contactus)
/gallery	گالری تصاویر مطب (original /gallery)
/blog	مقالات — Meshkee GET /tenants/{domain}/blogs
/blog/{id}/{titleSlug}	مقاله — GET /tenants/{domain}/blogs/by-id/{id}
/blog/{id}	Redirects to canonical {id}/{titleSlug}

Original also had /hair, /skin, /otherservices — not cloned as separate pages. Category cards on /services use in-page anchors (#hair, #skin, #other). Header: خدمات → /services, گالری → /gallery, مقالات → /blog.

Homepage order

1. Hero slider (2 banners)
2. Visible H1 intro (clinic name + description)
3. Specialized service icons
4. Latest blogs (8 from Meshkee). If the API has no posts yet, the original three cloned teasers are shown and link to /blog
5. Testimonials (microneedling / microderm / e-light)
6. Skin repair + about CTA band

Meshkee auth (customer portal)

• Logged-out user icon → https://customer.drasadian.com (customerPortalUrl in src/lib/config.ts)
• Logged-in: {firstName lastName} عزیز with dropdown:
  • پروفایل من → https://customer.drasadian.com/profile
  • خروج (clears shared tokens)
  • مدیریت وبسایت (admins/owners only) → https://business.drasadian.com via POST /api/auth/handoff
• Session: src/lib/session.tsx + cookies meshkee_customer_access_token / meshkee_customer_refresh_token (shared with customer portal on .drasadian.com)
• Current user: website GET /api/auth/me → Meshkee GET /auth/me
• Header: src/components/AccountMenu.tsx

Blog (Meshkee)

• List: GET /tenants/drasadian.com/blogs?page=&pageSize=
• Detail: GET /tenants/drasadian.com/blogs/by-id/{id} (preferred). Slug route exists but is not used for public URLs.
• Helpers: src/lib/blog.ts (blogHref, blogImage, fetchBlogs, fetchBlogById)
• Canonical URL: /blog/{id}/{titleSlug} — Farsi title slug (spaces → -, keep Persian letters)
• Homepage fetches pageSize=8
• Listing paginates 12 per page
• Do not invent blog copy. Empty API → empty listing + homepage fallback teasers only
• Blog CMS HTML is rendered as mainTextHtml (rich text)

Motion

• Header fades down on load
• Sections use Reveal (src/components/Reveal.tsx) — Intersection Observer, one-shot
• Children with .stagger-child fade up in sequence (--i delay, 130ms steps)
• Slider slides crossfade (1.15s)
• prefers-reduced-motion: reduce disables the above

Inner page title

• PageHero sits in .page-hero-row with a repeating minimal botanical-dot pattern (public/images/patterns/title-pattern.svg)

Original business data (do not invent replacements)

• Phone: 025-32907661
• Hours (contact): شنبه تا پنجشنبه، ۱۷ الی ۲۱
• Address: قم، میدان سپاه (جمهوری)، خیابان شهید اخلاقی، جنب مسجد امام حسن مجتبی، مطب دکترمحمد اسدیان
• Login icon → https://customer.drasadian.com
• Business dashboard → https://business.drasadian.com
• Instagram/Telegram URLs on the live site pointed to / — no public handles cloned
• Map coordinates were empty in site settings; contact page uses a Google Maps embed of the address

Content & assets

• Copy, hours table, testimonials, homepage teaser fallbacks: src/data/site.ts
• Logo: public/images/logo.png (live theme PMlhUjbrcj.png)
• Favicon: public/favicon.png (from logo; live favicon was empty)
• Banners / icons / photos / gallery: public/images/
• Fonts: public/fonts/
• Remote CMS images: meshkee-storage…, cdn.meshkee.com, c804387.parspack.net (see next.config.ts)

Footer Meshkee credit

• Bottom row matches https://safeteb.com/ (site name + framed hover credit)
• Component: src/components/Footer.tsx → .meshkee-credit
• Styles: src/app/globals.css
• Links to https://meshkee.com
• Logo: public/images/footer/MeshkeeLogo-White.png

Important paths

• Layout / shell: src/app/layout.tsx (wraps Providers + session)
• Header: src/components/Header.tsx (split logo, RTL)
• Account menu: src/components/AccountMenu.tsx
• Footer: src/components/Footer.tsx
• Home: src/app/page.tsx, src/components/HeroSlider.tsx
• Blog: src/app/blog/page.tsx, src/app/blog/[id]/[slug]/page.tsx
• Meshkee client: src/lib/meshkee.ts, src/lib/meshkee-server.ts, src/lib/config.ts
• Data: src/data/site.ts

Env

NEXT_PUBLIC_WEBSITE_DOMAIN=drasadian.com
NEXT_PUBLIC_MESHKEE_API_BASE=https://api.meshkee.com/api/v1
# Optional overrides:
# NEXT_PUBLIC_CUSTOMER_PORTAL_URL=https://customer.drasadian.com
# NEXT_PUBLIC_BUSINESS_ORIGIN=https://business.drasadian.com

Commands

npm install
npm run dev
npm run build
npm run generate:sitemap-config

Sitemap + robots

• Do not add public/sitemap.xml or public/robots.txt (nginx proxies to Meshkee API)
• Live sitemap is an index: /sitemap.xml → /sitemap-main.xml + /sitemap-products.xml
• Static pages config: GET /meshkee/sitemap-config.json (generated at build from app routes)
• Generator: scripts/generate-sitemap-config.mjs → src/lib/sitemap-config.generated.json
• Excludes api, meshkee, admin, auth, login, checkout, cart, account
• Blog / product / portfolio 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 — do not add templates unless customized)

• Blog: /blog/{id}/{titleSlug} → GET /tenants/{domain}/blogs/by-id/{id}
• Product: /products/{id}/{nameFaSlug} → GET /tenants/{domain}/products/by-id/{id} (not built yet; catalog empty)
• Category: /products/category/{id}/{nameFaSlug} → GET /tenants/{domain}/categories/by-id/{id}
• Portfolio: /portfolios/{id}/{titleFaSlug} → GET /tenants/{domain}/portfolios/by-id/{id} (not built yet)
• Slugify (src/lib/seo-slug.ts): keep Farsi letters, 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)
• Inner-page titles append | دکتر محمد اسدیان. Homepage title is unique and does not use the Next.js default
• Exactly one visible H1 per page (never .sr-only / CSS-hidden). Homepage H1 is .home-intro
• Section headings default to h2 (SectionHeading). Service cards / article cards use h3 under a section h2
• Prefer CMS title / abstract / image for blog metadata. Fallback teasers only when the API is empty
• Content images have meaningful alt (CMS title when available). Decorative deco.png uses alt=""
• src/app/not-found.tsx: unique title + one H1, noindex
• Favicon: public/favicon.png (tenant favicon API currently returns null)

Gallery

• 12 photos from the live /gallery page in public/images/gallery/01.jpg–12.jpg
• Lightbox: src/components/GalleryGrid.tsx (click to enlarge, arrows / Escape)
• Header گالری → /gallery

Next planned prompts

1. Products / portfolio pages if the clinic starts publishing through Meshkee
2. Image slots if a later prompt provides them