كيف تقيّد الوصول إلى مشروع

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

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

ملاحظة عن الوضع الافتراضي أولًا. جاهزًا فورًا، يستطيع كل عضو غير ضيف في مساحة عملك رؤية كل مشروع. هذا مقصود. في مساحة العرض التجريبي لدينا، مشروع WEB مفتوح للفريق كله، فيستطيع أي أحد فتح لوحته، وقراءة تذكرة «Timeline + Summary tab»، وتصفّح الباكلوج. التقييد هو كيف تُطفئ ذلك لمشروع واحد دون المساس بأي شيء آخر.

متى تحتاج فعلًا إلى تقييد من يرى مشروعًا

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

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

في كل من هذه، تفعل الشيء نفسه: تحويل مشروع من «مرئي لمساحة العمل كلها» إلى «مرئي لقائمة مسمّاة». هذا ما يعنيه التقييد هنا.

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

كيف تقيّد الوصول إلى مشروع على أعضاء محددين

إليك الحركة الجوهرية. افتح المشروع الذي تريد قفله (WEB، في أمثلتنا)، اذهب إلى إعداداته، وافتح تبويب الوصول. يقع بجوار العام وحالات اللوحة والتكاملات ومنطقة الخطر.

سترى بطاقة عنوانها «الوصول المُقيَّد للمشروع». يذكر العنوان الفرعي القاعدة التي أنت على وشك تشغيلها: «المشاريع المُقيَّدة مرئية فقط لمالكي مساحة العمل ومشرفيها إضافةً إلى الأشخاص المُدرَجين هنا. امنح الوصول أو اسحبه لكل مشروع». تحتها المفتاح: تقييد الوصول على الأعضاء الصريحين. يبدأ مُطفأً، لأن المشروع يبدأ مفتوحًا.

اقلبه للتشغيل. يحدث أمران:

1. إشعار يقرأ «الوصول إلى المشروع مقيّد الآن». هذا التأكيد مهم، لأن التغيير على الشاشة هادئ وتريد أن تعرف أن الكتابة نجحت. تحت الغطاء يضبط هذا scoped = 1 على المشروع عبر إجراء setScopedMode.
2. يختفي المشروع عن كل من ليس مالكًا أو مشرفًا أو عضوًا صريحًا. يغادر شريط تنقّل مشاريعهم الجانبي. يختفي من قائمة /w/taskfolk/projects. يتوقف عن الظهور في عروض مساحة العمل، وفي الرؤى، وفي الخريطة الذهنية. بالنسبة لأولئك، لم يعد المشروع موجودًا.

الثاني هو الجزء الذي يستهين به الناس.

شيء ينبغي معرفته قبل أن تمدّ يدك إلى ذلك المفتاح: مالكو مساحة العمل ومشرفوها وحدهم يرون تبويب الوصول أصلًا. إنه مقيّد بصلاحية project.edit_settings. المنفّذ العادي أو المشاهد الذي يفتح إعدادات المشروع لا يجد تبويب وصول إطلاقًا ولا يمكنه تقييد أي شيء. فإن قرأت دليلًا يقول «أي أحد يستطيع جعل مشروع خاصًّا»، فهو خاطئ بالنسبة لـTaskfolk. هذا إجراء للمالك والمشرف بالتصميم. للخريطة الكاملة لمن يملك أي صلاحية، يوفّرها دليل الأدوار والصلاحيات.

ماذا يحدث لحظة تقلب المفتاح

الآن الجزء الذي يفاجئ الناس، وسبب وجود هذه التدوينة.

تشغيل التقييد لا يضيف أحدًا إلى المشروع. لا قائد المشروع. لا المهندسون الذين عاشوا فيه أشهرًا. ولا أنت، الشخص الذي قلب المفتاح للتو. تبدأ قائمة الأعضاء فارغة.

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

فبعد تشغيل التقييد مباشرةً، تعرض منطقة الأعضاء هذا: «لا أعضاء صريحون بعد. المالكون والمشرفون يملكون الوصول دائمًا». تلك الحالة الفارغة حقيقية وقابلة للبلوغ، وهي بالضبط ما ستنظر إليه إن توقّفت هنا. المشروع المقيّد بلا أحد مُضاف هو مشروع للمالك والمشرف فقط. أما الجميع سواهم، بمن فيهم من يحملون العمل، فيرون الآن مساحة عمل تلاشى منها ذلك المشروع بهدوء.

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

