مجموعات تودوس وتودو
المهام الشخصية ومجموعات المهام المشتركة للتعاون مع الأصدقاء.
يحتوي Public على قائمة مهام خفيفة الوزن يمكنك استخدامها لنفسك، بالإضافة إلى مجموعات المهام لمشاركة المهام مع أشخاص آخرين.
المهام الشخصية
كل مهمة لديها:
- العنوان
- الوصف (اختياري)
- المرفقات (اختياري) — ما يصل إلى 10 ملفات لكل مهمة: الصور ومقاطع الفيديو وملفات PDF والمستندات الشائعة (انظر الحدود أدناه)
- مكتمل العلم
ابحث عنهم
- الويب: مفتوح
/todosمن الشريط الجانبي. - Android: افتح قائمة المهام من علامة التبويب القائمة.
ما يمكنك القيام به
- إضافة مهمة جديدة (مع مرفقات اختيارية).
- أكمل المهمة عن طريق التحقق منها.
- تحرير أو حذف مهمة (يمكنك إضافة أو إزالة أو استبدال المرفقات عند التحرير).
- تعليق على مهمة — ردود متسلسلة، وتعليقات اختيارية مجهولة المصدر، وحذف تعليقاتك الخاصة.
- دمج المهام الفرعية ضمن أي مهمة — عمق غير محدود (انظر أدناه).
تحتوي كل مهمة على معرف مهمة رقمي ورابط قابل للمشاركة على/tasks/:taskId. تكون المرفقات الخاصة بالمهمة مرئية على تلك الصفحة للأشخاص الذين يمكنهم الوصول إلى المهمة.
المهام الفرعية المتداخلة
يمكن أن تحتوي المهام على مهام فرعية، ويمكن أن تحتوي تلك المهام على المزيد من المهام الفرعية — ليس هناك حد للعمق.
- تعرض القائمة الرئيسية مهام المستوى الأعلى فقط بشكل افتراضي.
- قم بتوسيع مهمة لتحميلها والكشف عن الأطفال المباشرين.
- كل مهمة فرعية هي مهمة كاملة (العنوان والحالة والتعليقات والمرفقات ومعرف المهمة).
- إكمال أحد الوالدين لا يكمل الأطفال تلقائيًا (الحالة مستقلة).
- حذف مهمة يؤدي إلى حذف جميع العناصر التابعة المتداخلة أيضًا.
- يمكن للبحث أن يطابق المهام بأي عمق ويعيد قائمة ثابتة من التطابقات.
ملاحظات API (للعملاء):
- قبول إنشاء/تحديث اختياري
parentId. - قائمة نقاط النهاية (
GET /todos,GET /todo-groups/:groupId/todos) إرجاع الجذور فقط إلا إذا نجحتparentId=<id>للأطفال المباشرين، أو استخدم البحثq(أي عمق). - الردود تشمل
parentId,subtaskCount، وcompletedSubtaskCount.
المرفقات
عندما تقوم بإنشاء مهمة أو تحريرها (شخصية أو جماعية)، يمكنك إرفاق الملفات:
- الصور ومقاطع الفيديو — تم تحميلها عبر نقطة نهاية الوسائط (نفس حدود تحميلات وسائط الدردشة).
- المستندات — PDF، ونص عادي، وCSV، وتنسيقات Office الشائعة، وJSON، وZIP (بحد أقصى 25 ميجابايت لكل ملف).
ما يصل إلى 10 مرفقات لكل مهمة. تحديث مهمة باستخدامattachmentsArray يستبدل القائمة الكاملة.
مجموعات تودو
Todo Group هي قائمة مشتركة تحتوي على اسم ووصف ومنشئ وأعضاء متعددين.
ابحث عنهم
- الويب: مفتوح
/todo-groups. افتح مجموعة واحدة في/todo-groups/:groupIdوإدارة الأعضاء في/todo-groups/:groupId/users. - Android: نفس الشاشات متاحة من خلال إدخال قائمة المهام.
ما يمكنك القيام به
- إنشاء مجموعة جديدة (
/todo-groups/create) مع الاسم والوصف. - دعوة أشخاص آخرين إلى المجموعة.
- إضافة مهام يمكن للجميع رؤيتها (بما في ذلك المهام الفرعية المتداخلة داخل المجموعة).
- إكمال مهام المجموعة.
- التعليق على مهام المجموعة (يمكن لجميع أعضاء المجموعة القراءة والرد).
- مغادرة أو حذف مجموعة.
تعليقات المهمة
تعمل التعليقات مثل نشر التعليقات: يمكنك الرد في سلاسل الرسائل، والنشر بشكل مجهول على التعليقات ذات المستوى الأعلى، وحذف التعليقات التي كتبتها.
في المهام الجماعية، يتلقى منشئ المهمة والمكلف بهإشعاراتعندما يقوم شخص آخر بالتعليق أو الرد. يتلقى المكلف أيضًا إشعارات الدفع عندما يتم تعيين المهمة له، أو وضع علامة اكتمال عليها، أو إعادة فتحها، أو تبديلها قيد التقدم.
لا ترسل المهام الشخصية إشعارات بالتعليقات أو المكلفين (أنت فقط من يستطيع الوصول إليها).
تظهر أيضًا إشعارات حول المهام والإكمالات الجديدة فيإشعارات.