지식센터 / 레퍼런스

📋 GEOcare Changelog W08-2 (2026-02-21) — Phase0 통합 리팩토링

# GEOcare Changelog W08-2 (2026-02-21) ## Phase0 통합 리팩토링 — Starter/Paid WF 병합 ### 배경 소스 코드 검증 결과 Phase0 온보딩에 심각한 구조적 버그 6건 발견. Starter/Paid 2개 WF를 1개로 통합하고 프론

핵심 요약

# GEOcare Changelog W08-2 (2026-02-21)

Phase0 통합 리팩토링 — Starter/Paid WF 병합

배경

소스 코드 검증 결과 Phase0 온보딩에 심각한 구조적 버그 6건 발견. Starter/Paid 2개 WF를 1개로 통합하고 프론트엔드 3파일 수정.

버그 수정 상세

BUG-1: 이중 Job INSERT (🔴 Critical)

원인: 프론트 createAnalysisJob() INSERT + n8n 📋 Create Analysis Job INSERT → 2개 row
프론트는 자기 job_id 폴링(pending 영원), n8n은 자기 job 업데이트(completed)
수정: n8n If(job_id) 분기 — 있으면 PATCH(프론트 job), 없으면 POST(Admin Hub)

BUG-2: Webhook URL 하드코딩 (🔴 Critical)

원인: analysisJobService.ts:199 onboarding-free-start-v8 하드코딩
유료 고객도 Starter WF(crawl_limit=20, SoM 미실행)로 처리
수정: 프론트 3파일 → onboarding-start-analysis-v8 통합

BUG-3: Starter WF 비활성 (🔴 Critical)

원인: UNCEDNu4Bft6g3Nx 비활성 상태 → 신규 분석 404
수정: 통합 WF v8.1로 대체

BUG-4: Status 이중 업데이트 (🟡 Medium)

원인: 프론트 status='queued' UPDATE + n8n status='crawling' PATCH → 경쟁
수정: 프론트 UPDATE 제거, n8n 단독 담당

BUG-5: Code 노드 SB_KEY 하드코딩 (🟡 Medium)

원인: 💾 Save Brand & Site Settings Code 노드에 SB_KEY 직접 작성
수정: HTTP Request 노드 2개(UPSERT site/brand)로 전환

BUG-6: 병렬 저장 Race Condition (🟡 Medium)

원인: 병렬A(크롤링) / 병렬B(저장) → Completion Handler가 brand 조회 시 미저장 가능
수정: UPSERT를 메인 경로 앞 순차 배치

n8n WF 변경

[Phase0][Main] 유무료 온보딩 v8.1 (tViiA9NQOeVXh0B8)

이전: 6노드 (Webhook → Plan Settings → Create Job → Crawl → Respond + 병렬 Code)
이후: 9노드 순차 플로우

Webhook → 💾 UPSERT site → 💾 UPSERT brand → ⚙️ Plan Settings
  → ❓ Has Job ID?
    ├─ [true]  → 📋 PATCH Existing Job
    └─ [false] → 📋 POST New Job
                    → 🚀 geo-crawl-start → ✅ Respond

Determine Plan Settings 필드: plan_type(default:'starter'), crawl_limit(20/50/100), site_domain, user_id, job_id, brand_name, industry

프론트엔드 커밋

레포	Commit	파일	변경
geocare	9d06ad5c	analysisJobService.ts	URL 통합, plan_type:'starter' 추가, status 업데이트 제거
geocare	655baa64	PremiumStatusGuard.tsx	WEBHOOK_URLS→단일URL, job_id+plan_type 전달
geocare-admin-hub	18480092	UserDetailPage.tsx	free URL 통합, plan_type 동적매핑(starter/tier)

🔴 프론트 테스트 대기

Lovable 빌드 후 3개 시나리오 테스트 필요:

무료 분석 (job 1개만 생성)
PremiumStatusGuard 재시도 (통합 URL + job_id)
Admin Hub 재트리거 (plan_type 분기)

KHub 문서 업데이트

온보딩 레퍼런스 v2→v3: 58fa4631-18fc-4343-9314-2570956f9640
DevLog Snapshot: 061e5edb-9f55-4a2d-b7dc-a89e6bef16d8

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

없음

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