EN abstract: A complete technical walkthrough of the BrainSAIT OID badge management system's architecture — the React/Tailwind frontend, the FastAPI/Python backend, PostgreSQL storage, the AI assistant, and Docker-based deployment.
أهلاً بك في هذا الدليل التبسيطي الذي يستعرض البنية الهيكلية والتقنية لنظام BrainSAIT OID. هذا النظام ليس مجرد تطبيق ويب عابر، بل هو أداة متطورة مصممة خصيصاً لإدارة وتخصيص شارات "المعرفات الكائنية" (OID) داخل منظمة BrainSAIT.
1. الرؤية الشاملة: ما هو نظام BrainSAIT OID؟
في جوهره، يعمل نظام BrainSAIT OID كمركز قيادة وتنظيم للمعرفات الرقمية الخاصة بالمنظمة. تتمثل القيمة المضافة للنظام في ثلاث ميزات رئيسية:
- الواجهة المظلمة العصرية (Modern Dark UI): تقلل من إجهاد العين وتزيد من كفاءة العمل الطويل.
- تصور شجرة المعرفات (OID Tree Visualization): رؤية هرمية تفاعلية تسهّل فهم العلاقات بين الشارات.
- المساعد الذكي (AI-Powered Assistant): دمج الذكاء الاصطناعي لتقديم نصائح وسياقات مساعدة أثناء إدارة التخصيصات.
2. الواجهة الأمامية (Frontend): وجه النظام وتفاعله
تعتبر الواجهة الأمامية، الموجودة في مجلد oid-portal، الجسر الذي يعبر من خلاله المستخدم للتفاعل مع النظام. تم الاعتماد على مكتبة React.js لبناء واجهة سريعة واستجابة.
| التقنية المستخدمة | الوظيفة في تحسين تجربة المستخدم (UX) |
|---|---|
| React Hooks | تضمن تحديث الشاشة فوراً عند النقر على الأزرار دون الحاجة لانتظار تحميل الصفحة بالكامل. |
| TailwindCSS | بناء الواجهة المظلمة الأنيقة وتنسيق العناصر بمرونة عالية. |
| Modern JavaScript | استخدام معايير (ES6+) لكتابة أوامر برمجية قوية ونظيفة. |
3. الواجهة الخلفية (Backend): العقل المدبر ومحرك البيانات
يعتمد النظام في "عقله المدبر" الموجود في مجلد backend على تقنية FastAPI المدعومة بلغة Python 3.11+. يعمل النظام من خلال RESTful API:
-
GET /health— التحقق من صحة النظام. -
GET /oids— طلب قائمة بكافة الشارات المسجلة. -
POST /oids— تسجيل شارة OID جديدة. -
GET /oids/{oid}— البحث عن تفاصيل شارة محددة. -
PUT /oids/{oid}— تحديث شارة موجودة. -
DELETE /oids/{oid}— إلغاء شارة أو سحبها.
4. قاعدة البيانات والذكاء الاصطناعي: الذاكرة والنباهة
- PostgreSQL: قاعدة البيانات الموثوقة التي تعمل كـ"مستودع آمن" لجميع تفاصيل الشارات.
- المساعد المدعوم بالذكاء الاصطناعي (AI): يعمل كمستشار تقني فوري يحلل سياق المعرفات ويقدم توصيات ذكية.
5. بيئة التشغيل (Docker): الحاوية التي تجمع كل شيء
لتجنب مشكلة "البرنامج يعمل على جهازي فقط"، يستخدم النظام تقنية Docker — "صندوق أدوات متنقل" يحتوي على كل ما يحتاجه النظام في بيئة معزولة تماماً، عبر ثلاث خطوات: تحميل المشروع، إعداد الإعدادات، ثم التشغيل. بعد التشغيل، يقوم ملف test.sh بالفحص النهائي للنظام.
6. خريطة التدفق: كيف تعمل الأجزاء معاً؟
- نقطة الانطلاق (/oid-portal): يبدأ الطلب من مكونات React حيث يُدخل المستخدم البيانات.
- المعالجة المركزية (/backend/main.py): يستقبل الطلب ويعالجه عبر FastAPI.
- الاستشارة الذكية: استدعاء منطق الذكاء الاصطناعي لتقديم توصيات.
- التخزين المستديم: توجيه البيانات إلى قاعدة PostgreSQL.
- تأكيد النجاح: رسالة تأكيد للمستخدم بإتمام العملية بنجاح.
خاتمة
إن فهم هذه الهيكلية وكيفية ترابط المجلدات هو حجر الزاوية في مسيرتك كمطور. نظام BrainSAIT OID نموذج مثالي لكيفية تناغم الأدوات الحديثة لبناء حلول احترافية.
0 من التعليقات