Book Map

책 추천 리스트는 어디에나 있지만 "어떤 순서로 읽어야 하는지"의 지도가 없다. 입문자는 매번 다음 책을 고르는 데 시간을 쓰고, 사수는 "이거부터 봐" 한 마디로 끝낼 만한 답이 없다.

QA 엔지니어 14년 동안 "입문자에게 어떤 책부터 권할까"를 반복해서 마주한 데서 출발. 책의 가치는 한 권의 추천보다 한 주제의 경로를 잡는 데서 더 크게 나온다는 가설로 시작.

특정 주제를 처음 학습하려는 독학자, "어디서부터 시작하지" 묻는 후배에게 짧은 한 마디로 답하고 싶은 사수.

책을 카드 카탈로그로 늘어놓는 대신 한 장의 지도로 순서·연결·내 위치를 보여주면, "다음에 뭘 읽지"가 검색이 아니라 한눈 확인으로 바뀐다.

• 주제별 독서지도 데이터 모델 - 책 사이의 선후 관계와 단계 구분
• 지도 화면 - 책 카드를 경로 위에 배치하고 "현재 여기"로 진도 표시
• 책 상세 - "왜 읽어야 하는가·읽고 나면 얻는 것·읽기 전 알아두면 좋은 책들"을 정형화
• 독후감 + AI 피드백 - 작성한 글을 "잘 읽어낸 점·보완하면 좋을 점·한 줄 평"으로 회신하고 끝에 "지도 안 다음 책·지도 밖 책"을 함께 제안
• 내 서재 - 읽은 책·읽는 중·읽을 책을 한 곳에 모음, 별점·메모는 카드에서 바로 매김
• 프런트엔드는 정적으로도 동작, 백엔드(Hono + Neon Postgres + Drizzle + JWT)는 계정·진도 동기화·큐레이터 콘텐츠 수정용으로 분리

• 책 "추천 리스트"를 의도적으로 만들지 않음 - 추천이 아니라 경로를 보여주는 정체성을 흐리지 않으려고
• 독후감 후 추천도 "지도 안 다음 책·지도 밖 책" 두 줄로 분리 - 같은 길에 머무를지 가지를 칠지 사용자가 선택
• 백엔드를 옵셔널 레이어로 - 회원가입 마찰 없이 진입 가능, 진도 동기화는 원할 때만
• 콘텐츠는 큐레이터가 코드 배포 없이 수정 가능하게 - 한 장의 지도가 시간 지나도 신뢰를 유지하려면 운영자가 닿을 수 있어야 한다

• 비로그인 localStorage 진도와 로그인 서버 진도가 어긋나지 않는가 - 계정 가져오기 미지원을 화면에 정직하게 명시했는가
• 낙관적 업데이트(진도·별점 쓰기) 실패 시 이전 상태로 정확히 롤백되는가
• AI 응답이 tool_use 구조를 못 만들면 502로 막아 깨진 노트가 독자에게 닿지 않는가
• AI 키가 없을 때 /api/ai/*만 503으로 떨어지고 지도·진도·메모·인증은 계속 서비스되는가(의존성 실패 격리)
• 부팅 시 zod 환경변수 fail-fast 검증으로 설정 오류가 조용히 통과하지 않는가

Alpha 단계. 현재 3개 주제(창업·글쓰기·프로그래밍 입문) 등록, 사용자 수치는 측정 전.

프런트엔드만으로도 완결적으로 동작하는 상태에서 "한 주제부터 완성도 높이고 신호 보기"로 다음 라운드를 정의. 큐레이터가 늘었을 때 "한 장의 지도에 들어가는 규칙"이 가장 큰 디자인 과제로 남음.