Draft

💡 Reference

• 패키지 매니저의 과거, 토스의 선택, 그리고 미래

• JavaScript 패키지 매니저 비교하기

• 패키지 매니저 선택을 위한 여정: NPM에서 Yarn으로 그리고 다시 pNPM

• [Package Manager] 패키지 매니저 npm, yarn, yarn berry, pnpm

• 패키지 매니저 토끼굴 파기 (npm, Yarn Classic, pnpm, Yarn Berry 의 CI 배포 시간 비교)

• Biome Docs

B2B2C(Business to Business to Consumer)

B2B2C는 기업에 서비스를 제공하고, 그 기업을 통해 최종 사용자가 서비스를 이용하는 구조이다.

• 서비스 제공자 → 기업 → 최종 사용자 흐름을 가진 비즈니스 모델
• 기업 단위로 서비스를 제공하지만, 실제 사용자는 기업 소속 사용자들이다.
• SaaS, 사내 서비스, 플랫폼 서비스에서 자주 사용된다.
• ex.
  • 서비스 운영자 → 회사 → 회사 직원
  • 서비스 운영자 → 스터디 → 스터디 멤버
  • 서비스 운영자 → 커뮤니티 → 사용자

멀티테넌시(Multi-tenancy)

멀티테넌시는 하나의 애플리케이션에서 여러 고객(테넌트)이 독립된 환경처럼 서비스를 사용하는 구조이다.

• 하나의 서버 / 하나의 코드베이스
• 여러 회사 / 조직 / 그룹이 동시에 사용
• 데이터는 서로 분리됨
• SaaS에서 핵심 구조
• ex.
  • 하나의 서비스에서 여러 Space 운영 가능
  • 회사마다 사용자, 모임, 데이터 분리

Package Manager

패키지 매니저가 하는 일은 다음과 같다.

• 패키지를 어디서 가져오는지 (registry)
• 가져온 걸 어떻게 저장하는지 (node_modules 구조)

이 두 가지 방식의 차이가 성능과 모노레포 안정성 차이로 이어진다.

npm vs yarn vs pnpm vs bun

전부 자바스크립트 패키지 매니저지만, 설치 방식·속도·디스크 사용량·모노레포 친화성·호환성에서 차이가 있다.

도구	느낌	장점	아쉬운 점	추천 상황
npm	기본값	Node 설치하면 바로 사용 가능, 가장 보편적	속도/디스크 효율은 상대적으로 평범	입문, 작은 프로젝트, 별 설정 없이 시작
yarn	기능 많은 안정형	워크스페이스 강함, PnP/Zero-install 같은 고급 기능	개념이 조금 많고 팀 적응 필요	모노레포, 엄격한 의존성 관리
pnpm	효율 특화	빠르고 디스크 절약 큼, 모노레포에 강함	일부 오래된 패키지와 궁합 이슈 가능	실무 팀 프로젝트, 모노레포
bun	초고속 신흥 강자	설치/실행 빠름, 런타임+번들러+테스트 포함	Node 생태계 100% 호환성은 계속 개선 중	개인 프로젝트, 실험적/빠른 개발

모노레포

모노레포는 여러 프로젝트(어드민, 유저 페이지, 공통 UI 컴포넌트 등)를 하나의 저장소에서 관리하는 것이다.

모노레포 툴 Turborepo

왜 Turborepo인가?:

Next.js를 만든 Vercel에서 관리하는 도구이다.
설정이 매우 쉽고, 캐싱 기능이 강력해서 한 번 빌드하거나 테스트한 부분은 다시 안 해도 된다. (시간 단축의 핵심)

구조 예시:

• apps/user: 유저용 서비스 (Next.js)
• apps/admin: 어드민 관리 페이지 (Next.js)
• packages/ui: 공통 디자인 시스템 (Shadcn 등)
• packages/utils: 공통 함수 (API 통신 로직 등)

Next.js를 써야 하는 이유 (Server Side Rendering)

• SEO: Next.js의 SSR(서버 사이드 렌더링)은 검색 엔진 최적화에 필수적입니다.
• API 보안: B2B2C 구조에서 회사별 권한 체크나 데이터 처리를 서버에서 미리 처리한 뒤 브라우저로 보내줄 수 있어 보안상 유리합니다.
• 풀스택 가능성: 추가 기능(화상회의, 일정 관리)을 구현할 때 API Routes를 통해 간단한 서버 로직을 바로 짤 수 있습니다.

node_modules 저장 방식

npm / yarn classic (v1)

프로젝트A/node_modules/react  (100MB)
프로젝트B/node_modules/react  (100MB)
프로젝트C/node_modules/react  (100MB)
→ 똑같은 파일이 프로젝트 수만큼 중복 저장

pnpm

~/.pnpm-store/react@18  (100MB, 딱 1번만)
    ↑
프로젝트A/node_modules/react → 심링크
프로젝트B/node_modules/react → 심링크
프로젝트C/node_modules/react → 심링크
→ 실제 파일은 1개, 나머지는 참조만

yarn berry (v2+, PnP 모드)

.yarn/cache/react.zip
  (압축 상태로 보관)
  →
  node_modules
  폴더
  자체가
  없음
  →
  런타임에
  zip을
  직접
  읽음;

npm

npm은 Node.js에 기본 포함되는 가장 표준적인 패키지 매니저다. 그래서 별도 설치 없이 바로 쓸 수 있고, 생태계 기준점 역할을 한다. npm은 캐시를 content-addressable cache 방식으로 관리한다.

• Node 깔면 바로 사용 가능
• 호환성 걱정을 가장 적게 해도 됨
• pnpm이나 bun과 비교하면 설치 체감이 덜 빠를 수 있음
• 대규모 모노레포에서는 다른 도구가 더 편한 경우가 많음

Yarn