SIRO MAPS MASTER ROADMAP & ARCHITECTURE

خطة العمل التنفيذية والهندسية: منظومة سيرو ماب

بناء المسارات التراثية ونظام المرشدين المحليين (Local Guides) مع التدقيق اليدوي ومحرك التلعيب، مع ضمان العزل التام للخدمات التجارية القائمة.

1
الكتابة على الماك والبناء على السيرفر

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

2
عزل تام لخدمات الإنتاج (Zero Risk)

          محرك الملاحة GraphHopper، والبحث الجغرافي B2B، وتتبع السائقين، والفوترة تبقى معزولة تماماً بنسبة 100% دون أي تعديل.
        

3
التلعيب والتدقيق اليدوي الصارم

          نظام مرشدين وطني يمنح نقاطاً وأوسمة للمساهمات، ولكن لا يُنشر أي تعديل للخريطة إلا بعد موافقة المشرف من لوحة التحكم.
        

المرحلة 1: البنية التحتية والمخططات المعزولة في PostGIS

PHASE 01 : DATABASE

إنشاء مخططي heritage و community داخل نفس قاعدة البيانات لتجنب استهلاك الذاكرة، مع ضمان سرعة الربط المكاني اللحظي عبر خادم مارتن للبلاطات الشعاعية.

CREATE SCHEMA IF NOT EXISTS heritage;
CREATE SCHEMA IF NOT EXISTS community;

-- جدول المعالم والبوابات الدقيقة
CREATE TABLE heritage.landmarks (
    id SERIAL PRIMARY KEY,
    name_ar VARCHAR(255) NOT NULL,
    category VARCHAR(100) NOT NULL,
    centroid_geom geometry(Point, 4326) NOT NULL,
    access_gate_geom geometry(Point, 4326),
    parking_geom geometry(Point, 4326),
    narrative_ar TEXT,
    audio_url VARCHAR(500)
);

-- جدول مساهمات المرشدين الخاضعة للمراجعة
CREATE TABLE community.contributions (
    id SERIAL PRIMARY KEY,
    guide_id INT,
    contribution_type VARCHAR(50), -- ADD_PLACE, CORRECT_STREET, CONFIRM_GATE
    suggested_data JSONB,
    suggested_geom geometry(Geometry, 4326),
    status VARCHAR(30) DEFAULT 'PENDING'
);
      

المرحلة 2: الوحدات المستقلة في خادم التطبيقات (NestJS Modules)

PHASE 02 : BACKEND API

بناء موديولين معزولين تماماً داخل apps/api:

HeritageModule: لخدمة المعالم، المسارات الستة، والملفات الصوتية.
CommunityModule: لإدارة نقاط المرشدين، لوحة المتصدرين، وتلقي المساهمات.

جدول نقاط التلعيب المعتمد للمرشدين (Gamification Scorecard):

نوع المساهمة الميدانية	النقاط الممنوحة	طريقة التدقيق	الأثر الميداني
تأكيد بوابة أو موقف سيارات	+50 PTS	فحص جوي سريع بالأقمار الصناعية	توجيه السيارات مباشرة للمدخل الحقيقي
إضافة معلم محلي أو تراثي جديد	+100 PTS	تدقيق يدوي عبر لوحة المشرف	إثراء الخريطة السيادية بمعالم غير متوفرة تجارياً
تصحيح اسم شارع أو اتجاه	+75 PTS	فحص الاتصال بشبكة الطرق	رفع جودة التوجيه الملاحي في القرى والبوادي
توثيق حكاية أو تسجيل صوتي تراثي	+150 PTS	مراجعة محتوى وتوافق تاريخي	ربط المكان بالسردية الوطنية الأردنية

المرحلة 3: لوحة التدقيق الإدارية الخفيفة (Moderation Console)

PHASE 03 : ADMIN CONSOLE

شاشة خفيفة وسريعة جداً مبنية داخل لوحة التحكم الحالية (Vanilla JS بدون مكتبات ثقيلة)، تمكن المشرف من:

استعراض المساهمات المعلقة ومقارنتها فوراً مع صور الأقمار الصناعية.
الموافقة بضغطة زر واحدة (Approve) فتنزل النقطة فوراً في خريطة الإنتاج وتُصرف النقاط للمرشد.
الرفض مع كتابة سبب تنبيهي للمرشد (Reject with Feedback) لحماية نقاوة البيانات.

المرحلة 4: تكامل تطبيق الموبايل (Flutter - Siro Maps)

PHASE 04 : MOBILE APP

تفعيل الميزات التالية داخل كود apps/siro_maps:

مفتاح تفعيل طبقة المعالم والمسارات التراثية التكتيكية.
واجهة "اقترح تعديلاً أو أضف مكاناً" مع التقاط الإحداثية الحالية للمستخدم.
شاشة ملف المرشد الشخصي (رصيد النقاط، الرتبة، والأوسمة المكتسبة).
دعم التخزين المحلي Offline Cache لضمان العمل في المناطق النائية.

المرحلة 5: المزامنة، النشر والتحقق (Deployment & Testing)

PHASE 05 : VERIFICATION

دورة النشر الآمنة:

Run local integration tests on Mac
bash sync_to_server.sh
Execute database migration on map-db container
Rebuild API container safely: docker compose up -d --build api
Smoke test commercial B2B endpoints (Route, Geocode) -> Must return 200 OK
Verify new Heritage & Community endpoints -> Must return 200 OK
      

معاينة المخطط المعماري بوابة سيرو ماب التفاعلية