[faster-qwen3-tts] 프로젝트 구조 정리: 불필요한 문서 제거와 파일명 표준화

PR 링크: andimarafioti/faster-qwen3-tts#4 상태: Merged | 변경: +78 / -632

들어가며

오픈소스 프로젝트가 초기 프로토타입 단계를 지나면, 개발 과정에서 생성된 임시 문서와 내부 메모가 코드베이스에 남아 혼란을 줄 수 있습니다. 이 PR은 faster-qwen3-tts 프로젝트에서 632줄에 달하는 불필요한 문서(INTEGRATION_SUMMARY.md, JETSON_SETUP.md)를 제거하고, 핵심 모듈의 파일명을 의미 있는 이름으로 표준화한 대규모 정리 작업입니다.

핵심 코드 분석

1. 불필요한 문서 제거

INTEGRATION_SUMMARY.md(262줄)와 JETSON_SETUP.md(59줄) 등 프로젝트 내부 개발 메모 성격의 문서들이 삭제되었습니다. 이 문서들은 로컬 경로(/home/andi/Documents/...)를 포함하고 있어 외부 사용자에게는 무의미했습니다.

2. BLOG.md 파일명 참조 업데이트

프로젝트 블로그 문서에서 참조하는 핵심 모듈 파일명이 표준화된 이름으로 업데이트되었습니다.

Before:

Core implementation:
- `manual_cudagraph_predictor.py` (156 lines)
- `manual_cudagraph_talker.py` (137 lines)
- `fast_generate_v5.py` (156 lines) - non-streaming

After:

Core implementation:
- `predictor_graph.py` (156 lines)
- `talker_graph.py` (137 lines)
- `generate.py` (156 lines) - non-streaming

manual_cudagraph_predictor.py처럼 구현 방식을 파일명에 노출하던 것을 predictor_graph.py처럼 역할 중심의 이름으로 변경했습니다. fast_generate_v5.py의 버전 번호(v5)도 제거하여 파일명이 안정적으로 유지됩니다.

3. 벤치마크 결과 테이블 보강

BLOG.md의 벤치마크 테이블에 Baseline 수치가 추가되어, CUDA Graphs의 효과를 직접 비교할 수 있게 되었습니다.

Before:

| GPU               | Baseline RTF | CUDA Graphs RTF | Speedup | TTFA  |
| RTX 4090          | -            | 5.06            | -       | 36ms  |

After:

| GPU               | Baseline RTF | Baseline TTFA | CUDA Graphs RTF | CUDA Graphs TTFA | Speedup      |
| RTX 4090          | 1.34         | 462ms         | 4.56            | 55ms             | 3.4x / 8.4x |

왜 이게 좋은가

이 리팩토링은 코드를 한 줄도 변경하지 않으면서 프로젝트의 품질을 크게 향상시킵니다. 불필요한 문서 632줄을 제거함으로써 새로운 기여자가 코드베이스를 이해하는 데 드는 인지 부하를 줄이고, 파일명 표준화를 통해 모듈의 역할을 명확하게 전달합니다. 특히 v5와 같은 버전 번호가 파일명에 포함되면 리팩토링 시 불필요한 rename이 반복되는데, 이를 초기에 정리한 것은 좋은 판단입니다.

정리

• 로컬 경로가 포함된 내부 문서 2개(321줄) 삭제
• 핵심 모듈 파일명을 역할 중심으로 표준화
• 벤치마크 테이블에 Baseline 비교 수치 추가
• 전체 코드베이스 554줄 순감

참고 자료

• PR #4

⚠️ 알림: 이 분석은 AI가 실제 코드 diff를 기반으로 작성했습니다.