ai-code-app/docs/features/plan-schedule.md

Plan 스케줄 사용법

목적

반복적으로 등록되는 자동화 요청을 수동 입력 없이 생성하기 위한 스케줄 화면 사용법과 제약을 정리합니다.

구현 위치

• 화면: src/features/planBoard/PlanSchedulePage.tsx
• API: src/features/planBoard/api.ts

제공 기능

• 스케줄 목록 조회
• 신규 스케줄 등록
• 기존 스케줄 수정/삭제
• 즉시 실행 옵션 설정
• 활성/비활성 전환
• 반복 주기 또는 매일 실행 시간 설정
• 다음 실행 예정 시각 계산 표시

입력 항목

• workId: 반복 등록할 작업 ID
• note: 매번 생성될 요청 메모
• automationType: 자동화 유형
  • plan: Markdown 스타일 Plan 문서 등록/접수
  • auto_worker: 실제 자동 작업 실행
  • command_execution, non_source_work: 기존 분류 유지
• releaseTarget: 반영 대상 브랜치
• jangsingProcessingRequired: 기능동작확인 필요 여부
• autoDeployToMain: main 자동 반영 대상 여부
• enabled: 스케줄 사용 여부
• immediateRunEnabled: 생성 직후 바로 등록 허용 여부

스케줄 모드

1. 반복 주기

interval 모드입니다.

• 값 + 단위로 반복 주기 설정
• 단위: minute, hour, day, week, month
• 내부 저장은 repeatIntervalMinutes 기준

2. 매일 시간

daily 모드입니다.

• HH:mm 형식 시간 사용
• 시간 계산은 Asia/Seoul 기준
• 하루 1회 등록에 적합

유효성 규칙

현재 화면에서 다음 검사를 수행합니다.

• 작업 ID 필수
• 메모 필수
• 같은 작업 ID 중복 금지
• interval 모드 최소 10분 이상
• 비활성 스케줄은 자동 등록되지 않음을 경고

다음 실행 시각 계산

다음 실행 시각은 화면에서 즉석 계산해 보여줍니다.

• 비활성 상태면 중지
• 직전 등록 이력이 없고 즉시 실행이 켜져 있으면 현재 시각 기준
• daily는 오늘 KST 실행 여부를 보고 오늘 또는 다음 날 시각 결정
• interval은 마지막 등록 시각 또는 생성 시각 기준으로 다음 주기를 계산

추천 운영 방식

• 자주 반복되는 운영 작업은 고정 workId로 등록
• 사람이 검토해야 하는 작업은 autoDeployToMain을 끄고 release 검수 단계에서 확인
• 단순 알림성/반복성 작업은 immediateRunEnabled를 켜서 누락 없이 시작
• 짧은 주기 스케줄은 10분 이상으로 유지해 중복 생성 위험을 낮춤

API 경로 메모

스케줄 API는 서버 구현 차이를 흡수하기 위해 여러 경로를 순차 시도합니다.

• /plan/scheduled-tasks
• /plan/schedule/tasks
• /plan/schedule
• /plan/schedules
• /plans/... 변형 경로

서버 경로가 고정되면 후보 경로를 줄여도 됩니다.

테스트 포인트

• interval/daily 전환 시 값 보존이 자연스러운지 확인
• 같은 workId 중복 저장이 막히는지 확인
• KST 기준 다음 실행 시각이 기대와 일치하는지 확인
• 비활성 스케줄이 자동 생성되지 않는지 확인
• 토큰 없는 사용자에게 저장/삭제가 제한되는지 확인