# 오디오 파일 관리 정책

**버전**: v1.0
**작성일**: 2026-03-25
**작성자**: dev2-team/task-1003.1

---

## 1. 목적

유튜브 요약 등 작업 수행 중 다운로드한 오디오 파일이 시스템을 비대하게 만드는 것을 방지하기 위해, 체계적인 오디오 파일 생성 및 삭제 규칙을 정의합니다.

---

## 2. 대상 확장자

다음 오디오 파일 확장자를 관리 대상으로 합니다:
- wav
- mp3
- m4a
- ogg
- flac
- aac

---

## 3. 생성 규칙

- **생성 위치**: 오디오 파일은 반드시 작업 디렉토리 내에 생성
- **파일명**: task-id를 파일명에 포함하는 것을 권장 (예: `task-1003_audio.mp3`)

---

## 4. 삭제 규칙

- **즉시 삭제**: 요약/처리 완료 후 담당자가 즉시 삭제할 책임
- **최대 보존 기간**: 24시간 (자동 정리 스크립트가 강제 삭제)
- **자동 삭제 대상**: 50MB 이상 오디오 파일 (6시간마다 정리 실행)

---

## 5. Git 규칙

- **추적 금지**: 50MB 이상 오디오 파일은 git 추적 금지
- **.gitignore 설정**: 모든 오디오 확장자가 등록됨
  ```
  *.wav
  *.mp3
  *.m4a
  *.ogg
  *.flac
  *.aac
  ```
- **git push 전 확인**: 대용량 파일 여부 필수 확인

---

## 6. 자동 정리 시스템

### 6.1 정리 스크립트
- **위치**: `/home/jay/workspace/scripts/cleanup-large-audio.sh`
- **실행 주기**: 매 6시간 (cron)
- **로그 저장**: `/home/jay/workspace/memory/logs/audio-cleanup.log`

### 6.2 정리 범위
- 50MB 이상 오디오 파일 자동 삭제
- 24시간 이상 보존된 파일 강제 삭제

---

## 7. 예외 처리

- **진행 중 작업 보호**: task-timers.json에서 'running' 상태인 작업의 오디오 파일은 삭제하지 않음
- **시스템 디렉토리 제외**: workspace/projects 하위 파일만 정리 대상 (시스템 디렉토리 제외)

---

## 8. 운영 요청사항

- 오디오 파일 생성 시 task-id를 파일명에 포함할 것
- 작업 완료 후 지체 없이 오디오 파일 삭제
- git push 전 대용량 파일 존재 확인