refactor(blog): 공개 목록 정책과 시리즈 surface 정리 (#119)

* docs(blog): 블로그 시스템 구축기 제목 검토 반영

공개 전 콘텐츠 리뷰 결과를 반영해 제목과 검토 메모를 갱신했습니다.

* refactor(blog): 공개 정책 경계 분리

목록, static params, 상세 조회가 하나의 visibility 정책을 공유하도록 모듈을 추출했습니다.

private 기본값과 preview 동작을 검증하고 ADR로 경계를 기록했습니다.

* refactor(blog): 상세 MDX 토큰 정렬

글 상세 헤더와 MDX 본문 표면을 semantic color와 radius token으로 통일했습니다.

토큰 적용을 회귀 테스트로 고정했습니다.

* refactor(blog): 발행 정책 중앙화

공개 Tech 글의 리뷰 하한과 featured 자격을 policy 모듈의 실행 기준으로 통합했습니다.

글별 큐레이션 데이터는 meta.json에 유지하고 ADR로 경계를 기록했습니다.

* fix(content): 감사 정책 기준 공유

Node 기반 content audit이 앱 정책과 같은 JSON 기준을 사용하도록 변경했습니다.

공개 Tech와 featured 검증·요약의 기준 불일치를 방지했습니다.

* fix(blog): 공개 목록 발행 정책 적용

검토 기준을 충족하지 못한 public 글과 부적격 featured 글이 목록, 상세, static path에 노출되지 않도록 repository 경계에서 정책을 적용했습니다.

* refactor(blog): 시리즈 탐색 surface 제거

사용되지 않는 시리즈 route, 탐색 컴포넌트, model helper와 Archive 필터를 제거하고 legacy /series 요청은 Engineering으로 정리했습니다.

* chore(deps): Next와 React patch 업데이트

Next 16.2.10과 React 19.2.7로 patch 업데이트하고 production build를 확인했습니다.

---------

Co-authored-by: 박은우 <noah@bag-eun-uui-MacBookAir.local>

Author: dev-wooyeon

AGENTS.md

@@ -42,8 +42,8 @@ ADR 작성 기준:
 ## 프로젝트 구조
 
 - `app/`: Next.js App Router route adapter, route handler, metadata entry
-- `blog/`: 글 도메인. post schema, repository, publication policy, series,
-  blog UI, RSS feed serialization, view-count use case
+- `blog/`: 글 도메인. post schema, repository, publication policy, blog UI,
+  RSS feed serialization, view-count use case
 - `resume/`: 이력서 도메인. resume data, ordering, resume UI
 - `site/`: 도메인 조합 layer. home, AppShell, navigation, provider, site config
 - `infra/`: 외부/런타임 인프라. Supabase, Umami analytics, SEO helper,

app/engineering/series/[seriesId]/page.tsx

@@ -38,6 +38,9 @@ describe('sitemap', () => {
     );
     expect(urls).not.toContain(`${SITE_URL}/blog`);
     expect(urls).not.toContain(`${SITE_URL}/series`);
+    expect(
+      urls.some((url) => url.includes('/engineering/series/'))
+    ).toBe(false);
   });
 
   it('uses updated date for post lastModified when available', () => {

app/sitemap.test.ts

@@ -1,5 +1,4 @@
 import { MetadataRoute } from 'next';
-import { getSeriesSummaries } from '@/blog/model/series-group';
 import { getSortedFeedData } from '@/blog/services/post-repository';
 import {
   SITE_FEED_PATH,
@@ -17,15 +16,6 @@ export default function sitemap(): MetadataRoute.Sitemap {
     priority: 0.7,
   }));
 
-  const seriesEntries = getSeriesSummaries(
-    feeds.filter((feed) => feed.category === 'Tech')
-  ).map((series) => ({
-    url: createSiteUrl(`/engineering/series/${encodeURIComponent(series.id)}`),
-    lastModified: series.latestDate,
-    changeFrequency: 'weekly' as const,
-    priority: 0.6,
-  }));
-
   const routePaths: SitePath[] = [
     '',
     '/archive',
@@ -43,5 +33,5 @@ export default function sitemap(): MetadataRoute.Sitemap {
     priority: 1,
   }));
 
