# HLB Studio 반복 업무 설계 워크북

이 문서를 복사해 한 작업씩 채워 쓰세요. 텍스트 편집기나 Markdown 편집기에서 열 수 있습니다. 자동화 실행 코드, 서비스 연결, API 키는 들어 있지 않습니다.

빈 양식 다음에 가상의 파일 정리 설계 예시가 있습니다. 예시는 실제 시험 결과가 아니며, 직접 실행한 결과는 아래 시험 기록 칸에 별도로 적습니다.

## 1. 해결할 작업

- 작업 이름:
- 담당자 / 문제가 생겼을 때 확인할 사람:
- 현재 작업 순서:
- 실행 빈도:
- 한 번에 처리하는 평균 개수:
- 현재 회당 수작업 시간:
- 줄이고 싶은 반복 단계:
- 사람이 계속 판단해야 하는 단계:
- 이번에 자동화할 범위:
- 이번에 제외할 범위:

한 문장으로 적기: **[어떤 입력]을 받아 [정해진 처리]를 하고 [확인 가능한 결과]를 만든다.**

## 2. 입력과 실행 시작

| 항목 | 내 작업 |
|---|---|
| 입력 위치 / 입력 담당자 | |
| 입력 형식과 필수 항목 | |
| 실행 시작 조건: 수동 / 일정 / 새 자료 | |
| 한 번에 처리할 범위 | |
| 처리하지 않을 자료와 이유 | |
| 빈 입력일 때의 동작 | |
| 잘못된 자료일 때의 동작 | |
| 이미 처리한 자료를 구분하는 기준 | |
| 처리 기록을 보관할 위치 | |

## 3. 처리 단계

| 순서 | 입력 | 처리 규칙 | 결과 | 실패 시 동작 | 사람이 확인할 부분 |
|---:|---|---|---|---|---|
| 1 | | | | | |
| 2 | | | | | |
| 3 | | | | | |
| 4 | | | | | |

필요한 만큼 행을 추가하세요. 되돌리기 어려운 외부 전송·삭제·결제는 미리보기와 사람 확인 단계를 별도로 둡니다.

## 4. 완료를 판단하는 조건

- 결과를 보관할 위치:
- 정상 완료의 기준:
- 일부만 끝났을 때의 상태:
- 제외 항목을 기록할 방법:
- 실패 항목을 기록할 방법:
- 실제 결과를 확인할 담당자:
- 작업 결과를 재확인할 날짜:

완료는 실행 성공 메시지가 아니라 **필요한 결과와 검증 기록이 모두 있는 상태**로 정합니다.

## 5. 실패와 복구

- 재시도할 수 있는 오류:
- 재시도하지 않고 멈춰야 하는 오류:
- 최대 재시도 횟수 / 대기 시간:
- 일부 성공 후 다시 실행할 범위:
- 중복 결과를 막는 방법:
- 중단할 방법:
- 원본을 유지할 방법:
- 이전 결과로 되돌릴 방법:
- 문제가 해결되었다고 판단할 기준:

## 6. 권한과 자료 취급

- 읽기 권한이 필요한 위치:
- 쓰기 권한이 필요한 위치:
- 삭제 권한이 정말 필요한가:
- 외부로 보내는 자료가 있는가 / 보낼 필요가 있는가:
- 개인정보나 비밀값을 포함하는 자료가 있는가:
- 로그에 기록하지 않을 값:
- 비밀값을 보관할 위치 이름:
- 권한·도구 담당자가 바뀌면 점검할 항목:

비밀값 자체를 이 양식에 적지 마세요. 예를 들어 보관 위치 이름만 적고 실제 키나 비밀번호는 따로 관리합니다.

## 7. 작은 시험 계획과 실제 기록

시험 자료는 실제 업무 자료의 사본이나 가상 자료로 준비합니다. 예상 결과와 실제 결과를 다른 칸에 적습니다.

