Hamza/maps-saas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: add Jordan 3D topographic platform, Siro Map cinematic orbit studio, sun-shadow simulation, and sovereign intelligence security gating

Browse Source
This commit is contained in:
Hamza-Ayed
2026-09-19 12:34:26 +03:00
parent 91e9e71ce4
commit 0bf13824c9
180 changed files with 245224 additions and 704 deletions
Download Patch File Download Diff File Expand all files Collapse all files
apps/dashboard/uruk-guides-plan.html
+457
View File
@@ -0,0 +1,457 @@
<!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>