Providentia Network

شبكة بروفيدينتيا هو مشروع Django مع واجهة أمامية يستضيف نظام "بروفيدينتيا" للاستدلال/الأتمتة.

يحتوي هذا المستودع على خلفية Django (في providentia/ و manage.py) وواجهة أمامية مبنية باستخدام Vite + React (في src/ و package.json).

بداية سريعة

1. قم بإنشاء وتفعيل بيئة Python افتراضية:

   python -m venv .venv
   source .venv/bin/activate
   

2. قم بتثبيت تبعيات Python:

   pip install -r requirements.txt
   

3. قم بتثبيت تبعيات الواجهة الأمامية:

   npm install
   

4. قم بتشغيل خادم تطوير Django:

   python manage.py migrate
   python manage.py runserver
   

5. (اختياري) قم بتشغيل خادم تطوير الواجهة الأمامية:

   npm run dev
   

هيكل المستودع (مستوى عالٍ)

• providentia/ - وحدة مشروع Django (الإعدادات، عناوين URL، wsgi/asgi)
• manage.py - غلاف إدارة Django
• outdated/ - نصوص برمجية قديمة (مؤرشفة). راجع archive/ للنسخ
• Data/، Modules/، Assets/ - وحدات المشروع والأصول الثابتة
• src/ - مصدر الواجهة الأمامية (React + Vite)

ملاحظات

• بعض الملفات القديمة موجودة تحت outdated/. تم وضع نسخة في archive/ للرجوع إليها.
• احتفظ بالأسرار خارج المستودع. استخدم ملف .env (موجود بالفعل) وتأكد من أن .env موجود في .gitignore.

الخطوات التالية

• إضافة وثائق مطور خاصة بالمشروع (نقاط النهاية، متغيرات البيئة)
• إضافة اختبارات للوحدات الأساسية ومهمة CI