بنية مجلدات المشروع ومسارات الصفحات
بنية مجلدات المشروع ومسارات الصفحات — نظام إدارة الأعراس والمناسبات ودعوات QR | Next.js وPrisma | أديب الصلوي
وقت الدراسة
10 دقيقة
المسار: تطوير نظام إدارة الأعراس ودعوات QR الوحدة: إعداد المشروع والتقنيات
مدخل إلى الدرس: بنية مجلدات المشروع ومسارات الصفحات
بنية مجلدات المشروع ومسارات الصفحات — نظام إدارة الأعراس والمناسبات ودعوات QR | Next.js وPrisma | أديب الصلوي
طريقة الدراسة: اقرأ التعريف، تتبّع المثال في الشرح، نفّذه بنفسك، ثم اختبر النتيجة والحالات الاستثنائية قبل الانتقال.
أهداف هذا الدرس
- ربط اسم المجلد بالرابط URL المرتبط به.
- فهم توزيع الملفات: app / lib / components / prisma.
- بناء نموذج مسار ديناميكي /i/[token].tsx داخل App Router.
المخطط: خريطة مجلدات المشروع النهائية
flowchart TD
Root["wedding-events/"]
Root --> P["prisma/
schema.prisma"]
Root --> L["lib/
prisma.ts — عميل مشترك
tsign.ts — توليد/تحقق token"]
Root --> A["app/
layout.tsx · page.tsx"]
A --> I["i/[token]/page.tsx
صفحة الدعوة"]
A --> AD["admin/
page.tsx · guests/ · scan/"]
A --> API["api/
events/route.ts · guests/ · checkin/"]
Root --> PUB["public/ ..."]
| المسار في app/ | عنوان URL | النوع |
|---|---|---|
| i/[token]/page.tsx | /i/abc123 | صفحة دعوة Server Component |
| admin/page.tsx | /admin | لوحة الإحصائيات (use client جزئياً) |
| api/checkin/route.ts | POST /api/checkin | التسجيل |
تمرين تطبيقي: في مشروعك أضف مجلدين فارغين i/[token] و api/checkin ثم ضع في كل واحد ملف placeholder وافتح الرابطين لترى 404/200 بفهم.
الخلاصة السريعة
- المجلد في app ← المسار في الرابط، والأقواس ديناميكية.
- lib يحتضن المنطق المشترك (prisma, tsign).
- القاعدة: لا نضع ملفات أعمال داخل مجلدات الصفحات.
أخطاء شائعة يجب تفاديها
- وضع عميل prisma في كل ملف — يستنفذ الاتصالات.
- نسيان أن [token] يقبل أي نص، فالتحقق خارجياً.
- مزج head كما في Pages القديمة عوض layout.
معجم مصطلحات الدرس
- طرق ديناميكية
- اسم مجلد بين قوسين [x] يمثل الجزء المتغير من الرابط.
- layout
- ملف يشارك البنية بين كل صفحات فرع معيّن.
- lib
- مشترك المساعدة خارج app (عادياً).
مراجعة وتمرين تثبيت المهارة
اختبار سريع: اشرح بعبارتك معنى «بنية مجلدات المشروع ومسارات الصفحات»، ثم بيّن أين ستستخدمه داخل نظام تسجيل حضور دعوات مناسبة عبر رمز QR، وما الخطأ الذي يجب اختباره قبل الاعتماد على الحل.
تحدٍّ إضافي: غيّر شرطًا واحدًا في التطبيق، وتوقع النتيجة، ثم نفّذ الاختبار وفسّر الاختلاف.
