التوثيق

هذه الصفحة تصف بنية توثيق مستودع نيكسا ديسك. هذا ليس مرجع API منشور أو دليل قابل للتنزيل — إنه يفهرس التصميم والهندسة وسجلات القرارات للمستودع.

نظرة عامة على المستودع

README.md

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

الحالة الحالية

جلسات Linux CLI المصادق عليها والمقيدة بالموافقة مع TOFU وجلسات ping/pong؛ 44 اختبار أخضر على Linux بدون واجهة رسومية؛ لا التقاط شاشة، إدخال، نقل ملفات، ترحيل، أو إصدارات بعد.

القيود المعروفة

جلسات CLI تحمل فقط بيانات ping/pong. اختبارات Linux بدون واجهة رسومية لا تتحقق من سلوك Windows أو Ubuntu الرسومي. لا معايير أداء أو ادعاءات أداء. دعم Ubuntu Wayland مؤجل. إجراءات النسخ الاحتياطي/الاستعادة هي تصاميم فقط، لم يتم تنفيذها.

الهندسة والأمان

docs/architecture.md

النهج المختار (محرك NexaDesk مخصص مع أوراق التقاط/ترميز مرخصة بشكل متساهل)، فصل مستوى التحكم عن مستوى الوسائط/البيانات، حدود الواجهة/الوكيل، تعريف شريحة MVP، والمخاطر المحددة.

docs/security-model.md

نموذج التهديد، ضوابط MVP المعيارية (الهوية/Ed25519، المصافحة/المصادقة المتبادلة، التشفير/التشفير المصادق عليه، التفويض/الموافقة المحددة، بيانات الاعتماد/مخزن مفاتيح نظام التشغيل، مقاومة إساءة الاستخدام، سجل التدقيق)، وتخطيط التحقق.

docs/licensing.md

التزامات الترخيص، مشغلات الخيارات، قائمة التحقق من الامتثال، وأعلام المراجعة القانونية. تقييم AGPL لكود RustDesk، تصميم حدود الأوراق المتساهلة، وواجبات التوزيع. ثمانية أعلام استشارة صريحة محددة.

العمليات والدليل

كتيبات العمليات

جرد Hetzner (قراءة فقط)، تصميم النسخ الاحتياطي + التحقق، تسلسل الهجرة المحكوم (لا خطوة تدميرية مصرح بها)، تصميم الإشارة/الترحيل/TLS/جدار الحماية/المراقبة مع افتراضات السعة.

تقارير البوابة

تقارير تدقيق ومراجعة المستودع التي توثق دليل التقدم — بما في ذلك عمل الجلسات المصادق عليها الحالي — محفوظة في docs/gates/.

كيفية تفسير الحالة

المنفذ

ميزات باختبارات ناجحة ودليل. الحالي: جلسات ping/pong CLI المصادق عليها والمقيدة بالموافقة على Linux بدون واجهة رسومية.

  • نواة Rust (مساحة العمل موجودة)
  • جلسات مصادق عليها (CLI)
  • اتصالات مقيدة بالموافقة
  • نموذج ثقة TOFU
  • مضيف/عميل Linux CLI

مخطط / غير مختبر

ميزات في التصميم أو غير محققة. هذه نوايا، وليست قدرات.

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

صفحات ذات صلة

راجع نموذج الأمان لفهم الضوابط المنفذة والميزات المخطط لها، أو تحقق من صفحة الميزات للحصول على ملخص القدرات.