# task-727.1 완료 보고서: Threads 텍스트 포스트 업로드 1건

## S - Situation
ThreadAuto 시스템의 텍스트 전용 포스트 기능(`run_text_post.py`)이 구현 완료되어 운영 중이다. 줄바꿈 보정(`ensure_line_breaks`), AI 냄새 제거, 글자수 제한 검증이 내장되어 있다.

## C - Complication
첫 실행 시 `text_empathy` 타입(max 80자)에서 생성 텍스트가 85자로 3회 연속 검증 실패. 줄바꿈 문자(`\n`)가 글자수에 포함되어 제한을 초과하는 경향이 있다. 2차 실행에서는 `text_insight` 타입(max 140자)이 선택되어 정상 통과.

## Q - Question
텍스트 포스트가 정상적으로 Threads에 업로드되었는가? 줄바꿈·금칙어·문장 완결성 요건을 충족하는가?

## A - Answer
2차 실행에서 업로드 성공. post_id `17909550657182253` 확인. 줄바꿈 14개 포함, 글자수 140자, "잔존수당" 미포함 확인 완료.

---

## 실행 결과

- **post_id**: `17909550657182253`
- **text_type**: `text_insight` (업계 인사이트)
- **토픽**: GA 시장 성장 추이: 전속 설계사는 어디로 가나 (카테고리: 업계동향)
- **글자수**: 140자
- **줄바꿈(\n) 개수**: 14개
- **해시태그**: #GA시장 #보험트렌드
- **"잔존수당" 포함**: 없음 (정상)

### 텍스트 전문

```
이건 좀 주목할 만한데

2025년 기준
GA 소속 설계사 비중이
전체의 60% 넘었거든요

전속 채널은 매년 줄고
GA만 계속 느는 구조임

GA 시장 성장이란
전속→독립 이동의
가속화를 뜻하는 거임

서울대보험쌤 분석으로는
이 흐름 역전 어려움 📊
```

### 해시태그 포함 전문 (실제 업로드된 텍스트)

```
이건 좀 주목할 만한데

2025년 기준
GA 소속 설계사 비중이
전체의 60% 넘었거든요

전속 채널은 매년 줄고
GA만 계속 느는 구조임

GA 시장 성장이란
전속→독립 이동의
가속화를 뜻하는 거임

서울대보험쌤 분석으로는
이 흐름 역전 어려움 📊

#GA시장 #보험트렌드
```

---

## 발견 이슈 및 해결

### 자체 해결 (2건)

1. **text_empathy 타입 3회 연속 검증 실패 (85 > 80자)** — 스크립트 재실행으로 text_insight 타입 선택되어 해결. text_empathy의 max_length(80자)는 줄바꿈 포함 시 빈번히 초과되는 경향이 있으나, 본 태스크 범위 밖이므로 별도 보고.
2. **문장 끝 문자 경고 (마지막 문자='📊')** — 이모지로 끝나는 문장이 스크립트 자체 검증에서 경고 발생. 실제 콘텐츠를 확인하면 "이 흐름 역전 어려움 📊"로 의미상 완결된 문장임. 업로드에는 영향 없음.

### 범위 외 미해결 (1건)

1. **Firestore 초기화 실패 (ADC 자격증명 미설정)** — 범위 외 사유: 인프라 설정 이슈. 로컬 파일 폴백으로 정상 동작하며, 발행 이력은 로컬에 저장됨.

---

## 셀프 QC 체크리스트

- [x] 1. 다른 파일 영향: 없음 (스크립트 실행만, 코드 변경 없음)
- [x] 2. 엣지 케이스: text_empathy 글자수 초과 → 재실행으로 대응
- [x] 3. 작업 지시 일치: 텍스트 포스트 1건 업로드 완료, post_id/텍스트/글자수/줄바꿈 보고
- [x] 4. 에러 처리/보안: API 토큰 노출 없음, Firestore 폴백 정상
- [x] 5. 테스트 커버리지: 업로드 성공 확인 (post_id 반환)
- [x] 6. 이슈 모두 해결: 2건 자체 해결, 1건 범위 외 명시

---

## 증거

- Threads API 응답: HTTP 200 OK (container 생성 + publish 성공)
- post_id: `17909550657182253`
- history_id: `96709977-5447-4b12-b465-41c7c72a98c6`
- 글자수: 140자 (text_insight max 140 이내)
- 줄바꿈: 14개 (`\n` count)