지식센터 / 레퍼런스

[ARCH] GP MySQL gp_prod 계정·권한·연동 체계 레퍼런스

# 📊 GP MySQL gp_prod 계정·권한·연동 체계 레퍼런스

> v1.0 | 2026-03-29 | DB 실측 기반 | project_code: DATA_ENG

> 접근: n8n-bizspring webhook gp-mysql-temp3 (WF: FICNrkmVL8NKguT3)

> 관련: GP MySQL 데이터 구조 432148ba, GP MySQL 접근 가이드 344622a1

---

1. gp_prod 전체 도메인 분류 (183 objects = 174T + 9V)

---

2. 계정 체계 ER 다이어그램

tb_role (8개 역할)
  ├── super(1) / admin(2) / feign(3)         ← 시스템 역할
  ├── manager(11) / editor(12) / viewer(13)  ← 대행사 역할
  └── client_editor(22) / client_viewer(23)  ← 광고주 역할
       │
       ↓ tb_role_privilege (540건 = role×privilege 매핑)
tb_privilege (108개 기능 권한)

tb_agency (130건, agency_tp: 마스터/대행사/대리대행사/광고주)
  │ seq(PK), agency_nm, agency_tp, agency_option(JSON), act_st
  │
  ├── tb_agency_app (596건 = 앱 연동)
  │
  ├── → tb_admin (201건, agency_seq FK)
  │     │ seq(PK), admin_id, admin_pw, admin_nm, admin_option(JSON)
  │     │ act_st, agency_seq(FK), email_verified
  │     │ 상태: 사용중 194, 사용불가_D 10, 사용종료 7
  │     │
  │     ├── tb_admin_role (226건 = admin↔role N:M 매핑)
  │     │     admin_seq(FK) → role_seq(FK)
  │     │
  │     └── tb_admin_app (0건 = admin별 앱 권한, 미사용)
  │
  ├── → tb_team (agency_seq FK, parent_seq 계층)
  │     │ seq(PK), team_nm, team_level, parent_seq(자기참조)
  │     │
  │     ├── tb_team_admin (219건 = team↔admin 매핑)
  │     └── tb_team_client (248건 = team↔client 매핑)
  │
  └── → tb_client (265건, agency_seq FK)
        │ seq(PK), client_nm, client_option(JSON ★핵심), act_st
        │
        └── → tb_account (1,265건)
              │ agency_seq, account_no, media_tp, account_nm
              │ account_option(JSON), license_seq(FK)
              │
              └── tb_media_license (387건)
                    │ seq(PK), license_nm, media_tp, agency_seq
                    │ admin_seq, api_seq, license_option(JSON)
                    │
                    └── tb_media_api (매체별 API 토큰)
                          seq(PK), api_nm, media_tp, token, api_option(JSON)

---

3. 역할(RBAC) 체계 상세

tb_role (8건)

tb_privilege (108건)

• role_privilege (540건) = 8 role × 평균 67.5 privilege
• 기능 단위 권한 매핑 (메뉴/API 엔드포인트별)

---

4. 대행사 유형 코드 (tb_code cd_no=101)

---

5. 상태 코드 (tb_code cd_no=201 ACTIVE_ST)

---

6. 매체 코드 (tb_code cd_no=111, 41개)

주요 광고 매체 (API 수집 대상)

네이버(001), 카카오(002), 구글(003), 페이스북(004), 인스타그램(005), 카카오모먼트(006), 틱톡(008), GFA(009/015), 모비온(011), 타겟팅게이츠(012), 데이블(013), ADN(014), 쿠팡(016), 당근(017)

내부/연동 매체

로거(111), 비즈메일러(112), 부스트(113), 에어브릿지(114), 파이어베이스(131), 구글애즈(132), 구글드라이브(133), 카카오브랜드검색(134), 카카오친구톡(135), 크리테오(136), RTB하우스(137)

커머스 매체

11번가(141/142), 다나와(143), 이베이(144), 인터파크(145), 롯데온(146), 티몬(147), 위메프(148), 엠플랜잇(149)

기타

메일침프(121), 아이메일러(122), 아이하트(123), FTP(124), API GFA(009), 템플릿(901)

---

7. 코드 체계 전체 (tb_code 89그룹)

엔터티 유형 코드

작업/프로세스 코드

상태 코드

MA(마케팅 자동화) 코드

리포트 필드 코드 (매체별)

N01~N12 (네이버), K01~K05 (카카오), G01~G02 (구글), F01~F04 (페이스북), M01~M04 (카카오모먼트), S11~S15 (기타 매체)

대량 처리/엑셀 코드

501~505 (광고 대량처리), 601~606 (엑셀), 511 (키워드 유틸리티), 801 (신문사)

---

8. 외부 서비스 연동 체인

tb_media_api (매체별 API 인증)
  │ api_nm, media_tp, token(512), api_option(JSON)
  │
  ↓ tb_media_license (라이선스 = API + 매체 + 대행사 연결)
  │ license_nm, media_tp, api_seq(FK), agency_seq(FK), admin_seq(FK)
  │ license_option(JSON)
  │
  ↓ tb_account (광고 계정 = 라이선스 하위)
  │ account_no(bigint), media_tp, license_seq(FK), agency_seq(FK)
  │
  ↓ client_option.media[] (클라이언트별 매체 계정 매핑)
    JSON 배열로 media_tp + account_no 조합

연동 흐름: 매체 API 등록(api) → 라이선스 생성(license) → 계정 연결(account) → 클라이언트 할당(client_option.media[])

---

9. GP MySQL ↔ Supabase 연동 설계 방향

원칙: GP MySQL = SOT(Single Source of Truth)

GP MySQL (기존 운영)                    Supabase (어드민 UI)
────────────────────                    ──────────────────────
tb_agency (130)        ──sync──→       de_admin_agencies
tb_admin (201)         ──sync──→       de_admin_users
tb_client (265)        ──sync──→       de_admin_clients (기존)
tb_account (1,265)     ──sync──→       de_admin_accounts
tb_role + privilege    ──sync──→       Supabase RLS policies
tb_media + license     ──read──→       n8n relay (읽기 전용)
tb_code + code_dtl     ──cache──→      de_admin_codes (코드 캐시)

동기화 방식 (향후 구현)

• 일일 배치: n8n Cron → GP MySQL SELECT → Supabase UPSERT
• 이벤트 기반: GP에서 변경 시 → Kafka → n8n webhook → Supabase 갱신
• 변경 불가: Supabase → GP MySQL 역방향 쓰기 절대 금지

Supabase bawee 기존 어드민 테이블 (참고)

gp_admin_deals, _contacts, _notes, _deal_activities, _deal_emails (영업 CRM)

gp_admin_tickets, _ticket_messages, _plan_changes (운영)

gp_admin_secrets, _secret_access_log (보안)

gp_service_plans, _subscriptions, _projects, _project_sites, _usage (SaaS 구독)

user_profiles, user_domain_access (Supabase Auth)

---

10. 마케팅 자동화(MA) 테이블 구조

---

v1.0 2026-03-29 — DB 실측 기반 전수 조사

관련 문서

이 문서를 참조하는 문서 (역링크)

• 없음

다른 표현: Markdown · JSON · 최종 갱신 2026-08-24