══════════════════════════════════════════════════════════════════
الحزمة الكاملة — مركز سليمان للصيانة والتكنولوجيا
نسخة الموقع الحية: v12.60 (أول 2026-10-27 17:39 UTC)
تاريخ الحزمة: 2026-10-28
══════════════════════════════════════════════════════════════════

ما هي هذه الحزمة؟
=================
نسخة كاملة من كل شيء يعمل به موقع ومركز سليمان — بدون أي ملف ناقص
من ملفات المشروع — لتحفظها على جهازك كنسخة أمان ومرجع دائم.

المحتويات
=========
1) src/                        → كود الموقع كاملاً (Next.js) — 46+ صفحة
2) mini-services/api/          → كود الـAPI كاملاً (NestJS + Prisma) — كل الموديولات
                                  (المصدر الحي المنشور على Vercel: slmn-api-vercel1)
3) scripts/                    → كل سكربتات النشر والتحقق والتشخيص + نسخة الريبو الحي
                                  (api-repo-live) + لقطات التحقق التاريخية
                                  scripts/api-repo-live = نسخة كود الـAPI كما هو على Vercel
4) download/                   → كل الحزم التاريخية والأدلة ولقطات الموافقات
5) analysis/                   → أرشيف الموقع القديم (PHP/Laravel) والتحليلات
6) upload/                     → ملفات الرفع التاريخية
7) db/                         → قواعد البيانات المحلية القديمة (sqlite)
8) worklog.md                  → سجل العمل الكامل (كل المهام من رقم 4 حتى اليوم)
9) ملفات الإعداد الجذرية: package.json + package-lock.json + next.config.ts
   + tsconfig.json + components.json + postcss.config.mjs + Caddyfile + live-config.js

ماذا استُثنى ولماذا؟
====================
✗ التوكنات السرية (scripts/.cf_token* و scripts/.vc_token* ونسخ dead)
  → لأمان حساباتك: التوكنات لا تُحفظ في حزمة تنقل. لو احتجت توكن جديد
  أنشئه من لوحة Cloudflare/Vercel بنفس الصلاحيات المعروفة.
✗ node_modules (كلها)
  → قابلة للاستعادة بالضبط عبر ملفات القفل المرفقة (انظر الاستعادة أدناه).
✗ مجلد .git (تاريخ git الداخلي) — متاح كحزمة منفصلة عند الطلب.
✗ ملفات أدوات بيئة العمل المؤقتة (skills/ tool-results/) — ليست من مشروعك.

كيف تستعيدها وتشغلها على أي جهاز؟
=================================
الموقع (Next.js):
  1. ادخل مجلد الحزمة
  2. npm install --include=dev        (يرجّع كل الحزم من package-lock.json)
  3. npm run build                    (أو BUILD_STATIC=1 npm run build للتصدير الثابت)

الـAPI (NestJS):
  1. cd mini-services/api
  2. npm install
  3. npx prisma generate
  4. ضع ملف .env فيه: DATABASE_URL=(رابط TiDB) و JWT_SECRET=(السر الحالي)
  5. npm run start:dev   أو   npx tsc && node dist/main.js

البيانات الحقيقية (TiDB) ليست في الحزمة — وهي حية على السيرفر وآمنة؛
داتابيز sqlite المحلية في db/ هي أرشيف قديم فقط.

الحالة الحية عند بناء الحزمة
============================
- الموقع: https://solimanrepair.com  → v12.60 (درع النسخة + شفاء ذاتي شغال)
- الـAPI: https://slmn-api-vercel1.vercel.app (Vercel + TiDB)
- آخر ما أُنجز واتحقق حياً: اسم البائع يظهر على الفاتورة (كارت + مطبوعة «البائع: عثمان»
  لفاتورة 420002) وفي الإدارة (درج المبيعات «البائع: …» لكل حركة تحصيل).
- سجل التفاصيل الكامل خطوة بخطوة: worklog.md
