Skip to content

Commit 8ce886d

Browse files
committed
docs(architecture): 구조 결정과 유지 문서 정리
루트 모듈 경계와 공개 route 경계를 ADR 0013에 정리했어요. 유지되지 않는 실행 계획, research dump, product/design 초안 문서를 제거하고 사람용 문서와 AI 작업 기준을 분리했어요.
1 parent e6e11ab commit 8ce886d

53 files changed

Lines changed: 234 additions & 3489 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

AGENTS.md

Lines changed: 13 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -6,15 +6,17 @@
66
- 현재 MDX 파이프라인을 보존한다. MDX는 `next.config.mjs``@mdx-js/loader`
77
기반 커스텀 webpack rule에 남겨둔다. 전체 콘텐츠 파이프라인을 의도적으로
88
마이그레이션하지 않는 한 Next.js 내장 MDX로 바꾸지 않는다.
9-
- 시각화 중심 UI는 `shared/visualization/`에 둔다. 블로그 MDX가 재사용하는
10-
시각화 컴포넌트는 도메인 코드가 아니라 shared 시각화 모듈로 관리한다.
9+
- 시각화 중심 UI는 `blog/ui/visualization/`에 둔다. 블로그 MDX가 재사용하는
10+
시각화 컴포넌트는 블로그 콘텐츠 렌더링 책임으로 관리한다.
1111
- `any`를 사용하지 않는다. 구체 타입을 쓰거나 `unknown`과 narrowing을
1212
사용한다.
1313
- `p-[13px]` 같은 arbitrary Tailwind value를 사용하지 않는다. 표준 utility,
14-
shared token, 기존 스타일 패턴을 사용한다.
14+
ui token, 기존 스타일 패턴을 사용한다.
1515
- DDD의 전략적 설계 개념을 차용한 domain-first modular monolith 구조를
16-
유지한다. 주요 도메인은 `src`와 같은 최상위 모듈로 분리하고, `src/app`
17-
Next.js route adapter로 제한한다.
16+
유지한다. `app/`은 Next.js route adapter로 제한하고, 주요 도메인은
17+
저장소 최상위 모듈로 분리한다.
18+
- `src/` 디렉터리를 재도입하지 않는다. 새 코드 경계는 `app/`, 도메인 모듈,
19+
`site/`, `infra/`, `ui/`, `styles/` 중 하나에 둔다.
1820
- 블로그 콘텐츠 구조는 `posts/**/index.mdx`와 주변 `meta.json`으로 유지한다.
1921
중첩된 series 디렉터리도 보존한다.
2022
- 변경이 아래 ADR 작성 조건에 걸리면 반드시 ADR을 작성하거나 갱신한다.
@@ -39,19 +41,18 @@ ADR 작성 기준:
3941

4042
## 프로젝트 구조
4143

42-
- `src/app/`: Next.js App Router route adapter, route handler, metadata entry
44+
- `app/`: Next.js App Router route adapter, route handler, metadata entry
4345
- `blog/`: 글 도메인. post schema, repository, publication policy, series,
44-
blog UI, view-count use case
46+
blog UI, RSS feed serialization, view-count use case
4547
- `resume/`: 이력서 도메인. resume data, ordering, resume UI
4648
- `search/`: 검색 도메인. command palette, search action, recommendation
4749
- `site/`: 도메인 조합 layer. home, AppShell, navigation, provider, site config
48-
- `platform/`: 외부/런타임 인프라. Supabase, Umami analytics, SEO helper,
49-
devtool integration
50-
- `shared/`: 도메인 지식 없는 UI primitive, motion helper, testing helper,
51-
visualization widget
50+
- `infra/`: 외부/런타임 인프라. Supabase, Umami analytics, SEO helper,
51+
integration adapter
52+
- `ui/`: 도메인 지식 없는 UI primitive, layout primitive, motion helper
5253
- `styles/`: design token과 global style
5354
- `posts/`: 중첩 가능한 `index.mdx``meta.json` 기반 블로그 콘텐츠
54-
- `tests/`: Playwright E2E 테스트
55+
- `tests/`: Playwright E2E 테스트와 Vitest support helper
5556
- `tooling/`: script와 tool configuration
5657

5758
## 개발 명령

ARCHITECTURE.md

Lines changed: 0 additions & 139 deletions
This file was deleted.

README.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -74,17 +74,17 @@
7474

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

docs/DESIGN.md

Lines changed: 0 additions & 22 deletions
This file was deleted.

docs/FRONTEND.md

Lines changed: 0 additions & 32 deletions
This file was deleted.

docs/PLANS.md

Lines changed: 0 additions & 16 deletions
This file was deleted.

docs/PRODUCT_SENSE.md

Lines changed: 0 additions & 19 deletions
This file was deleted.

docs/QUALITY_SCORE.md

Lines changed: 0 additions & 29 deletions
This file was deleted.

0 commit comments

Comments
 (0)