محامي نفسك
منصة سعودية تساعد المستخدم على فهم موقفه النظامي وترتيب خطواته، عبر أدوات أسئلة وأجوبة مبنية على محركات قرار مُدارة ومراجَعة قانونيًا.
التشغيل
npm install
cp .env.example .env.local # ثم عدّل القيم
npm run dev
الموقع: http://localhost:3000 · لوحة الإدارة: http://localhost:3000/admin
متغيّرات البيئة
| المتغيّر | الغرض |
|---|
ADMIN_PASSWORD | كلمة مرور لوحة الإدارة — غيّرها قبل النشر |
ADMIN_SESSION_SECRET | مفتاح توقيع جلسة الإدارة (نص عشوائي طويل) |
NEXT_PUBLIC_SITE_URL | عنوان الموقع |
لا توجد أي مفاتيح داخل كود الواجهة.
البنية
app/ الصفحات العامة + لوحة الإدارة + مسارات API
components/ مكوّنات الواجهة (بلا أي منطق قانوني)
lib/ store · engine (مشغّل القرار) · custody (وحدة الحضانة) · hijri · auth · analytics
types/ تعريفات كل الكيانات
data/ البيانات — منفصلة تمامًا عن الكود
engines/ محرك لكل ملف (أدوات شجرة الأسئلة)
engine-versions/ أرشيف الإصدارات السابقة
modules/ قواعد الوحدات البرمجية
مبدأ الفصل
الأسئلة والقواعد والنتائج والمصادر النظامية لا توجد داخل كود الواجهة إطلاقًا. كلها في data/engines/*.json. يمكن تعديل شجرة القرار أو إنشاء نسخة جديدة منها دون لمس تصميم الموقع.
عند الانتقال إلى قاعدة بيانات حقيقية، التغيير محصور في lib/store.ts وحده.
محركات القرار
كل محرك يحمل: معرّفًا ثابتًا، اسمًا، مجالًا قانونيًا، أسئلة وخيارات، مسارًا تاليًا لكل إجابة، شروط ظهور، نتائج، أسباب النتيجة، الوقائع الناقصة، المصادر النظامية، تاريخ آخر مراجعة، اسم المراجع، رقم الإصدار، الحالة (مسودة/تحت المراجعة/منشور/موقوف)، مدة سريان الإصدار، وسجل تعديلات.
فحص السلامة: lib/engine.ts يتحقق قبل النشر من ترابط الشجرة — فروع تشير إلى عناصر غير موجودة، نتائج غير قابلة للوصول، نتائج بلا مصدر، مصادر غير متحقق منها، مراجعة قانونية ناقصة. النتائج تظهر في صفحة المحرك داخل لوحة الإدارة.
الإصدارات: تغيير رقم الإصدار يؤرشف الإصدار الحالي في data/engine-versions/ تلقائيًا ويضيف قيدًا في سجل التعديلات، فيبقى الرجوع ممكنًا.
كاشف نوع مدة العقد (engine-contract-type)
يوجّه المستخدم إلى نوع مدة عقده، بثلاثة أنواع نتائج: محدد المدة · غير محدد المدة · تحتاج مراجعة محامٍ.
غير السعودي (م.37): العقد يجب أن يكون مكتوبًا ومحدد المدة.
- خلا من بيان المدة → مدته سنة من تاريخ المباشرة الفعلية.
- استمر العمل بعد انتهاء المدة → تجدّد لمدة مماثلة (ويبقى محدد المدة).
السعودي (م.55):
- نص صريح بأنه غير محدد → غير محدد.
- لا مدة ولا نص على التحديد → غير محدد.
- انقضت المدة واستمر الطرفان في التنفيذ → تحوّل إلى غير محدد (55/1).
- شرط تجديد + ثلاث تجديدات متتالية أو أربع سنوات أيهما أقل مع استمرار التنفيذ → تحوّل إلى غير محدد (55/2).
- غير ذلك → محدد المدة.
«غير متأكد» في أي سؤال → مراجعة محامٍ، ولا يُصدر الكاشف نتيجة عندئذٍ.
المادة 77 مرفقة مع نتائج التكييف: التعويض في غير محدد المدة أجر 15 يومًا عن كل سنة خدمة، وفي محدد المدة أجر المدة الباقية، وبحد أدنى أجر شهرين.
المحرك بحالة مسودة، ويظهر للمستخدم بتنبيه واضح.
الهوية البصرية
مؤسسة قانونية هادئة: مساحات واسعة، حبر كحلي، ولون تمييز واحد هو الذهبي. الألوان التسعة والخطوط معرّفة في مكان واحد: app/globals.css (--bg --surface --ink --ink-2 --gold --gold-soft --text --muted --line)، وسلالم Tailwind (brand-* gold-* slate-*) موجّهة إليها، فيتغيّر الموقع كله من ذلك الملف. ألوان الحالة (أخضر/أصفر/أحمر) محصورة في نتائج الكواشف لأنها تحمل معنى قانونيًا.
الخط: IBM Plex Sans Arabic للواجهة، وNoto Kufi Arabic لاسم المنصة بجانب الشعار.
الشعار: درع ذهبي بداخله ميزان تمسك عموده قبضة — المستخدم يمسك ميزان العدل بيده. يُعرض على خلفية الحبر (الرأس والتذييل). المصادر في brand/ (الأصل في brand/original، والمشتقات في brand/option-3)، وما يستخدمه الموقع في public/brand وapp/icon.png. المكوّن: components/Logo.tsx.
الخطاب: يُخاطَب الزائر بصيغة المذكّر دائمًا. أما مطابقة التذكير والتأنيث داخل النتائج (الأم/الجدة) فتتبع القاعدة النحوية.
قاعدة تصميم الأدوات: كل أداة «كاشف» يوجّه ولا يحكم
كل أداة في المنصة تجيب عن سؤال واحد محدد وتوجّه المستخدم إلى موقفه النظامي مع مستنده — لا «موجّه مسار» يسرد الخيارات دون أن يصل إلى شيء. وإذا لم تكفِ المعطيات فالمخرج الصريح هو «تحتاج مراجعة محامٍ»، لا نتيجة مظنونة.
لكن المنصة لا تحكم ولا تُصدر قرارًا. النتيجة استرشادية دائمًا: تبيّن ما يقضي به النظام في الغالب بناءً على ما أدخله المستخدم، وللقضاء أن يخالفها. ولذلك يُمنع في نصوص الواجهة استعمال ألفاظ الحسم والقطع («تحسم»، «نتيجة قاطعة»، «المستحق للحضانة» مجردة)، ويُستعمل بدلها: يوجّهك، استرشادية، غالبًا، مع التذكير بأنها لا تُغني عن استشارة محامٍ مرخّص.
الوحدات البرمجية (kind: "module")
بعض الأدوات لا تكفيها شجرة أسئلة خطية: تحتاج حسابات، أو مخرجات متعددة، أو مصفوفة مرشّحين. هذه تُبنى كوحدة لها كود مخصّص، مع بقاء نصوصها وحدودها ومواد استنادها بيانات في data/modules/.
كاشف مستحق الحضانة (custody-checker)
يحدّد المستحق للحضانة لكل محضون على حدة، وفق نظام الأحوال الشخصية (المواد 124–135):
- الترتيب (م.127): الأم ← الأب ← الجدة (أم الأم) ← الجدة (أم الأب) ← ثم تقرر المحكمة. وللمحكمة العدول عن الترتيب لمصلحة المحضون.
- شروط الحاضن (م.125): كمال الأهلية، القدرة على التربية والحفظ والرعاية، السلامة من الأمراض المعدية الخطيرة.
- شروط إضافية (م.126): للمرأة ألا تكون متزوجة برجل أجنبي عن المحضون، وللرجل أن يقيم عنده من يصلح للحضانة من النساء.
- أسباب السقوط (م.128): تخلّف شروط (125) و(126)، الانتقال إلى مكان تفوت به مصلحة المحضون، السكوت عن المطالبة أكثر من سنة دون عذر.
- م.131: عند عدم مطالبة أحد — الأم لمن لا يتجاوز العامين، والأب لمن تجاوزها.
- م.132: لا والدين ولا قابل للحضانة → تختار المحكمة من الأقارب أو جهة مؤهلة.
- م.135: الاختيار عند إتمام الخامسة عشرة · انتهاء الحضانة بإتمام الثامنة عشرة · استمرارها لغير القادر على رعاية نفسه.
- م.33 من اللائحة التنفيذية: من لم يتجاوز العامين فحضانته للأم ولو تزوجت من رجل أجنبي عنه. الإعفاء مقصور على الأم دون الجدتين، وعلى شرط الزواج بأجنبي وحده — فشروط م.125 وأسباب السقوط في م.128 تبقى على إعمالها.
استثناء مصلحة المحضون: سببان يجوز للمحكمة استثناؤهما — زواج الحاضنة (126/1) والسكوت عن المطالبة (128/3) — ويظهران للمستخدم موسومين بذلك.
تنبيه للمطوّر: أحكام الحضانة موزّعة بين النظام واللائحة التنفيذية. لا يكفي الرجوع إلى النظام وحده — فقاعدة العامين ليست فيه بل في اللائحة.
«غير متأكد» لا تُرجَّح ضد صاحبها، بل تُسجَّل كنقطة تحتاج تحققًا وتُرفع راية مراجعة محامٍ.
الأعمار تُحسب بالسنوات الهجرية (تقويم أم القرى) في lib/hijri.ts.
الوحدة بحالة مسودة بانتظار اعتماد المراجع القانوني. تُدار حوكمتها من /admin/engines.
الخصوصية — مطبّقة في الكود لا في السياسة فقط
- إجابات الأدوات تبقى في المتصفح ولا تُرسل إلى الخادم إطلاقًا.
/api/track يقبل أحداثًا من قوائم مغلقة فقط (lib/metrics-schema.ts)، فلا يمكن تسريب نص حر أو إجابة./api/referral يتجاهل sharedSummary عمدًا — المنصة لا تنقل ملخص القضية.- رسالة واتساب الأولى تحمل الحد الأدنى فقط، وتسبقها شاشة موافقة صريحة منفصلة.
- الأدوات لا تطلب اسمًا ولا هوية ولا رقم قضية ولا أسماء أطفال.
قياس السلوك — عدّ مجمّع فقط
دالة واحدة في المتصفح track(event, props) (lib/track.ts) ترسل إلى /api/track، والخادم يزيد عدّاد اليوم في جدول واحد:
metrics_daily (date, event, props_json, count) -- المفتاح: (date, event, props_json)
- لا يُحفظ صف لكل حدث: لا توقيت دقيق، ولا تسلسل أحداث، ولا كوكي تتبّع، ولا معرّف زائر أو جلسة، ولا عنوان IP.
- لا تُسجَّل إجابات أحد: خطوات القمع تُسجَّل برقم ترتيبها لا بمعرّف السؤال (معرّف السؤال في شجرة القرار يكشف الإجابات السابقة)، ونتيجة الكاشف لا تُسجَّل.
- الأحداث والخصائص والقيم المسموحة كلها في
lib/metrics-schema.ts. أي قيمة خارج القوائم ترفض الحدث كله. لإضافة حدث جديد يُضاف هناك أولًا.
- الاحتفاظ 12 شهرًا ثم حذف تلقائي. حدّ الطلبات يستخدم بصمة مشفّرة للعنوان تنتهي بانتهاء نافذة الحد ولا تدخل الجدول.
- التخزين: جدول في القاعدة السحابية، وملف
data/metrics.json بديلًا محليًا غير مرفوع.
- لوحة الإدارة ← «السلوك»: المصادر، القمع، الاحتياجات، المحتوى، المحامون (مع تقرير شهري قابل للطباعة PDF)، الجودة (وفيها فحص حيّ لخصوصية الجدول)، الاستخدام.
عدّاد الاستخدام العام «استُخدمت X مرة» على بطاقة كل أداة وصفحتها: يُحتسب الاستخدام مرة لكل تبويب متصفح (بدء الكاشف الداخلي، أو فتح الخدمة الخارجية)، فتحديث الصفحة لا يزيده. يبدأ من صفر فعليًا ولا يوجد حقل لإدخال رقم. لا يظهر قبل الحد الأدنى (افتراضيًا 20، يُغيَّر من تبويب «الاستخدام») ويمكن إخفاؤه لكل أداة. القراءة العامة: /api/tools/{slug}/uses (مخزّنة مؤقتًا 10 دقائق).
الاختبار: node scripts/metrics-privacy.test.mjs للمخطط، ومع عنوان خادم محلي للاختبار الحي (حمولات خبيثة، كوكي وعنوان مزروعان، تزامن، ثم فحص كل صف مخزَّن).
الإعلانات
ثلاثة أنواع منفصلة: google / lawyer / sponsor. كل إعلان يحمل علامة «إعلان» أو «محتوى مدفوع» ظاهرة، ومعزول بصريًا.
قاعدة مفروضة في الكود: إعلانات Google محجوبة في أي أداة allowGoogleAds = false (الحضانة وفسخ النكاح مثلًا) حتى لو أُضيف الإعلان من اللوحة. صفحة النتيجة تبقى نظيفة.
المحامي المعلن (sponsored) والترشيح غير المدفوع (recommended) مميّزان بشارتين مختلفتين دائمًا.
ربط المحامين
علاقة متعدد-إلى-متعدد عبر lawyer-assignments: المحامي الواحد بعدة أدوات، والأداة الواحدة بعدة محامين، مع تخصيص بحسب النتيجة والمنطقة والمدينة ونوع القضية، ومدة إعلانية، وأولوية ظهور، وإيقاف دون حذف البيانات.
الأمان
- لوحة الإدارة مفصولة عن الواجهة العامة، وممنوعة من الفهرسة (
X-Robots-Tag).
- جلسة موقّعة HMAC، تنتهي تلقائيًا بعد 4 ساعات، ومقارنة كلمة المرور ثابتة الزمن.
- حد لمحاولات الدخول (5 محاولات / 15 دقيقة).
- كل عملية إضافة أو تعديل أو نشر أو حذف تُسجَّل في
audit-log.
- عرض المحتوى بلا
dangerouslySetInnerHTML — لا مجال لحقن HTML من المقالات.
- التحويلات الخارجية مقصورة على
http/https — يمنع javascript: وdata:.
- رؤوس
X-Frame-Options وX-Content-Type-Options وReferrer-Policy.
قبل النشر الحقيقي
- غيّر
ADMIN_PASSWORD وADMIN_SESSION_SECRET إلى قيم قوية.
- فعّل المصادقة الثنائية (الحقول جاهزة في
AdminUser).
- أكمل المراجعة القانونية لكل محرك وسجّل المراجع والتاريخ قبل تغيير الحالة إلى «منشور».
- أكمل أرقام المواد وروابط المصادر الرسمية وعلّم «تم التحقق».
- فعّل HTTPS، وشغّل نسخًا احتياطيًا دوريًا لمجلد
data وجرّب الاستعادة فعليًا.
- أنشئ بيئة تجريبية منفصلة عن الموقع الحقيقي.