| 시험 조건 | 예상 결과 | 실제 입력 / 실행 날짜 | 실제 결과 | 수정할 점 | 확인됨? |
|---|---|---|---|---|---|
| 정상 입력 한 건 | | | | | 미확인 |
| 빈 입력 | | | | | 미확인 |
| 형식이 맞지 않는 입력 | | | | | 미확인 |
| 같은 입력 두 번 | | | | | 미확인 |
| 읽기 권한 없음 | | | | | 미확인 |
| 결과 위치 쓰기 불가 | | | | | 미확인 |
| 일부 단계만 성공 | | | | | 미확인 |
| 중단 후 다시 실행 | | | | | 미확인 |

## 8. 적용 전 확인

- [ ] 원본을 보존한 작은 시험 자료로 실행했다.
- [ ] 예상 결과와 실제 결과를 구분해 기록했다.
- [ ] 정상·제외·실패를 구분할 수 있다.
- [ ] 같은 입력을 다시 처리해도 결과가 중복되지 않는다.
- [ ] 일부 실패 이후 다시 처리할 범위가 정해져 있다.
- [ ] 멈추는 방법과 복구 방법을 확인했다.
- [ ] 다른 사람이 실행 방법과 결과를 이해할 수 있다.
- [ ] 관리 담당자와 다음 점검 날짜를 정했다.

## 9. 운영 후 시간 기록

- 관찰 기간:
- 같은 기간의 기존 수작업 시간:
- 자동화 뒤 사람이 확인한 시간:
- 실패를 찾아 수정한 시간:
- 규칙과 설정을 변경한 시간:
- 일회성 구축 시간 (반복 관리 시간과 구분):
- 실제 실패 횟수 / 주요 원인:
- 유지 / 수정 / 중단 중 다음 결정:
- 다음 점검 날짜:

순절약 시간 = 기존 수작업 시간 − 결과 검토 시간 − 실패 처리 시간 − 반복 관리 시간.

## 가상 설계 예시: 견적서 PDF 복사

다음은 명세를 쓰는 방법을 보여주는 예시입니다. 특정 서비스·Google API와 연결한 작업이나 실제 실행 기록이 아닙니다.

**목표:** 테스트 폴더의 PDF를 날짜별 결과 폴더에 복사하고, 원본은 유지한다.

| 항목 | 설계 예시 |
|---|---|
| 입력 | 테스트 폴더에 가상 PDF 2개와 텍스트 파일 1개 |
| 시작 | 담당자가 실행 전 미리보기를 확인하고 수동 시작 |
| 처리 대상 | 읽을 수 있는 PDF만 |
| 제외 | 텍스트 파일은 제외 이유를 기록 |
| 식별 기준 | 파일 내용으로 만든 식별값과 처리 기록을 비교 |
| 결과 | 날짜별 폴더의 PDF 사본과 처리 기록 |
| 완료 조건 | 예정 PDF 2개의 사본 내용 확인; 처리 2건·제외 1건·실패 0건 |
| 중복 처리 | 이미 확인한 식별값은 건너뛰고 새 사본을 만들지 않음 |
| 원본 취급 | 복사만 하며 원본 삭제·이름 변경 없음 |
| 실패 | 결과 위치에 쓸 수 없으면 멈추고 원본과 기존 사본 유지 |
| 재실행 | 문제를 해결한 뒤 실패 항목만 다시 처리 |

**예상 시험 결과 (실제 확인 전):**

- 빈 폴더: 처리 0건. 오류와 구분해 기록.
- 같은 PDF 재입력: 추가 사본 0건. 중복으로 기록.
- PDF 한 개 읽기 실패: 성공한 항목과 실패한 항목을 따로 기록.
- 결과 폴더 쓰기 불가: 원본과 기존 결과를 유지하고 실패로 종료.
- 중간에 중단: 완료한 항목은 재생성하지 않고 남은 항목부터 재실행.

이 예시를 내 작업에 맞게 바꾼 다음 실제 시험 결과를 7번 표에 채우세요. 도구가 이 규칙을 구현할 수 있는지는 별도 확인이 필요합니다.

---

HLB Studio · halllllabongs