Namaa Blueprint وثائق تخطيط — لا منتج جاهز

معمارية نظام Namaa

Product Architecture

وصف هندسي مقترح لنظام Namaa — لا توثيق لنظام موجود. المبدأ الحاكم: فصل ما يجب أن يكون حتميًا عمّا يجوز أن يكون توليديًا.

[تحذير] نطاق هذه الصفحة

هذه معمارية نظام Namaa (مقترح، غير مبني). أما معمارية موقع Blueprint نفسه فهي Astro ثابت + Pagefind + Cloudflare Pages — انظر القرارات D-01 و D-03 وD-06.

النهج الهجين

الطبقات من الأعلى (ما يراه المستخدم) إلى الأدنى (ما يفرض القواعد)
الطبقة الدور النوع
مراجعة بشرية تأكيد إلزامي للإجراءات الحساسة أو غير القابلة للعكس حتمي (بوابة)
استدلال النموذج الفهم والتلخيص والاقتراح — عند الحاجة فقط توليدي
بيانات منظمة حالة النظام والذاكرة والسجل حتمي
القيود الصلبة المواعيد والحدود والصلاحيات — لا يجوز خرقه حتمي
تقييم مستمر سيناريوهات ومقاييس دورية حتمي (قياس)

المكونات بحسب الطبقة

المصدر الوحيد لهذه البيانات هو src/data/architecture.json — تعديل مكوّن أو علاقة يتم بتحرير الملف فقط، بلا لمس شيفرة العرض (FR-023).

الواجهة interface

  • صندوق الالتقاط Capture Inbox — PROPOSED
    مقترح: يستقبل المدخلات الخام (نص/ملف/حدث) بلا تفسير مبكر، ويُلحق كل عنصر بمصدره وطابعه الزمني. /core-loop

دورة العمل core-loop

  • طبقة الفهم Understanding — PROPOSED
    مقترح: تستخرج النية والكيانات والحقائق المرشحة من العنصر الخام، وتُوسم كل مرشحة بدرجة ثقة. /core-loop/research
  • حلقة المراجعة Review Loop — PROPOSED
    مقترح: تراجع النتائج وتحدّث الثقة والتفضيلات، وتنتج تقرير مراجعة دوريًا. /core-loop/evaluation

الذاكرة والسياق memory

  • مخزن الذاكرة Memory Store — PROPOSED
    مقترح: طبقات الحقائق والتفضيلات والأهداف والمهام والأحداث والسجل، مع تتبع المصدر والثقة والتقادم. /memory
  • فهرس الاسترجاع Retrieval Index — PROPOSED
    مقترح: بحث نصي/منظم فوق سجلات الذاكرة والمستندات. لا قاعدة متجهية في الإطلاق. /memory/research
  • مخزن متجهي Vector Store — FUTURE
    مستقبلي: استرجاع دلالي بالمتجهات — مؤجل حتى إثبات الحاجة، وممنوع في الإطلاق. /memory
  • باني السياق Context Builder — PROPOSED
    مقترح: يختار ما يدخل نافذة النموذج ويضغطه وفق سياسات معلنة وحدود صلبة. /context

التخطيط planning

  • المرتّب Prioritizer — PROPOSED
    مقترح: يرتب المهام بقواعد معلنة، وكل ترتيب له سبب قابل للعرض. /planning
  • القيود الصلبة Hard Constraints — PROPOSED
    مقترح: كود حتمي يفرض المواعيد والحدود والصلاحيات؛ لا يجوز للنموذج خرقه أبدًا. /planning
  • المخطِّط Planner — PROPOSED
    مقترح: يبني خطة بفترات زمنية صالحة داخل القيود الصلبة؛ الاقتراح توليدي والفرض حتمي. /planning/core-loop

الأدوات والصلاحيات tools

  • بوابة الأدوات Tool Gateway — PROPOSED
    مقترح: نقطة مرور واحدة لكل استدعاء أداة، تطبّق عقد الأداة ومبدأ أقل الصلاحيات والتأكيد البشري. /tools
  • سجل التدقيق Audit Log — PROPOSED
    مقترح: سجل إلحاقي (Append-only) لكل كتابة وتغيير؛ لا يُحذف صمتًا. /tools/memory
  • حدود الثقة Trust Boundary — PROPOSED
    مقترح: يفصل المحتوى الموثوق (تعليمات) عن غير الموثوق (مستندات مسترجعة)، ويحجر محاولات حقن التعليمات. /tools/documents

الوكلاء agents

  • مشغّل الوكيل Agent Runtime — PROPOSED
    مقترح: يشغّل وكيلًا واحدًا بمهمة وصلاحيات ومدخلات ومخرجات وتقييم معلن. تعدد الوكلاء FUTURE. /agents

حدود الثقة

يفصل النظام بين محتوى موثوق (تعليمات النظام) ومحتوى غير موثوق (مستندات مسترجعة). أي تعليمات داخل مستند غير موثوق تُحجر ولا تُنفَّذ — هذا هو الدفاع الأساسي ضد حقن التعليمات.

للتفصيل البصري والعلاقات بين المكونات: مستكشف المعمارية.