S-ACM هو نظام متكامل لإدارة المحتوى الأكاديمي، مصمم لتبسيط وأتمتة العمليات الأكاديمية في المؤسسات التعليمية. يجمع النظام بين سهولة الاستخدام وقوة الذكاء الاصطناعي لتحسين تجربة التعلم والتعليم.
| الميزة | الوصف |
|---|---|
| إدارة المستخدمين | تسجيل وإدارة الطلاب والأساتذة والموظفين مع نظام أرقام أكاديمية تلقائي |
| إدارة المقررات | إنشاء وتنظيم المقررات الدراسية وربطها بالتخصصات والمستويات |
| إدارة الملفات | رفع وتصنيف الملفات الأكاديمية (محاضرات، ملخصات، اختبارات) |
| الذكاء الاصطناعي | تلخيص المحتوى، توليد الأسئلة، والمحادثة الذكية |
| التقارير | إحصائيات وتقارير شاملة عن النظام |
| الإشعارات | نظام إشعارات متكامل للتواصل |
يعتمد المشروع على مجموعة من التقنيات الحديثة. في الواجهة الأمامية، نستخدم React 19 كإطار عمل رئيسي مع TypeScript للتحقق من الأنواع، و Tailwind CSS 4 للتنسيق، و shadcn/ui للمكونات الجاهزة، و Wouter للتوجيه، و Recharts للرسوم البيانية. أما أدوات البناء فتشمل Vite للتطوير والبناء، و pnpm لإدارة الحزم.
تحتاج إلى Node.js الإصدار 18 أو أحدث، و pnpm الإصدار 8 أو أحدث.
# استنساخ المستودع
git clone https://github.com/your-username/s-acm-frontend.git
# الانتقال للمجلد
cd s-acm-frontend
# تثبيت التبعيات
pnpm install
# تشغيل خادم التطوير
pnpm devبعد تشغيل الأوامر السابقة، افتح المتصفح على العنوان http://localhost:3000 للوصول للتطبيق.
s-acm-frontend/
├── client/ # الواجهة الأمامية
│ ├── public/ # الملفات الثابتة
│ └── src/
│ ├── components/ # المكونات
│ ├── pages/ # الصفحات
│ ├── contexts/ # السياقات
│ ├── hooks/ # الخطافات
│ └── lib/ # المكتبات المساعدة
├── docs/ # التوثيق
│ ├── analysis/ # التحليل والمتطلبات
│ ├── design/ # التصميم والهيكلة
│ ├── changelog/ # سجل التغييرات
│ └── guides/ # الأدلة
└── server/ # الخادم (placeholder)
يتوفر توثيق شامل للمشروع في مجلد docs/:
| الملف | الوصف |
|---|---|
| نظرة عامة | وصف المشروع وأهدافه |
| المتطلبات | المتطلبات الوظيفية وغير الوظيفية |
| الأدوار | الأدوار والصلاحيات |
| حالات الاستخدام | سيناريوهات الاستخدام |
| الهيكلة | الهيكلة العامة للنظام |
| تصميم الواجهات | تصميم واجهة المستخدم |
| المكونات | دليل المكونات |
| سجل التغييرات | تاريخ التحديثات |
| الأخطاء | الأخطاء والحلول |
| دليل المطور | دليل للمطورين |
تعرض لوحة التحكم إحصائيات شاملة عن النظام مع رسوم بيانية تفاعلية وبطاقات معلومات.
تصميم مخصص للهاتف يشبه التطبيقات الأصلية مع شريط تنقل سفلي وقوائم مضغوطة.
نرحب بالمساهمات! للمساهمة في المشروع:
- أنشئ Fork من المستودع
- أنشئ فرع جديد (
git checkout -b feature/amazing-feature) - قم بالتغييرات وأضفها (
git commit -m 'Add amazing feature') - ارفع الفرع (
git push origin feature/amazing-feature) - أنشئ Pull Request
راجع دليل المطور لمزيد من التفاصيل.
هذا المشروع مرخص تحت رخصة MIT. راجع ملف LICENSE للتفاصيل.
للأسئلة والاستفسارات، يمكنك فتح Issue في المستودع.
صُنع بـ ❤️ لتطوير التعليم