البدء

ما تحتاج إليه

• مضيف Linux: يستهدف المثبّت Debian 12 أو أحدث وUbuntu 22.04 أو أحدث. ويعمل المنتج كصورة Docker واحدة.
• قناة محادثة: خادم Matrix (فـ K9 Chat عميل Matrix) مع حساب روبوت مخصص ورمز الوصول الخاص به، أو مساحة عمل Slack، أو مستأجر Microsoft Teams مع تسجيل روبوت في Azure.
• قاعدة بيانات: SQLite هي الافتراضية ولا تحتاج إلى شيء؛ ووجّه المنتج إلى Postgres للنشر على عدة مضيفين.
• مفتاح مزوّد ذكاء اصطناعي، أو Ollama محلي للتثبيتات المعزولة تمامًا (مع تعطيل الردود المنطوقة). الدرجة لا تحتاج أبدًا إلى الذكاء الاصطناعي؛ أما المساعد والملخصات والتوجيه فتحتاج إليه.
• وكيل عكسي (Nginx أو Caddy) ينهي TLS أمام الحاوية.

التثبيت

انسخ الإصدار إلى المضيف، وشغّل المثبّت بصلاحيات root، وحرّر ملف البيئة الذي ينشئه، ثم شغّل المنظومة.

• يسجّل البدء النظيف غرف التحديثات اليومية والإجازات التي يستمع إليها الروبوت، ويؤكد وجود بناء الواجهة الأمامية.
• المسؤول الأول هو الحساب المذكور في BOOTSTRAP_ADMIN_MATRIX_ID؛ ويُرقَّى تلقائيًا عند بدء التشغيل.
• تغييرات المخطط إضافية وتعمل عند كل إقلاع، فالترقية سحب وإعادة تشغيل.

sudo bash install.sh
sudo nano /opt/inroots/.env
cd /opt/inroots && sudo docker compose up -d
sudo docker compose logs -f

اربط محادثتك

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

• تُضاف مساحات عمل Slack عبر تثبيت OAuth؛ وتخزّن كل مساحة عمل رمز الروبوت الخاص بها، مشفّرًا عند التخزين.
• يسجّل مستأجرو Teams روبوت Azure الخاص بهم ويلصقون بيانات الاعتماد؛ وتُولَّد حزمة بيان لترفعها.
• يمكن إنشاء هويات روبوت إضافية (شخصيات) لاحقًا وإسنادها إلى الغرف فرديًا؛ وتحتفظ كل واحدة بمفاتيح التشفير الخاصة بها.

MATRIX_HOMESERVER=https://chat.example.com
MATRIX_USER_ID=@inroots:example.com
MATRIX_ACCESS_TOKEN=...
MATRIX_STANDUP_ROOM_ID=!room:example.com

سجّل الدخول إلى لوحة التحكم

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

هيّئ فريقًا

• أيام العمل: منتقي سبعة أيام لكل فريق (أسبوع من الأحد إلى الخميس مدعوم بالكامل). وتركه دون ضبط يعني أن كل يوم يُحتسب.
• موعد تسجيل الدخول النهائي وفترة السماح، أو مفتاح تسجيل الدخول المرن الذي يقيّم بالساعات وحدها.
• الساعات المتوقعة يوميًا، وساعات أسبوعية لكل موظف للعاملين بدوام جزئي.
• تقويم عطل لكل فريق، يُولَّد دون اتصال من بلد ومنطقة، إضافة إلى قائمة على مستوى المؤسسة.
• غرفة مدير للتصعيدات، وإن أردتها، نبضات الحضور.

اختر مزوّد ذكاء اصطناعي

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

أول تحديث يومي

اطلب من أحدهم نشر هذا في غرفة التحديثات اليومية. يقرّ الروبوت به في الغرفة، ويسجّل وقت تسجيل الدخول، ويستخرج المهام والعائق، ويبدأ اليوم.

• في نهاية اليوم ينشر الشخص تسجيل الخروج. والساعات هي الفرق، مصحَّحًا بما يظهره اليوم فعليًا.
• يمكن لأي شخص كتابة /pulse me في المحادثة ليرى بطاقة تقييمه منذ الأسبوع الأول.

Yesterday:
- shipped the export fix
Today:
- invoice PDF rendering
Issues: NPs