지식센터 / 레퍼런스

🔀 서브방 핸드오프: SoM 분석 설정 모달 v2

# 🔀 서브방 핸드오프: SoM 분석 설정 모달

> 메인방 작성: 2026-02-17 (v2 업데이트)

> 서브방 프로토콜: ①작업설명+승인대기 ②승인 후 실행 ③결과보고

---

전체 진행 상태

---

배경

SoM 분석 실행/재실행을 위한 공용 설정 모달 신규 개발.

해결하는 문제

1. 업종(industry) null → 쿼리 품질 저하: 모달에서 업종 필수 입력
2. 재분석 불가: SoM 페이지에서 직접 실행 가능
3. 어드민 대행 불가: 어드민 패널에서 고객사 대신 실행 가능

---

✅ 메인방 완료 사항

A1~A3. Quota 백엔드

• gp_geoex_som_usage 테이블 — RLS, UNIQUE(user_id, site_domain, period_start)
• check_som_quota(p_user_id, p_site_domain, p_is_admin) → allowed, remaining, limit, used
• increment_som_usage(p_user_id, p_site_domain, p_executed_by) → UPSERT

A4. Realtime Publication

ALTER PUBLICATION supabase_realtime ADD TABLE gp_geoex_som_results;

A5. Premium-2 WF 병렬화 (v9.4)

WF: https://bawee.app.n8n.cloud/workflow/4ZSWwyYmqVqEOVVjyEWSM

SplitInBatches → ┬ OpenAI → Save → Merge[0] ─┐
                 ├ Anthropic → Save → Merge[1] ─┤→ Loop
                 ├ Perplexity → Save → Merge[2] ─┤
                 └ Gemini → Save → Merge[3] ─┘

LLM별 즉시 개별 저장 → Realtime 3~8초 간격 1건씩 수신

---

✅ 작업 1+2 (커밋 cf78b2b)

queriesReviewed UX

SoM 라이브 피드

Realtime 구독:

const channel = baweeSupabase
  .channel(`som-results-${siteDomain}`)
  .on('postgres_changes', {
    event: 'INSERT', schema: 'public',
    table: 'gp_geoex_som_results',
    filter: `site_domain=eq.${siteDomain}`
  }, (payload) => { /* payload.new = LLM 결과 1건 */ })
  .subscribe();

---

⏳ Phase C (메인방 승인 필요)

C1. SoM Orchestrator 파라미터

WF: SXdgnGyUFMAP9oTB

https://bawee.app.n8n.cloud/workflow/SXdgnGyUFMAP9oTB

{
  "force_regenerate_queries": false,
  "skip_report": true,
  "executed_by": "user"
}

C2. Quota 체크

CONFIG 직후 → check_som_quota → If allowed=false → 에러 → 완료 후 increment_som_usage

---

Phase B 잔여 (서브방 자율)

B3. SomAnalysisModal Props

interface SomAnalysisModalProps {
  open: boolean;
  onOpenChange: (open: boolean) => void;
  siteDomain: string;
  userId: string;
  mode: 'user' | 'admin';
  adminTargetUserId?: string;
  onAnalysisStarted?: () => void;
}

Submit 핸들러

await fetch('https://bawee.app.n8n.cloud/webhook/geo/som/pipeline', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    user_id, site_domain,
    force_regenerate_queries: queryMode === 'regenerate',
    skip_report: true,
    executed_by: mode === 'admin' ? `admin:${userId}` : 'user'
  })
});

B4. QueryListSubModal

쿼리 목록/수정/삭제(soft)/추가, 5~30개 제한

참조 코드

---

테스트 시나리오

• T1: dentistestore.kr (20쿼리) → 모달 → 간편재분석 → force_regenerate:false
• T2: 새 사이트 (쿼리 0개) → 자동 생성 → force_regenerate:true
• T3: 업종 변경 → 재생성 → force_regenerate:true
• T4: 어드민 모드 → quota 무제한 → increment 미호출
• T5: 라이브 피드 → 3~8초 간격 → 80건 → 3초 후 자동 종료

관련 문서

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

• 없음

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