docs(10_Wiki): 위키 전체 재구성 — Topic_* 폴더를 4개 카테고리로 통합 + 대규모 중복 제거
Topic_Agent/Topic_Blog/Topics/Topics_Biz/Topics_Meeting/Topics_Rag의 마크다운 지식 문서를 Topic_General/Topic_Programming/Topic_Graphic/Topic_Business 4개 카테고리로 재분류. - 중복 제거: frontmatter의 status:duplicate/merged + duplicate_of/redirect_to 필드로 자기 자신을 중복으로 선언한 리다이렉트 stub 1032개 제거, 완전 동일 내용 파일 472개 제거, 동일 파일명·다른 내용 충돌 시 더 큰(완전한) 버전만 유지(162개 제거) — 총 1639개 중복 제거. - 분류: 폴더 단위로 명확한 항목(AI_and_ML/Coding/Architecture 등 → Programming, Comfyui/Visual_Effects → Graphic, Topics_Biz/Topics_Meeting/사업 등 → Business, Poetic_Blog_Writing/창의성/Game_Design 등 → General)은 폴더 우선순위로, 나머지 혼재 폴더(Topic_Agent/Topic_Blog/Topics 루트/Thinking & Reasoning/Other/UI_UX_Assets)는 title/tags 키워드 스코어링으로 파일 단위 분류(불명확한 경우 General로 폴백). 원본 폴더명은 "From_*" 서브폴더로 보존해 추적 가능성 유지. - 최종 배치: Programming 2784 / General 1608 / Graphic 285 / Business 249 = 4926개 문서. - 에이전트 운영 상태(.astra/.agent/.obsidian/sessions/memory/_company/docs/lessons/_shared/src)는 지식 콘텐츠가 아니므로 재분류 대상에서 제외하고 원위치 유지. - Topics/Topic_email(상위 보호 폴더 Topic_email과 파일명 100% 중복) 삭제 — 보호 폴더 자체는 미변경. - 완전히 비게 된 Topic_Agent/Topic_Blog/Topics_Biz/Topics_Rag 폴더 제거.
This commit is contained in:
@@ -0,0 +1,31 @@
|
||||
---
|
||||
category: DevOps_and_Security
|
||||
tags: [auto-wikified, technical-documentation, devops_and_security]
|
||||
title: Monorepo (Turborepo/Nx)
|
||||
description: "모노레포(Monorepo)는 Turborepo나 Nx와 같은 도구를 사용하여 복잡한 의존성 그래프를 관리하고 대규모 애플리케이션 환경을 지원하는 산업 표준 아키텍처 패턴이다 [1]."
|
||||
last_updated: 2026-05-04
|
||||
---
|
||||
|
||||
# Monorepo (Turborepo/Nx)
|
||||
|
||||
## 📌 Brief Summary
|
||||
모노레포(Monorepo)는 Turborepo나 Nx와 같은 도구를 사용하여 복잡한 의존성 그래프를 관리하고 대규모 애플리케이션 환경을 지원하는 산업 표준 아키텍처 패턴이다 [1]. 고객 포털, 관리자 대시보드, 모바일 앱 등 여러 애플리케이션과 공유 라이브러리를 단일 저장소(Single repository)에서 함께 호스팅할 수 있게 해준다 [1]. 주로 코드의 재사용성을 높이고 지능형 캐싱 등을 통해 빌드 및 CI/CD 시간을 단축하며, 마이크로서비스 간의 공통 DTO나 UI 컴포넌트를 효과적으로 공유하기 위해 도입된다 [1, 2].
|
||||
|
||||
## 📖 Core Content
|
||||
* **다중 애플리케이션과 공유 코드의 단일 저장소 관리**
|
||||
모노레포 환경에서는 여러 개의 독립적인 애플리케이션과 공통으로 사용되는 `packages/ui` 또는 `libs/`와 같은 폴더를 하나의 저장소에 배치한다 [1, 2]. 예를 들어, NestJS로 마이크로서비스를 구축할 때 `nest new --monorepo` 명령이나 Turborepo/Nx 워크스페이스를 설정하여 모든 서비스가 공유하는 DTO를 단일 라이브러리 패키지에서 가져오도록 구성할 수 있다 [2].
|
||||
* **지능형 캐싱 (Intelligent Caching)**
|
||||
Turborepo와 같은 도구는 '핑거프린팅(fingerprinting)' 시스템을 사용하여 변경되지 않은 컴포넌트의 빌드를 건너뛴다 [1]. 이러한 캐싱 메커니즘을 통해 CI/CD 시간을 최대 80%까지 단축할 수 있어 대규모 프로젝트에서의 개발 생산성을 크게 향상시킨다 [1].
|
||||
* **워크스페이스 링킹 (Workspace Linking)**
|
||||
모노레포 내에서 공유되는 컴포넌트(예: Vue 3 컴포넌트)에 대한 변경 사항은 로컬 심볼릭 링크(symlinks)를 통해 이를 소비하는 다른 애플리케이션에 즉각적으로 반영된다 [1]. 이는 번거로운 npm 퍼블리시 주기 없이도 "실시간(real-time)" 개발 경험을 가능하게 만들어 준다 [1].
|
||||
* **엔터프라이즈 생태계의 표준화**
|
||||
마이크로 프론트엔드와 모노레포 아키텍처의 조합은 현대 대규모 엔터프라이즈급 웹 애플리케이션 개발에서 점차 필수적인 표준으로 자리 잡고 있다 [1, 3].
|
||||
|
||||
## ⚖️ Trade-offs & Caveats
|
||||
* **버전 관리 및 동기화의 복잡성 증대**
|
||||
모노레포를 통해 여러 서비스에서 공유되는 라이브러리를 사용하게 되면, 서비스 간의 버전을 관리하고 동기화 상태를 유지하며 배포를 조율하는 과정이 매우 빠르고 심각한 고통(painful fast)으로 다가올 수 있다 [4].
|
||||
* **대안 부재로 인한 관리 비용 감수**
|
||||
NestJS 마이크로서비스 등 특정 아키텍처에 헌신하기로 결정한 경우, 공유 라이브러리를 모노레포로 관리하면서 발생하는 배포 및 버전 관리의 복잡성을 감내해야만 하며, 이에 대한 뚜렷하고 훌륭한 대안이 부족하다는 제약이 있다 [4].
|
||||
|
||||
---
|
||||
*Last updated: 2026-05-03*
|
||||
Reference in New Issue
Block a user