-  return [...routes, ...seriesEntries, ...feedEntries];
+  return [...routes, ...feedEntries];
 }

app/sitemap.ts

@@ -4,9 +4,11 @@ import { describe, expect, it } from 'vitest';
 import type { FeedData } from '@/blog/model/types';
 import { getAllFeedSlugs, getSortedFeedData } from './post-repository';
 import {
+  filterListedPosts,
   filterVisiblePosts,
   getCoreTechReviewAverage,
   isEligibleForFeaturedPost,
+  isListedPost,
   isPostVisible,
   meetsPublicTechReviewThreshold,
   PUBLICATION_POLICY,
@@ -64,6 +66,29 @@ describe('publication policy', () => {
     ).toBe(false);
   });
 
+  it('excludes public tech posts that fail review thresholds from public listings', () => {
+    const belowThresholdPost: FeedData = {
+      title: 'Below threshold',
+      slug: 'below-threshold',
+      description: 'desc',
+      date: '2026-01-01',
+      category: 'Tech',
+      contentType: 'essay',
+      visibility: 'public',
+      qualityReview: {
+        philosophy: 2,
+        design: 2,
+        implementation: 2,
+      },
+    };
+
+    expect(isListedPost(belowThresholdPost)).toBe(false);
+    expect(isListedPost(belowThresholdPost, { includePrivate: true })).toBe(
+      true
+    );
+    expect(filterListedPosts([belowThresholdPost])).toEqual([]);
+  });
+
   it('keeps every private post out of public listings and static paths', () => {
     const allPosts = getSortedFeedData({ includePrivate: true });
     const privatePosts = allPosts.filter(

blog/model/series-group.test.ts

@@ -17,13 +17,48 @@ export function isPostVisible(
   return options.includePrivate || post.visibility === 'public';
 }
 
+export function isListedPost(
+  post: FeedData,
+  options: PublicationQueryOptions = {}
+): boolean {
+  const visibility = post.visibility ?? 'private';
+
+  if (visibility !== 'public') {
+    return options.includePrivate === true;
+  }
+
+  if (options.includePrivate) {
+    return true;
+  }
+
+  if (
+    post.category === 'Tech' &&
+    !meetsPublicTechReviewThreshold(post.qualityReview)
+  ) {
+    return false;
+  }
+
+  if (post.featured && !isEligibleForFeaturedPost(post)) {
+    return false;
+  }
+
+  return true;
+}
+
 export function filterVisiblePosts<T extends Pick<FeedData, 'visibility'>>(
   posts: T[],
   options: PublicationQueryOptions = {}
 ): T[] {
   return posts.filter((post) => isPostVisible(post, options));
 }
 
+export function filterListedPosts<T extends FeedData>(
+  posts: T[],
+  options: PublicationQueryOptions = {}
+): T[] {
+  return posts.filter((post) => isListedPost(post, options));
+}
+
 export function getCoreTechReviewAverage(
   review: QualityReview | undefined
 ): number | null {

blog/model/series-group.ts

@@ -7,7 +7,6 @@ import {
   calculateReadingTime,
   getFeedData,
   getFolderSlug,
-  getSeriesPosts,
   getSortedFeedData,
   getAllFeedSlugs,
 } from './post-repository';
@@ -60,19 +59,6 @@ ${'x'.repeat(5000)}
     expect(hasExtractedImage).toBe(true);
   });
 
-  it('does not retain learning series migrated to llm-wiki', () => {
-    expect(getSeriesPosts('redis-deep-dive', { includePrivate: true })).toEqual(
-      []
-    );
-    expect(getSeriesPosts('flink-mastery', { includePrivate: true })).toEqual(
-      []
-    );
-  });
-
-  it('returns empty array for unknown series id', () => {
-    expect(getSeriesPosts('non-existent-series-id')).toEqual([]);
-  });
-
   it('returns slug list with all feed entries', () => {
     const slugs = getAllFeedSlugs();