프로젝트 소개

이 프로젝트는 GitHub 저장소에 배포 가능한 클라우드 기반 자동 수집 솔루션으로, Ktown4u 사인회 이벤트의 실시간 판매량을 지속적으로 추적합니다. GitHub Actions의 예약 작업을 활용하여 5분마다 한 번씩 실행되며, 각 실행 주기 내에서 약 10초 간격으로 밀집 수집을 수행합니다. 수집된 결과는 data 디렉토리 아래의 CSV 파일에 추가되며, 필드에는 time(시간), member(멤버), sales(판매량), delta(변동량)가 포함됩니다. 주요 구성 요소는 다음과 같습니다: - .github/workflows/track.yml: 예약 트리거 워크플로우 구성 - ktown4u_ci.py: 수집 스크립트 - track_config.json: 모니터링할 활동 번호, 수집 간격, 각 주기 지속 시간을 설정 - data/: 자동 생성된 CSV 히스토리 데이터 사용 절차는 공개 저장소를 생성하고 위 파일을 업로드한 후 Actions를 활성화하고, track_config.json에 활동 번호를 입력하는 것입니다. 공개 저장소는 Actions를 무료로 무제한 사용할 수 있지만, 비공개 저장소는 월 2000분으로 제한됩니다. 데이터는 저장소에서 직접 확인하거나 다운로드할 수 있으며, 로컬에 클론한 후 제공된 스크립트를 사용하여 판매량 구간을 추정할 수도 있습니다. 프로젝트 문서는 제한 사항을 명확히 설명합니다: GitHub 예약 작업의 최소 세분화는 5분이며 지연될 수 있으므로, 실제로 연속적인 10초 수집이 아닙니다. 진행 중이거나 막 종료된 활동만 수집 가능하며, 이미 보관된 오래된 활동은 가져올 수 없습니다. 초 단위의 연속 수집이 필요하다면 상시 운영되는 클라우드 서버가 필요합니다.