지식센터 / 레퍼런스

[ARCH] 통합 DE 어드민 — 모듈러 아키텍처 설계서 v3.0

# 📋 BizSpring 통합 DE 어드민 — 모듈러 아키텍처 설계서

> v3.0 | 2026-03-29 | Phase: 📋 PLAN (DB 검증 완료)

> project_code: DATA_ENG | KHub ID: b3261b71

> v3.0: 전체 서비스(NotebookLM 11개 솔루션) 설계 포함, GP MySQL 계정체계 반영, Supabase 연동 설계

> v2.0: DB 실측 10건 수정. v1.0: 초판.

> 관련: 검증 리포트 f556f638, 계정 체계 0d8e87e6, 설계 브리프 160fd04b

---

1. 목표

11개 비즈스프링 솔루션을 독립 모듈로 설계 → Lovable 이관 → Claude MCP 제어 하에 결합·실행. LIFT 패턴 일반화.

2. 전체 서비스 모듈 맵 (NotebookLM 11개 솔루션 완전 매핑)

Phase 1 MVP — 즉시 구현 가능 (4개)

Phase 2 Core — 플랫폼 연동 (4개)

Phase 3 Extended — 전체 솔루션 (4개)

Phase 4 SaaS — 고객 접점 (3개)

공통 기반 모듈 (Phase 1과 동시)

총 18개 모듈 = 11 솔루션 모듈 + 4 확장 + 3 기반

3. GP MySQL 계정 체계 (통합 어드민의 근간)

핵심 구조 (상세: 0d8e87e6)

tb_agency (130, 4유형: 마스터/대행사/대리대행사/광고주)
  → tb_admin (201, RBAC 8역할)
    → tb_admin_role → tb_role → tb_role_privilege → tb_privilege(108)
  → tb_team (계층구조, parent_seq 자기참조)
    → tb_team_admin / tb_team_client
  → tb_client (265, client_option JSON)
    → tb_account (1,265, 매체별)
      → tb_media_license (387) → tb_media_api (API 토큰)

코드 체계 (tb_code 89그룹, tb_code_dtl 782건)

• 매체: 111 (41개), 대행사유형: 101 (4개), 상품: 103, 상태: 201 (6개)
• MA: 137~139, 리포트 필드: N/K/G/F/M/S 시리즈

Supabase 연동 설계

GP MySQL (SOT)              →(n8n 배치 동기화)→     Supabase growthplatform
─────────────────           ───────────────         ────────────────────────
tb_agency                   →                       de_admin_agencies (신규)
tb_admin + role             →                       de_admin_users (신규, Supabase Auth 연결)
tb_client                   → (기존 연결)           de_admin_clients
tb_account                  →                       de_admin_accounts (신규)
tb_code + code_dtl          →                       de_admin_codes (코드 캐시, 신규)
tb_media + license + api    →                       읽기 전용 (n8n relay)

원칙: GP MySQL → Supabase 단방향만. 역방향 쓰기 절대 금지.

4. 4-Layer 아키텍처

L1 Control:  Claude MCP + Lovable Host + n8n Orchestrator + Vercel CD
L2 UI:       18개 React 모듈 (Phase 1~4)
L3 API:      de-admin-api EF(Supabase 직접) + gp-admin-relay(n8n WF, MySQL 경유)
L4 Data:     GP MySQL + AP MySQL + Supabase×3 + BQ + ES/OS + Kafka×2

API Gateway 하이브리드

de-admin-api (Supabase EF) — Supabase 직접 접근
  ├── ?mod=lift      → lift_*, lift_stats(), gtm-api-test
  ├── ?mod=dmp       → de_dmp_*, 25+ RPC 직접 호출
  ├── ?mod=digo      → de_infl_* (influencer Supabase)
  ├── ?mod=feed      → de_feed_* (growthplatform 메타)
  ├── ?mod=etl       → de_etl_job_status
  ├── ?mod=auth      → de_admin_users + Supabase Auth
  ├── ?mod=code      → de_admin_codes (캐시)
  └── ?mod=system    → system_health_dashboard()

gp-admin-relay (n8n WF 신규) — GP MySQL 고정 쿼리
  ├── /service/clients        → tb_client 요약
  ├── /service/client/:id     → client_option JSON
  ├── /service/agencies       → tb_agency 목록
  ├── /media/codes            → tb_code_dtl(cd_no=111)
  ├── /media/licenses         → tb_media_license 목록
  ├── /report/jobs            → tb_report_job 현황
  └── /ma/campaigns           → tb_ma_campaign 현황

5. Lovable 이관 전략

Phase A: Claude Artifact → mod-lift PoC 검증
Phase B: Lovable 프로젝트 이관 (모듈 단위 페이지)
Phase C: Claude MCP 도구 등록 (각 mod API = 1 MCP tool)
Phase D: 복합 프로젝트 수행 (모듈 결합)
  예: "캘러웨이 풀스택" = mod-service + mod-feed + mod-media + mod-etl
  예: "신규 온보딩" = mod-lift + mod-service + mod-etl
  예: "전사 헬스체크" = mod-system + mod-etl + mod-media + mod-dmp

6. 신규 DB 리소스 계획

Phase 1 (PoC)

• lift_gtm_deployments: GTM 배포 이력
• lift_daily_stats() RPC: 일별 집계

Phase 2 (GP 연동)

• de_admin_agencies: tb_agency 동기화
• de_admin_users: tb_admin 동기화 + Supabase Auth
• de_admin_accounts: tb_account 동기화
• de_admin_codes: tb_code/code_dtl 캐시

Phase 3+

• de_admin_modules: 모듈 레지스트리
• de_admin_api_log: API 호출 로그

7. 세션 기록 문서 참조

v3.0 2026-03-29

관련 문서

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

• 없음

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