فوراً | Fawran App

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

الإصدار v1

• المنتج: Fawran App
• الإصدار: 1.0.0
• واجهة الهاتف: أربعة أقسام فقط: الرئيسية، المهام، المحادثات، الحساب.
• هوية التخزين والبيئة: FAWRAN_*
• قاعدة البيانات الافتراضية: fawran.sqlite3
• لا يقرأ التطبيق بيانات أو جلسات مستودع Khadamati.

فكرة المنتج

رحلة العميل الأساسية واحدة:

1. يكتب أو يملي ما يحتاجه، ويمكنه إرفاق صورة.
2. يقترح التطبيق الخدمة الدقيقة ويطلب تأكيدًا واحدًا.
3. يحدد موقع التنفيذ والتفاصيل الضرورية.
4. يصل الطلب إلى المزودين المطابقين فقط.
5. يختار العميل العرض المناسب.
6. ينتقل الطرفان إلى مهمة ومحادثة مشتركتين.
7. يؤكد العميل الإنجاز والجودة.

رحلة المزود الأساسية:

1. يرى الخطوة التالية أو فرصة مطابقة مباشرة.
2. يفتح مركز عمل واحد للفرص والمهام الجارية.
3. يرسل عرضه بقالب سعر ومدة.
4. بعد الاختيار تنتقل المهمة إلى التنفيذ والمحادثة.
5. تبقى الخدمات والباقة والأداء والدعم داخل الحساب وأدوات العمل.

التقنية

• واجهة PWA عربية وإنجليزية داخل index.html.
• نسخة النشر الثابتة داخل public/.
• خادم Python في server.py.
• SQLite محليًا مع مخطط PostgreSQL وخطة ترحيل موثقة.
• Leaflet للخرائط.
• Playwright لاختبارات الواجهة.
• اختبارات Python للوحدات، API، الأمن، النسخ الاحتياطي، والاستعادة.

التشغيل المحلي

python server.py

ثم افتح:

http://127.0.0.1:8080

يمكن كذلك استخدام:

.\start-fawran-app.bat

الاختبارات

python -m py_compile server.py fawran_domain.py fawran_workflow.py
python -m unittest discover -s tests -p "test_*.py" -v
python tests/security-api.py
python tests/run-smoke-isolated.py
npm run check:js
npm run test:ui
npm run test:performance
python scripts/verify_repository.py

متغيرات البيئة

انسخ أسماء المتغيرات من .env.example إلى إعدادات الخادم، ولا ترفع قيمًا حقيقية إلى GitHub.

أهم المتغيرات:

• FAWRAN_ENV
• FAWRAN_RELEASE
• FAWRAN_PUBLIC_URL
• FAWRAN_ALLOWED_ORIGINS
• FAWRAN_DB_PATH
• FAWRAN_UPLOAD_DIR
• FAWRAN_BACKUP_DIR
• FAWRAN_ADMIN_CODE
• FAWRAN_OTP_PEPPER
• FAWRAN_MEDIA_SIGNING_KEY
• FAWRAN_PAYMENT_WEBHOOK_SECRET

البريد الحالي للدعم هو om.khadamati@gmail.com إلى أن يعتمد المالك بريدًا مستقلًا لفوراً.

النشر

• الواجهة المنشورة: https://lllx6.github.io/Fawran-App/
• الخادم التجريبي المستقل: https://fawran-app-api.onrender.com
• المستودع: https://github.com/LLLX6/Fawran-App
• إعداد Render موجود في render.yaml باسم خدمة مستقل fawran-app-api.

GitHub Pages يشغل الواجهة وPWA، ويتصل حاليًا بخادم Render مستقل لا يشارك بيانات «خدماتي». هذا الخادم مخصص للتجربة فقط: خطة Render المجانية لا تدعم قرصًا دائمًا، ولذلك يمكن أن يعاد إنشاء SQLite والصور بعد السكون أو إعادة النشر. قبل الاستخدام العام يجب ربط الخادم بقاعدة وتخزين دائمين، ثم تحويل FAWRAN_ENV إلى production وإيقاف البيانات النموذجية.

مرجع حدود الخطة المجانية: https://render.com/docs/free

الملكية والأمان

• أبقِ GitHub وRender وقاعدة البيانات والدومين والتخزين وحسابات Apple وGoogle والدفع تحت ملكية صاحب المشروع أو المؤسسة.
• لا تضع كلمات مرور أو OTP أو مفاتيح API أو نسخ قواعد بيانات أو بيانات مستخدمين داخل المستودع.
• تحقق من الصلاحيات في الخادم؛ إخفاء الزر في الواجهة ليس حماية.
• لا تستخدم رمز إدارة افتراضيًا في الإنتاج.

ملفات مهمة

• AGENTS.md: قواعد التطوير الدائمة.
• DEVELOPER_GUIDE_AR.md: دليل المطور.
• FAWRAN_V1_RELEASE_REPORT.md: تقرير هذا الإصدار.
• SECURITY_AND_QUALITY_AUDIT.md: التدقيق الأمني والجودة.
• POSTGRESQL_MIGRATION.md: خطة الانتقال إلى PostgreSQL.
• ملفات-الإطلاق/: وثائق الجاهزية والسياسات والتسليم.