# Alma Beauti — AI / Project Context

Persian RTL rebuild of **almabeauti.com** (کلینیک تخصصی پوست و زیبایی آلما بیوتی، قم). Keep this file current — other AI tools and later prompts read it first.

## Source of truth
- Live site being cloned: https://www.almabeauti.com/
- Prompt instructions: `Ai-data/prompt.txt`
- Backend / Meshkee Website API: https://api.meshkee.com/docs/website
- Static image slots prompt (later): `Ai-data/prompt-images-slot.txt`
- SEO prompt: `Ai-data/prompt-seo.txt`
- Domain: `almabeauti.com`

## 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/`):
  - `yekan-bakh` (default Persian UI) — Light + Regular
  - `montserrat` (English kickers)

## Color palette (from live site CSS vars)
- Primary: `#594AB8` (`--wb-primary-color`)
- Secondary: `#7936FA` (`--wb-secondary-color`)
- Page gray: `#F8F8F8`
- Muted: `#6F6F6F` / `#ACACAC`
- Navbar pill: `#E5E5E5`

## Routes
| Route | Purpose |
|-------|---------|
| `/` | Homepage |
| `/about` | درباره ما (original `/aboutus`) |
| `/contact` | تماس با ما (original `/contactus`) |
| `/services` | خدمات — all 9 services as in-page sections with anchors |
| `/blog` | مقالات (Meshkee blogs API) |
| `/blog/{id}/{titleSlug}` | جزئیات مقاله |
| `/blog/{id}` | Legacy redirect → canonical |

Individual service detail URLs (`/facial`, `/carboxytherapy`, …) still deferred — nav dropdown links to `/services#{slug}`.

## Meshkee API integration
Base: `{NEXT_PUBLIC_MESHKEE_API_BASE}/tenants/{domain}/...`  
Helpers: `src/lib/meshkee.ts` → `meshkeeGet`, `tenantPath`, `getTenant`, `getBusinessId`  
Tenant: `almabeauti.com` (id `30`, modules: `products`, `blog`, `finance`)

### Blog
- List: `GET /blogs?page=&pageSize=`
- Detail: `GET /blogs/by-id/{id}` (canonical URL `/blog/{id}/{titleSlug}`)
- Legacy redirect: `/blog/{id-or-slug}` → canonical
- Comments: `GET /comments?entityType=blog&entityId={id}`
- Lib: `src/lib/blog.ts`
- Homepage preview: `src/components/ArticlesPreview.tsx` (3 latest posts)
- Title images may be on `c804387.parspack.net` (allowed in `next.config.ts`)
- If API is empty, fall back to static `articles` in `src/data/site.ts`

### Auth / customer portal
- Login icon → `https://customer.almabeauti.com` (`customerPortalUrl` in `src/lib/config.ts`)
- Admin dashboard: `https://business.almabeauti.com`
- Session: `src/lib/session.tsx` + shared cookies (`src/lib/shared-auth-cookie.ts`)
- Shared cookies: `meshkee_customer_access_token` / `meshkee_customer_refresh_token` (storefront + customer portal)
- Profile API proxy: `GET /api/auth/me` → Meshkee `/auth/me`
- Admin handoff: `POST /api/auth/handoff` → Meshkee `/auth/handoff` → `https://business.almabeauti.com`
- Logged-in header: `{name} عزیز`; dropdown: پروفایل من، خروج، مدیریت وبسایت (admins only)
- Component: `src/components/AccountMenu.tsx`

### Favicon
- API: `GET /tenants/{domain}/website/favicon`
- Helper: `src/lib/branding.ts` → `getWebsiteBranding`, `resolveFavicon`
- Current tenant has no dedicated favicon (`hasDedicatedFavicon: false`) → fallback `/favicon.png`

## Original business data (do not invent replacements)
- Phone: `09355036991` (footer `tel:` also used `09195196326` on the old site; display number is `09355036991`)
- Hours: شنبه تا پنجشنبه، ۴ بعد از ظهر تا ۸:۳۰ شب
- Address: بلوار شهید اخلاقی، بین بیست متری گلستان و بلوار شهید مفتح (محله‌ی بکایی)، پلاک ۵
- Instagram: https://www.instagram.com/alma.skincares/
- Telegram: https://t.me/almaskincares
- Map embed: Google Maps iframe in `src/data/site.ts`

## Homepage order
Hero slider → About → Price packages → Services grid (6) → Purple banner → Why Alma → Testimonials → Articles (Meshkee, local fallback) → Contact/map

## Content & assets
- Copy, services, FAQs, phones, address, socials: `src/data/site.ts`
- Logo: `public/images/logo.png` (from live theme)
- Favicon: `public/favicon.png`
- Banners / icons / service photos: `public/images/`
- Fonts: `public/fonts/`

## Footer Meshkee credit
- Bottom row matches https://meshkee.com/ (light bar, framed hover, “Designed And Developed By / Meshkee E-Commerce Team”)
- Component: `src/components/Footer.tsx` → `.meshkee-credit`
- Styles: `src/app/globals.css`
- Links to `https://meshkee.com`
- Logo: `public/images/footer/MeshkeeLogo.png`

## Important paths
- Layout / shell: `src/app/layout.tsx`, `src/components/Providers.tsx`
- Header + account: `src/components/Header.tsx`, `src/components/AccountMenu.tsx`
- Footer: `src/components/Footer.tsx`
- Home: `src/app/page.tsx`, `src/components/HeroSlider.tsx`, `src/components/AboutSection.tsx`
- Hero + About share `container-fluid` (5rem inset ≥992px). About matches the live overlapping layout: vertical purple strip aligned with the slide counter, image overflowing into a white card, dotted grid on the left.
- Blog: `src/app/blog/`, `src/components/ArticlesPreview.tsx`, `src/components/EntityTabs.tsx`
- Config: `src/lib/config.ts`
- Data: `src/data/site.ts`

## Env
```bash
NEXT_PUBLIC_WEBSITE_DOMAIN=almabeauti.com
NEXT_PUBLIC_MESHKEE_API_BASE=https://api.meshkee.com/api/v1
# Optional overrides:
# NEXT_PUBLIC_CUSTOMER_PORTAL_URL=https://customer.almabeauti.com
# NEXT_PUBLIC_BUSINESS_ORIGIN=https://business.almabeauti.com
```

## Commands
```bash
npm install
npm run dev
npm run build
npm run generate:sitemap-config
```

## SEO canonical URLs
- Blog: `/blog/{id}/{titleSlug}` → `GET /blogs/by-id/{id}`
- Slugify helper: `src/lib/seo-slug.ts` (Farsi letters kept, spaces → `-`, punctuation stripped; do not use legacy DB slug in public URLs)
- Page metadata helper: `src/lib/seo.ts` → `pageMetadata()` (absolute title, description, canonical, Open Graph, Twitter)
- Exactly one `<h1>` per page (homepage: visually hidden brand in hero; inner pages: `PageHero`)
- Content images use meaningful `alt` (CMS title when available)

## Sitemap + robots
- **Do not** add `public/sitemap.xml` or `public/robots.txt` (nginx proxies to Meshkee API)
- Live sitemap index: `/sitemap.xml` → `/sitemap-main.xml` + CMS URLs
- Static pages config: `GET /meshkee/sitemap-config.json`
- Generated at build: `scripts/generate-sitemap-config.mjs` → `src/lib/sitemap-config.generated.json`
- Run manually: `npm run generate:sitemap-config`
- After deploy: business dashboard → Website → Settings → Sync sitemap config

## Next planned prompts
1. Wire static image slots (`Ai-data/prompt-images-slot.txt`)