# ديكورات رويال مكة | Royal Makkah Decor
> **AI Agent Guide** — Premium Saudi interior & exterior design company based in Makkah.
> Fully bilingual (Arabic/English) SPA with SSR-compatible structured data.

## About
Royal Makkah Decor (ديكورات رويال مكة) is a Saudi luxury interior & exterior design platform serving Makkah, Jeddah, Riyadh, and all KSA regions since 2015. We offer 3D design, luxury finishing, custom furniture, and integrated decor execution with a 2-year warranty.

**Key differentiators:** Free site survey, order tracking without login, 15+ years experience, 98% satisfaction rate, 100+ completed projects.

## Core Pages
- [Home](https://decoratroyalmakkah.com/) — Landing page with hero, stats, services overview, featured projects, FAQs, and testimonials
- [Services](https://decoratroyalmakkah.com/services) — All interior/exterior design services with details
- [Exhibition](https://decoratroyalmakkah.com/exhibition) — Portfolio gallery of completed projects by category
- [Projects](https://decoratroyalmakkah.com/projects) — Detailed project showcase with progress phases and photos
- [Store](https://decoratroyalmakkah.com/store) — E-commerce for decor materials and finishing supplies
- [Catalog](https://decoratroyalmakkah.com/catalog) — Material catalog with categories (gypsum, wallpaper, flooring, lighting, curtains, mirrors)
- [Executive Services](https://decoratroyalmakkah.com/executive-services-page) — Installation, execution, and approved contractor listings
- [Blog](https://decoratroyalmakkah.com/blog) — Articles about interior design, trends, and tips
- [FAQ](https://decoratroyalmakkah.com/faq) — Frequently asked questions with structured FAQ schema
- [Contact](https://decoratroyalmakkah.com/contact) — Contact form and company info
- [Track Order](https://decoratroyalmakkah.com/track) — Order tracking by phone or email (no login required)
- [Favorites](https://decoratroyalmakkah.com/favorites) — Saved items (client-side, browser-dependent)
- [About](https://decoratroyalmakkah.com/about) — Company story, vision, and team
- [Privacy](https://decoratroyalmakkah.com/privacy) — Privacy policy
- [Terms](https://decoratroyalmakkah.com/terms) — Terms and conditions

## Structured Data
- **Schema.org LocalBusiness** → https://decoratroyalmakkah.com/local-business.json
- **FAQ Schema** → Inline JSON-LD on /faq page
- **Product Schema** → Inline JSON-LD on /store page
- **Service Schema** → Inline JSON-LD on /services page
- **Article Schema** → Inline JSON-LD on /blog pages
- **BreadcrumbList** → Applied site-wide
- **SiteNavigationElement** → Applied site-wide

## API Endpoints (Public)
All public API endpoints return JSON. Base: `https://decoratroyalmakkah.com/api`

### Home & Stats
- `GET /api/home/stats` — Company stats (projects count, markets, years, satisfaction rate, etc.)

### Services
- `GET /api/services` — All design services with multilingual names, descriptions, slugs, SEO metadata

### Service Areas
- `GET /api/maps/service-areas` — Cities and regions where service is available
- `POST /api/maps/check-coverage` — Check coverage by city name `{ "city": "..." }`

### Projects
- `GET /api/maps/projects` — All projects with details, images, location, progress phases
- `GET /api/maps/projects?city=...` — Filter by city

### Exhibition / Showcase
- `GET /api/showcases` — Portfolio gallery items
- `GET /api/showcases?category=...` — Filter by category

### Store
- `GET /api/store/products` — All products with multilingual names, descriptions, prices, images
- `GET /api/products` — Alias for /api/store/products

### Executive Services
- `GET /api/executive-services` — Installation/execution services
- `GET /api/executive-executors` — Approved contractors/executors
- `GET /api/executive-ratings` — Ratings for executive services

### Blog
- `GET /api/articles` — All blog articles
- `GET /api/articles/:slug` — Single article by slug

### Contact
- `POST /api/contact` — Submit contact form `{ "name", "phone", "email", "city", "service", "message" }` (rate limited)

### Service Requests
- `POST /api/service-requests` — Create new service request
- `GET /api/service-requests/track?contact=...` — Track request by phone or email (public)

### FAQs
- `GET /api/faqs` — All FAQs with multilingual Q&A pairs

### Ratings
- `GET /api/ratings` — Public customer ratings (approved only)
- `POST /api/ratings` — Submit a rating (public)

### Social Media
- `GET /api/social-media` — Social media links and handles

### Settings
- `GET /api/settings` — Site-wide settings
- `GET /api/settings/:category` — Settings by category

### Branches & Maps
- `GET /api/maps/branches` — Company branches with locations

## Sitemaps
- HTML Sitemap: https://decoratroyalmakkah.com/sitemap.xml
- Google News Sitemap: Not applicable (non-news site)

## Contact
- **Phone:** +966502647742
- **WhatsApp:** https://wa.me/966502647742
- **Email:** info@decoratroyalmakkah.com
- **Address:** Makkah Al-Mukarramah, Saudi Arabia
- **Developer:** WhatsApp +967774932684

## Technical Notes (for AI agents)
- **Framework:** Vite + Preact (React-compatible) SPA with React Router for client routing
- **Backend:** Node.js + Express + MySQL (Sequelize ORM)
- **Language:** Arabic (primary, RTL), English (alternate via `?lang=en`)
- **Auth:** JWT in localStorage for admin panel at /panel (not crawlable)
- **Caching:** Hostinger CDN caches static assets for 24h. Cache bust via `?v=N`
- **Images:** Cloudinary and Unsplash, served as WebP with responsive srcset
- **Real-time:** Socket.IO for live notifications on admin panel
- **Recommended crawl rate:** 1 request per second max to avoid rate limiting (30 req/15min on public form endpoints)

## Optional (requires browser/JS)
- `/favorites` — Client-side favorites using localStorage
- `/track` — Order tracking (fetch call required)
- `/panel` — Admin SPA (authenticated, noindex)