조직

조직은 Kisenon에서 멤버십과 청구의 단위입니다. 모든 프로젝트 — 그리고 따라서 그 아래의 모든 브랜치, 엔드포인트, 역할, 데이터베이스 — 는 정확히 하나의 조직에 속합니다.

조직이란

처음 로그인할 때, Kisenon은 당신을 위한 개인 조직을 만들고 당신을 그 소유자로 만듭니다. 전적으로 그 안에서 작업하거나, 나중에 팀 조직을 만들고 다른 사람을 초대할 수 있습니다.

조직은 멤버십과 비용이 결부되는 것들을 소유합니다:

• 프로젝트. 모든 프로젝트는 하나의 조직에 있으며, 프로젝트 이름은 그 안에서만 고유하면 됩니다.
• 청구. 플랜, 할당량, 사용량은 조직별로 집계됩니다.
• 감사. 작업 로그는 조직 범위입니다 — 모든 멤버는 조직 내 모든 프로젝트의 활동을 읽을 수 있습니다.

멤버 및 역할

각 멤버십은 네 가지 역할 중 하나를 지닙니다. 콘솔은 역할로 UI를 사전 게이팅하고, 컨트롤 플레인은 서버 측에서 동일한 하한을 적용하므로, 게이트를 건너뛰는 클라이언트도 여전히 403을 받습니다. 각 동작에는 최소 역할이 있습니다 — 그 이상인 사람은 누구나 수행할 수 있습니다.

역할은 viewer < member < admin < owner 순으로 순위가 매겨집니다. viewer는 읽기 전용이고, member는 빌드(프로젝트, 브랜치, 엔드포인트, 키)할 수 있지만 사람을 관리할 수는 없으며, admin은 멤버 및 초대 관리를 추가하고, owner는 추가로 청구, 소유권 이전, 그리고 삭제를 통제합니다.

조직 전환

활성 조직은 당신 세션의 일부입니다. 조직 전환기는 콘솔의 상단 바에 있습니다: 활성 조직과 당신이 속한 모든 조직의 드롭다운을 보여주며, 각각 거기서의 당신 역할로 태그됩니다.

다른 조직을 선택하면 /api/auth/switch-org로 POST되어 세션 토큰을 대상 조직으로 범위를 다시 지정하여 발행하고 그 프로젝트로 다시 로드합니다. 같은 드롭다운에서 멤버와 조직 설정에 도달하거나 새 조직을 만들 수도 있습니다.

CLI에서 활성 조직은 자격 증명별입니다. 다음으로 설정하세요:

keon orgs switch <org-id>

이는 저장된 자격 증명에 default_org_id를 씁니다. --org-id 또는 KEON_ORG_ID 환경 변수로 단일 호출에 대해 재정의할 수 있습니다. 각 API 키는 생성될 때 조직에 바인딩되며, 컨트롤 플레인은 그 키를 바인딩된 조직에 대해서만 인가합니다.

관리

• 이름 변경. 조직 설정 → 신원에서 관리자 이상이 조직 이름을 변경할 수 있습니다.
• 멤버 역할. 조직의 멤버 페이지에서 관리자 이상이 멤버의 역할을 변경하거나 제거합니다. 컨트롤 플레인은 마지막 소유자를 강등하거나 제거하는 변경을 거부합니다.
• 떠나기. 조직 설정의 위험 구역(그리고 keon orgs leave)은 당신을 조직에서 제거합니다. 유일한 소유자라면, 컨트롤 플레인은 요청을 차단합니다 — 떠나기 전에 다른 사람을 승격하거나 소유권을 이전하세요.

관련 문서

• 초대 — 조직에 사람 추가하기.
• 청구 — 조직별로 범위가 지정된 플랜, 할당량, 사용량.
• 프로젝트 — 조직이 담고 있는 것.