تعديل تطبيق

الوضع الحالي والمتطلبات:

1. ما هو موجود لدينا (جاهز):

· جميع واجهات المستخدم (UI) مصممة ومطورة كملفات HTML

أي أن الواجهة الأمامية (Front-end) جاهزة من ناحية الهيكل والتصميم.

· يمكن توفير هذه الملفات للمبرمج.

2. المطلوب تنفيذه (التطوير الأساسي):

· نحتاج إلى بناء النظام الخلفي (Back-end) بالكامل وقاعدة البيانات، ثم ربط واجهات HTML الحالية مع هذا النظام الخلفي لإنشاء تطبيق ويب ديناميكي وكامل الوظائف.

---

سير العمل (Workflow) الوظيفي المطلوب:

1. تقديم الطلب ودراسة الجدوى:

· يقوم مقدم الطلب بتسجيل بياناته الشخصية عبر نموذج.

· يدخل بيانات دراسة الجدوى (المساحة، الاستهلاك الكهربائي، الموقع... إلخ).

· النظام يحسب تلقائيًا تقديرًا أوليًا للسعة والتكلفة والتوفير.

2. نشر الطلب والاشتراك:

· بعد إكمال الدراسة، ينشر مقدم الطلب مشروعه.

· يتم إشعار الشركات المسجلة بالمنصة والمتخصصة في نطاق المشروع.

3. تقديم العروض والمنافسة العكسية (الخاصية الرئيسية):

· تقدم الشركات عروضها (سعر، مواصفات، ضمان، مدة تنفيذ).

· لمقدم الطلب خيارين:

· قبول عرض مباشرة.

· بدء منافسة عكسية (Reverse Auction) حيث يتم إعطاء فرصة للشركات لتحسين عروضها (خاصة السعر) خلال فترة زمنية محددة.

4. اختيار العرض وإكمال الإجراءات:

· يقارن مقدم الطلب العروض عبر لوحة تحكم.

· يختار العرض المناسب ويقبله.

· تستكمل الإجراءات (تبادل العقود، التوثيق) داخل المنصة.

---

المتطلبات التقنية للمبرمج (Technical Scope of Work):

1. تطوير النظام الخلفي (Back-End Development):

· بناء واجهة برمجة التطبيقات (REST API) باستخدام تقنية مناسبة (مثل Node.js, Python/Django, PHP/Laravel).

· تصميم وإدارة قاعدة البيانات (Database) (مثل MySQL, PostgreSQL) لتخزين بيانات المستخدمين، الطلبات، العروض، إلخ.

2. جعل واجهات HTML حية (Front-End Dynamic Integration):

· تعديل ملفات HTML الحالية بإضافة JavaScript (يفضل استخدام框架 مثل React, Vue.js, أو Ajax).

· وظيفة JavaScript ستكون:

· جمع البيانات من النماذج.

· التواصل مع API النظام الخلفي لإرسال واستقبال البيانات (بدون إعادة تحميل الصفحة – SPA-like experience).

· عرض البيانات الديناميكية القادمة من الخادم (مثل قائمة العروض) للمستخدم.

3. نقاط نهاية API الأساسية (Key API Endpoints):

سيحتاج النظام إلى تطوير الـ APIs التالية على الأقل:

· POST /api/auth/register (تسجيل مستخدم)

· POST /api/auth/login (دخول)

· POST /api/projects/feasibility (حساب دراسة الجدوى)

· POST /api/projects (إنشاء ونشر طلب جديد)

· GET /api/projects (للشركات: استعراض الطلبات)

· POST /api/bids (للشركات: تقديم عرض)

· POST /api/projects/{id}/start-auction (بدء منافسة عكسية)

· PUT /api/bids/{id} (للشركات: تحديث العرض خلال المنافسة)

· POST /api/bids/{id}/accept (لمقدم الطلب: قبول العرض)

4. الربط مع المنصة الجاهزة (External Platform Integration):

· سنوفر وثائق الـ API الخاصة بالمنصة الجاهزة.

· المطلوب هو كتابة كود في النظام الخلفي للتواصل مع تلك المنصة (مثلاً: عند قبول عرض، يتم إرسال بيانات المشروع النهائية إليها).

---

الخطوات التالية للمبرمج (Next Steps for the Developer):

1. مراجعة ملفات HTML/CSS/JS الحالية التي سنوفرها.

2. مراجعة وثائق API الخاصة بالمنصة الجاهزة (سنوفرها).

3. تقديم عرض فني ومالي يشمل:

· الهيكل التقني المقترح (Tech Stack).

· الجدول الزمني المقدر (Timeline) لكل مرحلة.

· التكلفة الإجمالية.

---

خاتمة: المشروع واضح من ناحية سير العمل والوظائف. التحدي الرئيسي هو التكامل السلس بين واجهات HTML الحالية والنظام الخلفي الجديد لإنشاء تطبيق موحد وسلس.