التسليم والحدود

طريقان إلى نفس الفكرة

قبل أن تبدأ

الفكرة الجوهرية

الخطوة الأخيرة أربعة أجزاء بالترتيب: اختبار الغرباء، ثم وثيقة الحدود، ثم حماية البيانات في السجلّات، ثم عرض نهائي يُظهر الأرقام والفشل معًا.

1اختبار الغرباء

النظام جاهز حين يستخدمه ثلاثة لا يعرفونك دون أن تشرح لهم. أنت تتجنّب أخطاءه دون أن تنتبه، والغريب يجدها بسرعة.

انظر إلى الرسم: ثلاثة غرباء في الصفوف وخمس مهام في الأعمدة. تراقب كل خانة بصمت وتسجّل: هل أنجز المهمة، وكم استغرق، وأين تعثّر.

خمس عشرة مهمة لا تكفي لرقم دقيق، فالمدى من 48% إلى 89%. هدفها أن تجد ما يفشل، وقد فشلت مهمة «سؤالان معًا» مع اثنين من ثلاثة.

2وثيقة الحدود

وثيقة الحدود جزء من المنتج لا اعتراف بالضعف. من يستخدم نظامك يحتاج أن يعرف متى يثق به ومتى يتحقّق بنفسه.

انظر إلى الرسم: الدقة بحسب الشريحة، وهي ما تكتبه الوثيقة بدل وعد عام بأن النظام «ذكي».

صفحة واحدة ترافق النظام، يقرؤها المستخدم قبل أن يعتمد عليه.

# Limits: shipping reply drafts for <shop name>   (v1.2, 2026-10)

Built for:     short Arabic support messages about order status
Not built for: refunds, complaints, legal questions, other languages
               beyond basic English

