모노레포와 개발 도구

(← TIL)

메인테이너가 물었다: “패키지 다이어그램에서 apps/web 등은 알겠는데 packages/core 등은 모르겠어요. packages/가 뭔가요?” (inbox, 2026-10-25). 같은 날 시안 M40에서 빌드 · 시험 도구를 Java에 빗대어 골랐다.

한 줄 요약

모노레포는 여러 프로그램과 라이브러리를 저장소 하나에 둔 것이다. JavaScript 쪽에서는 관례로 내놓는 프로그램을 apps/, **그것들이 함께 쓰는 라이브러리를 packages/**에 둔다.

백엔드로 비유하면

JavaScript 모노레포Java (Maven · Gradle)
저장소 하나에 패키지 여럿, pnpm-workspace.yaml멀티 모듈 프로젝트, 부모 pom.xml · settings.gradle
packages/core (@ariadne-nsd/core)공통 라이브러리 모듈(common, domain jar)
apps/web실행 모듈(Spring Boot 실행 jar, war)
package.json의 dependencies에 @ariadne-nsd/core<dependency>로 다른 모듈을 가져옴
pnpmMaven · Gradle의 의존성 관리

빌드 · 시험 도구(→ ADR-0038):

할 일AriadneNSDJava라면
빌드 · 묶기Vite(웹), esbuild(Obsidian)Gradle 빌드, jar · war 묶기
단위 시험 · 벤치마크VitestJUnit, JMH
속성 기반 시험fast-checkjqwik
브라우저 시험PlaywrightSelenium
의존 방향 검사dependency-cruiserArchUnit
실수 검사 · 모양 맞추기ESLint + PrettierCheckstyle · SpotBugs, Spotless
시험 파일의 자리소스 옆 measure.test.tssrc/test/java (따로)

마지막 줄만 관례가 다르다. TypeScript 쪽은 시험 파일을 소스 바로 옆에 두는 일이 흔하고, AriadneNSD도 그렇게 했다.

AriadneNSD에서는

  • 코드는 모두 src/ 아래에 있고 src/가 워크스페이스의 뿌리다. 화살표는 apps/web → packages/editor → packages/core → packages/fonts(쓰는 쪽 → 쓰이는 쪽) → 4. 구성 요소
  • core에는 화면(DOM)이 없어서 Node에서 바로 시험한다 → 02-test-architecture

더 읽을거리