<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Joshua Kim on Medium]]></title>
        <description><![CDATA[Stories by Joshua Kim on Medium]]></description>
        <link>https://medium.com/@syjkim0125?source=rss-74dbec2cc163------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*gjpTtqGVyk12FWJjA5OgFw.jpeg</url>
            <title>Stories by Joshua Kim on Medium</title>
            <link>https://medium.com/@syjkim0125?source=rss-74dbec2cc163------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Thu, 19 Nov 2026 23:05:14 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@syjkim0125/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[알림 서비스 탄생 비화]]></title>
            <link>https://team.modusign.co.kr/%EC%95%8C%EB%A6%BC-%EC%84%9C%EB%B9%84%EC%8A%A4-%ED%83%84%EC%83%9D-%EB%B9%84%ED%99%94-df517bdc530b?source=rss-74dbec2cc163------2</link>
            <guid isPermaLink="false">https://medium.com/p/df517bdc530b</guid>
            <category><![CDATA[모두싸인]]></category>
            <category><![CDATA[engineering]]></category>
            <category><![CDATA[microservices]]></category>
            <category><![CDATA[backend]]></category>
            <category><![CDATA[modusign]]></category>
            <dc:creator><![CDATA[Joshua Kim]]></dc:creator>
            <pubDate>Fri, 15 Jan 2021 06:55:30 GMT</pubDate>
            <atom:updated>2021-01-24T05:49:34.953Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*AvBN1N3lfKlmcivcetmyRw.png" /></figure><p>안녕하세요, 모두싸인에서 백엔드 개발을 하고 있는 조슈아입니다. 모두싸인에서는 계약의 진행 상황, 계약 당사자의 정보 등을 이메일과 카카오톡 같은 수단을 사용하여 이용자들에게 알려주고 있습니다. 이번 글에서는 이 알림과 관련된 서비스를 만들게 된 계기와 개선 과정에 대해서 소개를 해드리려고 합니다.</p><h3>문제점</h3><p>모두싸인에는 계약과 관련된 임무를 수행하는 서비스가 있습니다. 이용자가 계약서를 업로드 한 후, 실제 계약을 진행할 때 사용하게 됩니다. 해당 서비스를 간략하게 보자면 다음과 같은 형태가 됩니다.</p><ol><li>업로드한 계약서를 불러옴</li><li>계약에 참여할 사람들 설정</li><li>서명과 관련된 정보 입력(서명할 위치, 남길 말 등)</li><li>참여할 사람들에게 계약서 발송</li><li>해당 계약과 관련된 사람들에게 진행 상황 및 정보 알림</li></ol><p>여기서, 한 가지 문제점이 발생하게 됩니다.</p><blockquote>A : 어… 계약서로 서명을 요청하는데 자꾸 안 되는데요?<br>→ 외부 서비스가 장애가 났다네요..</blockquote><blockquote>A : 혹시 알림에 이런 기능을 붙일 수 있을까요? <br>→ 할 수는 있는데… 그럼 계약 기능에 영향이 어떻게 가는지 한 번 확인을…</blockquote><p>계약서 발송과 정보 알림을 이메일과 카카오톡으로 하고 있고, 관련 외부 서비스를 사용하고 있습니다. 해당 외부 서비스들이 장애가 나게 되면 1~3번의 계약과 관련된 서비스조차 이용을 못 하게 됩니다. 또한, 알림과 관련된 새로운 비즈니스 요구 사항들이 하나둘 생기기 시작했죠. 이는 계약 임무를 수행하는 것과는 무관한데도 불구하고, 영향을 끼칠 수밖에 없는 형태가 되었습니다.</p><p>간단하게 예를 들어 보겠습니다.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/468bd541fb1bd509d9ebdccd046dd99d/href">https://medium.com/media/468bd541fb1bd509d9ebdccd046dd99d/href</a></iframe><ol><li>requestContract 메소드에서</li><li>contract(계약)을 생성하고</li><li>이를 parameter로 해서 sendEmail 메소드를 호출합니다.</li><li>sendEmail 메소드는 contract를 받아서</li><li>이메일의 content를 create하고</li><li>외부 서비스를 호출합니다.</li></ol><p>외부 서비스가 장애가 나면 6번은 임무를 완수하지 못하고 계속해서 응답을 기다리게 됩니다. email 관련 기능이 변경 혹은 장애가 나면 영향을 받게 되겠죠?</p><h3>모호한 경계</h3><p>언뜻 보기에는 단순히 외부 서비스에 의존을 하고 있기 때문이라고 생각할 수 있지만, 서비스의 경계가 모호하기 때문에 일어난 것이라고 생각했습니다. 그래서 하나로 되어있던 서비스를 둘로 나누기로 결정했습니다.</p><p>왜 처음에 이를 구분하지 못했고, 지금 와서는 왜 이런 생각을 가지게 된 걸까요?</p><p>사실, 한 서비스 안에 2가지 기능이 다 들어있던 이유가 있습니다. 계약서를 발송하는 기능의 이면에는 계약과 관련된 정보들이 깊이 관여하고 있었기 때문입니다. 실제 서비스를 이용하면서 다음과 같은 이메일을 받게 됩니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Y7dn1jMa5tMFr6_b4hNUCQ.png" /><figcaption>이메일 내용</figcaption></figure><p>계약과 관련된 정보들이 이메일의 전반적인 내용들을 구성하고 있습니다. 이러한 정보들은 계약을 담당하는 서비스와 깊은 의존도를 가지고 있으므로 하나의 서비스로 구성해야 한다고 생각했었습니다. 문제는 알림 관련 기능에 변경이나 장애가 일어나면 계약과 관련된 기능들에 영향을 미쳤습니다. 알림 기능은 단순히 계약과 관련된 데이터만 받으면 할 일을 수행할 수 있는데 말이에요.</p><p>그렇다면 왜 단순히 외부 서비스(TOAST, Sendgrid, etc..)만을 분리하지 않은 것일까요?</p><p>그에 대한 이유는 3가지가 있었습니다.</p><ol><li>적절한 정보를 가지고 알림의 내용을 구성하는 일</li><li>계약 외의 다른 서비스의 알림도 존재</li><li>알림의 추가적인 비즈니스 요구 사항</li></ol><p>단순히 외부 서비스만 떼어내면, 각각의 알림이 필요한 서비스에서 이메일이나 카카오톡의 내용을 구성하는 일을 하게 됩니다. 또한, 비즈니스 요구 사항이 추가되면 관련된 모든 서비스에 추가하게 되겠죠. 그렇게 되면 중복되는 코드도 많아지고 알림의 내용 변경에 따른 영향을 받게될 수 있기 때문에, 알림 서비스라는 하나의 서비스를 구성하기로 합니다.</p><h3>마이크로 서비스 아키텍처의 경계</h3><p>모두싸인에서는 마이크로 서비스 아키텍처 형태로 백엔드 애플리케이션이 운용되고 있습니다. 이 형태로 애플리케이션이 잘 구성되려면 다음과 같은 최소한의 조건이 필요합니다.</p><ul><li>각 서비스는 <strong><em>단일 책임</em></strong>이다.</li><li>각 서비스의 <strong><em>도메인</em></strong>에 따른 경계가 잘 나뉘어야 한다.</li><li>의존성이 높은 기능들은 단일 마이크로 서비스로 두어야 한다.</li><li>다른 서비스를 다시 배포하지 않고도 서비스를 배포하는 것이 항상 가능하다.</li><li>서비스는 밀접하게 결합되어 있지 않으며 <strong><em>독립적으로 발전</em></strong>할 수 있다.</li></ul><p>서비스 간의 경계는<strong> </strong>기술적인 문제보다는 비즈니스 요구 사항에 집중해서 생각해야 합니다. 경계가 모호하고 의존성이 생기게 된다면 한 서비스의 변경이나 장애가 다른 서비스로 전파가 되는 등 여러 가지 현상이 발생하게 됩니다.</p><h3>개선 방향</h3><p>각각의 서비스가 단일 책임을 이루도록 하나로 되어있던 서비스를 둘로 나누기로 결정했습니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*VNzicoY6ZIcbmW0KWXVsSw.jpeg" /><figcaption>기존의 서비스 구성</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*kn_Y01KpjAj_BkFvNw4Tpg.jpeg" /><figcaption>개선할 서비스 구성</figcaption></figure><p>서비스의 경계를 구분할 기능을 2가지로 요약하자면 다음과 같습니다.</p><ol><li>계약과 관련된 기능</li><li>알림과 관련된 기능</li></ol><p>기존에 한 서비스에서 두 가지 기능을 모두 수행하고 있었는데, 개선할 구성에서는 두 개의 서비스가 각각의 기능을 전담하게 됩니다. A는 알림을 보내기 위해 필요한 데이터를 통합 이벤트로 B에게 전달하도록 구성했습니다.</p><p>아까의 예제를 살짝 고쳐보겠습니다.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/3ffa419542c7a737d22c04d0631131fd/href">https://medium.com/media/3ffa419542c7a737d22c04d0631131fd/href</a></iframe><p><strong>계약 서비스</strong>에서는 계약 임무를 수행한 후, 통합 이벤트를 만들어서 publish하게 됩니다.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/e20afce17bc1427d8995d485e69fd6f0/href">https://medium.com/media/e20afce17bc1427d8995d485e69fd6f0/href</a></iframe><p><strong>알림 서비스</strong>에서는 이렇게 통합 이벤트를 받아서 이메일을 보내는 임무를 수행하게 됩니다.</p><h3>개선 결과</h3><p>이제 두 서비스는 각각의 기능에 대해 충실하게 됩니다. A는 오로지 계약과 관련된 기능만, B는 알림과 관련된 기능만 수행하면 되죠. 알림과 관련된 기능이 변경이나 장애가 일어나게 되면, 이전에는 A서비스에도 문제를 일으켰지만 위와 같은 구성에서는 장애가 전파되지 않습니다. 이제 B서비스는 <strong><em>‘알림 서비스’ </em></strong>라는 하나의 독립적인 서비스로 무사히 성장할 수 있게 되었습니다.</p><h3>끝나지 않은 문제</h3><p>하지만 아직 모든 문제가 사라진게 아닙니다. 바로, 외부 서비스에 대한 의존이 아직 남아 있다는 것입니다. B 서비스에서 알림과 관련된 기능을 수행하지만, 직접적으로 외부 서비스를 의존하고 있기 때문에 외부 서비스에 장애가 나면 B서비스 또한 영향을 받게 됩니다. 그렇다면 이를 어떠한 방식으로 해결해야 할까요?</p><p>다음에 이어질 Part 2에서는 외부 서비스의 장애로 인해 어떠한 문제들이 발생하고, 이를 대처할 수 있는 시스템을 어떻게 구성할 것인지에 대해 자세하게 다룰 예정입니다.</p><h3>마무리</h3><p>이 글을 통해 모두싸인에서는 어떠한 방식으로 접근해서 서비스 간의 경계를 나눴는지 간단하게 전해드렸습니다. 마이크로 서비스는 경계를 분리하고 나서도 변경이 있을 수 있습니다. 서비스가 성장함에 따라서 다양한 요구사항이 추가되고 사라지거나 하면, 마이크로 서비스를 더 분해하거나 여러 마이크로 서비스를 하나로 결합해야 하는 경우가 생기겠죠. 이 글을 읽으신 분들이 비슷한 문제에 부딪혔을 때, 도움이 될 수 있으면 좋겠습니다.</p><p>또한 좋은 제품을 같이 만들어갈 백엔드 엔지니어를 채용하고 있으니, 관심 있으신 분은 지원 바랍니다.</p><p>감사합니다.</p><p>▶ <a href="http://bit.ly/2WtQysh">모두싸인 채용공고 보러가기</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=df517bdc530b" width="1" height="1" alt=""><hr><p><a href="https://team.modusign.co.kr/%EC%95%8C%EB%A6%BC-%EC%84%9C%EB%B9%84%EC%8A%A4-%ED%83%84%EC%83%9D-%EB%B9%84%ED%99%94-df517bdc530b">알림 서비스 탄생 비화</a> was originally published in <a href="https://team.modusign.co.kr/">모두싸인 기술블로그</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>