المبيعات والانتشار

التمويل والشراكات

المساهمة

كيفية المساهمة في Hogwarts — أعراف المستودع، صيغة الـcommit، أول PR، قنوات المجتمع.

شكراً لاهتمامك. اقرأ هذه الصفحة مرة واحدة قبل فتح PR، وراجع الـissues المفتوحة لتجنّب العمل المكرّر. تحتاج مساعدة؟ Discord.

المستودع

مدير الحزم — pnpm.
نظام البناء — Turbopack (Next.js 16).
الإصدارات — تُدار عبر changesets.

الهيكل

src/— Source code directory

app/— Next.js App Router

[lang]/— Internationalized routes

(saas-saas-marketing)/— Entry point 01: SaaS saas-marketing

(saas-dashboard)/— Entry point 02: SaaS dashboard

(auth)/— Authentication pages

onboarding/— User onboarding flow

s/— Multi-tenant routing

[subdomain]/— Tenant-specific routes

(school-dashboard)/— Entry point 04: School dashboard

(school-saas-marketing)/— Entry point 03: School saas-marketing

layout.tsx— Root layout component

components/— React components

ui/— shadcn/ui components

atom/— Complex components (2+ shadcn combined)

template/— Full sections (header, hero, footer)

auth/— Authentication components

onboarding/— Onboarding flow components

saas-marketing/— Entry point 01: SaaS saas-marketing

saas-dashboard/— Entry point 02: SaaS dashboard

school-marketing/— Entry point 03: School saas-marketing

school-dashboard/— Entry point 04: School dashboard

الإعداد

الخطوة	الوثيقة
الطريق السريع	ابدأ الآن
الدليل التفصيلي	Localhost

أعراف الـ commit

الصيغة: category(scope): message. الفئات:

الفئة	الاستخدام
`feat` / `feature`	كود جديد، ميزات جديدة
`fix`	إصلاح أخطاء (اربط issue إن وُجد)
`refactor`	تغيير كود ليس إصلاحاً ولا ميزة
`docs`	وثائق فقط
`build`	تغييرات البناء أو التبعيات
`test`	اختبارات جديدة أو محدّثة
`ci`	تغييرات CI / GitHub Actions
`chore`	كل ما عدا ذلك

استخدم اسم المجلد كـ scope:

feat(marketing)     # SaaS marketing
feat(operator)      # SaaS dashboard
feat(site)          # School marketing
feat(platform)      # School dashboard
feat(auth)          # Authentication
feat(onboarding)    # Onboarding flow
feat(ui)            # shadcn/ui primitives
feat(atom)          # Atomic components
feat(template)      # Templates / sections
fix(docs)           # إصلاحات الوثائق

راجع conventionalcommits.org للمواصفة الكاملة.

الاختبارات

pnpm test

كل PR يجب أن تجتاز الاختبارات. الميزات الجديدة يجب أن تتضمن اختبارات.

أول PR لك

استهدف أقل من 15 دقيقة من الاستنساخ إلى PR.

git checkout -b docs/first-pr
pnpm install
pnpm dev

اختر مهمة صغيرة — تصحيح خطأ مطبعي، توضيح جملة، إضافة أمر مفقود. نفّذ التعديل. إن غُيِّرت الواجهة، التقط لقطة LTR + RTL.

pnpm build
git add -A
git commit -m "docs: clarify get-started step"
git push origin HEAD

افتح PR بعنوان قصير محدّد ووصف موجز يبيّن سبب الفائدة. اربط الـissues ذات الصلة. أهلاً بك.

مكونات جديدة

افتح نقاشاً على GitHub قبل البناء. سنوجّهك إلى الأنماط القائمة.

المجتمع

ندير اقتصاداً مشتركاً لمطوّري البرمجيات — مفتوح المصدر، عمل مدفوع عند توفّره، ومشاركة عادلة للإيرادات. راجع الاقتصاد المشترك.

المبادئ

لا مواعيد نهائية، لكن مساهمات مستمرة.
شفافية — backlog عام، أولويات معلنة، changelog.
عدالة — مكافأة الأثر المستدام والصيانة والموثوقية.
شمولية — العربية + الإنجليزية، واجهات قابلة للوصول، تفكير صديق للوضع غير المتصل.

كيف نتعاون

async-first — الـissues والـPRs والوثائق تحمل السياق.
انحياز لشحن خطوات صغيرة.
توثيق القرارات في صفحة الوثيقة المعنية أو في الـPR.

الأدوار (مرنة، اختيارية)

Maintainers — يحافظون على صحة المستودعات ويراجعون الـPRs.
Contributors — يبنون الميزات ويصلحون الأخطاء ويحسّنون الوثائق.
Coordinators — يفرزون الـissues ويرتّبون خارطة الطريق.

القنوات

القناة	المكان	الاستخدام
Discord	discord.gg/uPa4gGG62c	`#general`, `#help`, `#announcements`
WhatsApp	chat.whatsapp.com/databayt	تنسيق سريع، ومشاركة `.env`

كن محترماً. ابحث قبل أن تسأل. شارك تقدّمك.

انظر أيضاً

أمان قاعدة البيانات هَوْغوارتس

On This Page

