# 📋 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개 시나리오 테스트 필요:
1. 무료 분석 (job 1개만 생성)
2. PremiumStatusGuard 재시도 (통합 URL + job_id)
3. Admin Hub 재트리거 (plan_type 분기)

### KHub 문서 업데이트
- 온보딩 레퍼런스 v2→v3: `58fa4631-18fc-4343-9314-2570956f9640`
- DevLog Snapshot: `061e5edb-9f55-4a2d-b7dc-a89e6bef16d8`


## FAQ


---
출처: https://bizspring.ai/kb/ref/khub/geocare-geocare-changelog-w08-2-2026-02-21-phase0-통합-리팩토링 · 최종 갱신 2026-08-24T11:53:44.684733+00:00