# سازمان، اعضا و نقش‌ها

> https://docs.errora.org/account/organizations

**سازمان** مالک پروژه‌ها، اعضا، یکپارچه‌سازی‌ها، کانال‌ها، داشبوردها، کیف پول و سیاست نگه‌داری
داده است. هر کاربر هنگام ثبت‌نام یک **سازمان شخصی** می‌گیرد و می‌تواند سازمان‌های بیشتری بسازد
یا به آن‌ها بپیوندد.

## ساخت سازمان

**جابه‌جاگر سازمان (بالای نوار کناری) ← سازمان جدید.** شما `owner` آن می‌شوید.

```text
GET/POST /api/v1/organizations
```

## دعوت افراد

دعوت‌نامه با **پیامک** به شمارهٔ موبایل ایران فرستاده می‌شود — همان شناسه‌ای که با آن وارد
می‌شوند.

1. **تنظیمات ← اعضا ← دعوت**.
2. شمارهٔ موبایل را وارد کنید و نقش را انتخاب کنید.
3. دعوت‌شونده پیامکی با یک پیوند می‌گیرد؛ با باز کردن آن و ورود، به سازمان می‌پیوندد.

```bash
curl -X POST "$ERRORA/api/v1/organizations/$ORG_ID/invite" \
  -H "Authorization: Bearer $ACCESS_TOKEN" -H "Content-Type: application/json" \
  -d '{"phone":"09121234567","role":"member"}'
```

دعوت تا پذیرفته‌شدن در وضعیت `pending` می‌ماند و پس از پایان بازه منقضی می‌شود؛ برای صدور
دعوت تازه دوباره دعوت کنید.

```text
GET   /api/v1/organizations/{id}/members
PATCH /api/v1/organizations/{id}/members/{member_id}     # تغییر نقش
GET   /api/v1/organizations/{id}/invites
POST  /api/v1/organizations/{id}/invite
GET   /api/v1/invites/preview/{token}
POST  /api/v1/invites/accept
```

## نقش‌ها و دسترسی‌ها

پنج نقش که **در سطح سازمان** و در صورت نیاز **در سطح پروژه** اعمال می‌شوند (نقش پروژه برای
همان پروژه بر نقش سازمان می‌چربد):

| نقش | برای چه کسی |
| --- | --- |
| `owner` | کنترل کامل، از جمله حذف سازمان |
| `admin` | همه‌چیز به‌جز کارهای در سطح مالکیت |
| `member` | کار روزمره: تفکیک خطاها، اجرای رفع خودکار |
| `billing` | کیف پول، مصرف و پرداخت‌ها — بدون دسترسی فنی |
| `viewer` | فقط خواندن |

نقش‌ها از راه یک **ماتریس توانمندی** ترجمه می‌شوند و هر نقطهٔ API به‌جای نام نقش، یک توانمندی
را بررسی می‌کند:

| توانمندی | اجازه می‌دهد |
| --- | --- |
| `org:manage` | تغییر نام/حذف سازمان، مدیریت اعضا و نقش‌ها |
| `org:billing` | دیدن و تغییر صورتحساب، دیدن مصرف و پرداخت‌ها |
| `project:create` | ساخت پروژه |
| `project:manage` | تنظیمات پروژه، کلیدهای DSN، حذف |
| `project:read` | دیدن خطاها، رویدادها، لاگ‌ها و داشبوردها |
| `issue:write` | حل/نادیده‌گرفتن/واگذاری/کامنت و ثبت گزارش کاربر |
| `ai:trigger` | شروع اجرای رفع خودکار |
| `integration:manage` | اتصال و همگام‌سازی یکپارچه‌سازی کنترل نسخه |
| `webhook:manage` | مدیریت کانال‌های اعلان و قواعد هشدار |

### نقش در سطح پروژه

به یک پیمانکار در سطح سازمان `viewer` بدهید و روی همان یک پروژه‌ای که کار می‌کند `member`.
برای آن پروژه، نقش پروژه برنده است.

## تنظیمات سازمان

**تنظیمات ← سازمان**: نام، اسلاگ و [نگه‌داری داده](/account/retention). حذف سازمان، پروژه‌ها و
همهٔ داده‌هایشان را حذف می‌کند — بازگشتی در کار نیست.

### الزام احراز هویت دومرحله‌ای

مالک و ادمین می‌توانند [۲FA](/account/auth) را برای کل سازمان الزامی کنند. تا وقتی روشن است،
عضوی که TOTP را فعال نکرده، در هر درخواست به دادهٔ این سازمان رد می‌شود (`403 2fa_required`) و
داشبورد او را به پروفایل می‌فرستد تا فعالش کند؛ سازمان‌های دیگرش بی‌تأثیر می‌مانند.

روشن‌کردن این گزینه فقط وقتی ممکن است که خودتان ۲FA را فعال کرده باشید، وگرنه از سازمانی که
تازه امن کرده‌اید بیرون می‌مانید. در تب اعضا، افرادی که هنوز فعال نکرده‌اند مشخص‌اند.

## عیب‌یابی

| نشانه | علت / راه‌حل |
| --- | --- |
| پیامک دعوت نمی‌رسد | شماره یک موبایل معتبر `09…` نیست، یا پیامک تأخیر دارد — یک دقیقه بعد دوباره دعوت کنید |
| دعوت‌شونده در سازمان اشتباهی است | دعوت دیگری را پذیرفته — بخش **دعوت‌ها** را ببینید |
| `403` هنگام انجام یک کار | نقش، آن توانمندی را ندارد؛ به‌جای حدس‌زدن ماتریس بالا را ببینید |
| آخرین owner حذف نمی‌شود | هر سازمان باید دست‌کم یک owner داشته باشد — اول کسی را ارتقا دهید |