المستودع الهيكل الإعداد أعراف الـ commit الاختبارات أول PR لك مكونات جديدة المجتمع المبادئ كيف نتعاون الأدوار (مرنة، اختيارية)القنوات انظر أيضاً

المبيعات والانتشار

التمويل والشراكات

المساهمة

كيفية المساهمة في Hogwarts — أعراف المستودع، صيغة الـcommit، أول PR، قنوات المجتمع.

المستودع

مدير الحزم — pnpm.
نظام البناء — Turbopack (Next.js 16).
الإصدارات — تُدار عبر changesets.

الهيكل

src/— Source code directory

app/— Next.js App Router

[lang]/— Internationalized routes

(saas-saas-marketing)/— Entry point 01: SaaS saas-marketing

(saas-dashboard)/— Entry point 02: SaaS dashboard

(auth)/— Authentication pages

onboarding/— User onboarding flow

s/— Multi-tenant routing

[subdomain]/— Tenant-specific routes

(school-dashboard)/— Entry point 04: School dashboard

(school-saas-marketing)/— Entry point 03: School saas-marketing

layout.tsx— Root layout component

components/— React components

ui/— shadcn/ui components

atom/— Complex components (2+ shadcn combined)

template/— Full sections (header, hero, footer)

auth/— Authentication components

onboarding/— Onboarding flow components

saas-marketing/— Entry point 01: SaaS saas-marketing

saas-dashboard/— Entry point 02: SaaS dashboard

school-marketing/— Entry point 03: School saas-marketing

school-dashboard/— Entry point 04: School dashboard

الإعداد

الخطوة	الوثيقة
الطريق السريع	ابدأ الآن
الدليل التفصيلي	Localhost

أعراف الـ commit

الصيغة: category(scope): message. الفئات:

الفئة	الاستخدام
`feat` / `feature`	كود جديد، ميزات جديدة
`fix`	إصلاح أخطاء (اربط issue إن وُجد)
`refactor`	تغيير كود ليس إصلاحاً ولا ميزة
`docs`	وثائق فقط
`build`	تغييرات البناء أو التبعيات
`test`	اختبارات جديدة أو محدّثة
`ci`	تغييرات CI / GitHub Actions
`chore`	كل ما عدا ذلك

استخدم اسم المجلد كـ scope:

feat(marketing)     # SaaS marketing
feat(operator)      # SaaS dashboard
feat(site)          # School marketing
feat(platform)      # School dashboard
feat(auth)          # Authentication
feat(onboarding)    # Onboarding flow
feat(ui)            # shadcn/ui primitives
feat(atom)          # Atomic components
feat(template)      # Templates / sections
fix(docs)           # إصلاحات الوثائق

راجع conventionalcommits.org للمواصفة الكاملة.

الاختبارات

pnpm test

كل PR يجب أن تجتاز الاختبارات. الميزات الجديدة يجب أن تتضمن اختبارات.

أول PR لك

استهدف أقل من 15 دقيقة من الاستنساخ إلى PR.

git checkout -b docs/first-pr
pnpm install
pnpm dev

pnpm build
git add -A
git commit -m "docs: clarify get-started step"
git push origin HEAD

افتح PR بعنوان قصير محدّد ووصف موجز يبيّن سبب الفائدة. اربط الـissues ذات الصلة. أهلاً بك.

مكونات جديدة

افتح نقاشاً على GitHub قبل البناء. سنوجّهك إلى الأنماط القائمة.

المجتمع

المبادئ

لا مواعيد نهائية، لكن مساهمات مستمرة.
شفافية — backlog عام، أولويات معلنة، changelog.
عدالة — مكافأة الأثر المستدام والصيانة والموثوقية.
شمولية — العربية + الإنجليزية، واجهات قابلة للوصول، تفكير صديق للوضع غير المتصل.

كيف نتعاون

async-first — الـissues والـPRs والوثائق تحمل السياق.
انحياز لشحن خطوات صغيرة.
توثيق القرارات في صفحة الوثيقة المعنية أو في الـPR.

الأدوار (مرنة، اختيارية)

Maintainers — يحافظون على صحة المستودعات ويراجعون الـPRs.
Contributors — يبنون الميزات ويصلحون الأخطاء ويحسّنون الوثائق.
Coordinators — يفرزون الـissues ويرتّبون خارطة الطريق.

القنوات

القناة	المكان	الاستخدام
Discord	discord.gg/uPa4gGG62c	`#general`, `#help`, `#announcements`
WhatsApp	chat.whatsapp.com/databayt	تنسيق سريع، ومشاركة `.env`

كن محترماً. ابحث قبل أن تسأل. شارك تقدّمك.

انظر أيضاً

أمان قاعدة البيانات هَوْغوارتس

On This Page

بالقلم

المساهمة

المستودع

الهيكل

الإعداد

أعراف الـ commit

الاختبارات

أول PR لك

مكونات جديدة

المجتمع

المبادئ

كيف نتعاون

الأدوار (مرنة، اختيارية)

القنوات

انظر أيضاً

بالقلم

المساهمة

المستودع

الهيكل

الإعداد

أعراف الـ commit

الاختبارات

أول PR لك

مكونات جديدة

المجتمع

المبادئ

كيف نتعاون

الأدوار (مرنة، اختيارية)

القنوات

انظر أيضاً