refactor(home): 최신순 단일 피드로 단순화

홈의 정렬 선택 UI와 런타임 인기 조회 경로를 제거했습니다.
카테고리 필터는 저장소의 최신순을 보존하고 홈을 정적 생성으로 되돌렸습니다.

글 상세의 누적 조회수와 중복 방지 계약은 유지했습니다.

Author: dev-wooyeon

app/page.test.ts

@@ -1,8 +1,6 @@
 import type { Metadata } from 'next';
 import { SITE_DESCRIPTION, SITE_NAME, createSiteUrl } from '@/site/config/site';
 
-export const dynamic = 'force-dynamic';
-
 const homeUrl = createSiteUrl();
 
 export const metadata: Metadata = {

app/page.tsx

@@ -1,12 +1,7 @@
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
 import { cookies, headers } from 'next/headers';
 import { getSupabaseServerClient } from '@/infra/integrations/supabase';
-import {
-  getPopularViewsInRecentDays,
-  getViewCount,
-  incrementView,
-  trackView,
-} from './view';
+import { getViewCount, incrementView, trackView } from './view';
 
 vi.mock('@/infra/integrations/supabase', () => ({
   getSupabaseServerClient: vi.fn(),
@@ -28,9 +23,6 @@ type SupabaseLike = {
   __queryMock: {
     select: ReturnType<typeof vi.fn>;
     eq: ReturnType<typeof vi.fn>;
-    gte: ReturnType<typeof vi.fn>;
-    order: ReturnType<typeof vi.fn>;
-    limit: ReturnType<typeof vi.fn>;
     maybeSingle: ReturnType<typeof vi.fn>;
   };
 };
@@ -51,9 +43,6 @@ function createQueryMock(payload: {
   return {
     select: vi.fn().mockReturnThis(),
     eq: vi.fn().mockReturnThis(),
-    gte: vi.fn().mockReturnThis(),
-    order: vi.fn().mockReturnThis(),
-    limit: vi.fn().mockResolvedValue(payload),
     maybeSingle: vi.fn().mockResolvedValue(payload),
   };
 }
@@ -78,23 +67,6 @@ function createSupabaseMock(options: {
 const mockedGetSupabase = vi.mocked(getSupabaseServerClient);
 const mockedCookies = vi.mocked(cookies);
 const mockedHeaders = vi.mocked(headers);
-const originalNextPhase = process.env.NEXT_PHASE;
-const originalNpmLifecycleEvent = process.env.npm_lifecycle_event;
-
-function restoreBuildPhaseEnv() {
-  if (originalNextPhase === undefined) {
-    delete process.env.NEXT_PHASE;
-  } else {
-    process.env.NEXT_PHASE = originalNextPhase;
-  }
-
-  if (originalNpmLifecycleEvent === undefined) {
-    delete process.env.npm_lifecycle_event;
-  } else {
-    process.env.npm_lifecycle_event = originalNpmLifecycleEvent;
-  }
-}
-
 function createCookieStoreMock(
   visitorId: string | null = null
 ): CookieStoreLike {
@@ -118,7 +90,6 @@ function createHeaderStoreMock(
 
 describe('view actions', () => {
   beforeEach(() => {
-    restoreBuildPhaseEnv();
     vi.clearAllMocks();
     mockedCookies.mockResolvedValue(createCookieStoreMock());
     mockedHeaders.mockResolvedValue(
@@ -130,10 +101,6 @@ describe('view actions', () => {
     );
   });
 
-  afterEach(() => {
-    restoreBuildPhaseEnv();
-  });
-
   it('increments view when slug is valid and client exists', async () => {
     const client = createSupabaseMock({
       queryPayload: { data: { count: 10 }, error: null },
@@ -358,93 +325,4 @@ describe('view actions', () => {
       })
     );
   });
-
-  it('fetches recent daily view totals through the popular views rpc', async () => {
-    const client = createSupabaseMock({
-      queryPayload: { data: null, error: null },
-      rpcPayload: {
-        data: [
-          {
-            slug: 'a',
-            count: 10,
-            updated_at: '2026-03-05T00:00:00.000Z',
-          },
-          {
-            slug: 'b',
-            count: 10,
-            updated_at: '2026-03-04T00:00:00.000Z',
-          },
-        ],
-        error: null,
-      },
-    });
-    mockedGetSupabase.mockReturnValue(client);
-
-    const result = await getPopularViewsInRecentDays(30, 5);
-
-    expect(client.rpc).toHaveBeenCalledWith('get_popular_views', {
-      days_input: 30,
-      limit_input: 5,
-    });
-    expect(result).toEqual([
-      { slug: 'a', count: 10, updated_at: '2026-03-05T00:00:00.000Z' },
-      { slug: 'b', count: 10, updated_at: '2026-03-04T00:00:00.000Z' },
-    ]);
-  });
-
-  it('returns empty list when supabase is unavailable for popular query', async () => {
-    mockedGetSupabase.mockReturnValue(null);
-
-    const result = await getPopularViewsInRecentDays(30, 5);
-
-    expect(result).toEqual([]);
-  });
-
-  it('returns empty list when popular query fails', async () => {
-    const client = createSupabaseMock({
-      queryPayload: { data: null, error: null },
-      rpcPayload: {
-        data: null,
-        error: { message: 'failed' },
-      },
-    });
-    mockedGetSupabase.mockReturnValue(client);
-
-    const result = await getPopularViewsInRecentDays(30, 5);
-
-    expect(result).toEqual([]);
-  });
-
-  it('skips popular query during production build phase', async () => {
-    process.env.NEXT_PHASE = 'phase-production-build';
-    mockedGetSupabase.mockReturnValue(
-      createSupabaseMock({
-        queryPayload: {
-          data: [{ slug: 'a', count: 10, updated_at: '2026-03-05' }],
-          error: null,
-        },
-        rpcPayload: { data: 0, error: null },
-      })
-    );
-
-    const result = await getPopularViewsInRecentDays(30, 5);
-
-    expect(result).toEqual([]);
-    expect(mockedGetSupabase).not.toHaveBeenCalled();
-  });
-
-  it('normalizes invalid day/limit inputs for popular query', async () => {
-    const client = createSupabaseMock({
-      queryPayload: { data: null, error: null },
-      rpcPayload: { data: [], error: null },
-    });
-    mockedGetSupabase.mockReturnValue(client);
-
-    await getPopularViewsInRecentDays(0, 0);
-
-    expect(client.rpc).toHaveBeenCalledWith('get_popular_views', {
-      days_input: 1,
-      limit_input: 1,
-    });
-  });
 });

blog/api/view.test.ts

@@ -11,7 +11,6 @@ const VIEW_FINGERPRINT_SALT =
   `${SITE_BRAND.technicalName}-view-fingerprint-v1`;
 const VIEW_FALLBACK_VISITOR_COOKIE = 'view_visitor_id';
 const VIEW_FALLBACK_VISITOR_COOKIE_MAX_AGE_SECONDS = 60 * 60 * 24 * 365;
-const NEXT_PHASE_PRODUCTION_BUILD = 'phase-production-build';
 const shouldLogViewIssues = process.env.NODE_ENV !== 'test';
 
 function readErrorField(error: unknown, field: 'code' | 'message'): string {
@@ -55,13 +54,6 @@ function logViewError(message: string, error: unknown): void {
   );
 }
 
-function isProductionBuildPhase(): boolean {
-  return (
-    process.env.NEXT_PHASE === NEXT_PHASE_PRODUCTION_BUILD ||
-    process.env.npm_lifecycle_event === 'build'
-  );
-}
-
 function normalizeSlug(slug: string): string | null {
   const value = slug.trim();
   return value.length > 0 ? value : null;
@@ -80,14 +72,6 @@ function toCount(value: unknown): number | null {
   return null;
 }
 
-function normalizePositiveInt(value: number, fallback: number): number {
-  if (!Number.isFinite(value)) {
-    return fallback;
-  }
-
-  return Math.max(1, Math.floor(value));
-}
-
 function readHeaderValue(
   headerStore: Awaited<ReturnType<typeof headers>>,
   names: string[]
@@ -186,12 +170,6 @@ function isLegacyIncrementViewSignatureError(error: {
   );
 }
 
-export interface PopularViewEntry {
-  slug: string;
-  count: number;
-  updated_at: string;
-}
-
 async function readViewCount(slug: string): Promise<number | null> {
   const supabase = getSupabaseServerClient();
   if (!supabase) {
@@ -305,62 +283,3 @@ export async function trackView(slug: string): Promise<number | null> {
 
   return readViewCount(normalizedSlug);
 }
-
-export async function getPopularViewsInRecentDays(
-  days: number,
-  limit: number
-): Promise<PopularViewEntry[]> {
-  if (isProductionBuildPhase()) {
-    return [];
-  }
-
-  const supabase = getSupabaseServerClient();
-  if (!supabase) {
-    logViewWarning(
-      'Supabase env is missing. Returning empty popular view list.'
-    );
-    return [];
-  }
-
-  const normalizedDays = normalizePositiveInt(days, 30);
-  const normalizedLimit = normalizePositiveInt(limit, 5);
-  const { data, error } = await supabase.rpc('get_popular_views', {
-    days_input: normalizedDays,
-    limit_input: normalizedLimit,
-  });
-
-  if (error) {
-    logViewError('Failed to fetch popular view entries.', error);
-    return [];
-  }
-
-  if (!Array.isArray(data)) {
-    return [];
-  }
-
-  return data
-    .map((entry) => {
-      const count = toCount(entry.count);
-      const slug = typeof entry.slug === 'string' ? entry.slug.trim() : '';
-      const updatedAt =
-        typeof entry.updated_at === 'string' ? entry.updated_at : '';
-
-      if (!slug || count === null || !updatedAt) {
-        return null;
-      }
-
-      return {
-        slug,
-        count,
-        updated_at: updatedAt,
-      } satisfies PopularViewEntry;
-    })
-    .filter((entry): entry is PopularViewEntry => entry !== null)
-    .sort((a, b) => {
-      if (a.count === b.count) {
-        return a.updated_at < b.updated_at ? 1 : -1;
-      }
-
-      return b.count - a.count;
-    });
-}

blog/api/view.ts

@@ -15,13 +15,7 @@ export {
   type SeriesGroup,
   type SeriesSummary,
 } from './model/series-group';
-export {
-  getPopularViewsInRecentDays,
-  getViewCount,
-  incrementView,
-  trackView,
-  type PopularViewEntry,
-} from './api/view';
+export { getViewCount, incrementView, trackView } from './api/view';
 export type {
   Feed,
   FeedData,

blog/index.ts

@@ -22,6 +22,7 @@ Last updated: 2026-07-13
 - `docs/adr/0021-load-heavy-mdx-visualizations-on-demand.md`
 - `docs/adr/0022-default-new-posts-to-private.md`
 - `docs/adr/0023-run-the-release-quality-gate-in-ci.md`
+- `docs/adr/0024-use-latest-only-home-feed.md`
 - `docs/blog-quality-guide.md`
 - `docs/database/db-schema.md`
 - `docs/database/supabase-view-count.sql`

docs/README.md

@@ -1,7 +1,8 @@
 # 0018. 콘텐츠 탐색 표면에 의미 기반 반경과 무그림자 상태를 사용한다
 
 Date: 2026-07-13
-Status: Accepted
+Status: Accepted; sort-control clause amended by
+[0024](0024-use-latest-only-home-feed.md)
 
 ## 배경
 

docs/adr/0018-use-semantic-surface-tokens-for-content-discovery.md

@@ -1,7 +1,7 @@
 # 0020. 인기 피드를 런타임 일별 조회수로 계산한다
 
 Date: 2026-07-13
-Status: Accepted
+Status: Superseded by [0024](0024-use-latest-only-home-feed.md)
 Supersedes: 0015
 
 ## 배경

docs/adr/0020-use-runtime-daily-views-for-popular-feed.md

@@ -0,0 +1,50 @@
+# 0024. 홈 피드를 최신순 단일 경로로 유지한다
+
+Date: 2026-07-13
+Status: Accepted
+Supersedes: 0020
+Amends: 0018의 정렬 컨트롤과 회귀 테스트 결정
+
+## 배경
+
+홈의 인기순은 최근 30일 조회수 집계를 위해 동적 route, Supabase RPC, 일별
+조회수 테이블과 클라이언트 정렬 상태를 요구한다. 그러나 운영 환경에는 해당
+RPC가 적용되지 않아 인기순을 선택해도 최신순으로 fallback되고 있었다.
+
+개인 블로그의 기본 탐색에서는 최신 기록을 시간순으로 보는 경로가 더 예측
+가능하다. 낮은 사용 가치에 비해 런타임 외부 의존, 배포 순서와 실패 fallback을
+유지하는 비용이 크다.
+
+## 결정
+
+- 홈 글 목록은 발행일 내림차순만 사용한다.
+- 최신순과 인기순 선택 UI 및 클라이언트 정렬 상태를 제거한다.
+- 카테고리 필터는 유지하며 필터 결과도 저장소가 제공한 최신순을 보존한다.
+- 홈에서 Supabase 인기 조회수를 읽지 않고 정적 생성 가능 상태로 되돌린다.
+- 글 상세의 누적 조회수와 중복 방지, Umami 분석은 ADR 0007에 따라 유지한다.
+- ADR 0020 전용 일별 인기 집계 API와 저장소 계약은 제거한다.
+- ADR 0018의 의미 기반 반경과 무그림자 표면 결정은 유지하되, 정렬 컨트롤과
+  해당 회귀 테스트 결정만 이 ADR로 대체한다.
+
+## 결과
+
+- 홈의 순서와 버튼 상태가 어긋나는 fallback 문제가 사라진다.
+- 홈 요청마다 Supabase RPC를 실행하지 않는다.
+- 인기 집계를 위한 DB 배포 선행 조건이 사라진다.
+- 오래된 글의 재발견은 카테고리, 검색과 시리즈 경로에 의존한다.
+- 인기순을 다시 도입하려면 실제 제품 필요와 데이터 계약을 새 ADR에서 다시
+  결정해야 한다.
+
+## 검토한 대안
+
+- UI만 숨기고 인기 집계 인프라 유지: 사용처 없는 코드와 DB 계약이 남는다.
+- 운영 RPC를 적용해 인기순 복구: 정확성은 해결하지만 현재 필요한 탐색
+  경로보다 운영 비용이 크다.
+- 최신순을 기본값으로 두고 인기순 유지: 단일 탐색 경로로 단순화하려는 목적과
+  맞지 않는다.
+- Umami 인기 페이지를 홈에 사용: 분석 도구와 사용자 UI를 결합하고 별도 실패
+  계약이 필요하다.
+
+## Related History
+
+- `9379593`: 최근 30일 인기 조회 집계 도입