🌐 بورتفوليو شخصي – Usama Elngar

مرحبًا 👋
هذا المستودع يحتوي على مشروع بورتفوليو شخصي احترافي تم بناؤه من الصفر باستخدام Django و Tailwind CSS.
المشروع يوثق جميع خطوات التنفيذ خطوة بخطوة حتى النشر النهائي، ليكون مرجعًا كاملًا للتطوير.

---

1️⃣ معلومات المشروع

• اسم المشروع: usama elngar
• الغرض: إنشاء موقع شخصي كامل يعرض:
  • السيرة الذاتية والملف الشخصي (Profile)
  • المشاريع (Projects)
  • المقالات (Articles)
  • المهارات (Skills)
  • نموذج تواصل (Contact Form)
  • واجهة مستخدم حديثة، مشابهة لأشهر مواقع البورتفوليو العالمية

---

2️⃣ الأدوات والتقنيات

• Backend: Python 3.13 + Django 5.x
• Frontend: Tailwind CSS + Alpine.js + Django Templates
• Database: PostgreSQL
• IDE: Visual Studio Code
• بيئة التطوير: بيئة افتراضية .venv + ملف requirements.txt
• إدارة الصور والوسائط: Media folder مرتبط بالنماذج (Models)

---

3️⃣ هيكل المشروع المتوقع

usama elngar/ │── manage.py │── .venv/ │── backend/ (settings.py, urls.py, wsgi.py, asgi.py, init.py) │── portfolio/ (apps.py, models.py, views.py, admin.py, tests.py, init.py, templates/, static/) │── templates/portfolio/ │── static/portfolio/css/ │── static/portfolio/js/ │── static/portfolio/images/

ملاحظة: لا يتم إنشاء الهيكل كاملًا مرة واحدة، بل على مراحل حسب الحاجة أثناء التنفيذ.

---

4️⃣ منهجية التنفيذ

• تثبيت المكتبات حسب المرحلة.
• تسجيل جميع التعديلات والاعتماد على التدرج خطوة بخطوة.
• تعليقات عربية داخل الأكواد لتسهيل المراجعة.

---

5️⃣ خطوات المشروع الرئيسية

1. إعداد البيئة الافتراضية وتشغيل السيرفر.
2. إعداد قاعدة البيانات PostgreSQL وربطها بالمشروع.
3. إنشاء التطبيقات (Models) الخاصة بكل جزء من البورتفوليو:
   • Profile
   • Project
   • Article
   • Skill
   • ContactMessage
4. إدخال بيانات تجريبية عبر لوحة التحكم (Admin).
5. إنشاء Views وربطها بالقوالب Templates.
6. تصميم واجهة المستخدم UI/UX باستخدام Tailwind CSS + Alpine.js.
7. ربط ملفات CSS و JavaScript مع Django Templates.
8. تجهيز الصور وربطها بالنماذج (Models).
9. اختبار الموقع محليًا والتأكد من عمل كل قسم.
10. التحضير للنشر (Static/Media files + خادم مثل Heroku / Vercel / VPS).

---

6️⃣ قواعد التعامل مع الأكواد

• لا يتم حذف أو تعديل ملفات قائمة إلا لسبب واضح.
• أي خطأ يتم إصلاحه مباشرة مع تحديث سجل الخطوات.

---

7️⃣ الهدف النهائي

الوصول إلى موقع بورتفوليو احترافي مكتوب بالعربية، يوثق جميع خطوات التنفيذ،
جاهزً للنشر على الإنترنت، بمستوى ينافس أفضل مواقع البورتفوليو العالمية.

---