백엔드 없이 GitHub Pages에서 동작하는 정적 웹사이트입니다. PC·모바일에서 카테고리별 글을 읽고 검색하는 데 집중합니다.
- 17개 카테고리, 128개 개념 복습 글, 대표·꼬리질문을 합친 401개 면접 질문
- MySQL, Redis, 분산 트랜잭션, Java/Kotlin/Spring, OS, 네트워크, 데이터 플랫폼, 설계·운영, 실제 경력과 인성 면접
- 개념 설명과 탄생 배경 → 실제 업무와 연관 → 다른 지식들과의 연관 → 예상 면접 질문과 예제 답변
- Java 17 이상으로 실행 가능한 코딩 예제 12개
- 한글·영어 동의어, 띄어쓰기·대소문자·전각 표기 정규화, 부분·초성·영문 한 글자 오타 검색
- 실제 글의 제목에서 만드는 PC 우측 목차와 스크롤에 따른 현재 구간 표시; 모바일 접이식 목차
- 세 단계 이상 이어지는 실행 경로를 상자와 화살표로 보여주는 반응형 개념 다이어그램
- 저장·메모·읽기 기록, 다크 모드·글자 크기, 선택적으로 사용하는 면접 연습
Node.js 24 LTS와 npm을 기준으로 합니다.
npm ci
npm run dev기본 개발 주소는 http://localhost:8081입니다. ./dev.sh도 같은 개발 화면을 실행합니다. 배포 파일만 만들고 확인하려면:
npm run build
npm run previewdist/에 HTML·CSS·JavaScript·아이콘만 생성됩니다. Node는 빌드·로컬 확인 도구이고 배포된 사이트에 실행 서버는 없습니다. 실제 글과 검색 색인은 빌드 결과에 포함됩니다.
- 이 프로젝트 파일을 GitHub 저장소의
main브랜치에 올립니다.node_modules,dist, 개인 메모 내보내기 파일은 올리지 않습니다. - 저장소 Settings → Pages → Build and deployment → Source에서 GitHub Actions를 선택합니다.
main에 변경을 push하거나 Actions → Deploy interview library to GitHub Pages → Run workflow를 실행합니다.- 성공한 배포의 주소는 Actions와 Settings → Pages에 표시됩니다.
배포 워크플로는 의존성 설치 → 검색·콘텐츠 검사 → 정적 빌드 → 경로·오프라인 범위 검사 → Pages 배포를 수행합니다. Pages의 base_path를 읽어 자산·서비스 워커 주소에 반영하므로 사용자 사이트와 저장소 사이트를 모두 지원합니다. 별도 토큰 비밀값을 추가할 필요 없이 GitHub Actions의 기본 토큰 권한을 사용합니다. Pages 사용 가능 여부와 저장소 정책은 GitHub 설정을 따릅니다.
글 주소는 /#lesson/mysql-index처럼 hash 경로를 사용합니다. 저장소 사이트에서는 /저장소명/#lesson/mysql-index가 되며, 글에서 새로고침해도 별도 서버 라우팅이나 404 우회 페이지가 필요 없습니다. 카테고리 주소도 #category/mysql로 바로 열 수 있습니다.
저장소 하위 주소를 로컬에서 검증하려면 빌드와 검사·미리보기에서 같은 경로를 지정합니다.
PAGES_BASE_PATH=/backend-interview-app npm run build
PAGES_BASE_PATH=/backend-interview-app npm run test:static
PAGES_BASE_PATH=/backend-interview-app npm run preview이 경우 미리보기 주소 뒤에 /backend-interview-app/을 붙입니다. 일반 루트 주소로 돌아오려면 npm run build로 다시 빌드합니다. Vite의 공식 GitHub Pages 배포 안내를 기준으로 구성했습니다.
Redis·레디스, GC·garbage collection·가비지 컬렉션, distributed lock·분산락을 연결합니다. ㅇㅇㅊㅈ 같은 초성, Reddis 같은 영문 한 글자 오타도 검색할 수 있습니다. 여러 검색어는 AND 조건으로 적용하고 제목·키워드 일치를 본문 일치보다 우선합니다. 짧은 영문 단어에는 오타 확장을 적용하지 않습니다. 동의어 사전은 src/search.mjs에서 확장할 수 있습니다.
목차는 렌더링된 큰 구획과 하위 절의 제목에서 만듭니다. 우측에는 글 제목과 현재 스크롤 구간이 표시되고 하위 절은 들여써서 개념의 계층을 보여 줍니다. 화면이 좁아지면 본문 위의 접이식 목차로 전환합니다. 실행 흐름 다이어그램은 PC에서 가로로, 모바일에서 위에서 아래로 읽히며 코드와 표는 각각 가로 스크롤을 지원합니다.
각 카테고리의 첫 글은 전문 용어 요약으로 시작하지 않습니다. 익숙한 백엔드 문제에서 출발해 구성 요소가 필요한 이유를 만든 뒤 이름을 붙입니다. scripts/curriculum_prerequisite_audit.py가 17개 첫 글과 분야 간 선행 관계를 생성 시 검사하며, 본문의 큰 목차는 개념 설명·실무 연결·지식 연결·면접 질문 네 단계로 고정됩니다.
기록은 브라우저의 backend-lab-v2에만 저장합니다. 자동 기기 동기화는 없습니다. 읽기 설정 → 기록 내보내기/가져오기로 PC·휴대폰 기록을 합칩니다. 같은 글은 수정 시각이 더 최근인 기록을 유지하므로 기기의 시각이 정확해야 합니다. 가져오기는 현재 화면 테마와 글자 크기를 유지합니다. 브라우저 데이터를 삭제하기 전에 필요한 기록을 내보내세요.
배포된 HTTPS 사이트 또는 localhost의 정식 빌드에 접속하면 서비스 워커가 전체 글과 앱을 저장합니다. 최초 저장 완료 이후 오프라인 읽기와 새로고침이 가능합니다. 개발 모드에서는 서비스 워커를 등록하지 않습니다. 외부 참고 문서와 일부 기기의 읽어주기는 인터넷이 필요합니다. 캐시를 저장소 경로별로 분리해 다른 Pages 프로젝트의 캐시를 삭제하지 않습니다.
면접 연습은 타이머·답변 가리기·꼬리질문·자기 평가를 제공합니다. 각 글의 대표 질문에는 결론, 원리, 실무 적용 순서, 트레이드오프와 면접관 확인 항목으로 구성한 예시 답변이 있습니다. 음성 녹음과 AI 자동 채점은 없습니다. Java 코드는 복사해 JDK나 코딩 플랫폼에서 실행합니다.
content/*.json은 버전 관리되는 정적 본문입니다. 반복 편집의 원문은 scripts/curriculum_*.py에 있습니다. scripts/curriculum_structure.py가 전체 읽기 순서·선행 글·학습 목표와 기초 장을 구성하고, scripts/curriculum_specialist.py가 MySQL·Redis·분산 트랜잭션·Kafka의 실행 흐름과 장애 타임라인을 확장합니다. scripts/curriculum_deep.py와 첨부 MySQL 원고를 재구성한 scripts/curriculum_review.py에는 분야별 표·반례가 있습니다.
npm run content:build
npm test
npm run build원문을 수정하고 생성된 JSON도 함께 커밋합니다. 먼저 루트의 AGENTS.md에 적힌 금지 방식과 인과적 글 구조를 적용합니다. 새 글은 고유한 id, 읽기 순서, 선행 글, 개념 요약·동작 원리·실행 경로·사례·보장 경계·운영 대응·연관 면접 질문·자기 점검을 갖춰야 합니다. 개념 설명이 먼저이고 면접 질문은 글의 마지막에 배치합니다. sections는 글에 필요한 만큼 추가할 수 있으며, 각 절의 id, title, body와 선택적인 table, code가 화면·검색·목차에 함께 반영됩니다.
실제 경력은 확인된 역할·결과·한계를 유지하고 학습용 가상 사례와 origin으로 구별합니다. 첨부 자료 속 가상 성과를 사용자 경력으로 옮기지 않았습니다. 콘텐츠 검토 기록에 근거와 보완 사항을 남겼습니다.
npm test
npm run lint
npm run build
npm run test:static
npm run test:java
npm run test:browsertest:static은 실제 빌드 자산, 서비스 워커 설치·오프라인 응답·저장소별 캐시 범위를 검증합니다. Java 검증은 PATH의 JDK 17 이상을 사용합니다. 필요하면 INTERVIEW_JAVA_HOME에 java와 javac가 있는 bin 디렉터리를 지정합니다.
브라우저 검증은 빌드한 dist/만 임시 로컬 주소로 제공하고, 별도 Chrome 프로필에서 검사한 뒤 모두 종료합니다. 설치된 Chrome 경로가 다르면 INTERVIEW_CHROME으로 지정할 수 있습니다. 1440px PC, 390px·320px 모바일, 실제 목차 이동·강조, 검색 입력 유지, 저장·메모, 저장소 하위 경로에서의 오프라인 새로고침을 검증했습니다. 결과 이미지는 artifacts/에 저장됩니다. Safari와 실제 iOS·Android 기기별 설치 동작은 별도 확인 범위입니다.