# Changelog — Lootah Robotics G1 Configurator
> تاريخ التغييرات — 20 أبريل 2026

---

## 2ff21c5 — perf: compress GLBs 75%, add Draco decoder, loading spinner for attire

### المشكلة
- الموبايلات القديمة كانت تعلّق لأوقات طويلة عند تحميل الأزياء الجديدة
- التبديل بين الأزياء (Robot Doctor / Security Guard) كان يعلّق بدون أي مؤشر تحميل

### التغييرات
| الملف | التغيير |
|---|---|
| `public/models/robot-doctor.glb` | ضغط Draco: 32 MB → 8.5 MB (توفير 74%) |
| `public/models/security-guard.glb` | ضغط Draco: 29 MB → 6.85 MB (توفير 77%) |
| `public/draco/` | إضافة ملفات Draco decoder للمتصفح |
| `src/components/RobotModel.tsx` | تفعيل `useGLTF.setDecoderPath('/draco/')` |
| `src/components/RobotCanvas.tsx` | تفعيل Draco decoder + تخفيض DPR من 2x إلى 1.5x |
| `src/components/ScrollScene.tsx` | تفعيل Draco decoder |
| `src/components/ConfigPanel.tsx` | إضافة spinner عند تحميل زي جديد |

### لماذا كانت المشكلة موجودة؟
الملفات كانت مضغوطة بـ Draco لكن المتصفح لم يكن عنده الـ decoder لفك الضغط، فكان يفشل بصمت ويرجع للروبوت الأساسي.

---

## b2a484f — fix: dynamic attire buttons in ScrollOverlays + mobile touch support

### المشكلة
- أزرار الأزياء في صفحة الـ Landing (Kandura, Vest, Suit) كانت مكتوبة بشكل ثابت (hardcoded)
- أي زي جديد يضاف من الأدمن لا يظهر في الصفحة الرئيسية
- الأزرار كانت تعمل بـ hover فقط (لا تعمل على الموبايل بالضغط)

### التغييرات
| الملف | التغيير |
|---|---|
| `src/components/ScrollOverlays.tsx` | جلب الأزياء ديناميكياً من `/api/admin/pricing/` |
| `src/components/ScrollOverlays.tsx` | إضافة `onClick` بجانب `onMouseEnter` لدعم اللمس |
| `src/components/ScrollOverlays.tsx` | إضافة `pointerEvents: 'auto'` لأن الـ overlay كان `pointerEvents: 'none'` |

---

## 320b77b — fix: contacts API - use ADMIN_JWT_SECRET env var

### المشكلة
- صفحة Contacts في الأدمن كانت ترجع خطأ 500

### السبب
- Route الـ contacts كان يستخدم `JWT_SECRET` بينما باقي الـ routes تستخدم `ADMIN_JWT_SECRET`
- أي JWT مولّد بـ `ADMIN_JWT_SECRET` سيفشل التحقق عند استخدام متغير مختلف

### التغييرات
| الملف | التغيير |
|---|---|
| `src/app/api/admin/contacts/route.ts` | استخدام `ADMIN_JWT_SECRET` بدلاً من `JWT_SECRET` |
| `src/app/api/admin/contacts/route.ts` | إضافة رسالة خطأ واضحة إذا كان `ADMIN_JWT_SECRET` غير موجود |

---

## 25ffbf4 — feat: add favicon and app icons for PWA support

### التغييرات
| الملف | التغيير |
|---|---|
| `public/favicon.ico` | أيقونة المتصفح |
| `public/apple-touch-icon.png` | أيقونة iOS Home Screen |
| `public/icon-192.png` | أيقونة PWA 192px |
| `public/icon-192-maskable.png` | أيقونة PWA maskable 192px |
| `public/icon-512.png` | أيقونة PWA 512px |
| `public/icon-512-maskable.png` | أيقونة PWA maskable 512px |
| `src/app/layout.tsx` | إضافة `<link rel="icon">` و `<link rel="apple-touch-icon">` |

---

## e686d41 — fix: use configStore.getState().setPersonaAttire in ScrollOverlays

### المشكلة
- بناء Docker كان يفشل مع خطأ TypeScript:
  ```
  Property 'getState' does not exist on type '<T>(selector: (state: ConfigStore) => T) => T'
  ```

### السبب
كان الكود يستخدم `useConfigStore.getState()` لكن `useConfigStore` هو React hook (دالة عادية) وليس Zustand store. فقط `configStore` المُصدَّر من vanilla Zustand يملك `.getState()`.

بالإضافة لذلك، اسم الدالة كان خاطئاً: `setActivePersonaAttire` بدلاً من `setPersonaAttire`.

### التغييرات
| الملف | التغيير |
|---|---|
| `src/components/ScrollOverlays.tsx` | `useConfigStore.getState().setActivePersonaAttire()` → `configStore.getState().setPersonaAttire()` |

---

## e159965 — feat: add GET endpoint to retrieve contact requests with admin authentication

### التغييرات
| الملف | التغيير |
|---|---|
| `src/app/api/admin/contacts/route.ts` | إضافة GET endpoint لجلب طلبات التواصل مع التحقق من الأدمن |

---

## ملاحظات عامة على البنية

### متغيرات البيئة المطلوبة
```
ADMIN_JWT_SECRET=   # مطلوب لجميع routes الأدمن
DATABASE_URL=       # Prisma / SQLite
STRIPE_SECRET_KEY=  # للمدفوعات
```

### هيكل Stores
| Store | الوصف |
|---|---|
| `configStore` (vanilla Zustand) | الألوان والزي النشط — يدعم `.getState()` |
| `useConfigStore` (React hook) | wrapper لـ `configStore` للاستخدام داخل components |
| `personaStore` (vanilla Zustand) | قائمة الأزياء — تُحمَّل من API عند التهيئة |
| `pricingStore` | أسعار العناصر — تُزامَن مع قاعدة البيانات |

### تدفق الأزياء المرفوعة
1. الأدمن يرفع `.glb` من لوحة التحكم
2. يُضغط تلقائياً بـ Draco عبر `upload-model` route
3. يُحفظ المسار في قاعدة البيانات (`PricingItem.modelPath`)
4. عند تحميل الصفحة، `personaStore.hydrate()` يجلب الأزياء من `/api/admin/pricing/`
5. تظهر تلقائياً في `ConfigPanel` وفي `ScrollOverlays` (الصفحة الرئيسية)