How ahmed4attya/markazak-saas works
مركزك منصة SaaS متعددة المستأجرين لإدارة مركز تدريبي. يبدأ المسار المعتاد من واجهة RTL لإدارة الدورات والمجموعات وتسجيل الطلاب، ثم متابعة الحضور والتحصيل، وصولاً إلى التقارير والشهادات. واجهات API هي طبقة التشغيل التي تتحقق من الجلسة وتنفذ الاستعلامات أو التغييرات على PostgreSQL. أظهرت الملفات عينة من هذه المسارات، لا كل استدعاءات الواجهة؛ لذلك لا أفترض وصلات تفصيلية بين الصفحات وواجهات API غير المثبتة. مسارات Stripe والذكاء الاصطناعي موثقة جزئياً، لذا تظهر تكاملاتها منفصلة.
Main entry points: db.ts وصول البيانات · auth.ts الجلسات والصلاحيات · enrollments/route.ts تسجيل الطلاب · invoices/route.ts الفواتير
Components 28
واجهة المركز
- بوابة المركز
app/layout.tsx - لوحة المعلومات
app/dashboard/page.tsx
التشغيل التدريبي
- إدارة الطلاب
app/students/page.tsx - إدارة الدورات
app/courses/page.tsx - المجموعات والقاعات
app/groups/page.tsx - تسجيل الطلاب
app/api/enrollments/route.ts - متابعة الحضور
app/api/attendance/route.ts - إدارة المدربين
app/teachers/page.tsx - إدارة القاعات
app/api/classrooms/route.ts
المالية والشهادات
- الفواتير
app/api/invoices/route.ts - المدفوعات
app/api/payments/route.ts - واجهة المالية
app/finance/page.tsx - دفع Stripe
app/api/stripe/checkout/route.ts - استقبال Stripe
app/api/stripe/webhook/route.ts - إصدار الشهادات
app/api/certificates/route.ts - التحقق من الشهادات
app/api/certificates/verify/route.ts
التقارير والإدارة
- التقارير
app/api/reports/route.ts - واجهة التقارير
app/reports/page.tsx - المساعد الذكي
app/api/ai/route.ts - المستخدمون والصلاحيات
app/api/users/route.ts - إعدادات المركز
app/api/settings/route.ts
طبقة المنصة
- الجلسات والصلاحيات
lib/auth.ts - وصول البيانات
lib/db.ts - سجل التدقيق
lib/audit.ts - PostgreSQL
Other components
- موظفو المركز
- خدمة Stripe
- مزود ذكاء اصطناعي
Connections 36
- موظفو المركز → بوابة المركز: يفتح
- بوابة المركز → لوحة المعلومات: يعرض
- تسجيل الطلاب → متابعة الحضور: يتحقق من التسجيل
- موظفو المركز → إدارة الطلاب: يدير
- موظفو المركز → إدارة الدورات: يدير
- موظفو المركز → المجموعات والقاعات: ينظم
- موظفو المركز → إدارة المدربين: يدير
- المجموعات والقاعات → إدارة القاعات: يقرأ القاعات
- متابعة الحضور → الجلسات والصلاحيات: يتحقق من الجلسة
- متابعة الحضور → وصول البيانات: يقرأ ويسجل
- تسجيل الطلاب → الجلسات والصلاحيات: يتحقق من الجلسة
- تسجيل الطلاب → وصول البيانات: يقرأ ويسجل
- الفواتير → الجلسات والصلاحيات: يتحقق من الجلسة
- الفواتير → وصول البيانات: يقرأ ويكتب
- الفواتير → سجل التدقيق: يسجل الإنشاء
- المدفوعات → الجلسات والصلاحيات: يتحقق من الجلسة
- المدفوعات → وصول البيانات: ينفذ المعاملة
- المدفوعات → سجل التدقيق: يسجل الإنشاء
- موظفو المركز → واجهة المالية: يراجع
- دفع Stripe → خدمة Stripe: ينشئ جلسة دفع
- خدمة Stripe → استقبال Stripe: يرسل حدث
- إصدار الشهادات → الجلسات والصلاحيات: يتحقق من الجلسة
- إصدار الشهادات → وصول البيانات: يقرأ ويصدر
- التحقق من الشهادات → وصول البيانات: يتحقق من الرمز
- موظفو المركز → واجهة التقارير: يراجع
- التقارير → الجلسات والصلاحيات: يتحقق من الجلسة
- التقارير → وصول البيانات: يجمع المؤشرات
- المساعد الذكي → الجلسات والصلاحيات: يتحقق من الجلسة
- المساعد الذكي → وصول البيانات: يجمع السياق
- المساعد الذكي → مزود ذكاء اصطناعي: يطلب إجابة
- المستخدمون والصلاحيات → الجلسات والصلاحيات: يتحقق من الدور
- المستخدمون والصلاحيات → وصول البيانات: يقرأ ويكتب
- المستخدمون والصلاحيات → سجل التدقيق: يسجل التغييرات
- إعدادات المركز → الجلسات والصلاحيات: يتحقق من الدور
- إعدادات المركز → وصول البيانات: يقرأ ويكتب
- وصول البيانات → PostgreSQL: ينفذ الاستعلامات