⌘K
HN
HN Foundation

Principles, Governance & the Architecture Bible

The official reference every human and every AI agent must read before touching HN Platform.

Overview Architecture Bible
HN Platform Architecture Bible
Version 1.0 — The Digital Operating System of HN Ecosystem

HN Platform Architecture Bible v1.0 هذا المستند هو المرجع الرسمي لبناء HN Platform. قبل كتابة أي سطر برمجي أو إنشاء أي صفحة أو أي قاعدة بيانات أو أي واجهة مستخدم، يجب قراءة هذا المستند بالكامل. كل ما يرد في هذا المستند يمثل القرارات المعمارية الرسمية للمشروع. لا تقم بإعادة تفسيرها أو تبسيطها أو حذفها. إذا احتجت إلى اقتراح تحسين، فاقترحه دون مخالفة هذه الوثيقة. الهدف هو بناء منصة يمكنها أن تنمو لعشرات التطبيقات والخدمات دون الحاجة إلى إعادة هيكلة المشروع مستقبلاً.

Table of Contents
  1. Chapter 01
    Philosophy · الفلسفة
    لماذا وُجدت HN Platform، ما المشكلة التي تحلّها، وعلاقتها بـ Foundation و AI و Nawat.
  2. Chapter 02
    Digital Ecosystem · المنظومة الرقمية
    الخريطة الكاملة: Foundation → Nawat → AI → Platform → Applications.
  3. Chapter 03
    Digital Architecture · المعمار الرقمي
    الطبقات التقنية: Frontend, Backend, DB, AI, Security, Cloud, Search, Memory, Automation, Monitoring.
  4. Chapter 04
    Core Engine (HN Core) · المحرّك الأساسي
    الهوية، المستخدمون، الصلاحيات، الأحداث، والتنسيق بين التطبيقات.
  5. Chapter 05
    Applications · التطبيقات
    دور كل تطبيق، البيانات التي يستهلكها وينتجها، وعلاقاته بالبقيّة.
  6. Chapter 06
    Data Architecture · معمار البيانات
    كل كيان، حقوله، علاقاته، فهارسه، صلاحياته، ودورة حياته.
  7. Chapter 07
    User Experience · تجربة المستخدم
    التنقّل، البحث، فتح مشروع، الحركة، الرسائل، الإحساس.
  8. Chapter 08
    Design Language · لغة التصميم
    زجاج، ضباب، إضاءة، جسيمات، حركة، خطوط، بطاقات، انتقالات، وصول، داكن وفاتح.
  9. Chapter 09
    Artificial Intelligence · الذكاء الاصطناعي
    كيف يفكّر HN AI، يساعد، يقترح، يراجع، يبني، يكتب، يتذكّر، ويتعلّم.
  10. Chapter 10
    Automation · الأتمتة
    النشر، النسخ الاحتياطي، المراقبة، الاختبار، الفحص الأمني، الإشعارات، الجدولة.
  11. Chapter 11
    Security · الأمن
    الهويّة، المصادقة، التفويض، التشفير، التدقيق، الأسرار، الطوارئ.
  12. Chapter 12
    Governance · الحوكمة
    كيف تُعتمد القرارات، الميزات، التصاميم، التحديثات، والكود.
  13. Chapter 13
    Knowledge · المعرفة
    كيف تُخزَّن المعرفة، تُربط، تُبحث، وكيف ترتبط بـ HN Nawat.
  14. Chapter 14
    Evolution · التطوّر
    كيف تضيف تطبيقاً أو وكيلاً أو خدمة جديدة دون كسر أيّ شيء.
  15. Chapter 15
    Future · المستقبل
    خارطة الطريق، الإصدارات، الأهداف، والمراحل.
Execution Rules (قواعد التنفيذ)
  • لا تكرر الكود إذا أمكن إنشاء Component قابل لإعادة الاستخدام.
  • لا تكرر المنطق البرمجي إذا أمكن إنشاء Service مشتركة.
  • لا تكرر البيانات إذا أمكن إنشاء مصدر واحد للحقيقة (Single Source of Truth).
  • اجعل كل وحدة مستقلة وقابلة للتطوير.
  • أي ميزة جديدة يجب أن تكون قابلة للتوسع.
  • لا تكسر التصميم الموحد.
  • لا تكسر HN Design Language.
  • لا تكسر قواعد HN Foundation.
  • وثّق كل قرار هندسي مهم.
  • حدّث الوثائق إذا تغيرت البنية.
  • اجعل الأداء والأمان جزءًا من كل قرار، وليس مرحلة لاحقة.
  • إذا وجدت طريقة أفضل، اقترحها مع توضيح أثرها، لكن لا تنفذها إلا بعد الموافقة.