# task-388.1 완료 보고서
## 스레드 자동화 20/일 확대 + 파이프라인 가동

**팀**: dev2-team (오딘 팀장)
**작업자**: 토르(백엔드), 헤임달(테스터)
**레벨**: Lv.2

---

## 작업 내용

### 1. 핵심 변경 (10개/일 → 20개/일)

#### scheduler/auto_publisher.py
- GOLDEN_SLOTS 확대: 출근시간 3→5, 점심시간 2→3, 퇴근후 2→6 (골든타임 합계 7→14)
- NON_GOLDEN_COUNT: 3→6
- 총 슬롯: 10→20 (골든타임 70% = 14, 비골든 30% = 6)
- docstring 업데이트

#### content/topic_selector.py
- DAILY_MIX 확대: 고민공감 3→6, 정보제공 3→6, 사회적증거 2→4, 업계동향 1→2, CTA 1→2
- 업계동향 count>1 지원: 첫 1개는 뉴스 캐시 우선, 나머지는 에버그린 풀에서 추가 선택
- docstring 업데이트

#### scheduler/daily_runner.py
- fill_with_evergreen 기본값: target_count=10 → 20
- run_daily_pipeline 내 target_count를 `sum(DAILY_MIX.values())`로 동적 참조
- DAILY_MIX import 추가
- docstring 업데이트

### 2. 테스트 업데이트

#### tests/test_auto_publisher.py
- 55개 테스트 모두 20개 기준으로 업데이트 (슬롯 수, 골든/비골든 카운트 등)

#### tests/test_topic_selector.py
- 45개 테스트 모두 20개 기준으로 업데이트 (DAILY_MIX 합계, 카테고리 배분 등)

#### tests/test_daily_runner.py
- 40개 테스트 모두 20개 기준으로 업데이트 (fixture, assertion 등)

---

## 생성/수정 파일 목록

- `content/topic_selector.py` (수정)
- `scheduler/auto_publisher.py` (수정)
- `scheduler/daily_runner.py` (수정)
- `tests/test_auto_publisher.py` (수정)
- `tests/test_topic_selector.py` (수정)
- `tests/test_daily_runner.py` (수정)

---

## 테스트 결과

- 변경 관련 140개 테스트: **전체 PASS**
- 전체 테스트 스위트: 427/428 PASS
  - 1개 실패: `test_evergreen_topics.py::test_used_count_initial_zero` — 실제 데이터 파일(`evergreen_topics.json`)의 used_count가 이전 실행에서 증가되어 발생. **본 작업과 무관한 기존 이슈**

---

## QC 검증 결과

```json
{
  "tdd_check": "PASS",
  "style_check": "PASS",
  "data_integrity": "PASS",
  "file_check": "6/6 코드 파일 OK",
  "test_runner": "427/428 PASS (1 pre-existing failure)",
  "pyright_check": "10 errors — 모두 기존 이슈 (date=None 타입 등)"
}
```

### pyright 기존 이슈 (본 작업 미도입)
- `auto_publisher.py:211`: `target_date: date = None` 타입 미스매치 (기존)
- `daily_runner.py:507`: `load_queue(target_date: date = None)` 동일 (기존)
- 테스트 파일 8개: 타입 narrowing 이슈 (기존)

---

## 파이프라인 가동 상태

### 미가동 항목 (수동 확인 필요)
1. **토큰 유효성**: 실행 환경에서 토큰 확인 필요 (`auth/token_store.py`)
2. **이미지 서버**: `curl http://127.0.0.1:8080/` 로 확인 필요
3. **daily_runner dry-run**: `python3 scheduler/daily_runner.py` 로 실제 20개 콘텐츠 생성 테스트 필요 (Claude CLI 호출 포함, ~40분 소요)
4. **publish_worker 데몬**: `nohup python3 scheduler/publish_worker.py --daemon --interval 60` 실행 필요
5. **cron 등록**: 매일 새벽 5시 daily_runner 실행

### cron 등록 예시
```bash
cokacdir --cron "ThreadAuto 일일 콘텐츠 20개 생성 실행: cd /home/jay/projects/ThreadAuto && python3 scheduler/daily_runner.py" --at "0 5 * * *" --chat 6937032012 --key c119085addb0f8b7
```

### 주의사항
- Threads API 일일 250건 한도 → 20개면 8% 사용, 여유 있음
- 에버그린 소재 200개, 쿨다운 7일 → 20개/일이면 10일분. 소재 추가 권장
- 점심시간 슬롯(12-13시 1시간)에 3개 배정 → 평균 20분 간격, MIN_INTERVAL 10분 충족

---

## 머지 판단

- **머지 필요**: Yes
- **브랜치**: task/task-388.1-dev2
- **워크트리 경로**: /home/jay/projects/ThreadAuto/.worktrees/task-388.1-dev2
- **머지 의견**: 140개 테스트 전체 PASS, 코드 변경이 명확하고 제한적 (상수값 + 업계동향 count>1 처리). 기존 테스트와 충돌 없음. 머지 권장.

---

## 버그

- 없음 (기존 이슈 1건: test_evergreen_topics의 데이터 파일 used_count)