برمجة تطبيق "أثر" (Athar) الشعار: اترك صوتك حيث تركت قلبك.

? وثيقة المتطلبات التقنية: مشروع "أثر" (Athar)

النسخة: 1.0 (MVP - الحد الأدنى من المنتج القابل للتطبيق)

نوع التطبيق: تواصل اجتماعي يعتمد على الموقع والواقع المعزز الصوتي (Location-based Audio AR).

1. الهدف من المشروع (Project Objective)

بناء تطبيق يسمح للمستخدمين بتسجيل رسائل صوتية وربطها بإحداثيات جغرافية محددة، بحيث لا يمكن للمستخدمين الآخرين الاستماع إليها إلا عند التواجد جسديًا في نفس الموقع الجغرافي.

2. المنصات المستهدفة (Platforms)

• iOS & Android (يفضل استخدام تقنية Flutter أو React Native لتوفير التكلفة والوقت وتوحيد الكود).

3. المميزات الوظيفية الأساسية (Functional Requirements)

أ. التسجيل والدخول (Authentication)

• تسجيل الدخول ببساطة عبر رقم الهاتف (OTP) أو حسابات التواصل (Google/Apple) لضمان هوية مستخدم حقيقية.

• إنشاء ملف شخصي بسيط (اسم، صورة، نبذة).

ب. الخريطة والرادار (Map & Radar UI)

• عرض الخريطة: واجهة خريطة مخصصة (Custom Dark Map) لا تظهر تفاصيل الشوارع المزدحمة، بل تركز على "نقاط الآثار".

• واجهة الرادار: عند التواجد في منطقة، يظهر رادار يوضح المسافة التقريبية لأقرب رسالة صوتية (بدون تحديد المكان بدقة 100% لإضافة عنصر الاستكشاف).

ج. إنشاء الأثر (Creating Content)

• تسجيل الصوت: واجهة تسجيل بسيطة (حد أقصى 60 ثانية للـ MVP).

• تثبيت الموقع: التقاط إحداثيات GPS الحالية للمستخدم تلقائيًا وربطها بالملف الصوتي.

• تحديد الخصوصية: خياران فقط للبداية:

1. عام (Public): أي شخص يمر يسمعه.

2. خاص (Private): للمستخدم فقط (ذكريات شخصية).

د. استكشاف واستماع الأثر (Discovery & Playback)

• Geofencing (السياج الجغرافي): يجب أن يكتشف التطبيق موقع المستخدم.

• قواعد التشغيل:

• عندما يدخل المستخدم دائرة قطرها (مثلاً 20 مترًا) حول الأثر، يظهر زر "استمع".

• أو (خيار متقدم): يبدأ الصوت بالتلاشي للداخل (Fade-in) تلقائيًا.

• مشغل الصوت: مشغل بسيط يظهر في أسفل الشاشة.

4. المتطلبات غير الوظيفية (Non-Functional Requirements)

• دقة الموقع (GPS Accuracy): التطبيق يحتاج دقة عالية (High Precision)، لذا يجب التعامل بذكاء مع استهلاك البطارية.

• زمن الاستجابة (Latency): الملف الصوتي يجب أن يبدأ فورًا عند الوصول للموقع (Streaming سريع).

• الأمان: منع تحميل محتوى مسيء (نظام إبلاغ بسيط - Report Button).

5. التقنيات المقترحة (Suggested Tech Stack)

هذه توصيات للمبرمج لضمان الجودة والتكلفة المعقولة:

• Front-end (واجهة التطبيق): Flutter (لغة Dart) - الخيار الأفضل حالياً للأداء العالي على المنصتين.

• Back-end (الخادم وقاعدة البيانات): Firebase (من Google).

• Firestore: لتخزين بيانات المستخدمين ومواقع الرسائل.

• Cloud Storage: لتخزين الملفات الصوتية.

• Cloud Functions: لمعالجة المنطق الخلفي.

• Map Service (الخرائط): Mapbox (أفضل من Google Maps في تخصيص التصميم والألوان لتناسب جو التطبيق الغامض).

6. تحديات تقنية يجب الانتباه لها (Notes for Developer)

• إدارة البطارية: يجب أن يعمل التطبيق بكفاءة ولا يستهلك البطارية بسرعة أثناء البحث عن الموقع في الخلفية.

• التعامل مع ضعف الإنترنت: هل يمكن تحميل "الآثار" المحيطة مسبقًا (Cache) لتعمل حتى لو انقطع النت في الموقع؟ (ميزة مهمة).