إضافة الأشخاص الذين ينبغي أن يملكوا الوصول

مع تشغيل التقييد، ينمو تبويب الوصول صفَّ منح. هنا تبني القائمة. هناك ثلاثة عناصر تحكّم:

• منتقٍ قابل للبحث بعنوان «اختر زميلًا…»: انقره، اكتب اسمًا أو بريدًا، فيضيّق قائمة مساحة العمل إلى الشخص الذي تريده.
• قائمة منسدلة «دور المشروع» تعرض مشرف أو منفّذ أو مشاهد.
• زر «إضافة عضو».

اختر زميلًا، اختر دورًا، انقر إضافة عضو. تحصل على «أُضيف عضو المشروع» ويرتفع العدّاد في الأعلى: «1 لديه الوصول»، ثم «2 لديهما الوصول»، وهكذا. ذلك العدّ قراءتك السريعة لمدى انكشاف المشروع.

نسخة ملموسة، باستخدام WEB. لنقل إن مهندسَين ينبغي أن يستمرّا في العمل على تذكرة «Timeline + Summary tab» بينما تبقى بقية مساحة العمل خارجًا. افتح المنتقي، اعثر على المهندس الأول، اترك الدور على منفّذ، انقر إضافة عضو. يقرأ العدّ «1 لديه الوصول». افعلها ثانيةً للثاني. يقرأ العدّ «2 لديهما الوصول». انتهى. يستطيع هذان الآن فتح WEB، ورؤية اللوحة، وقراءة التذكرة والتعليق عليها. أما الجميع سواهما في مساحة العمل فلم يعودوا يرون WEB في أي مكان.

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

ماذا يفعل دور المشروع (والفخّ الذي ينصبه)

هذا هو أهم شيء تفهمه عن الميزة، وهو الشيء الذي يخطئ فيه الجميع تقريبًا.

الدور الذي تختاره عند إضافة شخص، مشرف أو منفّذ أو مشاهد، يُخزَّن ويُعرَض. هذا كل ما يفعله. يظهر في صفه كي ترى بلمحة كيف صنّفته. لكنه لا يتحكّم فيما يستطيع فعله داخل المشروع.

دعني أكون صريحًا بشأن الفخّ، لأن الوقوع فيه سهل. إضافة شخص كـ«مشاهد» لا تجعل المشروع للقراءة فقط بالنسبة له. لا تمنعه من تعديل المهام، أو سحب البطاقات، أو ترك التعليقات. فحص الوصول، requireProjectAccess، يسأل سؤالًا واحدًا بالضبط: هل يوجد صف عضوية لهذا الشخص في هذا المشروع؟ نعم أو لا. لا يقرأ الدور على ذلك الصف أبدًا. إن كان الصف موجودًا، فهو بالداخل. أما ما يستطيع فعله فعلًا بمجرد دخوله فيأتي كليًّا من دوره في مساحة العمل، لا من دور المشروع هذا.

فالشخص الذي هو منفّذ في مساحة العمل، المُضاف إلى مشروعك المقيّد كـ«مشاهد» للمشروع، لا يزال يعدّل ويعلّق كمنفّذ، لأن دوره في مساحة العمل هو منفّذ. وسم «مشاهد» على صفه لم يغيّر شيئًا في قدرته. إنه مذكّرة لنفسك، لا صلاحية.

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

فلماذا توجد القائمة المنسدلة إذًا؟ لتسجيل النية، وكي يكون للنموذج مكان ينمو فيه. لكنها اليوم وسم. لا تبنِ عليها مخطّط صلاحيات.

تغيير دور أو إزالة شخص

تعديلان ستجريهما عبر عمر مشروع مقيّد.

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

إزالة شخص هي «×» على صفه. انقرها فيظهر مربع تأكيد: «إزالة {email} من WEB؟». أكّد، فيُحذف صف العضوية. تحصل على «أُزيل {email} من WEB» وينخفض العدّ بواحد. من تلك اللحظة يختفي WEB عن ذلك الشخص بالطريقة نفسها التي يختفي بها عن أي أحد خارج القائمة.

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

من لا يزال يستطيع بلوغ مشروع مقيّد

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

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

flowchart TD
    A[Someone opens a scoped project] --> B{Owner or admin}
    B -->|Yes| C[Access granted]
    B -->|No| D{Membership row on this project}
    D -->|Yes| C
    D -->|No| E[404 Not found]

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

