458 lines
16 KiB
HTML
458 lines
16 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="ar" dir="rtl">
|
|
<head>
|
|
<meta charset="UTF-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
<title>خطة العمل التنفيذية والهندسية | سيرو ماب ونظام المرشدين المحليين</title>
|
|
<link rel="preconnect" href="https://fonts.googleapis.com">
|
|
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
|
|
<link href="https://fonts.googleapis.com/css2?family=Tajawal:wght@400;500;700;800;900&family=JetBrains+Mono:wght@400;600;700&display=swap" rel="stylesheet">
|
|
<style>
|
|
:root {
|
|
--bg-base: #0a0f1d;
|
|
--bg-surface: #111827;
|
|
--bg-card: #1e293b;
|
|
--border-subtle: rgba(255, 255, 255, 0.08);
|
|
--border-accent: rgba(56, 189, 248, 0.3);
|
|
--text-primary: #f8fafc;
|
|
--text-secondary: #94a3b8;
|
|
--accent-cyan: #38bdf8;
|
|
--accent-emerald: #10b981;
|
|
--accent-gold: #f59e0b;
|
|
--accent-purple: #a855f7;
|
|
--accent-rose: #f43f5e;
|
|
}
|
|
|
|
* {
|
|
box-sizing: border-box;
|
|
margin: 0;
|
|
padding: 0;
|
|
}
|
|
|
|
body {
|
|
background-color: var(--bg-base);
|
|
color: var(--text-primary);
|
|
font-family: 'Tajawal', sans-serif;
|
|
line-height: 1.8;
|
|
padding: 2.5rem 1.25rem;
|
|
}
|
|
|
|
.container {
|
|
max-width: 1180px;
|
|
margin: 0 auto;
|
|
}
|
|
|
|
header {
|
|
text-align: center;
|
|
margin-bottom: 3rem;
|
|
padding-bottom: 2rem;
|
|
border-bottom: 1px solid var(--border-subtle);
|
|
}
|
|
|
|
.badge {
|
|
display: inline-block;
|
|
padding: 0.35rem 1.2rem;
|
|
background: rgba(56, 189, 248, 0.1);
|
|
color: var(--accent-cyan);
|
|
border: 1px solid rgba(56, 189, 248, 0.3);
|
|
border-radius: 9999px;
|
|
font-size: 0.85rem;
|
|
font-weight: 800;
|
|
margin-bottom: 1rem;
|
|
letter-spacing: 0.5px;
|
|
}
|
|
|
|
h1 {
|
|
font-size: 2.3rem;
|
|
font-weight: 900;
|
|
color: #ffffff;
|
|
margin-bottom: 0.75rem;
|
|
line-height: 1.3;
|
|
}
|
|
|
|
.subtitle {
|
|
color: var(--text-secondary);
|
|
font-size: 1.1rem;
|
|
max-width: 850px;
|
|
margin: 0 auto;
|
|
}
|
|
|
|
.pillar-grid {
|
|
display: grid;
|
|
grid-template-columns: repeat(auto-fit, minmax(320px, 1fr));
|
|
gap: 1.5rem;
|
|
margin-bottom: 3rem;
|
|
}
|
|
|
|
.pillar-card {
|
|
background: var(--bg-surface);
|
|
border: 1px solid var(--border-subtle);
|
|
border-radius: 14px;
|
|
padding: 1.75rem;
|
|
position: relative;
|
|
}
|
|
|
|
.pillar-card.highlight {
|
|
border-color: var(--accent-cyan);
|
|
box-shadow: 0 10px 30px -10px rgba(56, 189, 248, 0.15);
|
|
}
|
|
|
|
.pillar-icon {
|
|
width: 44px;
|
|
height: 44px;
|
|
border-radius: 10px;
|
|
display: flex;
|
|
align-items: center;
|
|
justify-content: center;
|
|
margin-bottom: 1rem;
|
|
font-weight: 900;
|
|
font-size: 1.2rem;
|
|
}
|
|
|
|
.pillar-title {
|
|
font-size: 1.2rem;
|
|
font-weight: 800;
|
|
color: #ffffff;
|
|
margin-bottom: 0.5rem;
|
|
}
|
|
|
|
.pillar-desc {
|
|
color: var(--text-secondary);
|
|
font-size: 0.95rem;
|
|
}
|
|
|
|
.section-title {
|
|
font-size: 1.6rem;
|
|
font-weight: 900;
|
|
color: #ffffff;
|
|
margin-bottom: 1.5rem;
|
|
display: flex;
|
|
align-items: center;
|
|
gap: 0.75rem;
|
|
border-right: 4px solid var(--accent-cyan);
|
|
padding-right: 0.75rem;
|
|
}
|
|
|
|
.phase-box {
|
|
background: var(--bg-surface);
|
|
border: 1px solid var(--border-subtle);
|
|
border-radius: 14px;
|
|
padding: 2rem;
|
|
margin-bottom: 2rem;
|
|
}
|
|
|
|
.phase-header {
|
|
display: flex;
|
|
justify-content: space-between;
|
|
align-items: center;
|
|
margin-bottom: 1.25rem;
|
|
flex-wrap: wrap;
|
|
gap: 0.75rem;
|
|
}
|
|
|
|
.phase-num {
|
|
background: rgba(16, 185, 129, 0.15);
|
|
color: var(--accent-emerald);
|
|
border: 1px solid rgba(16, 185, 129, 0.3);
|
|
padding: 0.25rem 0.75rem;
|
|
border-radius: 6px;
|
|
font-weight: 800;
|
|
font-size: 0.85rem;
|
|
font-family: 'JetBrains Mono', monospace;
|
|
}
|
|
|
|
.phase-name {
|
|
font-size: 1.35rem;
|
|
font-weight: 800;
|
|
color: #ffffff;
|
|
}
|
|
|
|
.code-block {
|
|
direction: ltr;
|
|
text-align: left;
|
|
background: #070b14;
|
|
border: 1px solid var(--border-subtle);
|
|
border-radius: 8px;
|
|
padding: 1.25rem;
|
|
font-family: 'JetBrains Mono', monospace;
|
|
font-size: 0.85rem;
|
|
color: #38bdf8;
|
|
overflow-x: auto;
|
|
margin: 1.25rem 0;
|
|
line-height: 1.6;
|
|
}
|
|
|
|
table {
|
|
width: 100%;
|
|
border-collapse: collapse;
|
|
margin: 1.5rem 0;
|
|
font-size: 0.95rem;
|
|
}
|
|
|
|
th, td {
|
|
padding: 0.9rem 1rem;
|
|
text-align: right;
|
|
border-bottom: 1px solid var(--border-subtle);
|
|
}
|
|
|
|
th {
|
|
background: rgba(255, 255, 255, 0.03);
|
|
color: var(--accent-cyan);
|
|
font-weight: 800;
|
|
}
|
|
|
|
td {
|
|
color: var(--text-secondary);
|
|
}
|
|
|
|
td strong {
|
|
color: #ffffff;
|
|
}
|
|
|
|
.badge-point {
|
|
display: inline-block;
|
|
padding: 0.2rem 0.6rem;
|
|
background: rgba(245, 158, 11, 0.15);
|
|
color: var(--accent-gold);
|
|
border-radius: 6px;
|
|
font-weight: 800;
|
|
font-family: 'JetBrains Mono', monospace;
|
|
direction: ltr;
|
|
}
|
|
|
|
.actions {
|
|
display: flex;
|
|
justify-content: center;
|
|
gap: 1rem;
|
|
margin-top: 3rem;
|
|
}
|
|
|
|
.btn {
|
|
display: inline-flex;
|
|
align-items: center;
|
|
gap: 0.5rem;
|
|
padding: 0.85rem 1.75rem;
|
|
border-radius: 10px;
|
|
font-weight: 800;
|
|
text-decoration: none;
|
|
font-size: 1rem;
|
|
transition: all 0.2s ease;
|
|
}
|
|
|
|
.btn-primary {
|
|
background: #0284c7;
|
|
color: #ffffff;
|
|
}
|
|
|
|
.btn-primary:hover {
|
|
background: #0369a1;
|
|
}
|
|
|
|
.btn-secondary {
|
|
background: var(--bg-card);
|
|
color: var(--text-primary);
|
|
border: 1px solid var(--border-subtle);
|
|
}
|
|
|
|
.btn-secondary:hover {
|
|
background: #334155;
|
|
}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
|
|
<div class="container">
|
|
<header>
|
|
<div class="badge">SIRO MAPS MASTER ROADMAP & ARCHITECTURE</div>
|
|
<h1>خطة العمل التنفيذية والهندسية: منظومة سيرو ماب</h1>
|
|
<p class="subtitle">
|
|
بناء المسارات التراثية ونظام المرشدين المحليين (Local Guides) مع التدقيق اليدوي ومحرك التلعيب، مع ضمان العزل التام للخدمات التجارية القائمة.
|
|
</p>
|
|
</header>
|
|
|
|
<!-- Operating Principles -->
|
|
<div class="pillar-grid">
|
|
<div class="pillar-card highlight">
|
|
<div class="pillar-icon" style="background: rgba(56, 189, 248, 0.15); color: var(--accent-cyan);">1</div>
|
|
<div class="pillar-title">الكتابة على الماك والبناء على السيرفر</div>
|
|
<div class="pillar-desc">
|
|
تطوير الكود واختباره محلياً في بيئة العمل الصارمة، ثم المزامنة التكتيكية مع خادم الإنتاج عبر سكريبت المزامنة الجاهز.
|
|
</div>
|
|
</div>
|
|
|
|
<div class="pillar-card highlight">
|
|
<div class="pillar-icon" style="background: rgba(16, 185, 129, 0.15); color: var(--accent-emerald);">2</div>
|
|
<div class="pillar-title">عزل تام لخدمات الإنتاج (Zero Risk)</div>
|
|
<div class="pillar-desc">
|
|
محرك الملاحة GraphHopper، والبحث الجغرافي B2B، وتتبع السائقين، والفوترة تبقى معزولة تماماً بنسبة 100% دون أي تعديل.
|
|
</div>
|
|
</div>
|
|
|
|
<div class="pillar-card highlight">
|
|
<div class="pillar-icon" style="background: rgba(245, 158, 11, 0.15); color: var(--accent-gold);">3</div>
|
|
<div class="pillar-title">التلعيب والتدقيق اليدوي الصارم</div>
|
|
<div class="pillar-desc">
|
|
نظام مرشدين وطني يمنح نقاطاً وأوسمة للمساهمات، ولكن لا يُنشر أي تعديل للخريطة إلا بعد موافقة المشرف من لوحة التحكم.
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Phase 1 -->
|
|
<div class="phase-box">
|
|
<div class="phase-header">
|
|
<div class="phase-name">المرحلة 1: البنية التحتية والمخططات المعزولة في PostGIS</div>
|
|
<div class="phase-num">PHASE 01 : DATABASE</div>
|
|
</div>
|
|
<p style="color: var(--text-secondary); margin-bottom: 1rem;">
|
|
إنشاء مخططي <code>heritage</code> و <code>community</code> داخل نفس قاعدة البيانات لتجنب استهلاك الذاكرة، مع ضمان سرعة الربط المكاني اللحظي عبر خادم مارتن للبلاطات الشعاعية.
|
|
</p>
|
|
|
|
<div class="code-block">
|
|
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'
|
|
);
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Phase 2 -->
|
|
<div class="phase-box">
|
|
<div class="phase-header">
|
|
<div class="phase-name">المرحلة 2: الوحدات المستقلة في خادم التطبيقات (NestJS Modules)</div>
|
|
<div class="phase-num">PHASE 02 : BACKEND API</div>
|
|
</div>
|
|
<p style="color: var(--text-secondary); margin-bottom: 1rem;">
|
|
بناء موديولين معزولين تماماً داخل <code>apps/api</code>:
|
|
</p>
|
|
<ul style="color: var(--text-secondary); padding-right: 1.5rem; margin-bottom: 1.25rem;">
|
|
<li><code>HeritageModule</code>: لخدمة المعالم، المسارات الستة، والملفات الصوتية.</li>
|
|
<li><code>CommunityModule</code>: لإدارة نقاط المرشدين، لوحة المتصدرين، وتلقي المساهمات.</li>
|
|
</ul>
|
|
|
|
<h4 style="color: var(--accent-gold); margin-top: 1.5rem; margin-bottom: 0.5rem;">جدول نقاط التلعيب المعتمد للمرشدين (Gamification Scorecard):</h4>
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>نوع المساهمة الميدانية</th>
|
|
<th>النقاط الممنوحة</th>
|
|
<th>طريقة التدقيق</th>
|
|
<th>الأثر الميداني</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><strong>تأكيد بوابة أو موقف سيارات</strong></td>
|
|
<td><span class="badge-point">+50 PTS</span></td>
|
|
<td>فحص جوي سريع بالأقمار الصناعية</td>
|
|
<td>توجيه السيارات مباشرة للمدخل الحقيقي</td>
|
|
</tr>
|
|
<tr>
|
|
<td><strong>إضافة معلم محلي أو تراثي جديد</strong></td>
|
|
<td><span class="badge-point">+100 PTS</span></td>
|
|
<td>تدقيق يدوي عبر لوحة المشرف</td>
|
|
<td>إثراء الخريطة السيادية بمعالم غير متوفرة تجارياً</td>
|
|
</tr>
|
|
<tr>
|
|
<td><strong>تصحيح اسم شارع أو اتجاه</strong></td>
|
|
<td><span class="badge-point">+75 PTS</span></td>
|
|
<td>فحص الاتصال بشبكة الطرق</td>
|
|
<td>رفع جودة التوجيه الملاحي في القرى والبوادي</td>
|
|
</tr>
|
|
<tr>
|
|
<td><strong>توثيق حكاية أو تسجيل صوتي تراثي</strong></td>
|
|
<td><span class="badge-point">+150 PTS</span></td>
|
|
<td>مراجعة محتوى وتوافق تاريخي</td>
|
|
<td>ربط المكان بالسردية الوطنية الأردنية</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<!-- Phase 3 -->
|
|
<div class="phase-box">
|
|
<div class="phase-header">
|
|
<div class="phase-name">المرحلة 3: لوحة التدقيق الإدارية الخفيفة (Moderation Console)</div>
|
|
<div class="phase-num">PHASE 03 : ADMIN CONSOLE</div>
|
|
</div>
|
|
<p style="color: var(--text-secondary); margin-bottom: 1rem;">
|
|
شاشة خفيفة وسريعة جداً مبنية داخل لوحة التحكم الحالية (Vanilla JS بدون مكتبات ثقيلة)، تمكن المشرف من:
|
|
</p>
|
|
<ul style="color: var(--text-secondary); padding-right: 1.5rem;">
|
|
<li>استعراض المساهمات المعلقة ومقارنتها فوراً مع صور الأقمار الصناعية.</li>
|
|
<li>الموافقة بضغطة زر واحدة (Approve) فتنزل النقطة فوراً في خريطة الإنتاج وتُصرف النقاط للمرشد.</li>
|
|
<li>الرفض مع كتابة سبب تنبيهي للمرشد (Reject with Feedback) لحماية نقاوة البيانات.</li>
|
|
</ul>
|
|
</div>
|
|
|
|
<!-- Phase 4 -->
|
|
<div class="phase-box">
|
|
<div class="phase-header">
|
|
<div class="phase-name">المرحلة 4: تكامل تطبيق الموبايل (Flutter - Siro Maps)</div>
|
|
<div class="phase-num">PHASE 04 : MOBILE APP</div>
|
|
</div>
|
|
<p style="color: var(--text-secondary); margin-bottom: 1rem;">
|
|
تفعيل الميزات التالية داخل كود <code>apps/siro_maps</code>:
|
|
</p>
|
|
<ul style="color: var(--text-secondary); padding-right: 1.5rem;">
|
|
<li>مفتاح تفعيل طبقة المعالم والمسارات التراثية التكتيكية.</li>
|
|
<li>واجهة "اقترح تعديلاً أو أضف مكاناً" مع التقاط الإحداثية الحالية للمستخدم.</li>
|
|
<li>شاشة ملف المرشد الشخصي (رصيد النقاط، الرتبة، والأوسمة المكتسبة).</li>
|
|
<li>دعم التخزين المحلي Offline Cache لضمان العمل في المناطق النائية.</li>
|
|
</ul>
|
|
</div>
|
|
|
|
<!-- Phase 5 -->
|
|
<div class="phase-box">
|
|
<div class="phase-header">
|
|
<div class="phase-name">المرحلة 5: المزامنة، النشر والتحقق (Deployment & Testing)</div>
|
|
<div class="phase-num">PHASE 05 : VERIFICATION</div>
|
|
</div>
|
|
<p style="color: var(--text-secondary); margin-bottom: 1rem;">
|
|
دورة النشر الآمنة:
|
|
</p>
|
|
<div class="code-block">
|
|
1. Run local integration tests on Mac
|
|
2. bash sync_to_server.sh
|
|
3. Execute database migration on map-db container
|
|
4. Rebuild API container safely: docker compose up -d --build api
|
|
5. Smoke test commercial B2B endpoints (Route, Geocode) -> Must return 200 OK
|
|
6. Verify new Heritage & Community endpoints -> Must return 200 OK
|
|
</div>
|
|
</div>
|
|
|
|
<div class="actions">
|
|
<a href="/architecture-diagram.html" class="btn btn-secondary">
|
|
<svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M19 12H5M12 19l-7-7 7-7"/></svg>
|
|
معاينة المخطط المعماري
|
|
</a>
|
|
<a href="/siro-maps.html" class="btn btn-primary">
|
|
بوابة سيرو ماب التفاعلية
|
|
<svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M5 12h14M12 5l7 7-7 7"/></svg>
|
|
</a>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
</body>
|
|
</html>
|