مدیریت اعضا
دعوت اعضا، تعیین نقش‌ها و مدیریت دسترسی تیم
مدیریت اعضا
با دعوت اعضا و تعیین نقش مناسب برای هرکدام، با تیم خود همکاری کنید.
آشنایی با نقش‌ها
پلتفرم Aize از یک سامانه کنترل دسترسی مبتنی بر نقش (RBAC) با سه نقش مجزا استفاده می‌کند:
مالک
کنترل کامل - دسترسی کامل به همه چیز
مجوزها:
- ✅ مدیریت کیف پول (مشاهده موجودی، افزایش اعتبار، مشاهده تراکنش‌ها)
- ✅ ایجاد و مدیریت تمام کلیدهای API (شخصی + تیمی)
- ✅ دعوت اعضا
- ✅ تغییر نقش اعضا (از جمله ارتقا به مدیر)
- ✅ حذف اعضا
- ✅ به‌روزرسانی تنظیمات فضای کاری
- ✅ مشاهده تمام تحلیل‌ها و گزارش‌ها
- ✅ دسترسی به گزارش رخدادها
- ✅ حذف فضای کاری
مورد استفاده: بنیان‌گذاران، مدیران مالی، تصمیم‌گیرندگان نهایی
مدیر
مدیریت تیم - مدیریت تیم و کلیدهای API، اما بدون دسترسی مالی
مجوزها:
- ❌ بدون دسترسی به کیف پول (نمی‌تواند موجودی را ببیند یا اعتبار را افزایش دهد)
- ✅ ایجاد کلیدهای API در سطح تیم
- ✅ مدیریت تمام کلیدهای API
- ✅ دعوت اعضا (فقط با نقش مدیر یا عضو)
- ❌ نمی‌تواند نقش‌ها را تغییر دهد
- ❌ نمی‌تواند اعضا را حذف کند
- ✅ مشاهده تحلیل‌های تیم
- ✅ مشاهدهٔ همهٔ گزارش فراخوانی‌های API
- ✅ دسترسی به محیط آزمون
- ❌ نمی‌تواند تنظیمات فضای کاری را به‌روزرسانی کند
مورد استفاده: تک‌لیدها، مهندسان DevOps، مدیران تیم
عضو
دسترسی شخصی - فقط دسترسی فردی برای توسعه‌دهنده
مجوزها:
- ❌ بدون دسترسی به کیف پول
- ✅ فقط ایجاد کلیدهای API شخصی
- ✅ مدیریت کلیدهای API خود
- ❌ نمی‌تواند کلید تیمی بسازد
- ❌ نمی‌تواند عضو دعوت کند
- ❌ نمی‌تواند تحلیل‌های تیم را ببیند
- ✅ فقط مشاهدهٔ گزارش فراخوانی‌های API خود
- ✅ دسترسی به محیط آزمون
- ❌ نمی‌تواند تنظیمات فضای کاری را به‌روزرسانی کند
مورد استفاده: توسعه‌دهندگان، پیمانکاران، اعضای مستقل تیم
دعوت اعضا
فرایند دعوت
برای مالکان و مدیران:
- به صفحه اعضا بروید
- روی دکمه «دعوت عضو» کلیک کنید
- فرم دعوت را تکمیل کنید:
- آدرس ایمیل: ایمیل عضو
- نقش: مدیر یا عضو را انتخاب کنید
- ⚠️ به دلایل امنیتی امکان دعوت با نقش مالک وجود ندارد
- روی «ارسال دعوت‌نامه» کلیک کنید
سامانه دعوت دو مسیره
سامانه با کاربران موجود و جدید متفاوت رفتار می‌کند:
مسیر A: کاربر موجود (از قبل حساب دارد)
- کاربر بلافاصله به فضای کاری اضافه می‌شود
- دسترسی فوراً اعطا می‌شود
- ایمیل اطلاع‌رسانی ارسال می‌شود
- کاربر در ورود بعدی، فضای کاری را می‌بیند
مسیر B: کاربر جدید (هنوز حساب ندارد)
- رکورد دعوت‌نامه ایجاد می‌شود
- ایمیلی به همراه لینک ثبت‌نام ارسال می‌شود
- لینک به مدت 72 ساعت معتبر است
- با ثبت‌نام و ورود کاربر، به‌طور خودکار به فضای کاری اضافه می‌شود
- دعوت‌نامه مصرف می‌شود و قابل استفاده مجدد نیست
ایمیل دعوت‌نامه
دریافت‌کنندگان ایمیلی حاوی موارد زیر دریافت می‌کنند:
- نام فضای کاری
- نقشی که برای آن دعوت شده‌اند
- لینک دعوت‌نامه (برای کاربران جدید)
- راهنمای پذیرش دعوت
وضعیت دعوت‌نامه
پیگیری دعوت‌نامه‌ها در صفحه اعضا:
- در انتظار: ارسال شده اما هنوز پذیرفته نشده
- پذیرفته‌شده: کاربر با موفقیت پیوست
- منقضی‌شده: 72 ساعت گذشته و لینک دیگر معتبر نیست
- لغوشده: مالک/مدیر دعوت‌نامه را لغو کرده است
مدیریت اعضا
مشاهده اعضای تیم
صفحه اعضا موارد زیر را نمایش می‌دهد:
جزئیات کارت عضو:
- آواتار: تصویر پروفایل یا حروف اول نام
- نام و ایمیل: هویت عضو
- نشان نقش: رنگ‌بندی‌شده
- 🔵 مالک (آبی)
- 🟣 مدیر (بنفش)
- 🟢 عضو (سبز)
- تاریخ پیوستن: زمان پیوستن به فضای کاری
- برچسب شما: نشان می‌دهد کدام‌یک خودتان هستید
آمار تیم:
- تعداد کل اعضا
- تعداد مدیران
- تعداد توسعه‌دهندگان (عضو)
تغییر نقش اعضا
الزامات:
- فقط مالک می‌تواند نقش‌ها را تغییر دهد
- امکان تغییر نقش خودتان وجود ندارد
- امکان تغییر نقش سایر مالکان وجود ندارد
نحوه تغییر نقش:
- عضو موردنظر را در فهرست پیدا کنید
- روی منوی کشویی نقش او کلیک کنید
- نقش جدید را انتخاب کنید:
- مالک ← مدیر ← عضو
- عضو ← مدیر ← مالک
- تغییر را تأیید کنید
- مجوزهای عضو بلافاصله به‌روزرسانی می‌شود
- اقدام در گزارش رخدادها ثبت می‌شود
- عضو ایمیل اطلاع‌رسانی دریافت می‌کند
اثرات تغییر نقش:
ارتقای عضو ← مدیر:
- اکنون می‌تواند کلید تیمی بسازد
- می‌تواند تمام گزارش‌های تیم را ببیند
- می‌تواند سایر اعضا را دعوت کند
- همچنان بدون دسترسی به کیف پول
ارتقای مدیر ← مالک:
- دسترسی به کیف پول به دست می‌آورد
- می‌تواند نقش اعضا را تغییر دهد
- می‌تواند اعضا را حذف کند
- کنترل کامل فضای کاری
تنزل مالک ← مدیر:
- دسترسی به کیف پول را از دست می‌دهد
- دیگر نمی‌تواند نقش‌ها را تغییر دهد
- نمی‌تواند تنظیمات فضای کاری را به‌روزرسانی کند
- توانایی‌های مدیریت تیم را حفظ می‌کند
تنزل مدیر ← عضو:
- توانایی ایجاد کلید تیمی را از دست می‌دهد
- نمی‌تواند گزارش‌های تیم را ببیند
- نمی‌تواند عضو دعوت کند
- فقط فعالیت خودش را می‌بیند
حذف اعضا
الزامات:
- فقط مالک می‌تواند اعضا را حذف کند
- امکان حذف خودتان وجود ندارد
- امکان حذف سایر مالکان وجود ندارد
نحوه حذف:
- عضو موردنظر را در فهرست پیدا کنید
- روی دکمه «حذف» (آیکن سطل زباله) کلیک کنید
- حذف را تأیید کنید
- عضو بلافاصله دسترسی خود را از دست می‌دهد
- از موارد زیر حذف می‌شود:
- پایگاه دادهٔ فضای کاری
- گروه Keycloak
- تیم LiteLLM
- کلیدهای API او لغو می‌شوند
- دیگر نمی‌تواند به فضای کاری دسترسی داشته باشد
- اقدام در گزارش رخدادها ثبت می‌شود
- عضو ایمیل اطلاع‌رسانی دریافت می‌کند
برای کلیدهای API او چه اتفاقی می‌افتد؟:
- کلیدهای شخصی: به‌طور خودکار لغو می‌شوند
- کلیدهای تیمی که او ساخته: فعال باقی می‌مانند (متعلق به فضای کاری)
- نمی‌توان همان کلیدها را دوباره ساخت
پیگیری فعالیت اعضا
تحلیل فعالیت هر عضو
برای مدیران/مالکانی که اعضای تیم را مشاهده می‌کنند:
- به گزارش فراخوانی‌های API بروید
- بر اساس عضو فیلتر کنید
- موارد زیر را مشاهده کنید:
- مصرف API
- مدل‌های استفاده‌شده
- هزینه‌های صرف‌شده
- سابقه درخواست‌ها
برای اعضایی که فعالیت خود را مشاهده می‌کنند:
- به گزارش فراخوانی‌های API بروید
- گزینه «فقط گزارش‌های من» را فعال کنید
- فقط فعالیت شخصی را ببینید
مسیر رخدادها
تمام اقدام‌های مرتبط با اعضا ثبت می‌شود:
- دعوت عضو
- پذیرش دعوت‌نامه
- تغییر نقش
- حذف عضو
- کلیدهای API ساخته‌شده توسط عضو
- تنظیمات به‌روزرسانی‌شده توسط عضو
مشاهده در صفحه گزارش رخدادها (فقط مالک/مدیر)
ماتریس مجوزها
شرح تفصیلی کارهایی که هر نقش می‌تواند انجام دهد:
| امکان | عضو | مدیر | مالک |
|---|---|---|---|
| کیف پول | |||
| مشاهده موجودی | ❌ | ❌ | ✅ |
| افزایش اعتبار | ❌ | ❌ | ✅ |
| مشاهده تراکنش‌ها | ❌ | ❌ | ✅ |
| کلیدهای API | |||
| ایجاد کلیدهای شخصی | ✅ | ✅ | ✅ |
| ایجاد کلیدهای تیمی | ❌ | ✅ | ✅ |
| مشاهده کلیدهای خود | ✅ | ✅ | ✅ |
| مشاهده کلیدهای تیمی | ❌ | ✅ | ✅ |
| لغو کلیدهای خود | ✅ | ✅ | ✅ |
| لغو کلیدهای تیمی | ❌ | ✅ | ✅ |
| اعضا | |||
| دعوت اعضا | ❌ | ✅ | ✅ |
| مشاهده فهرست اعضا | ✅ | ✅ | ✅ |
| تغییر نقش‌ها | ❌ | ❌ | ✅ |
| حذف اعضا | ❌ | ❌ | ✅ |
| تحلیل‌ها | |||
| مشاهده گزارش‌های خود | ✅ | ✅ | ✅ |
| مشاهده گزارش‌های تیم | ❌ | ✅ | ✅ |
| مشاهده تحلیل مصرف | ❌ | ✅ | ✅ |
| مشاهده گزارش رخدادها | ❌ | ✅ | ✅ |
| فضای کاری | |||
| به‌روزرسانی تنظیمات فضای کاری | ❌ | ❌ | ✅ |
| حذف فضای کاری | ❌ | ❌ | ✅ |
| محیط آزمون | |||
| دسترسی به محیط آزمون | ✅ | ✅ | ✅ |
بهترین شیوه‌ها
راهنمای تخصیص نقش
نقش مالک:
- به 1 تا 2 نفر محدود کنید
- ذی‌نفعان کسب‌وکار
- افرادی که به دسترسی مالی نیاز دارند
- اعضای بلندمدت و مورد اعتماد تیم
نقش مدیر:
- تک‌لیدها
- توسعه‌دهندگان ارشد
- مهندسان DevOps
- افرادی که کلیدهای API تیم را مدیریت می‌کنند
- افرادی که نیازی به دسترسی مالی ندارند
نقش عضو:
- اعضای مستقل تیم
- پیمانکاران
- اعضای موقت تیم
- مشاوران خارجی
- توسعه‌دهندگان تازه‌کار
توصیه‌های امنیتی
افزودن عضو جدید:
- با کمترین سطح دسترسی دعوت کنید (ابتدا عضو)
- در صورت نیاز پس از ارزیابی به مدیر ارتقا دهید
- هرگز کسی را با نقش مالک شروع نکنید
خروج عضو از تیم:
- به‌محض ترک تیم توسط عضو، او را حذف کنید
- کلیدهای API او به‌طور خودکار لغو می‌شوند
- فعالیت اخیر او را در گزارش رخدادها بررسی کنید
- اگر او به کلیدهای تیمی دسترسی داشت، آن‌ها را تغییر دهید
بازبینی‌های منظم:
- فهرست اعضا را ماهانه بررسی کنید
- اعضای غیرفعال را حذف کنید
- نقش‌های دیگر لازم نیستند را تنزل دهید
- گزارش رخدادها را برای فعالیت مشکوک بررسی کنید
سازمان‌دهی تیم
تیم‌های کوچک (1 تا 5 نفر):
- 1 مالک
- بقیه به‌عنوان عضو
- در صورت نیاز به مدیر ارتقا دهید
تیم‌های متوسط (5 تا 20 نفر):
- 1 تا 2 مالک
- 2 تا 3 مدیر (سرپرست تیم)
- بقیه به‌عنوان عضو
تیم‌های بزرگ (بیش از 20 نفر):
- 1 تا 2 مالک (بنیان‌گذاران/مدیران ارشد)
- 5 تا 10 مدیر (سرپرست‌ها/مدیران)
- بقیه به‌عنوان عضو
- برای بخش‌های مختلف، چند فضای کاری جداگانه در نظر بگیرید
پشتیبانی از چند فضای کاری
کاربران می‌توانند عضو چند فضای کاری باشند:
جابه‌جایی بین فضاهای کاری:
- روی منوی فضای کاری در سربرگ داشبورد کلیک کنید
- فضای کاری دیگری را انتخاب کنید
- داشبورد با داده‌های آن فضای کاری بازخوانی می‌شود
منابع جداگانه:
- هر فضای کاری کیف پول خاص خود را دارد
- کلیدهای API جداگانه
- اعضای تیم جداگانه
- تحلیل‌های جداگانه
یک کاربر، نقش‌های متفاوت:
- می‌تواند در یک فضای کاری مالک باشد
- و در فضای کاری دیگر عضو باشد
- مجوزها مختص هر فضای کاری هستند
سناریوهای رایج
افزودن توسعه‌دهنده جدید
- با نقش عضو دعوت کنید
- دعوت را می‌پذیرد
- کلیدهای API شخصی می‌سازد
- از کلیدها در توسعه خود استفاده می‌کند
- مصرف او فقط در گزارش‌های خودش قابل مشاهده است
ارتقای سرپرست تیم
- توسعه‌دهنده به تک‌لید تبدیل می‌شود
- نقش را به مدیر تغییر دهید
- اکنون می‌تواند:
- کلیدهای API تیمی برای محیط عملیاتی بسازد
- تمام فعالیت تیم را ببیند
- اعضای جدید دعوت کند
- کلیدهای تیمی را مدیریت کند
- همچنان بدون دسترسی مالی (مالک هزینه‌ها را کنترل می‌کند)
پایان همکاری پیمانکار
- پیمانکار کار را به پایان رسانده است
- او را از فضای کاری حذف کنید
- کلیدهای API شخصی او لغو می‌شوند
- دیگر دسترسی ندارد
- در صورت نیاز می‌توان بعداً دوباره دعوت کرد
افزودن هم‌بنیان‌گذار توسط بنیان‌گذار
- ابتدا با نقش مدیر دعوت کنید
- سطح اعتماد را ارزیابی کنید
- در زمان مناسب به مالک ارتقا دهید
- اکنون در مسئولیت‌های مالی سهیم است
عیب‌یابی
عضو نمی‌تواند فضای کاری را ببیند
علل احتمالی:
- دعوت‌نامه هنوز پذیرفته نشده است
- ایمیل به پوشه اسپم رفته است
- آدرس ایمیل اشتباه استفاده شده است
راه‌حل:
- صفحه اعضا را برای دعوت‌نامه‌های در انتظار بررسی کنید
- دعوت‌نامه را دوباره ارسال کنید
- صحت آدرس ایمیل را بررسی کنید
- بررسی کنید کاربر با همان ایمیل ثبت‌نام کرده باشد
عضو نمی‌تواند کلید تیمی بسازد
مشکل: عضو در تلاش برای ساخت کلید تیمی است
علت: فقط مدیران و مالکان می‌توانند کلید تیمی بسازند
راه‌حل:
- مالک نقش او را به مدیر تغییر دهد
- یا او به استفاده از کلیدهای شخصی ادامه دهد
امکان تغییر نقش عضو وجود ندارد
مشکل: منوی کشویی نقش غیرفعال است
علل احتمالی:
- شما مالک نیستید
- در حال تلاش برای تغییر نقش خودتان هستید
- در حال تلاش برای تغییر نقش مالک دیگری هستید
راه‌حل: از مالک فعلی بخواهید این تغییر را انجام دهد
دعوت‌نامه منقضی شده است
مشکل: لینک ثبت‌نام کاربر جدید دیگر کار نمی‌کند
علت: دعوت‌نامه فقط به مدت 72 ساعت معتبر است
راه‌حل:
- مالک دعوت‌نامه را دوباره ارسال می‌کند
- کاربر 72 ساعت دیگر برای پذیرش فرصت دارد
- لینک به همان آدرس ایمیل ارسال می‌شود