DDL 스키마·위젯 에디터 기술 부채 정리로 유지보수성 개선

table renaming script and widget editor adjustments

2026-01-17. 내부 구조 정리 작업. 기능은 안 바뀌지만 앞으로의 유지보수를 위한 투자임.

정리 대상

코드 리뷰나 기능 추가 작업을 하다 보면 '이 부분 나중에 꼭 정리해야지'라고 생각하는 곳들이 쌓임. 이번에 그 기술 부채를 정리했음.

• 테스트: 역할이 불명확한 부분 분리
• 프론트엔드 스크립트: 중복 로직 통합
• DDL 스키마: 일관성 없는 네이밍 통일

주요 변경

// 제거: 사용하지 않는 dead code
// 이동: 공통 로직을 적절한 위치로
// 이름 변경: 의도가 드러나도록
// 분리: 너무 큰 모듈을 적절한 크기로

리팩토링할 때 가장 중요한 건 한 번에 너무 많이 바꾸지 않는 것임. 변경 범위가 크면 검증이 어렵고, 뭔가 잘못됐을 때 원인 찾기도 힘듦. 이번엔 논리적으로 연관된 것들끼리 묶어서 단계별로 진행했음.

변경 후 기존 기능 동작 확인했고, 추가로 코드 가독성도 확연히 나아졌음. 기술 부채를 미루면 이자가 붙는다는 표현이 딱 맞는 것 같음.

리팩토링 후기

기능 동작은 그대로인데 코드 구조가 바뀌면 어떤 효과가 있는지 실감했음. 같은 기능을 수정해야 할 때 이전에는 여러 파일을 뒤져야 했는데, 정리 후에는 수정 포인트가 명확해져서 작업 시간이 줄었음.

리팩토링을 자주 하면서 느끼는 건, 코드는 처음부터 완벽할 수 없다는 거임. 요구사항도 변하고 이해도도 달라지기 때문에, 주기적으로 다듬는 게 자연스러운 과정임. '완성된 코드'라는 개념 자체가 없다고 생각함.

다음