Merge pull request #104 from dev-wooyeon/codex/move-next-app-root

refactor(architecture): 루트 모듈 경계 정리

Author: dev-wooyeon

.gitignore

@@ -41,5 +41,4 @@ next-env.d.ts
 .husky/
 .sisyphus/
 .claude/
-/.agentation/
 .idea

AGENTS.md

@@ -6,15 +6,17 @@
 - 현재 MDX 파이프라인을 보존한다. MDX는 `next.config.mjs`의 `@mdx-js/loader`
   기반 커스텀 webpack rule에 남겨둔다. 전체 콘텐츠 파이프라인을 의도적으로
   마이그레이션하지 않는 한 Next.js 내장 MDX로 바꾸지 않는다.
-- 시각화 중심 UI는 `shared/visualization/`에 둔다. 블로그 MDX가 재사용하는
-  시각화 컴포넌트는 도메인 코드가 아니라 shared 시각화 모듈로 관리한다.
+- 시각화 중심 UI는 `blog/ui/visualization/`에 둔다. 블로그 MDX가 재사용하는
+  시각화 컴포넌트는 블로그 콘텐츠 렌더링 책임으로 관리한다.
 - `any`를 사용하지 않는다. 구체 타입을 쓰거나 `unknown`과 narrowing을
   사용한다.
 - `p-[13px]` 같은 arbitrary Tailwind value를 사용하지 않는다. 표준 utility,
-  shared token, 기존 스타일 패턴을 사용한다.
+  ui token, 기존 스타일 패턴을 사용한다.
 - DDD의 전략적 설계 개념을 차용한 domain-first modular monolith 구조를
-  유지한다. 주요 도메인은 `src`와 같은 최상위 모듈로 분리하고, `src/app`은
-  Next.js route adapter로 제한한다.
+  유지한다. `app/`은 Next.js route adapter로 제한하고, 주요 도메인은
+  저장소 최상위 모듈로 분리한다.
+- `src/` 디렉터리를 재도입하지 않는다. 새 코드 경계는 `app/`, 도메인 모듈,
+  `site/`, `infra/`, `ui/`, `styles/` 중 하나에 둔다.
 - 블로그 콘텐츠 구조는 `posts/**/index.mdx`와 주변 `meta.json`으로 유지한다.
   중첩된 series 디렉터리도 보존한다.
 - 변경이 아래 ADR 작성 조건에 걸리면 반드시 ADR을 작성하거나 갱신한다.
@@ -39,19 +41,18 @@ ADR 작성 기준:
 
 ## 프로젝트 구조
 
-- `src/app/`: Next.js App Router route adapter, route handler, metadata entry
+- `app/`: Next.js App Router route adapter, route handler, metadata entry
 - `blog/`: 글 도메인. post schema, repository, publication policy, series,
-  blog UI, view-count use case
+  blog UI, RSS feed serialization, view-count use case
 - `resume/`: 이력서 도메인. resume data, ordering, resume UI
 - `search/`: 검색 도메인. command palette, search action, recommendation
 - `site/`: 도메인 조합 layer. home, AppShell, navigation, provider, site config
-- `platform/`: 외부/런타임 인프라. Supabase, Umami analytics, SEO helper,
-  devtool integration
-- `shared/`: 도메인 지식 없는 UI primitive, motion helper, testing helper,
-  visualization widget
+- `infra/`: 외부/런타임 인프라. Supabase, Umami analytics, SEO helper,
+  integration adapter
+- `ui/`: 도메인 지식 없는 UI primitive, layout primitive, motion helper
 - `styles/`: design token과 global style
 - `posts/`: 중첩 가능한 `index.mdx`와 `meta.json` 기반 블로그 콘텐츠
-- `tests/`: Playwright E2E 테스트
+- `tests/`: Playwright E2E 테스트와 Vitest support helper
 - `tooling/`: script와 tool configuration
 
 ## 개발 명령

ARCHITECTURE.md

@@ -74,17 +74,17 @@
 
 ```text
 eunu.log/
-├── 📁 src/
-│   └── 📁 app/                 # Next.js route adapter
+├── 📁 app/                     # Next.js route adapter
 ├── 📁 blog/                    # 글 도메인
 ├── 📁 resume/                  # 이력서 도메인
 ├── 📁 search/                  # 검색 도메인
 ├── 📁 site/                    # 홈, AppShell, provider, site config
-├── 📁 platform/                # Supabase, Umami, SEO, devtool integration
-├── 📁 shared/                  # 도메인 지식 없는 UI/모션/테스트/시각화
+├── 📁 infra/                   # Supabase, Umami, SEO integration
+├── 📁 ui/                      # 도메인 지식 없는 UI/레이아웃/모션
 ├── 📁 styles/                  # 전역 스타일과 토큰
 ├── 📁 tests/
-│   └── 📁 e2e/                 # Playwright E2E 테스트
+│   ├── 📁 e2e/                 # Playwright E2E 테스트
+│   └── 📁 support/             # Vitest support helper
 ├── 📁 tooling/
 │   ├── 📁 config/              # lint/spell 설정
 │   └── 📁 scripts/             # 자동화/유틸 스크립트

README.md

@@ -1,8 +1,8 @@
 'use client';
 
 import { useEffect } from 'react';
-import { RouteError } from '@/shared/ui';
-import { AnalyticsEvents, trackEvent } from '@/platform/analytics/lib/analytics';
+import { RouteError } from '@/ui';
+import { AnalyticsEvents, trackEvent } from '@/infra/analytics/lib/analytics';
 
 interface BlogPostErrorProps {
   error: Error & { digest?: string };

src/app/api/og/route.tsx app/api/og/route.tsxsrc/app/api/og/route.tsx renamed to app/api/og/route.tsx

@@ -1,8 +1,8 @@
 'use client';
 
 import { useEffect } from 'react';
-import { RouteError } from '@/shared/ui';
-import { AnalyticsEvents, trackEvent } from '@/platform/analytics/lib/analytics';
+import { RouteError } from '@/ui';
+import { AnalyticsEvents, trackEvent } from '@/infra/analytics/lib/analytics';
 
 interface BlogErrorProps {
   error: Error & { digest?: string };