How well it works (150 frozen real messages, labelled by the owner):
  shipping precision   96%  (95% range 91% .. 98%)   bar: 95%
  drafts sent unedited 64%  (owner's log, 2 weeks)     bar: 60%
  keyword baseline     85%  accuracy, same set

Where it fails:
  - messages with two requests: 45% accuracy -> always routed to a human
  - Gulf dialect spelling not seen in training: ~82%
  - names and street addresses are NOT removed from logs

When unsure (confidence < 0.7) it drafts nothing and flags the message.
Data: messages kept 30 days, phones/emails/IBANs/IDs removed before
      logging, never used for training without the owner's consent.
Contact for errors: <owner email>

كل رقم بمداه، وكل ضعف معروف مكتوب مع ما يفعله النظام حياله، وما لا يُحذف من السجلّات مذكور صراحة. هذه الصفحة هي ما سيقرؤه من يقيّم مشروعك قبل الكود، وهي التي تقول إنك تفهم نظامك.

الفكرة نفسها في بطاقات النماذج (Model Cards) التي ترافق النماذج المنشورة: الاستخدام المقصود، والأداء بحسب الشريحة، والقيود المعروفة.

3الخصوصية تبدأ في السجلّات

أغلب التسرّب في المشاريع الصغيرة يأتي من سجلّات تحفظ كل رسالة كما هي. انظر إلى الرسم: كل رسالة تمرّ على دالة تنقيح قبل أن تُكتب، لا بعد.

دالة صغيرة تمرّ عليها كل رسالة قبل أن تصل للسجل: البريد، ورقم الآيبان، ورقم الجوال السعودي، ورقم الهوية.

import re

PATTERNS = [
    ("EMAIL", re.compile(r"[\w.+-]+@[\w-]+\.[\w.]+")),
    ("IBAN", re.compile(r"\bSA\d{22}\b")),
    ("PHONE", re.compile(r"(?<!\d)(?:\+?966|0)?5\d{8}(?!\d)")),
    ("NATIONAL_ID", re.compile(r"\b[12]\d{9}\b")),
]

def redact(text):
    found = []
    for name, pattern in PATTERNS:
        text, n = pattern.subn(f"[{name}]", text)
        found += [name] * n
    return text, found

logs = [
    "طلبي ما وصل، جوالي 0551234567 وإيميلي sara.m@example.com",
    "حوّلوا المبلغ على SA0380000000608010167519",
    "رقم هويتي 1012345678 وأبي أغيّر العنوان",
    "كم سعر التوصيل لأبها؟",
]
for line in logs:
    clean, found = redact(line)
    print(clean, "  <-", ", ".join(found) or "nothing")

النص يبقى مفيدًا للتحليل، فما زلت تعرف أن الرسالة عن طلب متأخر، لكن لا أحد يقرأ السجل يستطيع أن يتّصل بصاحبها. الترتيب مهم: الآيبان قبل الجوال حتى لا يلتقط نمط الجوال جزءًا من رقم الحساب. والتعابير النمطية لا تلتقط كل شيء، فالأسماء والعناوين تحتاج أدوات أقوى، ولهذا تُكتب هذه الحدود أيضًا في وثيقة الحدود.

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

4العرض النهائي

العرض يحكي القصة بترتيب ثابت. انظر إلى الرسم: المشكلة والمستخدم، ثم النظام على حالة حقيقية، ثم الأرقام مقابل المعيار وخط الأساس، ثم حالة يفشل فيها.

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

كيف يعمل، خطوة بخطوة: كيف تُجري اختبار الغرباء

أعمق قليلًا

الخصوصية تبدأ في السجلّات لا في سياسة الخصوصية. أغلب تسرّب البيانات في المشاريع الصغيرة يأتي من سجلّات تحفظ كل رسالة كما هي، أرقام جوالات وهويات وحسابات بنكية، في ملف يقرؤه كل من له وصول للخادم. احذف هذه المعلومات قبل أن تُكتب، لا بعد. وإن كانت بيانات أشخاص في الاتحاد الأوروبي، أو في السعودية تحت نظام حماية البيانات الشخصية، فهناك التزامات قانونية بالموافقة والحذف عند الطلب.

مثال محلول

أنت تعرف كيف «يجب» أن يُستخدم نظامك، فتتجنّب أخطاءه دون أن تشعر. الغريب لا يعرف، فيجد الأخطاء بسرعة. ثلاثة مستخدمين، خمس مهام لكل منهم، وأنت تراقب صامتًا وتكتب: هل أنجز المهمة، وكم استغرق.

١. نتائج اختبار الغرباء

import math

def wilson(k, n, z=1.96):
    p = k / n
    c = (p + z * z / (2 * n)) / (1 + z * z / n)
    h = z * math.sqrt(p * (1 - p) / n + z * z / (4 * n * n)) / (1 + z * z / n)
    return c - h, c + h

# three strangers, five tasks each, observed without help
sessions = {
    "user A": [("track order", True, 40), ("ask about size", True, 25), ("return item", False, 180),
               ("report damage", True, 60), ("two questions at once", False, 150)],
    "user B": [("track order", True, 30), ("ask about size", True, 20), ("return item", True, 90),
               ("report damage", True, 45), ("two questions at once", False, 200)],
    "user C": [("track order", True, 35), ("ask about size", False, 120), ("return item", True, 70),
               ("report damage", True, 50), ("two questions at once", True, 110)],
}

tasks = [t for s in sessions.values() for t in s]
done = sum(ok for _, ok, _ in tasks)
low, high = wilson(done, len(tasks))
print(f"tasks completed: {done}/{len(tasks)} = {done / len(tasks):.0%}  (95% range {low:.0%} .. {high:.0%})")

failed_on = {}
for user, s in sessions.items():
    for name, ok, _ in s:
        if not ok:
            failed_on.setdefault(name, []).append(user)
print("failures by task:")
for name, users in sorted(failed_on.items(), key=lambda kv: -len(kv[1])):
    print(f"  {name:<22} {len(users)}/3  ({', '.join(users)})")

أحد عشر من خمس عشرة مهمة، لكن المدى من 48% إلى 89%، فخمس عشرة مهمة لا تكفي لرقم دقيق، وليس هذا هدفها. هدفها أن تجد ما يفشل: مهمة «سؤالان معًا» فشلت مع اثنين من ثلاثة، وهي نفس الشريحة التي ظهرت في تحليل الأخطاء. حين يتّفق التقييم الآلي ومستخدمون حقيقيون على نفس الضعف، فهذا أهم سطر في وثيقة الحدود.

جرّب بلا كود

خرافة مقابل حقيقة

جرّب بنفسك

بطاقات مراجعة سريعة

تحقق من فهمك