# Plan 활용 가이드

## 목적

운영자, 검수자, 개발자가 현재 Plan 기능을 어떤 순서로 써야 하는지 정리한 실무 가이드입니다.

## 빠른 진입

- 전체 목록 확인: `자동화 / 자동화`
- 상세 처리 중심: `자동화 / plan`
- release 검수: `자동화 / release 검수`
- 추이 확인: `자동화 / 차트`
- 반복 등록: `자동화 / 스케줄`

통합 검색에서도 `plan`, `release 검수`, `스케줄`로 바로 이동할 수 있습니다.

## 운영자 기준 사용 순서

1. `자동화 / 자동화`에서 작업을 찾습니다.
2. 필요하면 빠른 필터로 `현재 작업중`, `현재 release 상태`, `현재 자동화 실패`를 좁힙니다.
3. 상세 오버레이에서 현재 상태, 이슈, 최근 소스 작업을 확인합니다.
4. 상황에 맞는 액션을 실행합니다.
5. 후속 설명은 조치 기록 또는 이슈 조치 기록으로 남깁니다.

## 검수자 기준 사용 순서

1. `release 검수`에서 `main 대기` 필터를 우선 봅니다.
2. 검수 메모와 변경 파일, 관련 컴포넌트/위젯 샘플을 확인합니다.
3. 확인한 항목은 체크 상태로 반영합니다.
4. 이상 없으면 `검수완료`, 수정이 필요하면 `수정필요`로 저장합니다.

## 개발자 기준 확인 포인트

- 실패 상태면 `workerStatus`와 `lastError`를 먼저 확인
- 브랜치 누락 계열 실패는 `브랜치 재시도` 또는 `작업 재처리` 판단
- release/main 반영 관련 문제는 상세의 소스 작업 내역과 diff를 먼저 확인
- 메모 원문이 잠겨 있으면 추가 조치 기록으로 정정 사유를 남김

## 권한 없는 사용자 동작

- 목록과 검수 현황은 조회 가능
- 민감 메모는 마스킹
- 상세 수정/삭제/조치 실행은 제한
- 소스 작업 상세와 증적 확인도 제한될 수 있음

## 문서와 화면을 함께 운영하는 방법

- 기능 변경 시 `docs/features`를 먼저 갱신
- 새 문서를 만들면 앱 `Docs / 기능문서`에 자동 노출되는지 함께 확인
- 증적이 필요한 변경은 Plan 상세의 Preview, diff, 파일 목록으로 확인
- 작업일지에는 어떤 기능 문서를 왜 수정했는지 함께 남김

## 추천 문서 읽기 순서

1. `docs/features/plan-board-review.md`
2. `docs/features/plan-automation.md`
3. `docs/features/plan-schedule.md`
4. `docs/features/plan-usage.md`
