عدّي للتوثيق
v0.6 منشور · عربي أولاً · AGPL-3.0

الروم سهلة. والحدود مكتوبة.

دليل قصير وصريح للي LOR.‎ بتطلّعه دلوقتي، إزاي القطع راكبة على بعض، وفين المساهم يقدر يعمل التغيير المفيد الجاي.

ابدأ محلياً

شغّل نفس الروم اللي شفتها.

الموقع المستضاف أسرع طريقة تجرّب بيها LOR.‎. الطريق المحلي معمول لقراءة الكود وتغيير issue مركزة أو اختبار حد على جهازك.

قائمة الإعداد كاملة موجودة في .env.example والـREADME.

بداية سريعة

تلات أوامر، وبعدها حط قيمك المحلية

git clone https://github.com/Lord-shaban/lor && cd lor
cp .env.example .env.local
npm install && npm run dev

حط قيم LiveKit وSupabase في .env.local. المكالمة نفسها مش محتاجة مفتاح AI.

المنتج

روم فيديو للمحادثات اللي المفروض تسيب وراها حاجة مفيدة.

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

العربي والإنجليزي يقدروا ييجوا في نفس الجملة من غير ما الـtranscript يختار لغة مختلفة.

شوف حكاية المشروع

روم واحدة، خيط واحد

الاجتماع بيبقى سجل إزاي؟

التدفق صغير عن قصد. كل خطوة ليها صاحب وحد واضح.

  1. 01

    ادخل

    شارك لينك الروم، اكتب اسم العرض، واستخدم شاشة ما قبل الدخول عشان تختبر أجهزتك قبل ما حد يسمعك.

  2. 02

    اشتغلوا سوا

    خلّي الشات والكابشنز والسبورة والنوتس الغنية وWebM محلي قريبين من الكلام.

  3. 03

    راجع وارجع

    المضيف يأكد القرارات والالتزامات المملوكة للمشاركين. الـTimeline والـMemory والبحث يرجعوا للدليل المحفوظ.

اقرأ ده قبل ما تبني

LOR.‎ بتوعد بإيه دلوقتي؟

المنتج صريح عن اللي منشور واللي لسه حدود مساهمة.

قدرات LOR.‎ الحالية والمخططة
القدرةمنشور دلوقتيمخطط / مش وعد
اجتماع فيديوروم LiveKit وما قبل الدخول والشات ومشاركة الشاشةمفيش نظام حسابات أو خطة مدفوعة
دليل محفوظكابشنز وقرارات ومهام وTimeline وMemory وبحثمفيش فهرسة بين الرومات أو للكلام المباشر
حدود الخصوصيةنطاق الروم وتنظيف الحفظ وتسجيل محلي فقطعقد الاستضافة الذاتية شغل v0.9
الإضافاتمستودع واضح وissues عامةتكاملات في v0.8؛ منظومة plugins في v1.0

تحت السطح

طلبات قصيرة. وروم مباشرة واحدة.

الميديا وحالة الاجتماع المشتركة بتعدّي على LiveKit. Next.js بيعمل طلبات قصيرة؛ وPostgres شايل الإسقاط المحفوظ.

المتصفح (Next.js)
  │ WebRTC media + قناة بيانات LiveKit
  │ شات · كابشنز · سبورة · نوتس · reactions
  ▼
LiveKit (سحابي دلوقتي)
  │ طلبات REST قصيرة
  ▼
معالجات مسارات Next.js
  │ tokens · rooms · admission · AI proxy
  ▼
Postgres + pgvector
  كابشنز محفوظة · قرارات · مهام · استخدام

التطبيق مش بيشغّل WebSocket طويل خاص بيه. الحد ده بيخلّي نفس الكود ينفع على استضافة سحابية أو جهاز self-hosted في المستقبل.

امسك خيط

اعمل تغيير صغير قابل للتكرار.

كل مساهمة بتبدأ بـissue محددة، وbranch، والفحوصات المطلوبة، وpull request بتشرح اللي اتغير. العربي RTL هو أول اختبار؛ والإنجليزي LTR بعده.

  1. 01اقرأ عقد المساهمة
  2. 02اختار issue مركزة فيها معايير قبول
  3. 03شغّل typecheck وlint والاختبارات والـbuild واختبار المتصفح المناسب

قبل ما تفتح issue

أسئلة توفر جولة كاملة.

لو الإجابة مش هنا، قوالب الـissues في المستودع بتخلّي السؤال الجاي محدد.

المفاتيح بتوصل للتخزين؟

لأ. مفاتيح المشغّل server-only، ومفتاح المشارك متشفّر في المتصفح وبيتبعث من غير ما يتكتب في قاعدة البيانات أو اللوجز أو الكاش.

لو الـAI وقع المكالمة بتقع؟

لأ. ميزات الـAI بتقلّ بحدودها؛ الفيديو والصوت والتعاون والتسجيل المحلي ليهم مسارهم المستقل.

ينفع أعمل self-host دلوقتي؟

عقد الاستضافة الذاتية مخطط لـv0.9. المسار العام الحالي هو الديمو المستضاف وإعداد التطوير المحلي القابل للتكرار.

ليه العربي هو الاختبار الأول؟

الكلام المختلط عربي/إنجليزي وتخطيط RTL قيود أساسية في المنتج. كل تغيير واجهة بيتراجع بالعربي قبل الإنجليزي.