Skip to content

docs: EPUB 처리 구조와 문제 해결 사례 정리 - #155

Merged
ppp1969 merged 2 commits into
devfrom
docs/portfolio-readme-refresh
Oct 1, 2026
Merged

ppp1969 merged 2 commits into
devfrom
docs/portfolio-readme-refresh

Conversation

@ppp1969

@ppp1969 ppp1969 commented Oct 1, 2026 •

Copy link
Copy Markdown
Contributor

변경 내용

README가 예전 구조와 기능 설명에 머물러 있어, EPUB을 다루면서 해결한 문제와 현재 프로젝트 구성을 기준으로 다시 정리했습니다.

ReadWith를 만들게 된 이유부터 시작해 제가 구현 과정에서 부딪힌 문제를 순서대로 적었습니다.

  • 스포일러 없이 독서 기록을 나누려면 책 속 위치를 어떻게 표현해야 하는지
  • EPUB마다 다른 문장과 위치 정보를 정규화한 과정
  • 하이라이트 위치를 다시 찾아갈 수 있도록 Locator를 설계한 이유
  • 사용자 관계 변화를 저장하고 실패한 작업을 다시 처리한 방법
  • 현재 사용하는 Spring Boot, Spring AI와 배포 환경

기존 아키텍처 이미지와 검증 결과는 유지하고, 설계 용어는 필요한 부분에서 바로 이해할 수 있도록 설명을 덧붙였습니다.

확인한 내용

  • 기존 아키텍처 이미지 유지
  • README 외 파일 변경 없음
  • git diff --check 통과

@ppp1969
ppp1969 merged commit e9b2f95 into dev Oct 1, 2026
1 check passed
@ppp1969 ppp1969 changed the title Docs: ReadWith 백엔드 포트폴리오 README 개편 docs: EPUB 처리 구조와 문제 해결 사례 정리 Oct 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant