Documentation / Organizations
مدیریت سازمانها
سازمان در Gitrabbit لایهٔ بالاتر از مخزن است: چند مخزن را زیر یک نام تیم جمع میکند، نقش سازمانی برای هر عضو تعریف میشود و پایهٔ پوشهبندی مخازن و فیلتر درختی داشبورد است. ساخت و مدیریت از داشبورد، مسیر /organizations انجام میشود.
۱. ورود و مسیرها
- لیست سازمانها: /organizations — از سایدبار داشبورد «سازمانها».
- تنظیمات یک سازمان: /organizations/<orgId> — نام، توضیحات، مخازن متصل.
- پوشهبندی: جدا از این صفحه، در /repo-folders/<orgId> (راهنمای جدا).
- برای هر عملیات باید وارد حساب شده باشید و عضو فعال همان سازمان باشید.
۲. ساخت سازمان
- از «سازمان جدید» نام (حداقل ۲ کاراکتر) و توضیحات اختیاری (تا ۵۰۰ کاراکتر) وارد کنید.
- slug از نام ساخته میشود (مثلاً @team-product) و در صورت تکراری، پسوند عددی میگیرد.
- سازنده بهصورت خودکار نقش مالک (owner) میگیرد.
- پلن رایگان سازمان (free) هنگام ایجاد ثبت میشود.
۳. نقشها و دسترسی
هر عضو یکی از این نقشها را دارد:
| نقش | خلاصه |
|---|---|
| مالک (owner) | ویرایش نام/توضیحات، حذف سازمان (بدون مخزن)، افزودن/جدا کردن مخزن، پوشهبندی |
| مدیر (admin) | افزودن/جدا کردن مخزن، پوشهبندی؛ بدون حذف سازمان یا org.manage |
| توسعهدهنده (developer) | مشاهده سازمان و مخازن؛ بدون مدیریت ساختار |
| بیننده (viewer) | فقط مشاهده |
مجوزهای کلیدی: org.manage (فقط مالک)، repos.organize (مالک و مدیر برای پوشه و جابجایی مخزن).
۴. اتصال مخزن به سازمان
- در صفحهٔ تنظیمات سازمان، بخش مخازن سازمان لیست مخزنهای متصل را نشان میدهد.
- مالک یا مدیر از dropdown «افزودن مخزن»، مخزنی را که مالک آن هستید و هنوز به این سازمان وصل نشده انتخاب میکند.
- مخزن تازه اضافهشده ابتدا بدون پوشه است؛ دستهبندی در workspace پوشهبندی انجام میشود.
- «جدا کردن» فقط پیوند سازمان را قطع میکند؛ خود مخزن و تاریخچهٔ Git حذف نمیشود.
ویرایش اطلاعات سازمان
فقط مالک میتواند نام و توضیحات را ذخیره کند. با تغییر نام، slug در صورت نیاز بهروز میشود.
۵. حذف سازمان
- فقط مالک، از API با مجوز org.manage میتواند سازمان را حذف کند.
- اگر حتی یک مخزن به سازمان وصل باشد، حذف رد میشود — ابتدا همهٔ مخازن را جدا کنید.
- با حذف، عضویتها، پوشهها و اشتراک سازمان پاک میشوند.
۶. API (خلاصه)
- GET /api/organizations — لیست سازمانهای کاربر
- POST /api/organizations — ایجاد (بدنه: name، description)
- GET /api/organizations/<orgId> — جزئیات، پوشهها، مخازن
- PATCH /api/organizations/<orgId> — ویرایش (مالک)
- POST /api/organizations/<orgId>/repos — اتصال مخزن
- DELETE /api/organizations/<orgId>/repos/<repoId> — جدا کردن
مرحلهٔ بعد: پوشهبندی مخازن برای ساخت درخت پوشه و فیلتر درختی در داشبورد.