[파트 1] RSS 스크래퍼

이 파트의 진입점은 scraper/index.ts입니다. 다른 파일은 모두 index.ts에서 직접 또는 간접으로 호출됩니다.

이 파트가 하는 일

Neon DB에 등록된 RSS 피드를 주기적으로 수집하여, JSON 파일과 VitePress용 Markdown 파일을 생성합니다.

파일 맵

파일	역할	변경 빈도
`index.ts`	전체 파이프라인 조율 (메인 진입점)	낮음
`config/_shared.ts`	전역 설정값	설정 변경 시
`feedRepository.ts`	DB 쿼리 전담	DB 스키마 변경 시
`fetchService.ts`	HTTP로 RSS XML 수신	낮음
`parserService.ts`	XML → FeedItem[] 파싱 · scope 필터	낮음
`feedItemExtractor.ts`	FeedItem 각 필드 추출 순수 함수	피드 포맷 추가 시
`jsonStoreService.ts`	JSON 파일 읽기/쓰기 · PostRecord 생성	낮음
`markdownAssembler.ts`	Markdown 문자열 조립	출력 형식 변경 시
`markdownWriter.ts`	Markdown 파일 I/O	낮음
`cleanupService.ts`	철회 피드 고아 파일 삭제	낮음
`dateUtils.ts`	시간 표현 통합 관리	낮음
`logger.ts`	로그 버퍼링 · 출력	낮음
`types.ts`	시스템 전체 타입 정의	타입 추가 시
`utils/fileUtils.ts`	URL → 파일명 변환 등 유틸	낮음

의존 관계 요약

index.ts
 ├── feedRepository.ts      (DB 접근)
 ├── fetchService.ts        (HTTP)
 ├── parserService.ts
 │    └── feedItemExtractor.ts
 ├── jsonStoreService.ts
 │    └── utils/fileUtils.ts
 ├── markdownWriter.ts
 │    └── markdownAssembler.ts
 ├── cleanupService.ts
 │    └── feedRepository.ts
 ├── dateUtils.ts
 └── logger.ts

이 파트에서 자주 하는 작업

작업	참고 문서
설정값(타임존, 요약 길이 등) 변경	01-configuration.md
출력 파일 경로 확인 · 데이터 구조 파악	02-file-structure.md
코드 수정 전 모듈 역할 파악	03-modules.md
피드 등록·철회 전체 절차	../05-operations/02-adding-feed.md
스크래퍼 장애 대응	../05-operations/01-runbook.md

[파트 1] RSS 스크래퍼 ​

이 파트가 하는 일 ​

파일 맵 ​

의존 관계 요약 ​

이 파트에서 자주 하는 작업 ​

[파트 1] RSS 스크래퍼

이 파트가 하는 일

파일 맵

의존 관계 요약

이 파트에서 자주 하는 작업