> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agencyhandy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# تتبع الوقت وإدارة الجداول الزمنية في AgencyHandy

> سجّل الوقت بمؤقت حي أو إدخال يدوي وصفّح سجلات العمل حسب المهمة أو العضو أو الخدمة وصدّر بيانات الجدول الزمني بصيغة CSV أو XLSX في AgencyHandy.

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

## من يستطيع استخدام ميزات الجدول الزمني

| الميزة                     | المدير العام | المدير | مدير المشروع | الموظف |
| -------------------------- | :----------: | :----: | :----------: | :----: |
| عرض سجلات الوقت الخاصة     |       ✅      |    ✅   |       ✅      |    ✅   |
| تسجيل الوقت للآخرين        |       ✅      |    ✅   |       ✅      |    ❌   |
| تعديل إدخالات الوقت        |       ✅      |    ✅   |       ✅      |    ❌   |
| تصدير بيانات الجدول الزمني |       ✅      |    ✅   |       ✅      |    ❌   |

<Note>
  يجب أن تكون المهام موجودة قبل تتبع الوقت عليها. تأكد من إنشاء المهام داخل الطلبات قبل محاولة تسجيل الوقت.
</Note>

## عرض الجدول الزمني

<Steps>
  <Step title="فتح الجدول الزمني">
    انقر على **الجدول الزمني** في الشريط الجانبي الأيسر الرئيسي. ستجد جدولاً يسرد جميع سجلات الوقت لفريقك.

    يُظهر كل صف التاريخ وعضو الفريق واسم المهمة والخدمة والوقت المسجَّل وأي ملاحظات مرفقة بالإدخال.
  </Step>
</Steps>

## إضافة إدخال وقت

لديك خياران لتسجيل الوقت: مؤقت حي للعمل الجاري، أو إدخال يدوي للوقت الذي أنجزته بالفعل.

<Tabs>
  <Tab title="بدء مؤقت">
    <Steps>
      <Step title="اختيار مهمة">
        في عرض الجدول الزمني، ابحث عن المهمة التي ستعمل عليها أو حددها.
      </Step>

      <Step title="النقر على بدء المؤقت">
        انقر على **بدء المؤقت** لبدء تتبع الوقت في الوقت الفعلي. يعمل المؤقت حتى توقفه.
      </Step>

      <Step title="الإيقاف عند الانتهاء">
        انقر على **إيقاف** عند إنهاء العمل. يُسجّل AgencyHandy تلقائيًا الوقت المنقضي على المهمة المحددة.
      </Step>
    </Steps>

    <Tip>
      استخدم المؤقت للعمل الجاري لضمان التتبع الدقيق. التقريب اليدوي أو تقدير الوقت بعد الانتهاء أقل دقةً من تشغيل المؤقت.
    </Tip>
  </Tab>

  <Tab title="الإدخال اليدوي">
    <Steps>
      <Step title="النقر على + إضافة إدخال">
        في لوحة الجدول الزمني، انقر على **+ إضافة إدخال**. سيظهر نموذج.
      </Step>

      <Step title="ملء تفاصيل الإدخال">
        * **المهمة** — حدد المهمة التي ينطبق عليها هذا الوقت
        * **عضو الفريق** — عيّن الوقت للشخص الصحيح (يمكن للمديرين ومديري المشاريع التسجيل للآخرين)
        * **الوقت المُنجَز** — أدخل الساعات والدقائق
        * **الملاحظات** — أضف أي سياق حول ما تم العمل عليه
      </Step>

      <Step title="الحفظ">
        انقر على **حفظ** لتسجيل الإدخال. سيظهر في جدول الجدول الزمني فورًا.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## التصفية حسب نطاق التاريخ

استخدم فلاتر التاريخ للتركيز على فترة زمنية محددة.

<Steps>
  <Step title="فتح فلاتر التاريخ">
    انقر على عناصر التحكم في فلتر التاريخ في أعلى يمين لوحة الجدول الزمني.
  </Step>

  <Step title="اختيار نطاق">
    اختر من بين النطاقات المحددة مسبقًا:

    * **يومي** — سجلات اليوم فقط
    * **أسبوعي** — الأسبوع الحالي
    * **شهري** — الشهر الحالي

    للمشاريع الأطول أو التقارير التاريخية، حدد نطاق تاريخ **مخصص** بإدخال تاريخ بداية وتاريخ نهاية.
  </Step>

  <Step title="التطبيق">
    انقر على **تطبيق** لتحديث الجدول بالسجلات من الفترة المحددة.
  </Step>
</Steps>

<Tip>
  صفّح قبل التصدير لإنشاء تقارير مركّزة. قد يُنتج تصدير الجدول الزمني الكامل غير المصفّى ملفات كبيرة جدًا للوكالات النشطة.
</Tip>

## تجميع الإدخالات

يُعيد التجميع تنظيم صفوف الجدول الزمني دون إزالة أي بيانات. يساعدك على قراءة السجلات وتحليلها بسرعة أكبر.

