Matrix 계정 구조 개편안

등장하는 주체

권한은 이 네 주체를 기준으로 정해요.

누가 무엇을 보나

아래 버튼을 누르면 그 주체에게 보이는 계정만 강조돼요. 브랜드 A~D는 서로 별개인 브랜드 계정이에요.

권한 규칙

주체별로 보는 범위, 할 수 있는 일, 권한을 받는 방법이에요.

이럴 땐 이렇게

운영하면서 자주 생길 상황이에요.

지금과 무엇이 달라지나

엔티티

권한 판정에 필요한 최소 단위만 적었어요. 성과 데이터는 ad_account에 붙어 있다고 가정해요.

관계도

브랜드 계정이 중심이고, 사용자는 세 경로 중 하나로 광고 계정에 닿아요.

erDiagram
  BRAND_ACCOUNT ||--o{ AD_ACCOUNT : "소유"
  RETAILER ||--o{ AD_ACCOUNT : "판매처"
  BRAND_ACCOUNT ||--o{ BRAND_MEMBER : "멤버"
  USER ||--o{ BRAND_MEMBER : "소속"
  BRAND_ACCOUNT ||--o{ AGENCY_GRANT : "위임"
  AGENCY ||--o{ AGENCY_GRANT : "위임받음"
  AGENCY ||--o{ USER : "직원"
  RETAILER ||--o{ USER : "직원"
  BRAND_ACCOUNT {
    bigint id PK
    string name
    bigint owner_user_id FK
  }
  AD_ACCOUNT {
    bigint id PK
    bigint brand_account_id FK
    bigint retailer_id FK
    timestamp retail_consented_at
  }
  BRAND_MEMBER {
    bigint brand_account_id FK
    bigint user_id FK
    string role
    string permission
  }
  AGENCY_GRANT {
    bigint id PK
    bigint brand_account_id FK
    bigint agency_id FK
    string permission
    timestamp granted_at
    timestamp revoked_at
  }
  USER {
    bigint id PK
    string user_type
    bigint agency_id FK
    bigint retailer_id FK
  }

권한 판정 로직

광고 계정 하나에 대해 사용자의 권한을 구해요. 결과는 edit, view, null(안 보임) 중 하나예요. edit은 view를 포함해요.

function access(user, ad):            // → 'edit' | 'view' | null
  if user.user_type == 'madup':  return 'edit'            // 어드민

  m = brand_member(ad.brand_account_id, user.id)
  if m:                                                 // ① 브랜드 멤버십
    return m.role == 'owner' ? 'edit' : m.permission

  if user.user_type == 'agency':                        // ② 에이전시 위임
    g = agency_grant(ad.brand_account_id, user.agency_id, revoked_at IS NULL)
    if g: return g.permission                             // 기간 필터 없음: 위임 전 성과도 보임

  if user.user_type == 'retail' and user.retailer_id == ad.retailer_id:
    return 'view'                                        // ③ 리테일 매칭 (동의는 생성 시 필수)

  return null

function canManage(user, brand_account_id):         // 에이전시 추가·제외, 담당자 배정, 권한 값 지정
  return user.user_type == 'madup'
      or brand_member(brand_account_id, user.id).role == 'owner'

권한 매트릭스

한 브랜드 계정을 기준으로 주체별로 할 수 있는 일이에요.

불변 조건

어떤 경로로 데이터를 바꿔도 깨지면 안 되는 규칙이에요. DB 제약이나 서비스 검증으로 막아 주세요.

주요 시나리오와 데이터 변화

개발팀 확인 질문

기획에서 아직 정하지 않았거나, 구현 방식에 따라 달라지는 부분이에요.

1. 에이전시·리테일 조직 안의 사용자 범위.위임이 그 조직 직원 전원에게 적용되는지, 조직 안에서 다시 사람별로 배정해야 하는지.
2. 광고 계정 유일성.같은 브랜드 계정·리테일 조합에 광고 계정이 2개 이상 생길 수 있는지. 아니라면 (brand_account_id, retailer_id) UNIQUE.
3. 광고 계정을 만드는 주체.소유자, 어드민, 에이전시 중 누가 생성할 수 있는지.
4. 브랜드 계정 분리 시 기존 광고 계정 이동.A를 A-1, A-2로 나눌 때 광고 계정과 성과 이력을 옮기는 방법.
5. 기존 권한 이관.지금 브랜드 단위로 준 권한을 소유자·담당자·에이전시 중 무엇으로 옮길지 매핑 기준.
6. 권한 변경 이력.위임·해제·권한 값 변경을 감사 로그로 남길지.