# 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 기준 다음 실행 시각이 기대와 일치하는지 확인
- 비활성 스케줄이 자동 생성되지 않는지 확인
- 토큰 없는 사용자에게 저장/삭제가 제한되는지 확인