[외전] 3. 수정 지옥에 빠지다: 완벽주의의 함정과 FastAPI 핵심 풀코드 결산

👤 관리자

조회 수 96

들어가며: 앞으로 나아가지 못하는 병, '수정 지옥'

지난번 포스팅에서 파이썬 <code>Pillow</code> 라이브러리를 활용해 무거운 이미지 파일들을 가벼운 <code>WebP</code> 포맷으로 압축하는 데 성공했습니다. 방구석 노트북 서버의 500GB 하드디스크 용량 문제를 완벽하게 해결하고 나니, 이제 정말 홀가분한 마음으로 다음 기능(게시글 검색 기능이나 해시태그) 개발로 넘어갈 수 있을 줄 알았습니다.

그런데 제 에디터(VS Code) 화면은 며칠째 제자리에 머물러 있습니다. 이른바 모든 초보 개발자들이 한 번쯤 겪는다는 끔찍한 불치병, **'수정 지옥(Refactoring Hell)'**에 빠져버린 것입니다.

"코드가 너무 지저분한 것 같은데?", "이 함수를 저 함수랑 합치면 더 예쁘지 않을까?", "변수 이름이 직관적이지 않은데 싹 다 바꿔볼까?"

기능은 이미 완벽하게 작동하고 있는데도 불구하고, 제 눈에는 끊임없이 고치고 다듬어야 할 부분들만 보였습니다. 끝없는 수정표를 들고 코드를 이리저리 옮기다 보니 정작 새로운 기능 개발은 진척이 제로(0)에 수렴하고 있었습니다. 완벽주의가 부른 대참사였죠.

1. 멈춰 서서 뒤를 돌아보다: 우리가 만들어낸 기적들

이 수정 지옥에서 빠져나오기 위해서는, 역설적이게도 잠시 키보드에서 손을 떼고 제가 지금까지 만들어온 결과물들을 객관적으로 되돌아볼 필요가 있었습니다.

로스트아크 골드 40만 원으로 시작된 이 무모한 프로젝트는 어느새 거대한 형태를 갖추고 있었습니다.

무중단 배포를 위한 Render 클라우드 백업 연동

</li><li>

접속 기기에 맞춰 변하는 반응형 웹진 썸네일 게시판 * 트래픽 과부하를 막는 페이지네이션(Pagination)

</li><li>

30일 데이터 기반의 랭킹(명예의 전당) 알고리즘

</li><li>

OpenCV를 활용한 동영상 첫 프레임 썸네일 자동 추출

</li><li>

악성 도배를 막는 SlowAPI 기반 댓글 속도 제한(Rate Limit)

</li><li>

그리고 가장 최근에 적용한 Pillow 활용 WebP 이미지 90% 압축까지.

</li></ul>

불과 한두 달 전만 해도 리눅스 터미널의 까만 화면을 보며 식은땀을 흘리던 제가, 백엔드와 프론트엔드, 그리고 서버 인프라를 아우르는 이 수많은 기능들을 직접 손으로 구현해 낸 것입니다. 코드가 조금 못생겼으면 어떻습니까? 이 수많은 톱니바퀴들이 맞물려 하나의 웹사이트(<code>inspeep.com</code>)로 돌아가고 있다는 사실 자체가 이미 기적인 것을요.

2. 흩어진 코드들을 하나로: 백엔드 핵심 로직 풀코드 정리

수정 지옥의 굴레를 끊어내기 위한 마지막 의식으로, 그동안 덕지덕지 기워 붙였던 백엔드 게시글 업로드 코드를 단정하게 하나로 통합하여 정리했습니다.

마치며: 완벽함보다는 '완성'을 향해

위의 코드를 하나로 묶어내고 테스트를 통과한 순간, 비로소 강박처럼 저를 짓누르던 수정 지옥에서 빠져나올 수 있었습니다.

프로그래밍 격언 중에 **"Done is better than perfect(완벽한 것보다 일단 완성하는 것이 낫다)"**라는 말이 있습니다. 현업의 뛰어난 시니어 개발자들도 과거의 자기 코드를 보면 부끄러워 이불을 찬다고 하죠. 코드는 언제나 개선의 여지가 있는 법입니다. 과거의 코드에 얽매여 멈춰있기보다는, 약간의 아쉬움을 안고서라도 유저들에게 새로운 경험을 제공할 다음 페이지로 넘어가야 할 때입니다.

긴 외도를 마쳤으니, 다음 17편에서는 정말로 미뤄두었던 숙원 사업! 수많은 게시물 속에서 내가 원하는 글만 귀신같이 찾아내는 '게시판 검색 기능(Search)' 개발기로 힘차게 돌아오겠습니다. 기대해 주세요!