AI 뉴스 → 인스타 캐러셀: Claude Code로 풀스택 자동화 MVP를 하루 만에 구축한 기록

┌─────────────────────────────────────────────────────┐
│  Turborepo Monorepo (pnpm workspace)                │
│                                                     │
│  ┌──────────────┐  ┌──────────────┐  ┌───────────┐  │
│  │ apps/admin   │  │ apps/worker  │  │ packages/ │  │
│  │ Next.js 15   │  │ Node.js+tsx  │  │ core      │  │
│  │ App Router   │  │ node-cron    │  │ types     │  │
│  │ Tailwind v4  │  │ 6-step pipe  │  │ DB layer  │  │
│  │ 관리 대시보드 │  │ 파이프라인    │  │ scoring   │  │
│  └──────┬───────┘  └──────┬───────┘  │ dedup     │  │
│         │                 │          └─────┬─────┘  │
│         └────────┬────────┘                │        │
│                  ▼                         │        │
│         ┌────────────────┐                 │        │
│         │   Supabase     │◄────────────────┘        │
│         │ Postgres + S3  │                          │
│         └────────────────┘                          │
└─────────────────────────────────────────────────────┘
           │                    │
           ▼                    ▼
   Instagram Graph API    OpenAI API (GPT-4o-mini)

score = (source_weight × 30) + (recency_score × 30) + (keyword_score × 40)

배경: #0F0F0F (다크) / 카드면: #1A1A2E
강조: #6C63FF(보라) ↔ #00D4AA(틸) 그라디언트
텍스트: #FFFFFF(주) / #B0B0C0(부)
폰트: Noto Sans KR Variable (10MB, 한국어 전체 글리프)
크기: 1080 × 1350px (Instagram 캐러셀 최적 비율)

이미지 7장 → 각각 child container 생성 (POST /{user-id}/media)
         → 각 container 상태 polling (GET /{container-id}?fields=status_code)
         → FINISHED 될 때까지 대기
         → carousel container 생성 (POST /{user-id}/media, children=[...])
         → carousel 상태 polling
         → media_publish (POST /{user-id}/media_publish)
         → permalink 조회 (GET /{media-id}?fields=permalink)

// Before (컴파일 에러)
const data = await response.json();
data.articles // ❌ 'unknown' 형식에 'articles' 속성이 없습니다

// After
const data = (await response.json()) as GNewsResponse;
data.articles // ✅

// 주요 프로덕션 의존성
"@supabase/supabase-js"  // DB + Storage
"openai"                  // GPT-4o-mini 요약
"satori"                  // JSX → SVG
"sharp"                   // SVG → PNG
"rss-parser"              // RSS 피드 파싱
"node-cron"               // 스케줄링
"pino"                    // 구조화된 로깅
"zod"                     // 런타임 검증
"next"                    // Admin 대시보드
"lucide-react"            // 아이콘

c:\node\새 폴더\
├── apps/
│   ├── admin/                  # Next.js 15 관리 대시보드
│   │   └── src/
│   │       ├── app/            # 4페이지 + 4 API 라우트
│   │       ├── components/     # 사이드바, 파이프라인 버튼
│   │       └── lib/            # Supabase 클라이언트
│   └── worker/                 # Node.js 파이프라인 워커
│       └── src/
│           ├── pipeline/       # 6단계 파이프라인
│           ├── collectors/     # RSS + API 수집기
│           ├── openai/         # GPT 요약 생성
│           ├── instagram/      # IG Graph API 연동
│           ├── templates/      # Satori 카드 템플릿 7종
│           └── cron/           # 스케줄러
├── packages/
│   └── core/                   # 공유 타입, DB, 스코어링, 중복제거
├── supabase/
│   └── migrations/             # DB 스키마 SQL
├── turbo.json
├── pnpm-workspace.yaml
└── package.json

# 1. 의존성 설치
pnpm install

# 2. 환경변수 설정
cp .env.example .env
# SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY, OPENAI_API_KEY,
# INSTAGRAM_ACCESS_TOKEN, INSTAGRAM_USER_ID 등 입력

# 3. Supabase SQL Editor에서 마이그레이션 실행
# supabase/migrations/001_initial.sql

# 4. Supabase Storage에 card-images 버킷 생성 (Public)

# 5. 개발 서버 실행
pnpm dev                           # admin + worker 동시
pnpm --filter @repo/worker run-now # 파이프라인 즉시 실행