<aside> 🔥
목차
</aside>
스터디 세션을 리팩토링 과정에서 코드가 길어져서 고민을 했었습니다. 특히나 비즈니스 로직과 레포지토리 코드가 혼재 해 있었고, 그 부분에서 하나의 핸들러가 호출하는 로직에서 서비스.. 레포지토리.. 이렇게 다양한 계층을 따라 로직이 퍼져있었습니다.
그래서 해당 부분을 리팩토링을 시도했으나, 오히려 팀의 성장에 방해가 되었습니다. 그 부분에 있어서는 조금 더 깔끔한 코드와 프로토콜을 만들고자 하는 욕심 이 1순위로 작용했던 것이 아닐까 하고 회고하면서 판단해봅니다.
협업의 본질을 잊어버리고 스터디 기능 자체를 1일만에 개발한 건 분명 좋은 발전이었으나, 그만큼 3일을 팀 입장에서는 허비시키게 만들었습니다.
사실 이벤트 명을 바꾼건 크게 문제가 되지 않았습니다. 그냥 바꾸면 되니까요. 그런데 문제는 이런 점이었습니다.

위 내용은 제 리팩토링(이라는 이름의 리워크)에 영향받은, 저희 팀원의 스크럼 내용입니다. 이게 과연 협업일까요..? 이때 스스로 많이 반성하게 되었습니다. 스스로 협업을 위한 코드랍시고 나만을 위한 깔끔한 코드를 짜려고 했던 것 같았습니다.
결국 잘 모르겠어서 멘토님께 여쭤보았습니다. 부스트캠프에서 주어진 팀 멘토링 시간을 활용하였고, 글로 남겨서 정리하여 멘토님께 질문드려봤습니다. 이때까지만 해도 저는 나만을 위한 깔끔한 코드 에 집착하고 있었고, 이에 아래와 같이 질문하게 되었습니다.
<aside> 🔥
스터디 세션 부분을 리팩토링하면서 고민을 많이했었습니다.. 아예 구조 자체를 바꿔버리는 스펙이 변경되는 규모에서 100줄 이상 길어지는 코드를 여러 파일로 나누어 관리하다보니 아예 함수 (방을 나가는 로직) 만을 위한 서비스 클래스를 작성하게 되었고, 구별하게 되었는데 결론적으로는 예전보다는 보기가 쉽다고 팀 내부적으로 결론이 났었습니다.
그런데 이게 나중에 가서 최적화 측면에서 문제가 될 지 궁금합니다. 실제로 클래스 기반으로 함수를 짜실 때 멘토님께서는 어떤 방식으로 길어지는 로직을 분리하시거나 관리하시는지 궁금합니다.
</aside>
<aside> 🔥
가독성은 사실 주관적인 것입니다. 그래서 저는 클래스 기반으로 함수를 짜는 것은 개인적으로 추천하지 않습니다. 보통 재사용성이 높은 코드를 분리하는게 가독성이 좋다고 합니다. 그렇다고 두세번 쓰인다고 무조건 분리하는 것은 추천하지 않습니다.
보통 코드의 줄수를 줄이기만을 위해 고치려고 하지는 않습니다. 코드가 길어져도 분명한 역할이 있다면 그대로 두는게 맞다고 생각합니다. 많이 쓰이는 오픈소스 라이브러리들 중에서도 한 파일에 천 줄이 넘는 코드가 많습니다. 물론 구조화가 잘 되어서 나눠지면 좋지만, 그럴 수 없는 경우도 많으며 이때 코드가 길기 때문에 분리해야한다!는 곤란하다고 생각합니다. 오히려 한 파일에 긴 코드가 있는게 더 가독성이 높을 때도 많습니다. 코드의 길이보다도 구조에 중점을 두는게 더 좋을 때도 있습니다. 그러니, 확장 가능성을 고려해서 구조화를 하고, 분리를 해보세요
</aside>
멘토님께서는 실제로 클린코드와 같은 개념에 대해 의식하고 계신 것 같았습니다. 저도 실제로 클린 코드의 위험성에 대해 인지는 하고 있었지만, 멘토님께서는 많이 우려스러운 답변을 주셔서 저도 속으로는 의아했습니다.
import { RoomDto } from "@/room/dto/room.dto";
import { RoomRepository } from "@/room/room.repository";
import { Injectable } from "@nestjs/common";
@Injectable()
export class RoomHostService {
public constructor(private readonly roomRepository: RoomRepository) {}
private getNewHost(room: RoomDto) {
return Object.values(room.connectionMap).sort((a, b) => a.createAt - b.createAt)[0];
}
public async delegateHost(roomId: string) {
const room = await this.roomRepository.getRoom(roomId);
if (!room) throw new Error("Invalid room Id");
const newHost = this.getNewHost(room);
const found = room.connectionMap[newHost.socketId];
if (!found) throw new Error("invalid new host id");
room.host = newHost;
await this.roomRepository.setRoom(room);
return newHost;
}
}
위 방식도 Nest.js 에서 각각의 의존성이 어떻게 관리되고 있는지 생각해봐야합니다.
기본적으로 Nest.js 에서는 의존성을 하나의 인스턴스(싱글턴 객체)로 생성하여 관리하고 있습니다. 그렇게 될 경우, 서비스를 마구잡이로 나눌 경우, 제아무리 싱글턴 객체라도 메모리를 차지하는 것은 어쩔 수 없는 사실입니다.
물론, 멘토님께서도 완벽히 위와같은 코드를 분리하는 것에 반대를 하지 않으셨고, 애매한 상황이라고 말씀해주시긴 하셨습니다. 무엇이든 정답이 없습니다. 하나의 방법이 정답이라고 생각했던 것이 잘못되었다고 생각했습니다. 이번 케이스에서는 프론트엔드 개발자분의 스펙 변경에 대해서 고려하지 않고, 단순히 코드의 가독성만을 위해서 구조를 나눈 것이 주객전도됨을 깨달았습니다.
특히나, 확장성을 고려하여 roomService 의 인터페이스를 맞추지 않았어서 문제가 되었습니다. 실제로 이렇게 편하게 보기위해 코드를 짰을 경우, 외부 모듈에서 참조를 하게 되는 경우 roomService가 아니라 roomHostService를 불러와야하는지 어떤걸 불러와야 적용할 수 있는지 확인할 수 없었습니다. 처음 적용할 때 roomService 에 없는 것을 보고 엥? 싶을 것이다 생각이 들었습니다.
특히나 리턴되는 값을 마구잡이로 바꿔가면서 테스트 코드의 중요성을 깨닫게 되었습니다. 리팩토링을 할 때 테스트 코드를 통해 스펙을 고정하고 리팩토링을 하게 되어야함을 깨달았습니다.