JavaGuide는 자바 백엔드 개발자를 위한 방대한 면접 준비 지식 베이스이자, 이를 렌더링하는 VuePress(vuepress-theme-hope) 기반 정적 문서 사이트의 소스 레포입니다. Java 기초/컬렉션/동시성/JVM/DB/네트워크/분산시스템 등 전통 CS·백엔드 주제부터 최근 추가된 AI 응용 개발(LLM, Agent, RAG, MCP, Claude Code 등) 면접 자료까지 함께 다룹니다. 실행 가능한 애플리케이션이 아니라 수백 개의 마크다운 문서와 그 목차/테마 설정으로 구성된 '콘텐츠 프로젝트'입니다.
핵심은 docs/ 폴더의 방대한 마크다운 파일들과 docs/.vuepress/ 아래의 VuePress 설정입니다. sidebar/*.ts 파일들(java, cs-basics, ai, ai-coding, books 등)이 각 카테고리의 목차 트리를 정의하고, config.ts·theme.ts·navbar.ts가 전체 사이트 테마와 네비게이션을 구성합니다. LazyMermaid.vue, UnlockContent.vue 같은 커스텀 Vue 컴포넌트로 다이어그램 지연 렌더링이나 콘텐츠 잠금 UI를 얹습니다. pnpm install 후 VuePress 빌드 명령을 실행하면 마크다운이 정적 HTML로 컴파일됩니다. .github/workflows/test.yml은 push/PR마다 pnpm docs:build를 실행해 '빌드가 깨지지 않는지'만 검증하며, 내용의 정확성 검증은 아닙니다. .husky/pre-commit은 커밋 시 nano-staged를 통해 markdownlint-cli2로 문서 스타일을 강제합니다.
- STEP 01
git clone 후 pnpm install을 실행하면 vuepress-theme-hope 등 의존성이 설치되는데, 문서량이 방대해 node_modules 용량과 설치 시간이 상당함을 체감하게 됩니다.
- STEP 02
pnpm docs:dev(또는 유사 스크립트)를 실행하면 로컬 개발 서버가 뜨고, sidebar/*.ts에 정의된 목차 그대로 좌측 메뉴에 '면접 준비', 'Java', 'CS 기초', 'AI' 등 카테고리가 나타나는 것을 확인하게 됩니다.
- STEP 03
pnpm docs:build를 실행하면 GitHub Actions test.yml과 동일한 빌드 과정을 겪는데, NODE_OPTIONS로 4GB 메모리를 지정해야 할 만큼 문서량이 많아 빌드 시간이 꽤 걸립니다.
- STEP 04
마크다운 파일을 수정하고 커밋하면 husky pre-commit 훅이 markdownlint-cli2로 스타일 검사를 돌려, 헤딩 스타일이나 목록 기호(dash) 규칙 위반 시 커밋이 막히는 경험을 하게 됩니다.
- STEP 05
mermaid 다이어그램이 포함된 문서 페이지를 열면 LazyMermaid.vue 컴포넌트가 스크롤 시점에 다이어그램을 지연 렌더링하는 것을 볼 수 있습니다.
- STEP 06
README에서 언급된 'AI 지능형 면접 도우미 + RAG 지식베이스' 같은 실전 프로젝트는 별도 링크(javaguide.cn/zhuanlan)로 안내될 뿐, 이 레포 안에 해당 소스코드가 포함되어 있지는 않다는 것을 알게 됩니다.
실행 결과로 얻는 것은 실행형 소프트웨어가 아니라, 자바 기초부터 동시성·JVM·DB·네트워크·분산시스템·시스템설계, 그리고 최신 AI 응용(Agent/RAG/MCP/Claude Code) 면접 주제까지 체계적으로 정리된 로컬 문서 사이트(정적 빌드물)입니다. 사이드바 구조 그대로 카테고리별 탐색이 가능하고, 온라인판(javaguide.cn)과 동일한 콘텐츠를 로컬에서 검증할 수 있습니다.
이 레포는 실제 서비스나 라이브러리가 아니라 문서/콘텐츠 프로젝트이므로 '실행 결과'는 웹페이지 콘텐츠이지 기능적 산출물이 아닙니다.
README 상단에 소개된 'AI 지능형 면접 도우미 + RAG 지식베이스' 실전 프로젝트는 이 레포가 아니라 유료/별도 콘텐츠(javaguide.cn/zhuanlan)로 연결되며, 소스는 포함되어 있지 않습니다.
gitignore에 docs/ai/claude.md, MATERIALS.md, TODO 등 로컬 전용 파일이 명시되어 있어, 공개 레포의 콘텐츠가 온라인판과 100% 동일하지 않을 수 있습니다.
문서량이 매우 방대해(파일 수백 개) 빌드에 4GB 메모리 옵션이 필요할 정도로 로컬 빌드 리소스 소모가 있습니다.
Java 백엔드 및 최근 AI 응용 개발 면접을 준비하는 개발자에게는 무료로 체계적인 참고자료를 제공하는 레포입니다. sidebar 구성과 실제 md 파일 트리만으로도 다루는 범위(전통 CS/Java 심화부터 LLM·Agent·RAG·MCP까지)를 충분히 파악할 수 있고, GitHub Actions가 매 커밋마다 문서 빌드 성공 여부를 검증하고 있어 '설치하면 정상적으로 빌드되는 문서 사이트'라는 판단은 직접 실행하지 않아도 신뢰할 수 있습니다. 다만 콘텐츠 자체의 최신성·정확성은 각 md 문서를 개별적으로 확인해야 하며, 홍보된 '실전 AI 프로젝트'는 이 레포 범위 밖임을 유의해야 합니다.