<Steps>
  <Step title="فتح القائمة المنسدلة تجميع حسب">
    انقر على القائمة المنسدلة **تجميع حسب** بالقرب من أعلى لوحة الجدول الزمني.
  </Step>

  <Step title="اختيار تجميع">
    اختر من بين الخيارات التالية:

    | خيار التجميع            | ما يُظهره                                                      |
    | ----------------------- | -------------------------------------------------------------- |
    | **اسم المهمة**          | جميع إدخالات الوقت مجمّعة تحت كل مهمة                          |
    | **عضو الفريق**          | جميع الإدخالات مجمّعة تحت كل شخص                               |
    | **الخدمة → اسم المهمة** | الإدخالات مجمّعة حسب الخدمة ثم مُقسّمة حسب المهمة داخل كل خدمة |
  </Step>
</Steps>

<Note>
  التجميع تغيير مرئي فقط — لا يؤثر على البيانات الأساسية ولا على ما يُصدَّر. تشمل عمليات التصدير دائمًا جميع الصفوف المرئية.
</Note>

## عرض تفاصيل المهمة من الجدول الزمني

<Steps>
  <Step title="النقر على اسم مهمة">
    في جدول الجدول الزمني، انقر على أي **اسم مهمة**. يأخذك AgencyHandy إلى صفحة التفاصيل الكاملة لتلك المهمة.
  </Step>

  <Step title="مراجعة سياق المهمة">
    في صفحة تفاصيل المهمة، ستجد سجل الوقت الكامل والملاحظات المرفقة والمُعيَّنين والحالة وغيرها من المعلومات على مستوى المهمة. استخدم هذا العرض للتحقيق في الإدخالات أو التحقق مما تم إنجازه.
  </Step>
</Steps>

## تصدير بيانات الجدول الزمني

صدّر جدولك الزمني لكشوف المرتبات أو تقارير فوترة العميل أو أدوات إدارة المشاريع الخارجية.

<Steps>
  <Step title="تطبيق الفلاتر أولاً (موصى به)">
    استخدم فلتر نطاق التاريخ لتضييق التصدير إلى الفترة التي تحتاجها. هذا يبقي الملف مركّزًا وقابلاً للإدارة.
  </Step>

  <Step title="النقر على تصدير">
    انقر على زر **تصدير** في أعلى لوحة الجدول الزمني.
  </Step>

  <Step title="اختيار تنسيق">
    اختر إما:

    * **CSV** — لأدوات جداول البيانات مثل Excel و Google Sheets أو مسارات البيانات
    * **XLSX** — لمصنفات بتنسيق Excel مع الحفاظ على تنسيق الأعمدة
  </Step>

  <Step title="تنزيل الملف">
    يُنزَّل الملف على جهازك تلقائيًا. يشمل كل تصدير جميع الأعمدة المرئية: التاريخ وعضو الفريق واسم المهمة والخدمة والوقت المسجَّل والملاحظات.
  </Step>
</Steps>

<Warning>
  إذا لم يُطلق التصدير تنزيلاً، قد يمنع **حاجب النوافذ المنبثقة** في متصفحك تنزيل الملف. عطّل حجب النوافذ المنبثقة لـ AgencyHandy وحاول مرة أخرى.
</Warning>

## ملاحظات إضافية

<Accordion title="المؤقت مقابل الإدخال اليدوي">
  المؤقت الأفضل للعمل النشط في الوقت الفعلي. الإدخالات اليدوية الأفضل عندما نسيت بدء المؤقت أو تحتاج إلى تسجيل الوقت بأثر رجعي. كلتا الطريقتين تُنتجان إدخالات سجل متطابقة في جدول الجدول الزمني.
</Accordion>

<Accordion title="التجميع مقابل التصفية">
  الفلاتر **تُقلّل** الصفوف الظاهرة في الجدول. التجميع **يُعيد تنظيم** الصفوف الظاهرة بالفعل. يمكنك تطبيق كليهما في الوقت نفسه — صفّح حسب نطاق تاريخ ثم جمّع حسب عضو الفريق لرؤية إجماليات كل شخص لتلك الفترة.
</Accordion>

<Accordion title="التصديرات تشمل جميع الأعمدة المرئية">
  يلتقط كل تصدير الحالة الحالية للجدول المرئي: التاريخ والمستخدم والمهمة والخدمة والوقت والملاحظات. إذا طبّقت إعداد تجميع، فإن التصدير يعكس بنية التجميع أيضًا.
</Accordion>

<Accordion title="النطاقات المخصصة للبيانات التاريخية">
  للمشاريع طويلة الأمد أو المراجعات الفصلية، استخدم خيار نطاق التاريخ المخصص لاستخراج بيانات الجدول الزمني التاريخية التي تتجاوز النوافذ الزمنية المحددة مسبقًا (يومية/أسبوعية/شهرية).
</Accordion>