개인용 AI Reading Queue
읽지 않고 방치되고 있는 문서들을 핵심 요약 및 관리해주는 AI 서비스
프로젝트 개요
저장만 해두고 읽지 못한 글과 자료를 지금 가진 시간에 맞춰 소비할 수 있도록 만든 개인 AI Reading Queue입니다. 실제 서비스로 운영 중이며, URL 저장 시 Jina Reader로 본문을 임시 추출하고 Gemini로 한국어 압축 핵심, 핵심 포인트, 실무 적용 포인트, 원문 확인 필요 여부를 생성합니다. 원문 전체는 저장하지 않고, 사용자는 1분, 3분, 5분 단위로 읽지 않은 글을 추천받을 수 있습니다. 자주 읽는 블로그를 RSS로 구독하면 매일 아침 새 글이 모이고, 사용자가 고른 글만 reading queue에 들어갑니다.
주요 화면
주요 기능
URL 저장과 읽기 큐 관리
읽지 못한 글의 URL을 저장하고, unread / read / archived 상태로 관리할 수 있는 개인 reading queue를 제공합니다.
AI 핵심 요약과 실무 적용 포인트
Jina Reader와 Gemini를 사용해 한국어 압축 핵심, 핵심 포인트, 실무 적용 포인트를 생성합니다.
읽을 수 있는 시간 기준 추천
사용자가 가진 1분, 3분, 5분 단위의 시간에 맞춰 읽지 않은 글을 추천합니다.
브라우저 확장 프로그램
Chrome Extension에서 현재 탭 URL을 바로 저장해, 글을 발견한 순간 reading queue로 보낼 수 있게 했습니다.
RSS 구독으로 읽을 글 모으기
블로그를 RSS로 구독하면 매일 아침 새 글이 발견 화면에 모입니다. 사이트 주소만 넣어도 RSS 주소를 찾아 주고, 사용자가 고른 글만 reading queue에 들어갑니다.
기술 스택
Next.js · React · TypeScript · Supabase Auth · Supabase Postgres · Drizzle · TanStack Query · Mantine · SCSS Modules · Jina Reader · Chrome Extension · PWA · Web Push · fast-xml-parser · Vitest · Biome
담당 범위와 결과
역할 · 기획, 개발, 운영 전담
URL 저장부터 요약 생성까지 하나의 흐름으로 연결
- POST /api/articles에서 URL 검증, 사용자 인증, 중복 URL 반환, 일일 저장 제한을 처리했습니다.
- Jina Reader 추출과 Gemini metadata 생성을 거쳐 title, summary, key points, practical takeaway, digest reading time을 저장했습니다.
- Jina 또는 Gemini 실패 시 analysisStatus: failed와 error를 저장하고, UI에서 재분석과 원문 열기 흐름으로 이어지게 했습니다.
새 글을 자동으로 넣지 않고 사용자가 고르게 한 RSS 구독
- reading queue가 비면 시간 기반 추천과 아침 알림이 멈추고, 앱을 열 이유도 사라졌습니다. 읽을 글을 모아 주려고 RSS 구독을 추가했습니다.
- 새 글을 reading queue에 바로 넣지 않고 사용자가 고르게 했습니다. 안 읽은 글이 쌓이지 않고, AI 요약 비용은 고른 글에만 듭니다.
- 처음 구독하면 최신 글 5개만 보여주고, 그 뒤로는 하루에 구독 하나당 10개까지만 보여줍니다. 고르지 않은 글은 7일 뒤 목록에서 빠집니다.
- 같은 RSS를 여러 사용자가 구독해도 외부 요청은 하루 한 번만 보냅니다.
- 기존 저장 로직을 createArticleForUser로 분리했습니다. 고른 글에도 URL 검증, 중복 확인, 하루 저장 한도, 요약 생성이 그대로 적용됩니다.
사용자가 넣은 주소로 서버가 요청할 때의 보안(SSRF 방어)
- http/https만 허용하고, localhost와 사설·예약 IP(IPv4, IPv6, IPv4-mapped IPv6)는 막았습니다.
- DNS 결과를 검사한 뒤, 실제 연결도 그 IP로만 하게 했습니다. 검사와 연결 사이에 DNS 응답을 바꾸는 공격(DNS rebinding)을 막기 위해서입니다.
- 이를 위해 fetch 대신 node:http의 lookup 옵션을 썼습니다.
- redirect는 3번까지만 따라가고, 그때마다 주소를 다시 검사합니다. 응답은 10초, 압축을 푼 크기 기준 2MB로 제한했습니다.
RSS 수집이 실패해도 아침 알림은 나가도록
- 새 정기 작업을 만들지 않고, 기존 아침 알림 작업에서 수집 → 오래된 기록 정리 → 알림 순서로 실행했습니다. RSS는 4개씩 동시에 가져옵니다.
- 작업 제한 시간 300초 가운데 수집에는 180초만 씁니다. 시간이 넘으면 남은 구독은 건너뛰고 알림으로 넘어갑니다.
- 구독 하나가 실패해도 나머지는 계속 수집합니다. 3번 연속 실패한 구독은 설정 화면에 "수집 실패"로 표시합니다.
- 수집이 통째로 실패해도 알림은 보냅니다. reading queue가 비어 있어도 새 글이 있으면 "새 글 N개" 알림을 보냅니다.
- RSS 읽기, RSS 주소 찾기, 보여줄 글 고르기는 네트워크와 DB 없이 동작하는 함수로 분리했습니다. 실제 RSS 파일 6개로 13개 경우를 Vitest로 확인합니다.
Server/Client Component 경계를 나눠 reading queue 구성
- App Router에서 Supabase session을 확인한 뒤 비로그인 landing과 로그인 사용자의 queue 화면을 분기했습니다.
- TanStack Query로 글 목록, 상태별 필터, 검색, counts, 읽음/아카이브/삭제, 재분석 mutation을 관리했습니다.
- 저장 중, 분석 실패, empty state, 검색 결과 없음, 추천 없음 같은 상태를 각각 다른 사용자 행동으로 연결했습니다.
시간 기반 추천과 데이터 경계를 운영 설계에 반영
- 현재 가진 시간 안에 읽을 수 있는 unread 글을 추천했습니다.
- 원문 전체 content, markdown, html은 DB에 저장하지 않고 URL과 요약 metadata만 저장하도록 schema와 정책 문서에 반영했습니다.
- Privacy Policy, Content Policy, About, sitemap, robots 같은 공개 운영 요소를 같이 정리했습니다.
PWA와 알림으로 다시 읽는 흐름 구성
- PWA manifest와 service worker를 구성해 모바일과 macOS에서 앱처럼 접근할 수 있게 했습니다.
- Web Push 알림으로 저장해둔 글을 잊지 않고 다시 읽을 수 있는 흐름을 만들었습니다.