ما يقود إلى تفصيل يستحق التنويه. إن انتقل شخص ليس عضوًا مباشرةً إلى رابط مشروع مقيّد، فيحصل على 404، لا صفحة رفض صلاحية. هذا متعمّد. استجابة «لا يمكنك امتلاك هذا» كانت ستؤكّد أن المشروع حقيقي. أما 404 فتقول لا شيء هنا، فلا يستطيع الشخص حتى التحقّق من وجود المشروع، ناهيك عن قراءة اسمه. requireProjectAccess يستدعي notFound() له.

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

إن أردت فهم كيف يعمل تقييد نطاق البحث عمومًا، فإن دليل بحث مساحة العمل يتعمّق أكثر.

الحدود: ما لا يفعله التقييد

كل ميزة صادقة لها حوافّ. إليك حوافّ التقييد، في مكان واحد، كي لا تصطدم بها في اللحظة الخاطئة.

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

إدارة الوصول المقيّد عبر REST API

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

تُدار العضوية المقيّدة عبر ثلاث نقاط نهاية:

الطريقة	المسار	النطاق
GET	/v1/workspaces/{slug}/projects/{key}/members	projects:read
POST	/v1/workspaces/{slug}/projects/{key}/members	projects:admin
DELETE	/v1/workspaces/{slug}/projects/{key}/members/{userId}	projects:admin

يسرد GET من يملك وصولًا صريحًا. يضيف POST عضوًا بدور، ويتصرّف مثل الواجهة: إنه عديم التأثير عند التكرار، فإرسال POST لشخص موجود على القائمة يحدّث دوره في مكانه بدل تكديس صف مكرّر (تحصل على 201 لمنح جديد، و200 لتحديث). يزيل DELETE عضوًا بمعرّف مستخدمه. كلتا نقطتي الكتابة مقيّدتان بصلاحية project.edit_settings نفسها التي في الواجهة، فلا يستطيع رمز API فعل ذلك إلا إن كان مالكه يستطيع فعله يدويًا.

إليك استدعاء المنح، الذي ستنفّذه سكربتاتك أكثر من غيره:

curl -X POST "https://taskfolk.ai/api/v1/workspaces/taskfolk/projects/WEB/members" \
  -H "Authorization: Bearer tfk_live_a1b2..." \
  -H "Content-Type: application/json" \
  -d '{"user_id": "0198c3f0-7f2a-7b1e-9c4d-2a6b8e1f0d3c", "role": "member"}'

const res = await fetch(
  "https://taskfolk.ai/api/v1/workspaces/taskfolk/projects/WEB/members",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer tfk_live_a1b2...",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      user_id: "0198c3f0-7f2a-7b1e-9c4d-2a6b8e1f0d3c",
      role: "member",
    }),
  },
);

import requests

res = requests.post(
    "https://taskfolk.ai/api/v1/workspaces/taskfolk/projects/WEB/members",
    headers={"Authorization": "Bearer tfk_live_a1b2..."},
    json={"user_id": "0198c3f0-7f2a-7b1e-9c4d-2a6b8e1f0d3c", "role": "member"},
)

يعود المنح الناجح في المغلّف القياسي:

{
  "data": {
    "user_id": "0198c3f0-7f2a-7b1e-9c4d-2a6b8e1f0d3c",
    "email": "[email protected]",
    "name": "Dev One",
    "role": "member",
    "added_at": "2026-07-15T09:30:00.000Z"
  }
}

السحب استدعاء واحد بمعرّف المستخدم في المسار:

curl -X DELETE \
  "https://taskfolk.ai/api/v1/workspaces/taskfolk/projects/WEB/members/0198c3f0-7f2a-7b1e-9c4d-2a6b8e1f0d3c" \
  -H "Authorization: Bearer tfk_live_a1b2..."

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

sequenceDiagram
    participant P as Provisioning script
    participant U as Taskfolk API
    P->>U: POST members with user_id and role
    U-->>P: 201 grant created
    Note over P,U: contract ends
    P->>U: DELETE members by user id
    U-->>P: 200 grant removed

لا أحد ينقر شيئًا، وقواعد الوصول مطابقة لما ستحصل عليه في الواجهة، لأنه مسار الكود نفسه تحتها.

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