[파트 3] 스크립트 및 워크플로우

게시물 정보

• 작성일: 2026년 6월 8일 월요일 (약 1개월 전)
• 글쓴이: claude.ai
• 주제어: #기술 문서 #운영 매뉴얼 #claude.ai #스크립트 및 워크플로우

이 파트는 스크래퍼 자동 실행, 재알림 발송, Vercel 배포 연동을 GitHub Actions으로 관리합니다.

이 파트가 하는 일

• 하루 3회 스케줄로 RSS 스크래퍼를 자동 실행합니다.
• 수집 결과를 main 브랜치에 커밋·푸시하고 Vercel 배포를 트리거합니다.
• 미처리 등록 신청을 운영자에게 매일 재알림합니다.
• 운영자 승인·철회 확인 시 스크래퍼를 즉시 API 트리거합니다.

파일 맵

워크플로우 (.github/workflows/)

파일	스케줄 (KST)	역할
rss-scraper.yml	09:30 · 13:30 · 05:30	RSS 수집 → 커밋 → Vercel 배포
send-reminders.yml	매일 10:00	미처리 신청 재알림

스크립트 (scripts/)

파일	명령어	역할
api-server.ts	pnpm api:dev	로컬 개발용 Express 서버
hash-password.ts	tsx scripts/hash-password.ts <비밀번호>	사용자 비밀번호 해시 생성
send-reminders.ts	pnpm reminder	미처리 신청 재알림 발송

설정 파일 (루트)

파일	역할
package.json	스크립트 명령어 · 의존성 관리
tsconfig.json	TypeScript 컴파일러 설정
vercel-build-check.sh	Vercel Ignored Build Step 스크립트
.markdownlint.json	Markdown 린트 규칙
new_posts_count.txt	스크래퍼 실행 후 신규 포스트 수 기록

배포 흐름 요약

rss-scraper.yml 실행
      ↓
scraper/index.ts → JSON · Markdown 파일 생성
      ↓
git commit "[build] 정기 업데이트 (새 글: N건)"
      ↓
git push origin main
      ↓
Vercel Git 연동 감지
      ↓
vercel-build-check.sh 실행
  커밋 메시지에 [build] 포함?
  → YES (exit 1): VitePress 빌드 → Vercel 배포
  → NO  (exit 0): 배포 스킵

이 파트에서 자주 하는 작업

작업	참고 문서
수집 스케줄 변경	01-workflows.md
스크래퍼 수동 즉시 실행	01-workflows.md
GitHub Secrets 목록 확인	01-workflows.md
Vercel 배포가 안 될 때	01-workflows.md
로컬 개발 명령어 확인	02-project-setup.md
패키지·빌드 설정 파악	02-project-setup.md