20260502 작업로그

Claude-Code Says

⏺ 오늘 작업 내용입니다.

---

### 1. OG 이미지 미노출 수정

**문제**: 어떤 페이지에서도 SNS 공유 시 OG 이미지가 나타나지 않음

**원인**: Next.js metadata shallow merge — `/blog/[category]/page.tsx`에서 `openGraph: { title, url }`만 반환해 root layout의 `openGraph.images`가 통째로 덮어씌워짐

**수정**:
- `layout.tsx` — `metadataBase` 추가
- `/blog/[category]` — `openGraph.images` + `twitter` 메타 추가 (fallback OG 이미지)
- `/blog/[category]/[path]`, `/projects/[path]` — `twitter` 카드 메타 추가 (포스트 첫 이미지 또는 fallback)

---

### 2. README·CLAUDE.md 문서 업데이트

**CLAUDE.md**: `og.ts` 유틸, `/api/notion-image` 라우트 문서화, SEO 섹션에 `metadataBase`·Google/Naver 인증·OG 동작 방식·twitter 카드 추가, sitemap ISR 24시간 항목 추가

**README**: PRD 형식으로 재정비 — "완료된 인프라 항목" 섹션을 "SEO·배포 스펙" 명세로 전환, 범위 표에 SEO/PWA/Analytics 추가, 페이지 정의에 OG 이미지 동작 명세 추가

---

### 3. 홈 위젯 이미지 간헐적 유실 수정

**문제**: profile-cms `img` 이미지(`BookWidget`, `NowWidget`)가 자꾸 깨짐

**원인**: `/api/notion-image` 라우트의 `unstable_cache`가 Route Handler에서 불안정하게 동작 → 만료된 Notion 서명 URL이 캐시에 잔류. `stale-while-revalidate=3600`이 너무 길어 문제 지속

**수정**: `unstable_cache` → `fetch + next: { revalidate: 240 }` 교체, `stale-while-revalidate` 3600→60초 단축

---

전체 변경사항은 [PR #5](https://github.com/joyfive/joyfive-blog/pull/5)에 포함되어 있습니다.

NEXT