상태

Accepted · 2026-07-25 · 영향 High

ADR-001 — 예약 원자료 미확보 시 정책 기반 계산기를 MVP로 사용

맥락

정보나루 공개 API는 도서관, 장서, 대출 가능 여부, 인기·추천·추이 데이터를 제공하지만 개인별 예약 순번, 복본별 실시간 반납 예정일, 예약 취소·미수령 이력은 제공하지 않는다. 현재 협력 도서관의 비식별 예약 원자료도 확보되지 않았다.

결정

7월 27일 의사결정 게이트의 B안을 적용한다.

• MVP를 정책 기반 예상 대기 구간 + 지금 빌릴 수 있는 대체도서 추천으로 고정한다.
• 공개 API에 없는 예약 순번·복본·대출 정책은 사용자가 해당 도서관에서 확인한 값을 직접 입력한다.
• 결과는 확정일이 아니라 구간과 신뢰도로 표시하고, 정확한 대기 일정은 해당 도서관 사서에게 확인하도록 안내한다.
• 실제 예측 정확도 수치를 만들거나 주장하지 않는다.

대안과 이유

• 합성 예약 데이터로 정확도 제시: 실제 성능 오해 위험으로 기각
• 대기 기능 제거: 핵심 문제를 해결하지 못해 기각
• 정책 계산기와 한계 동시 제공: 재현성과 확장성이 있어 채택

결과

공개 데이터만으로 재현 가능하지만 연장·지연·취소·미수령에 따른 실제 오차는 검증하지 못한다. 사서 대시보드에는 정보나루 실제 급상승 응답만 표시하며 가상 예약·복본·수요 압력 수치를 생성하지 않는다. 원자료 확보 시 개인정보 제거·사용 범위·기준선 오차 측정을 별도 ADR로 승인한다.

ADR-002 — 정보나루 API 키는 서버 환경변수에서만 사용

결정

• 키는 .env 또는 배포 환경의 DATA4LIBRARY_API_KEY로만 주입한다.