انتقل إلى المحتوى

الهيكل

السابقالتالي

أين يعيش كل ملف ولماذا.

src/
  proxy.ts                     تحويل اللغة + بوابة الإدارة المتفائلة
  mdx-components.tsx           تنسيق نصوص التوثيق
  app/[lang]/
    (site)/…                   الصفحات العامة — أغلفة رقيقة (نمط المرآة)
    (site)/docs/[[...slug]]    هذا التوثيق
    admin/login, admin/…   منطقة الفريق (غير مفهرسة)
  components/
    ui/                        مكوّنات shadcn الأولية (كود المصدر كما هو)
    atom/                      تراكيب: cta, media-frame, page-hero, prose, …
    template/                  رأس وتذييل الموقع، شريط الإجراءات للهاتف
    site/<feature>/            content · queries · actions · validation · form · config
    admin/<feature>/           شاشات الإدارة وإجراءاتها المطابقة
    docs/                      شريط التوثيق الجانبي، والفهرس، ونسخ الصفحة، والتنبيهات
    internationalization/      الإعداد والقواميس (ar/en لكل نطاق)
  config/site.ts               قنوات التواصل، والتواصل الاجتماعي، والموقع
  lib/                         db, auth, time, format, validation, guard, seo, source
content/
  docs-en/, docs-ar/           صفحات التوثيق (MDX) + ترتيب meta.json
prisma/schema.prisma           نماذج المحتوى والعمليات

مجلد الميزة

كل ميزة في src/components/site/<feature> تستخدم أسماء الملفات نفسها:

الملفالدور
content.tsxمكوّن الخادم الذي يعرضه المسار
queries.tsقراءات قاعدة البيانات
actions.tsServer Actions
validation.tsمخططات Zod المشتركة بين النموذج والإجراء
form.tsxنموذج العميل
config.tsالإعداد الثابت للميزة