PaperOps 주간 릴리즈 노트

2025년 8월 31일 - 9월 6일

주요 개발 내용 요약

이번 주는 PDF 청크 하이라이팅 기능 구현, 데이터베이스 마이그레이션 시스템 도입, 채팅 인터페이스 UX 개선, 프로젝트 구조 정리에 중점을 둔 집중적인 개발 기간이었습니다. 총 7개의 주요 PR이 병합되었으며, 고급 PDF 뷰어 기능, Alembic 마이그레이션 시스템, 개선된 채팅 기능이 완료되었습니다.

새로운 기능 (New Features)

1. PDF 청크 하이라이팅 기능 (#175)

• 구현 완료: BBox 기반 PDF 청크 하이라이팅 시스템
• 주요 기능:
  • PDF 문서 내 임베딩 청크를 시각적으로 하이라이트 표시
  • 토글 컨트롤을 통한 하이라이팅 활성화/비활성화
  • 다중 페이지 문서에서 정확한 청크 위치 추적
  • BBox 기반 정확한 텍스트 영역 하이라이팅
  • 향상된 가시성과 범위 커버리지
• 커밋: d0168c9, a729dba, cb0e5f8, 26bc87b, ac4275c, 95893db

2. Alembic 데이터베이스 마이그레이션 시스템 (#168)

• 구현 완료: 체계적인 데이터베이스 스키마 관리 시스템
• 주요 기능:
  • Alembic 기반 데이터베이스 버전 관리
  • 자동 마이그레이션 생성 및 적용
  • Docker 환경에서 마이그레이션 지원
  • Kubernetes 매니페스트 업데이트
  • 종합적인 데이터베이스 관리 가이드 문서
• 커밋: e3e7998, 74aa0a5, 6eb2027, b5ba98e

3. 독립형 LLM 채팅봇 기능 (#164)

• 구현 완료: PDS 메뉴 하위 독립형 채팅 기능
• 주요 기능:
  • 문서와 독립된 일반 LLM 채팅 인터페이스
  • 새로운 “New Chat” 메뉴 항목 추가
  • LLM 서비스와 통합된 일반 채팅 엔드포인트
• 커밋: 853968f, 9c90540

4. 채팅 히스토리 네비게이션 사이드바 (#166)

• 구현 완료: 채팅 히스토리 관리 및 네비게이션 시스템
• 주요 기능:
  • 채팅 히스토리 네비게이션 사이드바 구현
  • 향상된 채팅 인터페이스 UX
  • 히스토리 로딩 문제 해결
  • 일반 채팅이 문서 목록에 표시되지 않도록 수정
• 커밋: 7c6ae62, 128cdd2, 9d3a1a1, 1e3dd60

개선사항 (Improvements)

1. 채팅 응답 안정성 개선 (#170)

• 채팅 응답 생성 실패 문제 해결: 채팅 응답 생성 시 발생하는 오류 수정
• 데이터베이스 제약 조건 개선: 채팅 기능의 데이터베이스 제약 조건 최적화
• 오류 처리 로직 강화: 채팅 오류 상황에 대한 처리 로직 개선
• 커밋: 5ed32fe

2. UI/UX 개선

• 중복 메뉴 항목 제거 (#162): 사이드바에서 중복된 ‘Notes’ 메뉴 제거
• ChatHistoryNav 정리: 페이퍼 페이지에서 불필요한 ChatHistoryNav 컴포넌트 제거
• 커밋: 20b3207, 9d3a1a1

3. 프로젝트 구조 정리

• 테스트 및 검증 스크립트 구조화: 구조화된 디렉토리로 스크립트 재구성
• 불필요한 Docker Compose 파일 정리: 사용하지 않는 Docker 설정 파일 제거
• PostgreSQL 전용 Docker Compose: 로컬 개발용 PostgreSQL 전용 구성으로 단순화
• 커밋: a0b7c5f, 02da41f, b641b5c

버그 수정 (Bug Fixes)

1. PDF 청크 하이라이팅 관련 버그 수정

• 다중 페이지 청크 하이라이팅 문제: 여러 페이지에 걸친 청크 하이라이팅 이슈 해결
• 포괄적인 텍스트 하이라이팅 커버리지: 텍스트 영역 하이라이팅 범위 개선
• 커밋: cb0e5f8, 26bc87b

2. 채팅 기능 버그 수정

• LLM 서비스 통합 문제: 일반 채팅 엔드포인트의 LLM 서비스 통합 수정
• 채팅 히스토리 로딩: 채팅 히스토리 로딩 관련 문제 해결
• 커밋: 9c90540, 1e3dd60

인프라 및 배포 (Infrastructure & Deployment)

1. 데이터베이스 마이그레이션 시스템

• Alembic 통합: Docker 환경에서 Alembic 마이그레이션 지원
• Kubernetes 지원: Alembic 마이그레이션을 위한 Kubernetes 매니페스트 업데이트
• 자동화된 스키마 관리: 데이터베이스 스키마 변경의 자동화된 관리
• 커밋: 6eb2027, b5ba98e

2. 구성 파일 정리

• 구식 init.sql 제거 (#172): Alembic 마이그레이션으로 대체된 init.sql 파일 제거
• 설정 파일 업데이트: 새로운 마이그레이션 시스템에 맞는 설정 조정
• 커밋: 18a2708

문서화 (Documentation)

1. 개발 가이드 문서화

• 구조화된 개발 설정 가이드: README에 체계적인 개발 환경 설정 가이드 추가
• 스크립트 참조 업데이트: 재구성된 스크립트 참조를 위한 README 업데이트
• 종합적인 데이터베이스 관리 가이드: Alembic을 포함한 데이터베이스 관리 문서
• 현재 시스템 상태 반영: README 및 문서를 현재 시스템 상태에 맞게 업데이트
• 커밋: 7a87557, 1f37552, 74aa0a5, abf36fb

2. 기술 문서 체계화

• 데이터베이스 마이그레이션: Alembic 사용법 및 마이그레이션 절차 문서화
• Docker 설정: 단순화된 Docker 구성에 대한 문서 업데이트
• 스크립트 구조: 재구성된 스크립트 디렉토리 구조 설명

성과 지표 (Metrics)

• 총 커밋 수: 30+ 커밋
• 해결된 이슈: 6개 주요 이슈 해결 (#174, #171, #169, #167, #165, #163, #161)
• 새로운 기능: 4개 주요 기능 추가
• 문서 업데이트: 4개 주요 문서 추가/업데이트
• 버그 수정: 5개 주요 버그 수정
• 병합된 PR: 7개 풀 리퀘스트

주요 PR 목록

• #175: PDF 청크 하이라이트 기능 구현
• #172: 구식 init.sql 파일 제거 - Alembic 마이그레이션 완전 적용
• #170: 채팅 응답 생성 실패 문제 해결
• #168: Alembic 데이터베이스 마이그레이션 시스템 구현
• #166: 채팅 인터페이스 UX 개선 및 히스토리 로딩 수정
• #164: PDS 하위 독립형 LLM 채팅봇 메뉴 추가
• #162: 사이드바에서 중복 Notes 메뉴 제거

다음 주 계획 (Next Week Plans)

1. PDF 기능 고도화

• PDF 청크 하이라이팅 성능 최적화
• 추가적인 PDF 뷰어 기능 구현
• 사용자 설정 가능한 하이라이팅 옵션

2. 데이터베이스 관리 강화

• Alembic 마이그레이션 모니터링 시스템
• 데이터베이스 성능 최적화
• 마이그레이션 롤백 시나리오 테스트

3. 채팅 기능 확장

• 채팅 히스토리 검색 기능
• 채팅 내용 내보내기 기능
• 채팅 성능 최적화

4. 코드 품질 및 테스팅

• PDF 하이라이팅 기능 테스트 강화
• 마이그레이션 시스템 테스트 추가
• E2E 테스트 시나리오 확장

결론

이번 주는 PaperOps의 핵심 기능인 PDF 뷰어를 대폭 향상시키고, 데이터베이스 관리 체계를 현대화한 중요한 주간이었습니다. 특히 PDF 청크 하이라이팅 기능을 통해 사용자가 문서 내용과 AI 응답의 연관성을 시각적으로 확인할 수 있게 되었고, Alembic 마이그레이션 시스템 도입으로 데이터베이스 스키마 관리의 안정성과 전문성을 크게 향상시켰습니다. 또한 채팅 기능의 UX 개선과 프로젝트 구조 정리를 통해 전반적인 시스템의 완성도를 높였습니다.

문서 작성일: 2025년 9월 6일
버전: v0.8.0