[WIL] 모호한 요구사항을 구현 가능한 설계로 바꾸기

이번 주에는 쿠폰과 주문 도메인을 예제로, 모호하게 주어진 요구사항을 구현이 가능한 수준까지 구체화하는 과정을 설계 문서를 직접 작성하는 방법을 통해 학습했다.

이번 주에 가장 어려웠던 부분은 코드 자체보다는 과제가 무엇을 고민하도록 만들어진 것인지 파악하는 것이었다.
평소 실무에서는 이미 정리된 요구사항을 전달받고(UI/UX 설계서를 통해서든, 현업의 직접적인 요청을 통해서든) 이를 바로 코드로 구현하는 경우가 많았기 때문에, 구현 이전 단계에서 요구사항을 직접 해석하고 규칙을 구체화하며 다듬는 작업 자체가 낯설고 어려웠다.

처음에는 익숙하지 않은 용어나 개념들이 한꺼번에 등장해서 각각을 작성하는 것에 집중했는데, 내용을 하나씩 풀어서 공부하면서 결국 이 과제의 핵심은 "코드를 작성하기 전에 요구사항의 모호함을 발견하고 개발자가 결정해야 할 부분을 찾아내는 것" 이라는 생각이 들었다.

 

이번 주에 한 일

이번 주에는 가장 먼저 요구사항을 보고 바로 코드를 작성하지 않았고, 그 안에 숨어 있는 비즈니스 규칙과 반례를 찾아 정의하는 연습을 했다.

예를 들어 단순히 "이미 사용된 쿠폰은 다시 사용할 수 없다" 라는 요구사항을 그대로 두는 것이 아니라,

• 사용자가 해당 쿠폰을 가지고 있는가?
• 쿠폰이 아직 사용되지 않은 상태인가?
• 쿠폰을 사용하면 어떤 상태로 변경되어야 하는가?
• 존재하지 않는 쿠폰이라면 어떻게 해야 하는가?
• 다른 사용자의 쿠폰이라면 어떻게 해야 하는가?
• 이미 사용한 쿠폰이라면 어떻게 해야 하는가?

위의 사례 같이 실제로 판단할 수 있는 조건으로 나누어 보았다.

또 제품 담당자에게 물을 질문이나 불변식이나 반례를 차례대로 정리하면서 단순한 쿠폰 하나에 함께 엮여있는 쿠폰 차감/중복/만료와 같은 세분화된 작업에 대해서도 생각해 보았다.

특히 외부 계약과 내부 경계에 대해 작성하는 부분이 특히 난이도가 높았는데, 단순히 결정을 내리고 끝내는 것이 아닌 그 결정을 택한 구체적인 이유, 선택하지 않은 결정과 그 이유에 대해서도 고려해야 했기 때문이다. 지금껏 회사에서 일을 하면서 접해 왔던 수많은 애매모호한 요구사항 및 결정들과, 그로 인해 코드를 짜고 수정하고 번복하고 했던 삽질들이 떠올라서 씁쓸하기도 했다.

 

새롭게 이해한 점

1. 요구사항을 구현하기 전에 '규칙'으로 바꾸는 과정이 필요하다

이번 주차 과제를 하면서 가장 크게 느낀 점은 요구사항에 적혀 있는 문장들이 곧바로 코드가 되는 것은 아니라는 점이었다(하지만 여태껏 되는 줄 알았다. 그렇게 지시받고 일해왔으니까..😢).

"쿠폰을 사용할 수 있다" 혹은 "재고를 차감한다"와 같은 문장만으로는 실제 구현에 필요한 정보가 충분하지 않을 수 있다.
정상적인 경우뿐 아니라 어떤 조건에서 실패해야 하는지, 실패한다면 데이터는 어떤 상태여야 하는지까지 결정해야 비로소 구현 가능한 요구사항이 된다.

앞으로는 요구사항을 받았을 때 바로 코드부터 구현할 생각 보다는, 설계를 고려해 순서대로 생각해 보는 습관을 가져보려고 한다.

요구사항 → 비즈니스 규칙 → 성공/실패 시나리오 → 구현

2. 이제 개발자는 developer 보다는 builder 같다

달라진 개발자의 역할에 대해 이해할 수 있었다. 사실상 이번 주의 가장 큰 소득이 아닐까?
요즘은 개발자들이 직접 코딩을 하지 않는다더라.. AI로 딸깍 한다더라... 올해 초부터 이런 이야기를 여기저기서 많이 들어왔다.
그래서 항상 의문을 갖고 있었다. 그럼 에이전트가 고친 코드들은 어떻게 다 확인하고, AI로 생성한 코드들은 일종의 부채일텐데 나중에 다 어떻게 감당하려고 하지?

하지만 이를 극복하는 것이 설계라는 것을 이번 주에 느끼게 됐다.
기초 공사를 튼튼하게 했을 때, 구현이 흔들리지 않을 것이라는 것을 직접 설계를 해보며 깨달았다.
이렇게 골치 아프게 문서를 만들고 설계하는데, 이를 바탕으로 구현을 시키면 당연히 잘 해줄 수밖에 없지 않을까?

그래서 한 편으로는 아쉽기도 했다.
내가 진정으로 개발에 재미를 붙였을 때는 직접 에러 찾아다니고 스택오버플로우에서 선배 개발자들이 달아놓은 댓글로 문제 해결할 때였는데,
이제 그런 시대는 완전히 저물었구나..하는 생각이 들었다.