Cron 작업 코드 생성

페르소나

• node-cron 기반 스케줄러 마스터
• 적응형 스케줄링 알고리즘 설계
• Cron 로깅 및 모니터링 전문가
• 에러 복구 및 재시도 로직 구현

입력 정보 수집

1. 모듈명 (필수): kebab-case (예:

   log-cleanup

   ,

   sms-result-processor

   )
2. 작업 설명 (필수): 크론 작업이 수행할 내용
3. 실행 주기 (필수):
   • Cron expression (예:

     '0 2 * * *'

     → 매일 새벽 2시)
   • 또는 한글 설명 (예: "매일 새벽 2시", "1분마다")
4. 스케줄러 타입:
   • 고정 스케줄: node-cron 기본 (시간 기반)
   • 적응형 스케줄: 백그라운드 무한 루프 (데이터 양 기반)

생성 프로세스

1. 참조 패턴 확인

적응형 스케줄러인 경우

• 무한 루프 백그라운드 실행
• 적응형 대기 시간 조정
• Cron 로그 기록
• 치명적 에러 처리

server.ts 통합

• node-cron 사용법
• Cron expression 작성
• 시간대 설정

2. 파일 생성

api/src/modules/{{module-name}}/

Service 파일 (

service/{{module-name}}.service.ts

)

• cron-service-template.ts 참조
• 적응형 스케줄러 로직
• Cron 로그 기록
• 서버 정보 수집
• 에러 처리 (치명적/일반)

DAO 파일 (

dao/{{module-name}}.dao.ts

)

• countPending()

  : 미처리 건수 조회

• findPending()

  : 미처리 항목 조회

• insertCronLog()

  : Cron 로그 생성

• updateCronLog()

  : Cron 로그 업데이트

server.ts 통합 코드

• server-cron-integration.ts 참조
• import문 추가

• start{{SchedulerMethodName}}()

  메서드 추가

• koaServer()

  메서드 내에서 호출

3. 템플릿 변수 치환

• {{MODULE_NAME}}

  : 모듈명 (kebab-case)

• {{ServiceClassName}}

  : Service 클래스명 (PascalCase)

• {{DaoClassName}}

  : DAO 클래스명 (PascalCase)

• {{JOB_NAME}}

  : 작업명 (kebab-case)

• {{SchedulerMethodName}}

  : 스케줄러 메서드명 (PascalCase)

• {{작업 설명}}

  : 작업 설명 (한글)

• {{cron-expression-description}}

  : 실행 주기 설명

4. Cron Expression 변환

'*/5 * * * * *'

'0 * * * * *'

'0 2 * * *'

'0 0 * * 0'

'0 0 1 * *'

5. common_log_cron 테이블 생성

CREATE TABLE common_log_cron (
  log_seq INT AUTO_INCREMENT PRIMARY KEY,
  job_name VARCHAR(100) NOT NULL,
  job_type VARCHAR(20) NOT NULL,       -- 'auto' / 'manual'
  start_time DATETIME NOT NULL,
  end_time DATETIME,
  duration INT,                         -- 실행 시간 (초)
  status VARCHAR(20) NOT NULL,          -- 'running' / 'success' / 'failed'
  processed_count INT DEFAULT 0,
  success_count INT DEFAULT 0,
  failed_count INT DEFAULT 0,
  error_message TEXT,
  error_stack TEXT,
  server_info VARCHAR(200),             -- IP|hostname|pid|version|platform
  detail_log TEXT,                      -- JSON 상세 로그
  insert_seq INT NOT NULL,
  insert_date DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
  update_seq INT,
  update_date DATETIME
);

6. server.ts 수동 통합

1. import문을 파일 상단에 추가

2. start{{SchedulerMethodName}}()

   메서드를 Server 클래스에 추가

3. koaServer()

   메서드 내 스케줄러 시작 부분에 호출 추가

출력

1. 생성된 Service 파일 경로
2. 생성된 DAO 파일 경로
3. server.ts에 추가할 코드 (코드 블록으로 표시)
4. 테스트 실행 방법

예시

사용자: "매일 새벽 2시에 오래된 로그를 삭제하는 크론 작업 만들어줘"

생성 결과:
- api/src/modules/log-cleanup/service/log-cleanup.service.ts
- api/src/modules/log-cleanup/dao/log-cleanup.dao.ts
- server.ts 통합 코드

실행 주기: 매일 새벽 2시 (0 2 * * *)
시간대: Asia/Seoul

검증 단계

# 타입 체크
cd api && bun run build

# 린트 체크
cd api && bun run lint:fixed

# Cron 로그 테이블 존재 확인
# common_log_cron 테이블이 없으면 생성 안내

완료 조건

• bun run build 성공
• bun run lint:fixed 통과
• server.ts 통합 코드 제공
• common_log_cron 테이블 확인/생성 안내