학습자
모바일에서 세로 영상을 보고, 대본과 원문 출처를 이어 읽습니다.
ARCHITECTURE · PORTFOLIOSearch And RAG
Search And RAG
Paper Academy
새 검색 연구를 발견하고 한국어 해설·원문 근거·60fps 흐름 영상으로 연결하는 서비스의 설계와 구현.
모바일 우선K3S · 영속 DB무료 음성 사용 제한
작성·갱신 2026-11-04 02:12 KST
Asia/Seoul · UTC+09:00
Asia/Seoul · UTC+09:00
공개 기술과 자체 구현을 설명하는 포트폴리오 · 개인·조직의 비공개 데이터와 자격증명을 포함하지 않습니다.
관심 있는 검색 연구를 꾸준히 공부할 수 있게 만듭니다
논문과 기술 블로그는 계속 나오지만, 발견한 자료를 읽고 구조를 이해하는 일은 따로 필요합니다. 이 서비스는 새 자료를 찾고, 근거 범위를 밝힌 한국어 해설과 영상으로 학습하는 흐름을 제공합니다.
자료
검색엔진·RAG 고도화에 관련된 공개 논문과 공식 기술 피드를 선별합니다.
운영
KST 00:00·12:00에 확인하고, 기존 자료는 다시 처리하지 않습니다. 새 자료가 없으면 생성도 생략합니다.
생성 작업과 공개 읽기 화면의 책임을 나눕니다
공식 피드논문 초록·기술 블로그 요약
신규 근거 →K3S 작업중복 확인·로컬 해설·음성 준비
검증 원고 →영상 렌더HyperFrames · 9:16 · 60fps
완성본 →공개 웹영상·대본·출처·실행 상태
공개 웹은 읽기 요청만 받습니다. 방문자가 임의 자료 수집이나 유료 음성 생성을 실행하는 API는 제공하지 않습니다. 운영 키와 미완성 파일을 공개 경로에서 분리합니다.
새로운 자료인지 먼저 확인하고 생성 비용을 줄입니다
| 자료 | 중복 기준 | 처리 |
|---|---|---|
| 논문 | 고유 논문 ID, 버전 접미사 제거 | 같은 논문의 버전 URL을 새 학습으로 반복 생성하지 않음 |
| 블로그 | 정규화 주소, 추적 인자·fragment 제거 | 유입용 인자가 달라도 같은 문서로 인식 |
| 동일 본문 | 공백 정리 후 내용 SHA-256 | 주소가 다른 동일 내용도 재처리 방지 |
| 실패 작업 | 기존 작업의 근거·대본·음성 체크포인트 | 새로 수집하지 않고 보존된 단계에서 복구 |
피드 목록을 다시 확인하는 것과 이미 처리한 문서를 다시 생성하는 것은 구분합니다. 원문 전체 재배포나 무제한 웹 크롤링은 이 서비스의 기능이 아닙니다.
DB는 상태·사용량·출처를, 볼륨은 영상 파일을 보관합니다
SQLite · 전용 영속 볼륨
자료 고유 키와 본문 해시, 처리 상태, TTS 문자 예약, 실행 이력, 공개 영상 메타데이터를 저장합니다. 작업을 한 번에 하나씩 처리하는 초기 운영 범위에 맞췄습니다.
파일 · 전용 영속 볼륨
대본, 장면별 음성, 편집 가능한 HyperFrames 프로젝트, 검증된 MP4와 스토리보드를 보존합니다. 공개 가능한 파일 이름과 경로를 제한합니다.
DB 변경은 명시적인 트랜잭션으로 처리합니다. 노드 디스크 장애에 대비하는 별도 장애 영역의 백업과 다중 노드 운영은 각각 추가 검증이 필요한 운영 범위입니다.
파일 검증 뒤 DB를 커밋하고 공개 목록을 교체합니다
아래 시간축은 실제 처리 속도를 나타내지 않는 설명용 모형입니다. DB 내부 커밋과 파일·목록 갱신은 서로 다른 경계입니다.
공개되지 않은 중간 결과는 읽기 화면에 나타나지 않습니다
| 단계 | 저장·검증 | 실패 시 동작 |
|---|---|---|
| 음성·영상 준비 | 작업 전용 경로에 기록, 실제 길이·프레임·오디오 확인 | 기존 공개본 유지, 보존된 음성 재사용 |
| 완성 파일 | 완성 경로로 옮긴 뒤 영상 메타데이터와 해시 확보 | 검증되지 않은 파일을 카탈로그에 연결하지 않음 |
| DB 커밋 | 영상 공개 메타데이터와 원문 처리 상태를 함께 기록 | DB 오류 시 해당 트랜잭션 롤백 |
| 공개 목록 교체 | 완료된 DB 상태에서 읽기용 목록을 만들고 원자적으로 교체 | 이전 목록 유지, 다음 복구에서 목록 갱신 |
로컬 DB와 파일 시스템 전체가 하나의 분산 트랜잭션인 것처럼 표현하지 않습니다. 재실행 시 같은 완료 결과를 다시 공개하지 않도록 멱등성을 검사합니다.
근거에서 확인한 범위만 한국어로 설명합니다
구조화된 원고
로컬 언어 모델은 제목·해설·한계·장면·출처 ID를 JSON으로 만듭니다. 모델이 만든 임의 HTML이나 스크립트를 실행하지 않습니다.
출처 검사
장면의 출처 ID는 입력 근거에 존재해야 합니다. 초록이나 피드 요약만 읽은 콘텐츠에는 그 범위를 표시합니다.
해석의 한계
형식과 출처 연결 검사는 해설의 모든 문장이 사실이라는 증명이 아닙니다. 원문의 실험 조건과 주장, 서비스의 설명용 모형을 구분합니다.
외부 TTS 호출 전에 문자 사용량을 예약합니다
Google Cloud TTS의 한국어 여성 음성을 사용합니다. 앱의 초기 상한은 최근 31일 10만 문자·KST 하루 6천 문자입니다. 실패하거나 응답이 불명확한 요청의 예약도 반환하지 않습니다.
기존 음성 파일기존 파일이 있으면 재사용
새 합성 필요 →DB 문자 예약동시 요청도 같은 상한 검사
허용 시에만 →여성 음성 합성다른 유료 음성으로 자동 전환 안 함
무료 제공량은 Google 계정의 다른 사용과 합산될 수 있습니다. 운영자는 다른 TTS 사용이 없음을 확인했으며, 이 조건이 바뀌면 설정을 재검토해야 합니다. 공식 요금과 무료 제공량
내레이션의 실제 길이에 60fps 흐름을 맞춥니다
영상 제작
HyperFrames의 일시정지 타임라인을 프레임별로 탐색합니다. 같은 시점은 같은 상태를 보여야 하며, 음성 파일을 측정한 길이로 장면을 연결합니다.
트랜잭션 시각화
전용 스킬이 요청·응답, 분기·병합, 커밋·롤백·큐·재시도를 표현합니다. 이번 영상의 시간축은 설명 순서이며 성능 벤치마크가 아닙니다.
모바일에서는 9:16 세로 구성, 큰 한국어 자막, 장면 탐색과 대본을 제공합니다. 실제 파일의 60fps와 개별 휴대전화의 재생 성능은 별도로 검증해야 합니다.
서비스의 생성 흐름을 영상으로 따라갑니다
검색 연구가 학습 영상이 되는 구조
새 자료 발견 → 중복 확인 → 한국어 해설 → 무료 음성 → 영상 → 완성본 공개.
구현 구조를 설명하는 별도 포트폴리오 영상입니다. 일일 연구 자료 수집과 구분해 한 번 제작합니다.
재생에는 운영 서비스 연결이 필요합니다. 본문과 구성도는 영상 없이도 읽을 수 있습니다.
정기 Job·키 격리·읽기 전용 웹으로 운영합니다
정기 실행
Kubernetes CronJob의 Asia/Seoul 시간대와 00:00·12:00 일정을 명시합니다. 동시 실행을 막고 자동 재시도를 제한해 외부 합성 호출이 무한 반복되지 않게 합니다.
권한 분리
Google 키는 음성 준비 단계에만 주입합니다. 렌더 단계와 공개 웹에는 키를 마운트하지 않습니다. 공개 웹은 완료된 목록과 허용 파일만 제공합니다.
경계
공개 호스트 앞의 프록시와 원본 인증을 분리합니다. 임의 수집·렌더 실행 API, 공개 DB, 미완성 파일 노출을 만들지 않습니다.
실행 증거와 설계 의도를 구분해 공개합니다
| 영역 | 검증 방법 | 해석 범위 |
|---|---|---|
| 중복·무료 문자 | 논문 버전·추적 주소·내용 중복, 동시 예약, 실패 예약, 월 경계 테스트 | 테스트한 입력과 불변식의 동작 |
| 흐름 도식 | 커밋 가시성·롤백·재시도·역방향 탐색 테스트 | 설명 모형의 의미 정합성 |
| 영상 | HyperFrames 검사, 중간 장면, 실제 MP4의 프레임·길이·오디오 | 파일 출력과 확인한 장면의 동작 |
| 운영 | 정확한 배포 결과물의 보안 검토, 공개 응답·일정·실행 이력 확인 | 관측 시점의 상태. 무중단·다중 노드·재해 복구 보장은 별도 |
실제 운영·첫 실행 상태는 서비스의 최근 수집 상태에서 확인합니다. 수행하지 않은 검사를 통과로 표시하지 않습니다.