<?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 James on Medium]]></title>
        <description><![CDATA[Stories by James on Medium]]></description>
        <link>https://medium.com/@james_34049?source=rss-2f11563a285d------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*j5tRcmBeYD_ljvMt6mtDpQ.jpeg</url>
            <title>Stories by James on Medium</title>
            <link>https://medium.com/@james_34049?source=rss-2f11563a285d------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Tue, 17 Nov 2026 15:45:21 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@james_34049/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[AI(Gemini)를 활용하여 체계적인 품질관리를 위한 지라(Jira) 이슈 분석 비서 만들기]]></title>
            <link>https://blog.kmong.com/ai-gemini-%EB%A5%BC-%ED%99%9C%EC%9A%A9%ED%95%98%EC%97%AC-%EC%B2%B4%EA%B3%84%EC%A0%81%EC%9D%B8-%ED%92%88%EC%A7%88%EA%B4%80%EB%A6%AC%EB%A5%BC-%EC%9C%84%ED%95%9C-%EC%A7%80%EB%9D%BC-jira-%EC%9D%B4%EC%8A%88-%EB%B6%84%EC%84%9D-%EB%B9%84%EC%84%9C-%EB%A7%8C%EB%93%A4%EA%B8%B0-5091ba4a8df6?source=rss-2f11563a285d------2</link>
            <guid isPermaLink="false">https://medium.com/p/5091ba4a8df6</guid>
            <category><![CDATA[gemini]]></category>
            <category><![CDATA[kmong]]></category>
            <category><![CDATA[qa]]></category>
            <category><![CDATA[ai]]></category>
            <category><![CDATA[quality-management]]></category>
            <dc:creator><![CDATA[James]]></dc:creator>
            <pubDate>Fri, 11 Jul 2025 06:24:11 GMT</pubDate>
            <atom:updated>2025-07-30T02:12:15.751Z</atom:updated>
            <content:encoded><![CDATA[<p>AI를 이용해 소프트웨어 개발 프로젝트에 참여하는 누군가는 요구사항 분석에 도움을 받고, 누군가는 프로그램 설계와 개발에 도움을 받고, 누군가는 문서 작성에 도움을 받기도 합니다. 저는 품질관리 관점에서 가장 많이 보고 접하는 이슈라는 녀석을, AI를 이용해서 도움을 받아보고자 합니다.</p><figure><img alt="품질에 AI를 활용할 수 있을까?" src="https://cdn-images-1.medium.com/max/1024/1*0gZ3CqDC-mEJR_vdFl469g.jpeg" /><figcaption>품질관리를 위한 AI 활용 방법</figcaption></figure><p>안녕하세요. 크몽에서 QA를 담당하는 제임스입니다.</p><p>많은 회사가 Jira라는 도구를 이용해서 이슈(해결해야 하는 문제 혹은 사건)나 자신이 해야 하는 작업(Task)을 관리하고 있습니다.</p><p>크몽도 역시 이슈와 업무 관리를, Jira를 이용하고 있습니다. Jira에는 많은 히스토리와 앞으로의 계획, 그리고 지금 우리가 하는 일에 대해서 가장 잘 기록된 현재 진행형 백과사전과 같은 존재라 생각합니다.</p><p>대부분의 QA라 불리는 사람들은 이슈라는 녀석을 자신의 동반자와 같이 살아왔고, 앞으로도 살아가야 할 텐데요. 저 또한, 이 녀석과 함께 살아온 날짜를 세려야 셀 수 없을 정도가 된 것 같습니다.</p><p>크몽의 QA는 품질 관리에 AI를 어떤 목적을 가지고, 어떤 방법을 이용하여 AI를 활용하는지 설명해 드리려 합니다. <strong>비서를 만들기 위한 재료</strong>는 아래와 같습니다.</p><ol><li>로우 데이터: <strong>Jira</strong></li><li>데이터 수집: <strong>Jira Cloud for Sheets</strong></li><li>수집된 데이터 AI 분석: <strong>App Script</strong></li><li>리포트 전송: <strong>Slack</strong></li></ol><p>매일 같이 생성되는 이슈를 하나하나 확인하기는 현실적으로 어려운 일이라 생각합니다. 더군다나 내가 하는 일이 아닌 다른 팀이나 부서에서 하는 일은 더욱이 알기 어렵습니다.</p><p>저 또한 제가 등록한 이슈나 해야 하는 일, 팀에서 해야 하는 일은 잘 알지만, 다른 팀에서 등록한 이슈나 관리해야 하는 이슈는 알기 어려운 것이 현실입니다.</p><p>품질 관리를 정말 잘하기 위해서는 <strong>최대한 이슈에 민감하게 반응</strong>해야 한다고 생각합니다. 작은 이슈든 큰 이슈든, 혹은 정말 테스트의 누락으로 발생한 이슈인지 알게 된다면 개선점을 찾고, 앞으로 해야 하는 일에 실수나 오류를 줄일 수 있을 거로 생각하게 되었습니다.</p><p><em>“특정 기간 내의 등록된 이슈 추이에 대해서 누가 정리를 해주면 좋겠는데?”</em></p><h3>데이터 수집하기</h3><p>Jira에서 Search Filter를 통해 분석이 필요한 이슈 목록을 추출합니다. JQL을 이용해서 특정 기간(-1W)에 누가(QA) 어떤 유형(Bug, Improvement)의 이슈를 등록했는지에 대한 목록을 추출했습니다.</p><pre>reporter in (QA) and issuetype in (Bug, Improvement) and created &gt;= -1W </pre><p>구글 시트 확장 프로그램인 <strong>Jira Cloud for Sheets</strong>를 이용해서 자동 갱신되도록 세팅합니다. 해당 기간 내의 갱신된 새로운 데이터(구글 시트에 정리된 Jira 이슈 목록)에 대해서 AI는 분석하고 향후 슬랙으로 리포트를 전송해 줄 수 있을 거로 가정합니다.</p><blockquote><strong>Jira Cloud for Sheets 세팅 방법입니다.</strong></blockquote><ol><li><a href="https://docs.google.com/spreadsheets/"><em>https://docs.google.com/spreadsheets/</em></a> 에 접속합니다.</li><li>임의 구글 시트를 생성합니다.</li><li>메뉴바 &gt; 확장 프로그램 &gt; Jira Cloud for Sheets &gt; <strong>[Open]</strong>을 클릭합니다.</li><li>우측 사이드바 &gt; <strong>[Get issues from Jira]</strong>를 클릭합니다.</li><li>Tab: ISSUES &gt; Import type을 <strong>[JQL]</strong>로 변경합니다.</li><li>JQL 쿼리 입력 후 <strong>[REFRESH ISSUES]</strong> 버튼을 클릭합니다.</li></ol><p>쿼리가 제대로 입력되었다면 Jira에서 필터링한 목록이 구글 시트에 로드됨을 확인할 수 있습니다. 또한, Tab: FIELDS에서 분석에 필요한 데이터 필드를 수정할 수 있으니 참고 바랍니다.</p><figure><img alt="Jira Cloud for Sheets’s를 적극 활용해 보자." src="https://cdn-images-1.medium.com/max/296/1*dV5j9T3r9ABBxM3GKD1W-w.png" /><figcaption>Jira Cloud for Sheets’s tab FIELDS Edit</figcaption></figure><h3>수집된 데이터 AI 분석: API 세팅</h3><p>AI를 활용하기 위해 2가지를 세팅해야 합니다.</p><ul><li>슬랙 Webhook URL 만들기</li><li>Gemini API 키 발급</li></ul><blockquote><strong>슬랙 Webhook URL 만들기 방법입니다.</strong></blockquote><p>AI가 이슈에 대해서 분석한 내용을 슬랙에 전송하기 위해서 Webhook을 사용합니다. 참고로 Webhook 지원하는 어떠한 도구도 상관없습니다.</p><ol><li><a href="https://api.slack.com/apps"><em>https://api.slack.com/apps</em></a> 에 접속합니다.</li><li><strong>[Create New app &gt; From scratch]</strong> 클릭합니다.</li><li>App Name을 설정하고, Pick a workspace to develop your app in: 에서 연결할 슬랙 공간 선택합니다.</li><li><em>(선택)</em> Display Information에서 슬랫봇을 원하는 디자인으로 꾸며봅니다.</li><li>Incoming Webhooks에서 Activate Incoming Webhooks의 <strong>토글: On</strong>으로 변경합니다.</li><li>아래 Webhook URLs for Your Workspace에서 <strong>[Add New Webhook]</strong>을 클릭합니다.</li><li>연결할 채널을 선택한 후, <strong>[허용]</strong>을 클릭합니다.</li><li>만들어진 Webhook URL을 <strong>[Copy]</strong> 합니다.</li></ol><p><strong>[6] 번의 경우</strong> 회사의 <strong>슬랙에 접근 권한 요청</strong>이 필요할 수 있습니다. 보안팀이나 슬랙 권한 관리자의 문의가 필요할 수 있으니 참고해 주세요.</p><p>혹은 연결이 되지 않는 에러 메시지가 발생한다면</p><ul><li>App Home에서 Your App’s Presence in Slack의 App Display Name의 <strong>[Edit]</strong> 버튼을 클릭하여 Display Name (Bot Name)과 Default username 모두 설정한 후, <strong>[Save]</strong> 버튼을 클릭한 후 재시도합니다.</li></ul><blockquote><strong>Gemini API 키 발급 방법입니다.</strong></blockquote><p>GPT API가 아닌 Gemini API를 사용하는 이유는 누구나 무료로 사용할 수 있기도 하고 크몽은 회사에서 지원되어 Gemini Pro를 사용할 수 있기 때문에 활용하게 되었습니다.</p><ol><li><a href="https://cloud.google.com/?hl=ko"><em>https://cloud.google.com/?hl=ko</em></a><em> </em>에 접속합니다.</li><li>우측 상단 <strong>[콘솔]</strong>을 클릭합니다.</li><li><strong>[새 프로젝트]</strong>를 클릭합니다.</li><li>프로젝트 이름 입력 후, <strong>[만들기]</strong>를 클릭합니다.</li><li>Google Cloud 로고 &gt; 우측에<strong> [프로젝트]</strong>를 클릭합니다.</li><li><a href="https://aistudio.google.com/prompts/new_chat"><em>https://aistudio.google.com/prompts/new_chat</em></a><em> </em>에 접속합니다.</li><li><strong>[Get API Key]</strong>를 클릭합니다.</li><li><strong>[+ API 키 만들기]</strong>를 클릭합니다.</li><li><strong>[복사]</strong>를 클릭합니다.</li></ol><h3>수집된 데이터 AI 분석: <strong>App Script</strong></h3><p>기본적인 동작 방식은 아래와 같습니다.</p><ol><li>데일리 or 위클리 or 사용자 커스텀한 시간에 구글 시트 목록을 갱신합니다.</li><li>구글 시트 목록이 갱신되면 App Script가 동작하고 AI 분석이 시작됩니다.</li><li>App Script의 트리거가 시작되면 슬랙으로 메시지가 전송됩니다.</li></ol><p>Jira 이슈 목록을 가져온 구글 시트 파일에서 메뉴바 &gt; 확장 프로그램 &gt; <strong>App Script</strong>를 클릭합니다. URL은 <a href="https://script.google.com/"><em>https://script.google.com/</em></a> 입니다.</p><p>Gemini를 실행시키기 위한 Script를 작성합니다.</p><pre>// --- Constants ---<br>const SHEET_NAME = &quot; &quot;; // 스프레드시트 탭 이름을 입력하세요<br>const GEMINI_API_KEY = &quot; &quot;; // Gemini API 키를 입력하세요<br>const SLACK_WEBHOOK_URL = &quot; &quot;; // Slack Webhook URL을 입력하세요<br><br>// --- 슬랙에 중복 전송 제한 ---<br>function sendGeminiConsumPlanToSlack() {<br>  const lock = LockService.getScriptLock();<br>  const hasLock = lock.tryLock(30000); <br><br>  if (!hasLock) {<br>    Logger.log(&quot;⚠️ 이미 실행 중이거나 최근에 실행이 완료되었습니다. 이번 실행은 건너뜝니다.&quot;);<br>    return;<br>  }<br><br>  try {<br>    // --- 임시 디버깅 코드 ---<br>    Logger.log(&quot;🚀 sendGeminiConsumPlanToSlack 함수가 지금 실제로 실행됩니다! 시간: &quot; + new Date());<br>    postToConsumSlackViaWebhook(&quot;🚨 테스트 메시지: sendGeminiConsumPlanToSlack 함수가 호출되었습니다!&quot;);<br>    // --- 임시 디버깅 코드 종료 ---<br><br>    // 원래 로직은 잠시 주석 처리하거나 제거할 수 있습니다.<br>    // const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(SHEET_NAME);<br>    // ... 나머지 원래 코드 ...<br><br>  } catch (e) {<br>    Logger.log(&quot;❌ 실행 중 오류 발생: &quot; + e.toString());<br>  } finally {<br>    lock.releaseLock();<br>    Logger.log(&quot;🔒 스크립트 잠금 해제됨.&quot;);<br>  }<br>}<br>/**<br> * Google Sheet에서 이슈 목록 데이터를 가져와 Gemini로 분석하고 Slack으로 리포트를 전송합니다.<br> */<br>function sendGeminiConsumPlanToSlack() {<br>  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(SHEET_NAME);<br>  if (!sheet) {<br>    Logger.log(`❌ 오류: &#39;${SHEET_NAME}&#39; 시트를 찾을 수 없습니다.`);<br>    return;<br>  }<br><br>  const rawData = sheet.getRange(&quot;A1:B2&quot;).getDisplayValues(); // 예시 범위. 실제 데이터 범위에 맞게 조정하세요.<br>  Logger.log(&quot;📋 원본 데이터: &quot; + JSON.stringify(rawData));<br><br>  const parsedData = convertSheetToStructuredJSON(rawData);<br><br>  if (!parsedData || parsedData.length === 0) {<br>    Logger.log(&quot;❌ 처리할 테이블 데이터가 없습니다. 시트 내용을 확인하세요.&quot;);<br>    return;<br>  }<br><br>  Logger.log(&quot;📊 첫 번째 행의 키 목록:&quot;, Object.keys(parsedData[0]));<br><br>  // Gemini 분석 리포트 생성<br>  const analysisSummary = generateConsumGeminiAnalysis(parsedData);<br><br>  if (!analysisSummary || analysisSummary.includes(&quot;⚠️&quot;)) {<br>    Logger.log(&quot;❗ Gemini 분석 리포트 생성에 실패했거나 응답이 유효하지 않습니다.&quot;);<br>    return;<br>  }<br><br>  // Slack으로 리포트 전송<br>  postToConsumSlackViaWebhook(analysisSummary);<br>  Logger.log(&quot;✅ Gemini 이슈 분석 리포트가 Slack으로 성공적으로 전송되었습니다.&quot;);<br>}<br><br>/**<br> * 데이터를 기반으로 Gemini AI를 사용하여 Jira 이슈 분석 리포트를 생성합니다.<br> * @param {Array&lt;Object&gt;} data - 분석할 구조화된 데이터 (예: [{ &quot;상태&quot;: &quot;해결책&quot;, &quot;설명&quot;: &quot;값&quot; }])<br> * @returns {string} Gemini AI가 생성한 분석 리포트 텍스트 또는 오류 메시지<br> */<br>function generateConsumGeminiAnalysis(data) {<br>  const prompt = `<br>집계 기간을 명시하고, 이슈 전체를 분석해서 가독성이 좋게 핵심만 요약한 &#39;QA 이슈 분석 리포트&#39;를 작성해줘.<br><br>아래 기준을 반드시 지켜서 요약해 줘.<br>1. Status와 Resolution을 기준으로 카운트를 데이터 테이블로 명료하게 작성한 다음 이슈 추이에 대한 내용을 요약해줘.<br>2. Priority가 Critical 이슈는 해당 Description 내용을 분석해서 부족한 테스트케이스를 작성해줘. Critical 이슈가 없으면 생략해줘.<br>3. 다음 프로젝트에서 테스트 관점으로 보완할 점을 5~6줄 이내로 요약해줘.<br><br>${JSON.stringify(data, null, 2)}<br>`;<br><br>  const payload = {<br>    contents: [<br>      {<br>        role: &quot;user&quot;,<br>        parts: [{ text: prompt }]<br>      }<br>    ]<br>  };<br><br>  const url = `https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=${GEMINI_API_KEY}`;<br><br>  try {<br>    const response = UrlFetchApp.fetch(url, {<br>      method: &quot;post&quot;,<br>      contentType: &quot;application/json&quot;,<br>      payload: JSON.stringify(payload),<br>      muteHttpExceptions: true // HTTP 예외 발생 시 에러를 던지지 않음<br>    });<br><br>    const rawResponseText = response.getContentText();<br>    Logger.log(&quot;📩 Gemini 응답 원문: &quot; + rawResponseText);<br><br>    const jsonResponse = JSON.parse(rawResponseText);<br><br>    if (jsonResponse.candidates &amp;&amp; jsonResponse.candidates[0] &amp;&amp; jsonResponse.candidates[0].content &amp;&amp; jsonResponse.candidates[0].content.parts[0]) {<br>      return jsonResponse.candidates[0].content.parts[0].text;<br>    } else {<br>      Logger.log(&quot;❌ Gemini 응답 형식 오류: &#39;candidates&#39; 또는 &#39;content&#39; 경로를 찾을 수 없습니다.&quot;);<br>      return &quot;⚠️ Gemini 응답 처리에 실패했습니다: 유효하지 않은 응답 형식.&quot;;<br>    }<br>  } catch (e) {<br>    Logger.log(&quot;❌ Gemini API 호출 또는 JSON 파싱 중 오류 발생: &quot; + e.toString());<br>    return &quot;⚠️ Gemini API 호출 중 오류가 발생했습니다.&quot;;<br>  }<br>}<br><br>/**<br> * Slack Webhook을 통해 분석 리포트를 전송합니다.<br> * @param {string} summary - Slack으로 전송할 리포트 요약 텍스트 (마크다운 포함 가능)<br> */<br>function postToConsumSlackViaWebhook(summary) {<br>  const formattedText = convertMarkdownToSlack(summary);<br><br>  const payload = {<br>    text: &quot;*📊 Gemini 분석 리포트*\n\n&quot; + formattedText<br>  };<br><br>  try {<br>    UrlFetchApp.fetch(SLACK_WEBHOOK_URL, {<br>      method: &quot;post&quot;,<br>      contentType: &quot;application/json&quot;,<br>      payload: JSON.stringify(payload)<br>    });<br>    Logger.log(&quot;✅ Slack으로 메시지 전송 성공.&quot;);<br>  } catch (e) {<br>    Logger.log(&quot;❌ Slack Webhook으로 메시지 전송 실패: &quot; + e.toString());<br>  }<br>}<br><br><br>/**<br> * 마크다운 텍스트를 Slack 메시지 형식에 맞게 변환합니다.<br> * @param {string} text - 변환할 마크다운 텍스트<br> * @returns {string} Slack 형식으로 변환된 텍스트<br> */<br>function convertMarkdownToSlack(text) {<br>  return text<br>    .replace(/^## (.*)$/gm, &#39;*$1*&#39;) // ## 제목 -&gt; *제목* (Slack 볼드)<br>    .replace(/\*\*(.*?)\*\*/g, &#39;*$1*&#39;) // **굵게** -&gt; *굵게* (Slack 볼드)<br>    .replace(/^(\d+)\.  \*\*가설:\*\* (.*)/gm, `• *가설 $1:* $2`) // 번호 가설 -&gt; • *가설 N:* 내용<br>    .replace(/^(\d+)\. +/gm, `• `); // 일반 번호 리스트 -&gt; •<br>}<br><br>/**<br> * Google Sheet의 원본 데이터를 구조화된 JSON 배열로 변환합니다.<br> * 첫 번째 행은 헤더로 간주하고, 나머지 행은 데이터로 처리합니다.<br> * @param {Array&lt;Array&lt;string&gt;&gt;} data - Google Sheet에서 가져온 원본 2차원 배열 데이터<br> * @returns {Array&lt;Object&gt;} 각 행이 객체로 표현된 JSON 배열<br> */<br>function convertSheetToStructuredJSON(data) {<br>  if (!data || data.length === 0) {<br>    return [];<br>  }<br><br>  const headers = data[0].map(header =&gt; header.trim()); // 헤더 공백 제거<br>  const rows = data.slice(1);<br><br>  return rows<br>    .filter(row =&gt; row.some(cell =&gt; cell &amp;&amp; cell.toString().trim() !== &quot;&quot;)) // 모든 셀이 비어있지 않은 행만 포함<br>    .map(row =&gt; {<br>      const obj = {};<br>      headers.forEach((header, i) =&gt; {<br>        // 헤더가 비어있지 않고, 해당 셀에 값이 있는 경우에만 객체에 추가<br>        if (header &amp;&amp; row[i] !== undefined &amp;&amp; row[i].toString().trim() !== &quot;&quot;) {<br>          obj[header] = row[i].toString().trim();<br>        }<br>      });<br>      return obj;<br>    });<br>}</pre><p>제가 Jira 이슈를 분석하기 위해 AI에 한 <strong>질문 예시</strong>입니다.</p><pre>집계 기간을 명시하고, 이슈 전체를 분석해서 가독성이 좋게 핵심만 요약한 &#39;QA 이슈 분석 리포트&#39;를 작성해 줘.</pre><pre>아래 기준을 반드시 지켜서 요약해 줘.<br>1. Status와 Resolution을 기준으로 카운트를 데이터 테이블로 명료하게 작성한 다음 이슈 추이에 대한 내용을 요약해 줘.<br>2. Priority가 Critical 이슈는 해당 Description 내용을 분석해서 부족한 테스트케이스를 작성해 줘. Critical 이슈가 없으면 생략해 줘.<br>3. 다음 프로젝트에서 테스트 관점으로 보완할 점을 5~6줄 이내로 요약해 줘.</pre><p>질문을 잘 작성하기 위해 개인 DM(Webhook URL만 수정)으로 수십 번 테스트를 진행했습니다. AI 답변이 의미 있는 답변? 도움이 될 만한 답변이라 생각될 때까지 질문을 수정하고 또 수정했습니다. 데이터 기반의 리포트라 그런지 테스트 중에는 특별히 환각이 될 만한 정보는 없다고 생각되었습니다.</p><p>만약에 세팅하시게 된다면 꼭!! 질문의 답변이 나 혹은 우리에게 도움이 될 만한 답변을 하고 있는지 검증해 보시길 바랍니다.</p><h3>수집된 데이터 AI 분석: 리포트</h3><p>스크립트를 실행하면 Webhook에서 설정한 채널로 AI 이슈 분석 리포트가 전송됩니다.</p><figure><img alt="사내 메신저에 AI 리포트를 공유하여 인공지능의 환각을 상쇄하자." src="https://cdn-images-1.medium.com/max/1024/1*LpgvUReP8To-jN-vsSKTGw.png" /><figcaption>Gemini’s issues report for slack</figcaption></figure><h3>수집된 데이터 AI 분석: 스케줄러</h3><p>스케줄러를 등록하기 위해서는 2가지를 세팅해야 합니다.</p><ul><li>Jira Cloud for Sheets &gt;<strong> Tab: SCHEDULE</strong></li><li>App Script &gt; <strong>트리거</strong></li></ul><p>필자의 경우 일주일 전 등록된 이슈에 대해서 분석 리포트를 보려고 했기 때문에 Jira Cloud for Sheets 스케줄러 세팅은 매주 월요일 오전 00시 ~ 01시 사이 구글 시트를 갱신하도록 세팅했습니다.</p><figure><img alt="Jira Cloud for Sheets’s에서 스케줄러를 통해 데이터를 갱신한다." src="https://cdn-images-1.medium.com/max/297/1*sJBh3vaBCKQTrpaYoMTWzg.png" /><figcaption>Jira Cloud for Sheets’s scheduler Setting</figcaption></figure><p>App Script는 갱신된 데이터를 기준으로 분석 리포트를 발행하기 위해 매주 월요일 오전 9시 ~ 10시 사이에 동작하도록 세팅하였습니다.</p><figure><img alt="App Script’s에서 데이터 갱신에 대한 트리거를 발생시킨다." src="https://cdn-images-1.medium.com/max/302/1*k3tzjhXk1cQbTIActET7Pw.png" /><figcaption>App Script’s trigger Setting</figcaption></figure><h3>마무리…</h3><p>저는 품질에 대해서 조금 더 고민하기 위해<strong> 이슈에 대한 분석 목적</strong>으로 AI를 활용해 보았습니다. 다만, 위와 같이 세팅하게 되면 확장성은 무궁무진하다고 생각합니다.</p><p>예를 들면, 제가 세팅한 것은 구글 시트의 데이터를 Jira 데이터로 활용했지만, 마케팅이나 재무 등 사업 관점에서도 구글 시트에 데이터를 입력하면 질문에 따라서 AI는 필요한 시점에 반복적으로 실행될 것이기 때문인데요.</p><p>AI 활용을 품질 관점에서 많은 시간 고민을 했습니다. 개발 코드나 문서 작성, 데이터 분석 등에는 많이 활용하고 있지만, 왠지 아무것도 하지 않는 저 자신은 도태되거나 뒤처진다는 느낌도 받았던 것 같습니다.</p><figure><img alt="AI 활용은 테스트뿐만 아니라 품질관리에도 도움이 될 수 있다." src="https://cdn-images-1.medium.com/max/1024/1*yrt-AjKqC-NxWx9ad9gBMw.jpeg" /><figcaption>Using AI in Quality control</figcaption></figure><p>하지만 급하게 생각하지 않았고 QA 팀이 가장 많이 하고 있는 업무 우선순위를 고민하던 끝에 활용법을 하나 찾게 된 것 같아 좋았습니다. 다음에 관련된 글을 다시 작성하게 된다면 세팅된 AI 비서를 잘 활용해서 도움이 될 만한 정보를 업무에 적용했을 때 품질 개선 관점에서 ‘AI 활용 후기’를 작성해 보도록 하겠습니다.</p><p>품질관리를 하시는 분들에게 <strong>AI 활용의 첫 발걸음</strong>이 되길 기대해 봅니다.</p><p>긴 글 읽어 주셔서 감사합니다.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=5091ba4a8df6" width="1" height="1" alt=""><hr><p><a href="https://blog.kmong.com/ai-gemini-%EB%A5%BC-%ED%99%9C%EC%9A%A9%ED%95%98%EC%97%AC-%EC%B2%B4%EA%B3%84%EC%A0%81%EC%9D%B8-%ED%92%88%EC%A7%88%EA%B4%80%EB%A6%AC%EB%A5%BC-%EC%9C%84%ED%95%9C-%EC%A7%80%EB%9D%BC-jira-%EC%9D%B4%EC%8A%88-%EB%B6%84%EC%84%9D-%EB%B9%84%EC%84%9C-%EB%A7%8C%EB%93%A4%EA%B8%B0-5091ba4a8df6">AI(Gemini)를 활용하여 체계적인 품질관리를 위한 지라(Jira) 이슈 분석 비서 만들기</a> was originally published in <a href="https://blog.kmong.com/">kmong</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Kmong’s Quality Assurance Secret Note? 이건 회사 대외O?]]></title>
            <link>https://blog.kmong.com/kmongs-quality-assurance-secret-note-%EC%9D%B4%EA%B1%B4-%ED%9A%8C%EC%82%AC-%EB%8C%80%EC%99%B8o-f94e77babd08?source=rss-2f11563a285d------2</link>
            <guid isPermaLink="false">https://medium.com/p/f94e77babd08</guid>
            <category><![CDATA[kmong]]></category>
            <category><![CDATA[크몽]]></category>
            <category><![CDATA[test]]></category>
            <category><![CDATA[qa]]></category>
            <category><![CDATA[secrets]]></category>
            <dc:creator><![CDATA[James]]></dc:creator>
            <pubDate>Mon, 21 Oct 2024 05:55:25 GMT</pubDate>
            <atom:updated>2025-07-30T02:08:34.024Z</atom:updated>
            <content:encoded><![CDATA[<h3>크몽의 품질 보증(관리) 비밀 노트? 이건 회사 대외O?</h3><p><strong>대외적</strong>으로 크몽의 QA는 품질에 대해서 <strong>어떤 목표</strong>를 가지고 <strong>어떻게 활동</strong>하고 있는지 지난 2년간의 이야기해 보려 합니다.</p><figure><img alt="크몽에서 품질 활동에 대한 비밀을 알려줄께." src="https://cdn-images-1.medium.com/max/1024/1*bjJhaPsYi7WbPGRG463IoA.jpeg" /><figcaption>Secret Note?</figcaption></figure><p>안녕하세요. 크몽에서 QA를 담당하는 제임스입니다.</p><p>대표님도 클릭하게 하는 제목이었을까요? 비밀이라고 얘기하는 순간 비밀이 아니게 되는 마법은 저만 알고 있는 사실은 아닐 것 같습니다.</p><p>오늘은 누구나 다 알고 있는 품질 지식이지만 실제 수행하는 프로젝트나 업무에 적용하지 못하고 무엇을 활용해서 품질 활동을 해야 할지 망설여지는 분들을 위한 나름의 비밀 노트? 입니다.</p><p>품질 지키고 개선하는 활동의 가장 대표적인 것은 바로 “테스트”입니다. 이게 비밀은 아니잖아요? 다들 알고 있잖아요?</p><p>크몽의 QA는 어떤 테스트를 어떻게 해서 품질을 지키고, 지금까지 어떤 목표를 가지고 업무를 수행했는지에 대한 현재 진행형 품질 활동의 목차입니다.</p><ol><li><strong>품질 목표 설정</strong>하기: 테스트 왜 하지?</li><li><strong>품질 분석/설계</strong>하기: 언제 테스트하지?</li><li><strong>품질 점검</strong>하기: 테스트 어떻게 하지?</li><li><strong>품질 보증</strong>하기: 가능한가?</li></ol><h3><strong>품질 목표 설정하기: 테스트 왜 하지?</strong></h3><p>테스트의 원론적인 의미는 “결함을 발견하기 위한 활동”입니다. 결함만 발견해서 해결한다고 품질이 좋다?고 말할 수 없다는 것을 우리는 ISTQB(International Software Testing Qualifications Board)의 소프트웨어 테스팅의 원리 7가지 중 “<strong>오류 부재의 궤변(Absence of errors fallacy)</strong>”으로 인해 너무도 잘 알고 있습니다.</p><figure><img alt="테스트 활동의 목적을 명확히 하자." src="https://cdn-images-1.medium.com/max/1024/1*2PM8kU6A6cQotFeL-ycZpw.jpeg" /><figcaption>Fixed? Quality?</figcaption></figure><p><strong>오류 부재의 궤변</strong>은 수많은 결함을 발견하고 수정했다고 하더라도 사용자 또는 비즈니스의 요구를 충족하지 못한다면 품질이 좋다고 말할 수 없다는 이론입니다.</p><p>급변하는 <strong>UI/UX에 품질을 지키기 어려운 이유 </strong>중의 하나이기도 합니다.</p><p>테스트 왜 해야 할까요? 자신이 QA라면 지금 한번 질문해 보시길 바랍니다. 필자는 초년 시절에 결함을 많이 발견하고, 남들이 잘 찾아내지 못하는 어려운 결함을 발견했을 때 희열을 느끼곤 했습니다.</p><p>그래서 테스트케이스의 수행(리그레이션)의 중요성을 배제하였고, 나중에는 내가 테스트를 잘한다는 것에 자아도취 되어 결국 “<strong>살충제 패러독스(</strong>Pesticide Paradox)”에 빠져서 실수를 하게 되었습니다.</p><figure><img alt="살충제 패러독스에 빠지지 않도록 테스트를 다양하게 수행해야 한다." src="https://cdn-images-1.medium.com/max/1024/1*cS6SwTwuCL3EEyymx5x6ww.jpeg" /><figcaption>Paradox</figcaption></figure><p><strong>살충제 패러독스</strong>란 ‘같은 테스트 케이스를 가지고, 테스트를 계속해서 반복하는 경우 어느 시점부터는 더 이상 결함을 발견하지 못한다.’는 이론입니다.</p><p>실수의 경험을 바탕으로 깨달은 것은 테스트는 단순히 결함을 발견하기 위한 활동이 아닌 사용자나 비즈니스의 요구사항을 충족하고 있는지를 점검 or 보증하는 활동이라는 것을 알게 되었습니다.</p><p>그래서 저는 명확하게 <strong>품질 목표를 설정</strong>하게 되었습니다.</p><ol><li><strong>사용자나 비즈니스의 요구사항을 충족하는가?</strong></li><li><strong>발견된 결함은 해결되었는가?</strong></li><li><strong>해결하지 못한 결함의 구체적인 방안은 모색되었는가?</strong></li></ol><p>프로젝트를 수행하게 되면 1번 목표를 달성하기 위해 요구사항이 포함된 문서(화면 설계서/스토리보드/Figma 등)를 기준으로 테스트케이스를 설계/작성하고 있습니다.</p><p>요구사항대로 개발물이 잘 개발되었는지 일차적으로 테스트를 수행하여 확인하고 <strong>탐색적 테스트</strong>를 통해 예외적인 상황의 케이스에서 문제가 발생하고 있는지 다양한 환경과 조건, 영향 범위 내의 테스트를 집중해서 수행하고 있습니다.</p><p>테스트케이스 수행과 탐색적 테스트를 통해 발견된 결함은 목록화하여 배포되기 전까지 추적 관리하고 있습니다. 마지막으로 배포 전까지 해결되지 않은 결함은 명확한 해결 방안을 수립하고 배포될 수 있도록 관리하고 있습니다.</p><h3><strong>품질 분석/설계하기: 언제 테스트하지?</strong></h3><p>품질 프로세스에 대해서 이야기해 보려 합니다. 프로덕트나 서비스의 품질을 지키고 개선하는 프로세스에는 반듯이 ‘테스트’라는 활동이 포함되어 있어야 합니다.</p><figure><img alt="테스트가 필요한 시점을 명확히 해야 한다." src="https://cdn-images-1.medium.com/max/1024/1*3NkV7baNm3b4sluPWi9XuQ.jpeg" /><figcaption>Test &amp; Check</figcaption></figure><p>테스트 프로세스라고 해서 테스트만 하는 것이 아닙니다. 어떤 절차를 거쳐서 내가 테스트해야 하는 대상이 명확히 어떤 목적으로 만들어졌는지 알고 테스트를 해야 합니다. 이것은 비단 QA나 테스터라고 하는 사람들만의 몫이 아닙니다. <strong>프로덕트나 서비스를 만드는 모든 구성원의 몫</strong>입니다.</p><p>현재 품질 상태를 분석해서 어느 시점에 어떤 테스트를 해야 할지 확인하시길 바랍니다. 통합 테스트에만 집중하고 있어서 다른 테스트 활동에 <strong>품질 누수</strong>가 있는 건 아닌지 확인하셔야 합니다.</p><p>‘언제 테스트하지?’의 결론을 말씀드리면 <strong>항상</strong> 하는 겁니다. 밥 먹듯이 누가 시키지 않아도 해야 합니다. 기획자는 내가 의도한 대로 개발되었는지 테스트해야 하고, 개발자는 내가 개발한 게 잘 동작하는지 테스트해야 합니다. QA는 의도한 대로 잘 동작하는지를 테스트해야 합니다. 사용자는 내가 편한 대로 잘 동작하는지 일상에서 테스트를 해주고 있습니다.</p><p>크몽은 이러한 테스트를 체계화하기 위해서 개발 프로세스에 녹였으며, 개발 단계에서는 내부 테스트라는 명목으로 PO, 디자이너, 개발자가 테스트합니다. 실제 품질을 보증하기 위한 테스트 단계에서는 요구사항 문서 기준으로 설계/작성된 문서(테스트 케이스)를 기반으로 테스트를 수행하고 있습니다.</p><p>이러한 일환으로 크몽에서는 프로젝트, 운영, 정기, 자동화 테스트로 구분하여 테스트를 수행하고 있습니다.</p><ul><li><strong>프로젝트 테스트</strong>: 요구사항 문서가 작성되어 프로덕트 혹은 서비스 전반에 영향이 있어 테스트가 필요한 경우</li><li><strong>운영 테스트</strong>: 일반적인 수정이지만 영향 범위가 넓어 리그레이션을 포함한 테스트가 필요한 경우</li><li><strong>정기 테스트</strong>: Android/iOS 오픈 마켓 등록이 필요한 앱에 대해서 정기적으로 테스트가 필요한 경우(한 번 등록되면 수정이 쉽지 않기 때문)</li><li><strong>자동화 테스트(<em>개발 진행 중</em>)</strong>: 변경 점에 대한 영향 범위에 리그레이션 테스트가 필요한 경우</li></ul><p><strong>프로젝트 테스트</strong>는 요구사항이 명확해지는 시점에 테스트 계획을 수립하고 출시일이 맞춰 테스트를 수행하고 있습니다.</p><p><strong>운영 테스트</strong>는 PO나 개발 담당자의 판단하에 영향 범위가 넓은 경우 리그레이션 범위를 정해서 테스트를 수행하고 있습니다.</p><p><strong>정기 테스트</strong>는 스프린트가 끝나는 시점에 테스트를 수행하고 차주 월요일 배포 될 수 있도록 관리하고 있습니다. 간혹 수정 사항이 영향 범위가 넓다고 판단되면 하루나 이틀 전에 개발 버전의 빌드에서 테스트 수행하고 최종적으로 Android 내부 테스트 버전과 iOS 테스트플라이트 버전에서 확인 후 심사를 등록하고 있습니다.</p><p><strong>자동화 테스트</strong>는 철저하게 리그레이션의 목적으로만 활용되고 있으며, 영향 범위에 따라 시나리오를 추가/제외하는 방법으로 테스트를 수행하고 있습니다.</p><figure><img alt="테스트 목적에 따라 다양한 테스트 방법을 수행해야 한다." src="https://cdn-images-1.medium.com/max/1024/1*_NMtGuS9F1Oy_KPY2X_jJA.jpeg" /><figcaption>Point of view</figcaption></figure><p>가장 중요한 것은 프로덕트나 서비스가 안정화되는 시점입니다. 이 시점부터는 변경 관리를 철저히 해야 하며 최대한 영향 범위 내의 테스트가 수행될 수 있도록 해야 합니다. 크몽의 QA는 변경 점에 대한 영향 범위를 철저하게 분석하여 테스트가 수행될 수 있도록 노력하고 있습니다.</p><p>PMBOK(Project Management Body of Knowledge)이나 ITSM(IT Service Management)에서도 변경 관리가 가장 어렵고 중요한 부분으로 언급하고 있는 만큼 변경 혹은 수정에 대한 영향 범위 내에서 테스트가 수행될 수 있도록 항상 계획하고 준비되어 있어야 합니다.</p><h3><strong>품질 점검하기: 테스트 어떻게 하지?</strong></h3><p>‘테스트’와 ‘어떻게’는 매우 상반되는 개념이라 생각합니다. 우리는 알게 모르게 일상에서 인지하지 못할 만큼 ‘테스트’라는 활동을 하고 있기 때문입니다.</p><figure><img alt="리그레이션 테스트, 확인 테스트, 탐색적 테스트 등 매우 중요한 테스트 방법이다." src="https://cdn-images-1.medium.com/max/1024/1*6hqeGj2wyXDvsz8ox6baLw.jpeg" /><figcaption>Execution your’s smart phone.</figcaption></figure><blockquote><strong>잠깐! 간단히 따라 해 보세요.</strong></blockquote><ul><li>스마트폰의 가장 많이 활용하는 앱을 실행시켜 보세요.</li></ul><p>지금 당신은 테스트를 수행했습니다.</p><p>만약 테스트 케이스가 작성되어 있다면 가장 맨 첫 줄에 ‘앱을 실행한다.’라는 스텝이 작성되어 있고, 기대 결과에는 ‘앱이 실행된다.’라고 작성되어 있을 겁니다.</p><p>‘테스트를 어떻게 하지?’라고 물음이 생기는 경우는 정말 특별한 케이스가 필요한 경우입니다. 특별한 케이스의 예시를 들어보면 결제 PG사 모듈에 세상 모든 카드가 등록되어 있다고 가정해 봅시다. 이럴 때 ‘테스트 어떻게 하지?’의 물음이 생길 겁니다.</p><p>이러한 경우 필요한 것이 테스팅 전략입니다. 크몽의 QA는 프로젝트 테스트가 필요한 경우 <strong>테스팅 전략 문서를 작성하여 계획 + 테스팅 방법(어떻게) + 테스트 결과</strong>를 공유하고 있습니다.</p><p>일반적으로 특별한 케이스가 없는 경우에는 요구사항 기반으로 작성된 신규 테스트 케이스와 영향 범위 내의 리그레이션 케이스를 수행하는 것이 표준 전략입니다. 테스트 계획을 수립하기 전 기획 리뷰를 통해 확인된 기능이나 비즈니스 흐름에 특별한 케이스가 있는 경우 테스트할 수 있는 조건과 환경을 만들기 위해 고민합니다. 고민된 내용을 최대한 테스트 케이스화해서 전략 문서에 작성하고 있습니다.</p><p>테스팅 전략 문서는 표준 전략 + 특별한(도출된 예외 케이스) 테스팅 방법이 작성된 문서로 활용하고 있습니다.</p><figure><img alt="예외케이스의 발견은 프로덕트를 안정화 시키는데 큰 영향이 있다." src="https://cdn-images-1.medium.com/max/1024/1*lqih2-LIepLiXEoMjerRmQ.jpeg" /><figcaption>What? This is stratery?</figcaption></figure><p>누군가는 ‘이게 무슨 전략 문서에요?’라고 할 수 있을 것 같습니다. ‘<strong>전략이란 특정한 목표를 수행하기 위한 행동 계획</strong>’이라고 정의하고 있습니다. QA의 특정한 목표는 <strong>요구사항에 대한 검증</strong>이며, 요구 사항에 대한 검증을 위해서 신규 테스트 케이스와 기존 작성된 리그레이션 케이스를 활용하는 것도 전략이라 할 수 있습니다.</p><p>이렇게 ‘테스트’는 매우 일반적이고 인지하지 못할 만큼 항상 수행되고 있는 행동입니다. 크몽에서는 이러한 부분을 매우 잘 활용하고 있다고 생각합니다. <strong>크몽은 N잡 활동을 권장</strong>하고 있는데 구성원들이 의뢰인과 전문가로서 일상에서 서비스를 이용하면서 테스트하고 있다는 것입니다.</p><p>S사나 L사도 스마트폰이 출시되면 내부 직원들이 사용하게 함으로써 테스트하게 했던 것과 같은 맥락이라 생각됩니다.</p><p>꼭 ‘테스트하세요’라고 명명하기보다는 <strong>회사의 구성원이 일상적으로 테스트할 수 있는 시스템을 구축</strong>한다면 더 높은 품질을 유지할 수 있을 것으로 생각합니다. 이것은 품질적으로 매우 중요한 포인트입니다. <strong><em>내부 구성원의 피드백은 고객의 피드백보다 빠르기 때문</em></strong>입니다.</p><h3><strong>품질 보증하기: 가능한가?</strong></h3><p>결론부터 말씀드리면 ‘<strong>가능하다</strong>.’ 입니다.</p><p>다만, ‘<strong>어려울 뿐이다</strong>.’입니다.</p><p>보증이라는 용어는 ‘어떤 사람 또는 사물 등에 대한 사항을 책임지고 증명하는 행위’라고 정의 되어 있습니다. 여기서 중요한 것은 사람이나 사물이라는 부분입니다.</p><p>소프트웨어의 최종 산출물은 눈에 보이지 않는 소프트웨어. 즉, 정보의 집합체이기 때문에 품질 보증은 어렵다고 말씀드리는 부분입니다. 소프트웨어의 테스트 케이스는 무한대에 가깝기 때문에 QA라는 사람들이 할 수 있는 건 최대한 테스트 커버리지를 높여 커버리지 데이터를 통한 프로덕트나 서비스의 품질 상태를 증명하는 것입니다.</p><p>이런 소스코드의 동작을 보증하기 위해서 QA 들은 크게 단위 테스트, 통합 테스트, 시스템 테스트, 인수 테스트의 단계를 수행하게 되거나 매뉴얼 테스트, 자동화 테스트, 리그레이션 테스트, 확인 테스트, 리 테스트, 부하 테스트, 성능 테스트 등의 다양한 테스트 방법을 통해 <strong>보증</strong>이라는 무거운 용어를 짊어지게 됩니다.</p><p>최근 AI를 활용하고, 테스트를 자동화하는 것도 블랙홀 같은 소프트웨어의 테스트 커버리지를 높이기 위한 하나의 활동이라 생각합니다. 테스트 커버리지를 가장 명확하게 확인 할 수 있는 <strong>요구사항에 대한 커버리지를 먼저 확인하고 정량화하는 것을 추천</strong>해 드립니다.</p><figure><img alt="테스트 자동화를 통해 부족한 영역을 채울 수 있도록 한다." src="https://cdn-images-1.medium.com/max/1024/1*n-yA3xw0rQmWR4GfplQR2Q.jpeg" /><figcaption>AI &amp; Test-automation is a support tool.</figcaption></figure><p>최근 QA 업계 트랜드?는 급변하는 기술 시장에 따라가기 위해서 본질적인 품질의 의미를 뒤로하고 너무 새로운 기술을 쫓고 있는 것은 아닌지 개인적으로 생각합니다. 본질적으로 <strong>품질에 대한 안정성을 확보 후에 기술이 서포트</strong> 될 수 있도록 하는 것이 바람직해 보입니다.</p><p>크몽의 QA는 앞으로 요구사항에 대한 커버리지를 최대한 확보하고 정량화된 상태에서 모수를 늘려가면서 커버리지를 확대해 ‘<strong>품질이 좋다</strong>’는 것을 증명해 보려 합니다.</p><p>긴 글 읽어 주셔서 감사합니다.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=f94e77babd08" width="1" height="1" alt=""><hr><p><a href="https://blog.kmong.com/kmongs-quality-assurance-secret-note-%EC%9D%B4%EA%B1%B4-%ED%9A%8C%EC%82%AC-%EB%8C%80%EC%99%B8o-f94e77babd08">Kmong’s Quality Assurance Secret Note? 이건 회사 대외O?</a> was originally published in <a href="https://blog.kmong.com/">kmong</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[테스트 자동화를 시작하는 QA 혹은 테스트 엔지니어들을 위해]]></title>
            <link>https://blog.kmong.com/%ED%85%8C%EC%8A%A4%ED%8A%B8-%EC%9E%90%EB%8F%99%ED%99%94%EB%A5%BC-%EC%8B%9C%EC%9E%91%ED%95%98%EB%8A%94-qa-%ED%98%B9%EC%9D%80-%ED%85%8C%EC%8A%A4%ED%8A%B8-%EC%97%94%EC%A7%80%EB%8B%88%EC%96%B4%EB%93%A4%EC%9D%84-%EC%9C%84%ED%95%B4-db3f3ea84296?source=rss-2f11563a285d------2</link>
            <guid isPermaLink="false">https://medium.com/p/db3f3ea84296</guid>
            <category><![CDATA[테스트]]></category>
            <category><![CDATA[qa]]></category>
            <category><![CDATA[크몽]]></category>
            <category><![CDATA[kmong]]></category>
            <category><![CDATA[test-automation]]></category>
            <dc:creator><![CDATA[James]]></dc:creator>
            <pubDate>Mon, 11 Mar 2024 05:35:52 GMT</pubDate>
            <atom:updated>2025-07-30T01:57:48.823Z</atom:updated>
            <content:encoded><![CDATA[<blockquote><strong><em>To. 테스트 자동화가 고민인 품질 관리자 혹은 테스트 엔지니어가 꼭 알고 시작하면 좋은 정보에 대해서</em></strong></blockquote><figure><img alt="Start Test-Automation for people." src="https://cdn-images-1.medium.com/max/1024/1*Zz_fo_GbVpa94ZDb_SFvrQ.jpeg" /><figcaption>Start Test Automation</figcaption></figure><p>안녕하세요. 크몽에서 QA를 담당하는 제임스입니다.</p><p>이번 세션에는 테스트 자동화를 처음 구축하기 위해 꼭 필요한 정보를 알려드리고 아무리 노력해도 테스트 자동화에 실패하거나 분명히 많은 부분을 테스트 자동화했는데 효과를 알 수 없어서 이게 맞는 방향인지 고민하시는 분들을 위해서 글을 작성하게 되었습니다.</p><ul><li>테스트 자동화에 대한 개념 이해하기</li><li>테스트 자동화의 목적 명확히 하기</li><li>별도의 테스트 자동화 시나리오가 필요한 이유는?</li></ul><p>참고로 필자는 전문 테스트 자동화 엔지니어는 아닙니다. 품질 관리자로서 테스트 자동화를 어떻게 설계하고 운영하는 것이 테스트 자동화를 최대한 성공으로 이끄는 방법에 대해서 말씀드리고자 합니다.</p><h3><strong><em>테스트 자동화란?</em></strong></h3><p>너무 당연한 이야기지만 ‘테스트 자동화’는 말 그대로 테스트할 대상을 자동화하는 것을 의미합니다. 다만, 어떤 영역을 자동화할지 명확하게 해야 하며 <strong>목적과 기준을 수립</strong>하고 시작해야 합니다.</p><figure><img alt="마이크 코언( Mike Cohn)의 테스트 자동화 피라미드" src="https://cdn-images-1.medium.com/max/426/1*Xd8nNjNKqe1SjfYkqZx8LA.png" /><figcaption>마이크 코언( Mike Cohn)의 테스트 자동화 피라미드</figcaption></figure><p>위 이미지는 테스트 자동화 피라미드로 자동화할 수 있는 영역을 그려놓은 이미지입니다. 중요한 것은 공수 대비 자동화 효과가 표현되어 있다는 점입니다.</p><p>가장 하단 영역인 Unit Tests / Component Tests 영역을 테스트 자동화하는 경우 공수 대비 효율(ROI)이 좋다는 의미가 내포되어 있으며 위로 갈수록 공수 대비 효율(ROI)이 높지 않다는 점입니다.</p><figure><img alt="테스트 자동화의 ROI를 고려해야 합니다." src="https://cdn-images-1.medium.com/max/1024/1*TKZ1Ngtgjk-Rllv32KecTw.png" /><figcaption>테스트 자동화의 ROI</figcaption></figure><p>이유는 간단합니다. 위로 갈수록 <strong>변경에 취약하고 자동화 실행 시간 및 복잡도가 증가</strong>하기 때문입니다. 변경에 취약하다는 의미는 간단하게 변경되더라도 자동화 소스 코드를 많이 수정해야 한다는 것입니다.</p><p>Unit Tests / Component Tests 영역은 변경이 되더라도 영향 범위가 작기 때문에 해당 부분만 수정해도 되지만 위로 갈수록 복잡도가 증가하기 때문에 변경에 점점 취약해지게 됩니다.</p><p>피라미드의 모든 영역을 테스트 자동화하는 것이 가장 좋겠지만 비용과 리소스의 문제로 우리는 <strong>모든 영역을 자동화하는 것은 현실적으로 불가능</strong>합니다.</p><p>그래서 대부분의 경우 Unit Tests / Component Tests 영역은 개발팀에서 커버하고 있고 Acceptance Tests(API Layer)는 테스트 엔지니어가 하는 회사도 있고, 개발팀에서 하는 회사도 있습니다. GUI Tests와 Manual Tests는 대부분 QA 혹은 테스트 엔지니어가 자동화하는 것이 보편적입니다.</p><p><strong>가장 바람직한 방법</strong>이기도 합니다.</p><p>개발자는 자신이 개발한 소스코드에 대해서 Unit Tests 코드를 넣어서 확인하는 것이고 필요에 따라 분석 도구를 통해 테스트 커버리지를 측정합니다.</p><p>GUI 기반으로 테스트하는 QA나 테스트 엔지니어는 반복적인 활동을 조금이라도 줄이고 객관적인 테스트 결과를 확인하기 위해서 GUI Tests와 Manual Tests 영역을 자동화하게 되는 것입니다.</p><blockquote><strong><em>QA 혹은 테스트 엔지니어의 테스트 자동화 목적</em></strong></blockquote><p>결론부터 말씀드리면 테스트 자동화 목적을 <strong>‘Regression(회귀) 테스트’</strong>로 설정하는 것을 권장해 드립니다.</p><p>폭포수 개발 환경이 아닌 애자일한 개발 환경일수록 변경이 빠르고 기간이 매우 짧기 때문입니다. 변경에 취약한 영역인 GUI Tests와 Manual Tests 영역을 매번 수정하는 것은 매우 비효율적인 활동이 될 수 있기 때문입니다.</p><p>예를 들면, 신규 기능(New Feature)을 대상으로 테스트 자동화를 한다고 했을 때 신규 기능은 배포되기 직전까지 요구사항이 변경되거나 이슈로 인해 수정될 수 있습니다. 자동화 개발을 완료했다고 하더라도 어떠한 이유로 인해 변경되면 매우 짧은 시간 내의 자동화 코드를 수정해야 하는 상황이 발생하게 됩니다.</p><p>물론 신규 기능에 대한 테스트 자동화도 불가능한 것은 아닙니다. 다만, 테스트 자동화를 모듈화해서 다른 테스트 자동화 영역에 영향을 받지 않도록 설계하면 가능할 것으로 생각됩니다.</p><figure><img alt="테스트 자동화 시나리오는 별도로 작성되고, 모듈화 되어야 한다." src="https://cdn-images-1.medium.com/max/1024/1*7KJ7yUyka3DGBmlu3gOzaQ.png" /><figcaption>Test Automation Scenario Module</figcaption></figure><p>하지만 테스트 자동화 영역에 영향을 받지 않도록 설계하기가 매우 어렵습니다. 어렵다기보다는 현실적으로 불가능에 가깝습니다.</p><p>테스트 자동화의 실행은 1 Flow로 동작해야 하므로 제품이나 서비스의 핵심 기능 중 최대한 변경이 되지 않는 영역(이전 버전에 배포되어 Regression(회귀) 테스트가 필요한 부분)에서 실행되는 경우 공수 대비 효율(ROI)이 가장 높을 것으로 생각합니다.</p><figure><img alt="테스트의 목적은 결함을 발견하기 위한 활동이다." src="https://cdn-images-1.medium.com/max/521/1*KziWCTFcCMSCALgA1ZE72g.png" /></figure><p>위 이미지는 각 테스트 방법에 따라 결함 발견율 사례로 자동화된 테스트는 전체 결함의 일부만을 찾을 수 있다는 것을 알 수 있습니다.</p><p>테스트 자동화의 목적을 Regression(회귀) 테스트로 설정했다면 결함을 찾기 위한 방법이 아닌 프로덕트나 서비스의 안정화를 확인하기 위한 테스트의 수단이라고 할 수 있습니다.</p><blockquote><strong><em>테스트 자동화 개발을 시작하기 전에 꼭 해야 하는 것</em></strong></blockquote><p>테스트 자동화를 구축하려는 분들께 가장 많이 받는 질문은 “테스트 자동화를 구축하려고 하는데 어떤 도구를 사용해야 하나요?” 혹은 “어떤 언어로 테스트 자동화를 개발해야 하나요?”라는 질문을 많이 받습니다.</p><p>테스트 자동화의 목적과 영역을 명확히 하였다면 다음에 해야 할 일은 자동화 시나리오를 설계/작성하는 것입니다. 자동화를 위한 도구나 개발 언어는 자동화 시나리오를 작성해 보고 구현 방법 등을 고려하여 선택하는 것이 좋습니다.</p><p>대부분의 테스트 자동화 개발을 하시는 분들이 테스트 케이스를 기반으로 테스트 자동화를 하려는 분들이 상당히 많습니다. 테스트 케이스와 테스트 시나리오의 차이점은 아랫글을 참고하기를 바랍니다.</p><p><a href="https://medium.com/@james_34049/%EB%88%84%EA%B0%80-%EB%B4%90%EB%8F%84-%EC%9D%B4%ED%95%B4%EB%90%98%EB%8A%94-%EC%89%AC%EC%9A%B4-%ED%85%8C%EC%8A%A4%ED%8A%B8-%EC%BC%80%EC%9D%B4%EC%8A%A4-%EC%9E%91%EC%84%B1%ED%95%98%EA%B8%B0-7de66e7ef5b0">누가 봐도 이해되는 쉬운 테스트 케이스 작성하기</a></p><p>테스트 케이스가 아닌 테스트 자동화를 위한 시나리오가 필요한 이유는 일반적인 요구사항을 확인하기 위한 테스트 케이스 혹은 테스트 케이스를 포함한 시나리오와는 조금은 다르게 작성해야 하기 때문입니다.</p><p>위에서 잠깐 말씀드렸듯이 테스트 자동화 시나리오는 1 Flow로 동작하도록 작성해야 합니다. Start가 있으면 End의 동작이 개별 시나리오에 반복적으로 작성돼 있어야 자동화가 실행되었을 때 원활히 동작할 수 있기 때문입니다. 혹은 Data Set이 활용되거나 특수한 조건이 필요한 경우도 있습니다. 이러한 정보들은 테스트 자동화 시나리오에 모두 작성되어 있어야 합니다.</p><p>또한, 테스트 자동화의 시나리오가 어떤 기능을 커버하고 있는지 확인하기 위해서도 자동화를 위한 시나리오는 별도로 작성되어 있어야 합니다. 테스트 자동화를 매번 실행하고 있지만 어떤 기능을 어떻게 테스트 되고 있는지를 자동화 수행 결과인 Pass/Fail로만 확인하는 것은 매우 좋지 않은 방법이라 생각합니다.</p><p>명확하게 어떤 기능을 테스트 자동화가 커버하고 있는지 알고 있거나 모르더라도 확인할 수 있어야 영향 범위 내의 Regression(회귀) 테스트를 수행할 수 있기 때문입니다.</p><h3>효율적으로 테스트 자동화 관리 방법 요약</h3><ol><li>테스트 자동화의 목적과 기준을 명확히 하기</li><li>테스트 자동화를 위한 별도의 테스트 시나리오 설계/작성하기</li></ol><p>필자의 경우 테스트 자동화 시나리오는 직접 설계/작성하고 있으며 테스트 자동화 개발 리소스는 작성된 시나리오로 개발에만 집중할 수 있도록 프로세스를 운용하고 있습니다.</p><p>추가로 요구검증(Manual Tests)을 수행하는 사람이 테스트 자동화를 병행하는 것은 테스트 자동화 실패에 가장 큰 요인입니다. <strong>리소스는 반듯이 분리해서 R &amp; R(Roles And Responsibilities)을 명확히 하고 시작</strong>해야 합니다.</p><figure><img alt="테스트 자동화는 커버리지를 높이기 위한 하나의 보조 수단이다." src="https://cdn-images-1.medium.com/max/1024/1*sFG7SjilM6ISpBAf4XT6-w.jpeg" /><figcaption>Test Automation management</figcaption></figure><p>테스트 자동화는 테스트 커버리지가 높아지는 수단이며 잘 활용된다면 충분히 프로덕트나 서비스의 안정화를 유지하는 데 큰 도움이 되는 부분이니 잘 준비하셔서 성공적인 테스트 자동화를 구축/운영해 보시길 바랍니다.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=db3f3ea84296" width="1" height="1" alt=""><hr><p><a href="https://blog.kmong.com/%ED%85%8C%EC%8A%A4%ED%8A%B8-%EC%9E%90%EB%8F%99%ED%99%94%EB%A5%BC-%EC%8B%9C%EC%9E%91%ED%95%98%EB%8A%94-qa-%ED%98%B9%EC%9D%80-%ED%85%8C%EC%8A%A4%ED%8A%B8-%EC%97%94%EC%A7%80%EB%8B%88%EC%96%B4%EB%93%A4%EC%9D%84-%EC%9C%84%ED%95%B4-db3f3ea84296">테스트 자동화를 시작하는 QA 혹은 테스트 엔지니어들을 위해</a> was originally published in <a href="https://blog.kmong.com/">kmong</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[QA가 개발자에게 보내는 편지]]></title>
            <link>https://blog.kmong.com/qa%EA%B0%80-%EA%B0%9C%EB%B0%9C%EC%9E%90%EC%97%90%EA%B2%8C-%EB%B3%B4%EB%82%B4%EB%8A%94-%ED%8E%B8%EC%A7%80-feat-%EA%B0%9C%EB%B0%9C%EC%9E%90-%ED%85%8C%EC%8A%A4%ED%8A%B8%EC%97%90-%EB%8C%80%ED%95%98%EC%97%AC-25ba018c212b?source=rss-2f11563a285d------2</link>
            <guid isPermaLink="false">https://medium.com/p/25ba018c212b</guid>
            <category><![CDATA[크몽]]></category>
            <category><![CDATA[kmong]]></category>
            <category><![CDATA[qa]]></category>
            <category><![CDATA[테스트주도개발]]></category>
            <category><![CDATA[test]]></category>
            <dc:creator><![CDATA[James]]></dc:creator>
            <pubDate>Mon, 25 Sep 2023 16:50:03 GMT</pubDate>
            <atom:updated>2025-07-30T02:14:05.640Z</atom:updated>
            <content:encoded><![CDATA[<h4>feat. 개발자 테스트에 대하여</h4><blockquote><strong>To. 테스트가 고민인개발자에게</strong></blockquote><p>안녕하세요. 크몽에서 QA를 담당하고 있는 제임스입니다.</p><p>이번 세션에는 개발자가 아무리 많은 시간과 다양한 케이스에 대해 테스트를 수행해도 막상 QA 단계에서 테스트하면 기본적인 결함이 발생하는 이유가 무엇일까요?</p><p>이 주제로 간단하게 이야기하고 마지막에는 개발자가 가장 효율적으로 테스트하는 방법에 대해서 말씀드리겠습니다.</p><figure><img alt="This is a letter from QA to developers." src="https://cdn-images-1.medium.com/max/1024/1*RwLEpDba_-nTLawe5LhhaQ.jpeg" /><figcaption>This is a letter from QA to developers.</figcaption></figure><p>아래 상황을 예로 들어보겠습니다.<br>개발이 완료되고, QA 단계에서 테스트하게 된 상황입니다.</p><ul><li><em>QA 담당자 : 빌드 주세요.</em></li><li><em>개발자 : 1.0.0 빌드 올렸습니다. 테스트 부탁드립니다.</em></li><li><em>QA 담당자 : 1.0.0 설치했는데 앱이 실행이 안 되네요? 재빌드 부탁드립니다.</em></li><li><em>개발자 : 빌드 옵션이 잘못돼서 재빌드했습니다. 1.0.1로 설치해서 재확인 부탁드립니다.</em></li><li><em>QA 담당자 : 설치는 되었는데 로그인이 안 됩니다. 확인 부탁드립니다.</em></li></ul><p>한 번쯤은 경험해 보았을 상황이라 생각합니다.</p><p>QA 담당자의 입장에서는 개발자가 설치 한번 안 해보고 테스트 요청한 건가? 설치만 하고 로그인 한번 안 하고 테스트 요청한 건가? 라고 생각할 수 있습니다.</p><p>하지만 개발자는 설치도 했고 로그인도 확인했습니다. 그래서 매우 억울하고 안타까운 상황이 발생하고 QA 담당자는 빌드를 기다려야 하는 비효율적인 상황에 놓이게 됩니다.</p><p>왜 이런 일이 발생할까요? 이유는 매우 간단합니다.<strong> 테스트 방법이 다르기 때문</strong>인데요. 간혹 정말 생각지 못한 범위에서 결함이 발생하기도 합니다. 이 경우에는 QA 단계에서도 발견하기 어렵기 때문에 개발자와 동일한 상황에 놓이게 됩니다. 이 부분은 뒷부분에 조금 더 자세히 말씀드리겠습니다.</p><p>위와 같은 상황이 발생하는 지극히 주관적이지만 제가 알고 있는 개발자의 개발/수정/테스트하는 경우를 예를 들어 보겠습니다.</p><h4><strong><em>첫 번째 경우,</em></strong></h4><p><strong>한 사람</strong>이 A라는 Feature를 개발하기 위해 A-1, A-2, A-3, A-4, A-5의 작업을 생성해서 개발을 시작했다고 해봅시다.</p><ol><li><em>A-1, A-2 개발이 완료되어 Resolved 처리 하였습니다.</em></li><li><em>A-3 개발 중 버그가 발견되어 A-3-b를 생성하여 작업하였습니다.</em></li><li><em>A-3–b 개발 완료 후 확인 테스트를 수행하였고, Resolved 처리 하였습니다.</em></li><li><em>A-4, A-5 개발이 완료되어 Resolved 처리 하였습니다.</em></li><li><em>A라는 상위 Feature에 대해서 Source Merge 후 테스트하고 상태를 Resolved 처리 하였습니다.</em></li></ol><p>이런 상황에서 A(상위 Feature)를 Resolved 전에 A 기능에 대해 테스트하게 되면 개발 중에 발견한 버그도 확인이 되고 문제없이 QA로 인계가 될 것입니다.</p><p>중요한 것은 A-3-b를 수정하고 테스트할 때 기존 개발 완료 처리 했던 A-1, A-2에 영향이 없는지 분석/검토해야 합니다. 좀 더 나아가서 A-3-b가 B-3와 같이 개발 범위가 아닌 부분에 영향이 없는지도 검토가 되어야 하고, 필요에 따라 테스트가 수행되어야 합니다.</p><p>대부분의 경우는 위와 같은 상황에서 충분히 분석되지 않고 테스트도 수행되지 않아 QA로 인계하였을 때 결함이 발생합니다.</p><h4><strong><em>두 번째의 경우,</em></strong></h4><p>A, B, C, D, E의 Feature를 한 사람이 아닌 <strong>여러 사람이 개발</strong>하는 경우입니다. 이 경우는 첫 번째 상황보다 매우 복잡하고 경우의 수가 무한에 가까운 수준으로 올라가게 됩니다.</p><p>하지만 매우 안타깝게도 대부분의 개발은 두 번째 상황으로 개발이 진행됩니다. 그렇기 때문에 개발자는 많은 시간과 다양한 케이스에 대해서 테스트를 수행하더라도 막상 QA 담당자가 테스트하게 되면 매우 기본적인 결함이 발견되는 것입니다.</p><figure><img alt="품질과 테스트에 대한 질문을 한다." src="https://cdn-images-1.medium.com/max/1024/1*rX6-NiUh2mn0d23r4NqRHg.jpeg" /><figcaption>Qustion</figcaption></figure><p>그렇다면 이 상황을 어떻게 풀어야 할까요? 문제점은 명확하게 알고 있기 때문에 방치하거나 QA 담당자가 알아서 하겠지? 라기보다는 최대한 문제를 해결하기 위해 노력해야 합니다.</p><p>개발자가 Feature에 대한 개발이 완료된 경우 <strong>체크리스트를 작성해서 테스트</strong>하시길 권장해 드립니다. 단위 테스트를 위해서 가장 많이 활용하는 것이 체크리스트이며 체크리스트는 요구에 대한 검증이 아닌 기능의 동작에 초점이 맞춰진 방법입니다.</p><p>메뉴 트리 방식의 체크리스트도 좋고, 기능 명세에 대한 체크리스트도 좋습니다. 다양한 방식이 있으니 검토해 보시고 활용해 보시길 적극 추천해 드립니다. 체크리스트를 도입하게 되면 QA 단계의 테스트에서 기본적인 결함은 발견되지 않을 것입니다.</p><p>좀 더 나아가서 체크리스트의 목록을 자동화 테스트하는 방법입니다. 빌드 전 테스트가 수행될 수 있도록 CI/CD를 구축하는 것이 가장 바람직하며, 한번 정해진 시나리오로 매번 테스트하는 것이 아닌 시나리오는 점차 늘려가면서 커버리지를 높이는 것이 중요합니다.</p><p>그렇다면 개발자가 체크리스트도 수행하고 테스트 자동화도 구축해서 커버리지도 높였다고 하면 그러면 QA 담당자는 무엇을 하지? 라고 생각하실 수도 있을 것 같습니다.</p><p>가끔 QA는 무엇을 하는 사람들이지? 라는 질문을 받곤 하는데요. 회사에 개발자가 테스트하면 되지 QA 담당자 혹은 테스터가 무슨 필요 있어? 라고 하는 회사도 있습니다.</p><figure><img alt="QA의 필요성은 테스트에 집중할 수 있는 리소스의 여부이다." src="https://cdn-images-1.medium.com/max/1024/1*MFNE_DclSzoMIqhYNvp3RA.jpeg" /><figcaption>Conclusion</figcaption></figure><p>결론을 말씀드리면 QA 담당자 혹은 테스터는 선택 아닌 필수라고 말씀드리고 싶습니다. 제가 QA라서 말씀드리는 것은 아니고 소프트웨어는 매우 가변적이고 복잡성이 높기 때문에 최대한 테스트를 많이 해야 하는데 개발자가 테스트하거나 기획자, PM, PO, 디자이너 등이 테스트를 많이 하게 되면 본연의 업무에 집중할 수 없게 됩니다.</p><p>그렇기 때문에 요구사항에 대해서 검증하고 테스트 커버리지를 최대한 높일 수 있는 테스트에 집중하고 품질을 고민할 수 있는 전문 인력이 꼭 필요한 것입니다.</p><p>개발에서 최대한 테스트를 수행하고 커버리지를 높였다고 하면 QA는 좀 더 다양한 테스트를 통해 커버리지를 높이는 활동을 하게 됩니다.</p><p>또한 요구사항에 대한 검증은 자동화 테스트로 해결할 수 없기 때문에 요구대로 개발이 되었는지 테스트 케이스라는 문서를 통해 확인하는 작업을 하게 됩니다. 테스트 케이스로 작성된 문서는 이후 시나리오화해서 자동화 테스트로 커버할 수도 있습니다.</p><p>이 외에도 VOC(Voice of Customer)를 통해 사용성 품질을 모니터링하고, 기능뿐만 아니라 비기능 측면의 품질을 높이기 위한 활동을 할 수도 있습니다. 그러기 위해서는 품질을 정량화해야 하고, 모니터링할 수 있는 환경을 구축해야 합니다.</p><p>마지막으로 지극히 주관적이지만 제가 생각하는 <strong>개발 잘하는 개발자</strong>는 코딩을 잘하는 프로그래머가 아닙니다.</p><p>코드 10줄을 5줄로 할 수 있는 사람보다 중요한 것은 내가 요구대로 개발한 것인지? 예외적인 상황에서 결함은 없는 것인지? 결함이 발생했을 때 빠르게 해결할 수 있는지를 <strong>다양하게 고민하는 개발자</strong>가 정말 개발 잘하는 개발자라고 생각합니다.</p><p>그래서 개발 잘하는 사람은 개발과 테스트 비율이 3:7인 사람이라고 생각합니다. 물론, 테스트의 7의 비율은 커뮤니케이션과 문서작업 코드 리뷰 등 개발 외 활동하는 비율이라고 생각해 주시기를 바랍니다.</p><blockquote><strong>From. 고민 해결에 도움이 되고자 하는 QA가 드림</strong></blockquote><figure><img alt="배포 자신감이 생길 수 있을 때까지 테스트하고 또 테스트 해야 한다." src="https://cdn-images-1.medium.com/max/1024/1*0p5OW2Mz5Caw4VSQQ_oKhg.jpeg" /><figcaption>Have a good day.</figcaption></figure><blockquote><strong>P.S</strong></blockquote><p>개발자는 테스트에 너무 몰입하기보다는 자신이 개발한 Feature에 대해서는 명확하게 요구대로 개발되었는지 검증(Verification)하고, 영향 범위에 대한 정보를 QA 담당자에게 공유하여 다양한 방법으로 테스트할 수 있게 하는 것이 가장 효과적이고, 효율적인 방법이라 생각합니다.</p><p>개발자든 QA 담당자든 항상 시간에 쫒기고 있기 때문에 FM에 기록된 모든 것을 다 할 수 없습니다. 최대한 그물망(품질의 구멍)을 좁힐 방법을 서로 고민하고 방법을 찾아서 협업하는 것이 가장 좋은 방법이라는 것을 항상 생각하고 있어야 합니다.</p><p>긴 글 읽어 주셔서 감사합니다.</p><p><strong>[깨알 상식 : Verification(검증)과 Validation(확인) 구분하기]</strong></p><ul><li><strong>Verification</strong> : Are we building <strong>the system right? </strong>(우리가 제품을 올바르게 만들고 있나?) : 디자인과 코드를 검사하는 정적인 방법</li><li><strong>Validation</strong> : Are we building <strong>the right system? </strong>(우리가 올바른 제품을 만들고 있나?) : 실제 제품을 검사하는 동적인 방법</li></ul><p><em>출처 : 위키백과</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=25ba018c212b" width="1" height="1" alt=""><hr><p><a href="https://blog.kmong.com/qa%EA%B0%80-%EA%B0%9C%EB%B0%9C%EC%9E%90%EC%97%90%EA%B2%8C-%EB%B3%B4%EB%82%B4%EB%8A%94-%ED%8E%B8%EC%A7%80-feat-%EA%B0%9C%EB%B0%9C%EC%9E%90-%ED%85%8C%EC%8A%A4%ED%8A%B8%EC%97%90-%EB%8C%80%ED%95%98%EC%97%AC-25ba018c212b">QA가 개발자에게 보내는 편지</a> was originally published in <a href="https://blog.kmong.com/">kmong</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[누가 봐도 이해되는 쉬운 테스트 케이스 작성하기]]></title>
            <link>https://blog.kmong.com/%EB%88%84%EA%B0%80-%EB%B4%90%EB%8F%84-%EC%9D%B4%ED%95%B4%EB%90%98%EB%8A%94-%EC%89%AC%EC%9A%B4-%ED%85%8C%EC%8A%A4%ED%8A%B8-%EC%BC%80%EC%9D%B4%EC%8A%A4-%EC%9E%91%EC%84%B1%ED%95%98%EA%B8%B0-7de66e7ef5b0?source=rss-2f11563a285d------2</link>
            <guid isPermaLink="false">https://medium.com/p/7de66e7ef5b0</guid>
            <category><![CDATA[qa]]></category>
            <category><![CDATA[크몽]]></category>
            <category><![CDATA[테스트케이스]]></category>
            <category><![CDATA[okr]]></category>
            <category><![CDATA[kmong]]></category>
            <dc:creator><![CDATA[James]]></dc:creator>
            <pubDate>Thu, 29 Jun 2023 01:51:35 GMT</pubDate>
            <atom:updated>2025-07-30T02:04:52.987Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="누구나 쉽게 테스트 케이스 작성 방법입니다." src="https://cdn-images-1.medium.com/max/1024/1*qDRK4P6VXsIQ1rfwAFvJVQ.jpeg" /><figcaption>Test, TestCase, Test Scenario</figcaption></figure><p>안녕하세요. 크몽에서 QA를 담당하고 있는 제임스입니다.</p><p>이번 세션에는 ‘테스트 케이스’ 잘 작성하는 법 혹은 쉬우면서도 관리하기 좋은 테스트 케이스란 무엇인지에 대해서 말씀드리려 합니다. 그리고 평소에 잘 알면서도 하기 어려웠던 ‘테스트 케이스 리뷰’를 크몽에서는 어떻게 하고 있을까요?</p><p>우선 많이 사용하지만, 의미가 다른 테스트 관련 용어의 정의부터 간단하게 알아볼까요?</p><ul><li><a href="https://istqb-glossary.page/test/">테스트(Test)</a>란 한 개 이상의 테스트 케이스의 집합을 의미합니다.</li><li><a href="https://istqb-glossary.page/test-case/">테스트 케이스(Test Case)</a>란? 「프로그램의 특정 경로를 실험」해 보거나 혹은 「프로그램이 특정 요구 사항을 준수하는지를 확인」하기 위한 목적으로 사용. 이때, 「특정 목적」 또는 「테스트 조건의 확인」을 위해 개발된 「입력값, 실행 사전 조건, 예상 결과 및 실행 사후 조건」 등을 포함한 내용의 집합.</li><li><a href="https://istqb-glossary.page/test-scenario/">테스트 시나리오(Test Scenario)</a>란? 테스트 실행을 위한 일련의 활동을 구체적으로 기술해둔 문서. 테스트 시나리오는 「테스트 스크립트」라고 불리기도 하며, 혹은 「수동 테스트 스크립트」</li></ul><p>실무에서는 혼용해서 사용하는 경우가 대부분입니다. 테스트 케이스를 테스트 시나리오라고 하는 경우도 있고, QA라는 용어를 테스트라고 의미하는 경우도 있습니다.</p><p>조직 내에서 약속만 된다면 용어의 의미는 크게 중요하지 않습니다.</p><p>하지만 아래의 내용을 이해하기 위해서는 <a href="https://istqb-glossary.page/test/">테스트(Test)</a>라는 용어와 <a href="https://istqb-glossary.page/test-case/">테스트 케이스(Test Case)</a>라는 용어가 다르다는 것을 이해하고, <a href="https://istqb-glossary.page/test-case/">테스트 케이스(Test Case)</a>라는 용어와 <a href="https://istqb-glossary.page/test-scenario/">테스트 시나리오(Test Scenario)</a>라는 용어도 다르다는 것을 명확하게 이해하고 읽어야 실무에 도움이 되실 거라 생각됩니다.</p><figure><img alt="테스트 케이스는 요구사항대로 개발되었는지 검증하는 목적이다." src="https://cdn-images-1.medium.com/max/1024/1*GUc55aqlxvVZYNXDS4zXOw.jpeg" /><figcaption>테스트 케이스를 잘 작성하려면?</figcaption></figure><blockquote><strong><em>테스트 케이스를 체계적으로 작성하고 관리하기 위한 바이블!</em></strong></blockquote><ul><li>엑셀은 이제 그만! : 시스템 도구 활용하기</li><li>누구나 쉽게 이해하고 수행할 수 있는 테스트 케이스 작성하기</li><li>테스트 케이스 리뷰하기</li><li>OKR(Objectives와 Key Results) 활용하기</li><li>마무리</li></ul><h3>엑셀은 이제 그만!</h3><blockquote><strong><em>시스템 도구 활용하기</em></strong></blockquote><p>처음 테스트 케이스를 작성하게 되면 대부분 엑셀에 작성을 하게 됩니다. 누가 시키지 않아도 엑셀에 작성하거나 기존에 작업자도 엑셀에 작성을 해둔 것을 자주 보셨을 겁니다.</p><figure><img alt="엑셀로 작성된 테스트케이스는 관리가 어렵다." src="https://cdn-images-1.medium.com/max/1024/1*QuNSVrhf_hj1bAoTRUYbag.jpeg" /><figcaption>엑셀로 테스트케이스 관리?</figcaption></figure><p>엑셀에 테스트 케이스를 작성함으로써의 장점은 수행의 편리함과 수정이 쉽고 한눈에 볼 수 있는 장점이 있습니다.</p><p>예를 들면, Pass/Fail 등 결과를 입력하기 편하다는 말입니다. 또한, 설계만 잘한다면 비즈니스 흐름이나 예상 시나리오로 기능의 흐름에 따라 작성되어서 끊김이 없이 한 번에 수행할 수도 있습니다.</p><p>장점이자 단점으로 동시에 수행이 어렵고(엑셀 특징상 공유하게 되면 매우 느려짐) 수정하더라도 언제 무슨 이유로 수정하게 되었는지 이력을 찾기 어렵습니다. 물론 이점을 조금 보완한 구글 시트를 활용하기도 하지만 마찬가지로 이력을 확인하기는 어렵습니다.</p><p>가장 문제는 이슈 트래킹이 원활하지 않다는 점입니다. 엑셀의 Fail 케이스에 대한 이슈를 별도의 시스템에 등록하거나 시트를 분리해서 이슈를 작성하게 되는데 이슈의 상태나 이력을 테스트 케이스와 싱크를 맞추기가 매우 어렵습니다.</p><p>그래서 우리는 엑셀을 과감히 포기하고 시스템 도구(테스트 관리 도구)를 활용해야 합니다. 테스트 관리 도구는 매우 많지만 제가 사용해 보고 추천해 드리는 도구는 Zephyr와 Xray라는 도구 입니다. 둘 다 Jira와 연동되는 플러그인으로 유료 도구인 점 참고 부탁 드립니다.</p><figure><img alt="테스트케이스는 꼭 시스템을 통해 관리해야 한다." src="https://cdn-images-1.medium.com/max/1024/1*p3vTcs6A-DLNAEcbRYBNqQ.png" /><figcaption>Zephyr와 Xray 비교</figcaption></figure><p>Zephyr와 Xray는 테스트 목적에 따라 활용하면 되는 데 메뉴얼 테스트가 많은 도메인의 경우 Zephyr가 유리할 수 있고, 테스트 자동화를 계획하고 있는 도메인의 경우 Xray를 활용하는 것이 좋습니다.</p><p>두 가지 도구 모두 활용법이나 사용법이 비슷하고, 심지어 UI도 비슷합니다. 비용은 Zephyr가 조금 비싸지만 그만큼 기능이 좀 더 많습니다. 도구 선택 시에는 기능을 잘 살펴보고 활용할 수 있는 기능인지 검토 후 선택하시길 바랍니다.</p><p>도구가 선택되었다면 기존 엑셀 데이터를 가공하여 시스템에 임포트 할 수 있습니다. 임포트 방법은 해당 도구 가이드에 잘 설명되어 있으니 확인해 보시고 방식은 동일하며 보통은 .csv 파일의 컬럼과 Jira의 필드를 매칭시켜 업로드하는 방식입니다. .json도 지원하고 있습니다.</p><figure><img alt="테스트케이스를 Jira에 대량으로 임포트할 수 있다." src="https://cdn-images-1.medium.com/max/774/1*PU5cPATFy3kZF9PvOKd8Vg.png" /><figcaption>Jira 임포트 시 필드 매핑 페이지</figcaption></figure><p>테스트 케이스를 시스템 도구에 업로드하고 수행/관리하려는 가장 큰 이유는 <strong>요구사항 = 개발 아이템 = 테스트 케이스 = 이슈</strong>에 대한 요구 추적이 가장 큰 이유 중의 하나입니다. 이슈로 인해 요구 사항이 변경될 수도 있고, 개발 아이템의 변경으로 테스트 케이스 및 이슈의 내용이 수정될 수도 있습니다.</p><p>물론 현실적으로 모든 내용을 현행화하기는 매우 어려운 일입니다. 하지만 중요한 것은 테스트 관리를 시스템 도구를 통해 할 수 있다는 것이 요구 추적이 가능한 환경이 구축되었다는 것이고 이점이 매우 중요한 포인트입니다.</p><p>테스트 케이스 검색에 대한 이점도 있습니다. 엑셀 파일을 열어야만 확인할 수 있는 내용을 시스템 도구에서는 바로 검색할 수 있으며, 현재 테스트 케이스가 사용되고 있는지 사용되지 않는지에 대한 정보도 관리하기 편리합니다.</p><p>결론적으로 장기적으로 봤을 땐 테스트 케이스를 관리하기 위해 시스템 도구를 활용하는 것은 <strong>선택 아닌 필수 사항</strong>으로 생각해 주세요.</p><h3>테스트 케이스 작성하기</h3><blockquote><strong><em>시스템 도구에 테스트 케이스 등록하기</em></strong></blockquote><p>엑셀의 작성했던 테스트 케이스를 그대로 시스템 도구에 입력한다고 가정해 봅시다.</p><p>엑셀에 작성한 테스트 케이스</p><ul><li>컬럼 : TC ID | Req. ID | 구분 | 대/중/소 | 우선순위 | 스텝 | 기대 결과 | 확인자 | 확인 일자 | 결과 | 비고 등</li></ul><p>아마도 엑셀에는 위와 같은 컬럼으로 테스트 케이스가 작성되어 있을 것입니다. 우선 여기서 시스템에 임포트 했을 때 자동으로 설정되는 부분은 아래와 같습니다.</p><ul><li>시스템 도구 자동 설정 필드 : TD ID | 우선순위 | 스텝 | 기대 결과</li><li>테스트 수행 시 자동 설정 : 확인자 | 확인 일자 | 결과</li></ul><p>그리고 우리가 가장 중요하게 설정해야 하는 부분은 바로 Req. ID와 구분 관련된 대/중/소입니다.</p><figure><img alt="요구 추적이 가능하도록 테스트케이스가 관리되어야 한다." src="https://cdn-images-1.medium.com/max/1024/1*DgABNLeMsxGyIZ7A6tJ2fA.jpeg" /><figcaption>요구사항 = 개발 아이템 = 테스트 케이스 = 이슈</figcaption></figure><p>엑셀은 이 부분이 매우 쉽게 보이기도 하고, 매우 유용하게 사용되는 부분이기도 합니다. 그래서 시스템 도구에서도 구분 관련된 부분을 쉽게 보일 수 있도록 설정해야 합니다.</p><p>시스템 도구의 경우 테스트 케이스를 등록할 때 이슈 등록과 동일한 방법으로 작성하게 됩니다. 내부적인 포맷(이슈 상세)이 다르지만, 등록하는 방법은 일반적인 이슈 등록과 동일합니다.</p><p>대부분 시스템 도구에 테스트 케이스를 작성하게 되면</p><ul><li>요약(제목) : 로그인하기, 로그아웃하기 등등</li></ul><p>위와 같이 구분 없이 작성합니다. 갑자기 어디서 나온 시나리오 성 문구일까요?</p><p>일반적으로 이슈를 등록할 때 습관? 같이 테스트 케이스의 요약(제목)을 작성했던 것입니다. 하지만 도구만 엑셀에서 시스템으로 바뀌었을 뿐 테스트 케이스의 베이스는 변함이 없기 때문에 위와 같이 작성하게 되면 보기도 어려워지고 관리도 어렵게 됩니다.</p><p>위와 같이 요약(제목)을 작성하게 되면 스텝에 메뉴의 위치 혹은 기능의 위치 정보를 모두 작성해야 하고 하나의 케이스에 여러 케이스를 작성해야 하는 상황이 발생할 수 있습니다.</p><p>시스템 도구에서도 누구나 쉽게 테스트 케이스를 보고 이해하기 위해서는 요약(제목)에 메뉴의 위치나 기능의 위치 정보를 작성해 주는 것이 좋습니다.</p><p>예를 들면,</p><ul><li>로그인 버튼의 경우 : [로그인] 홈 &gt; Navigation bar : 로그인 &gt; 로그인하기</li></ul><p>위치 정보를 작성하고 마지막에는 기능명이나 컴포넌트 명, 혹은 모듈명을 작성해 주는 것이 좋고, 특수문자를 이용해서 구분해 주면 매우 좋습니다.</p><ul><li><strong>시스템 도구 등록 요약(제목) : [구분] 대분류 &gt; 중분류 &gt; 소분류 : 기능명</strong></li></ul><figure><img alt="시스템에서 테스트케이스 관리하기" src="https://cdn-images-1.medium.com/max/1024/1*JagnpPJs1orUBwkzDfOwOQ.png" /><figcaption>예시) Jira에 작성된 이메일 로그인 케이스</figcaption></figure><p>Req.ID의 경우 라벨링이나 시스템 도구에서 활용 가능한 사용자 지정 필드를 이용해서 구분자를 넣어주면 향후 요구 추적 시 매우 유용한 정보로 활용할 수 있습니다. 또한, 테스트 케이스를 수정하기 위해 정보를 찾는 용도로도 활용하게 됩니다.</p><ul><li>Tip : Jira의 Figma/Zeplin 등 플러그인을 통해 바로 요구 문서에 연결 가능하도록 설정하거나 컨플런스 문서를 링크해 놓고 있습니다.</li></ul><p>시스템 도구로 테스트 케이스를 관리하기 위해서는 빠르게 찾아서 수정이 가능해야 하며 빠르게 찾기 위한 정보를 구분자로 입력을 해두어야 합니다. 엑셀에서 구분이나 대분류를 입력했듯이 시스템 도구에도 테스트 케이스를 구분할 수 있는 명확한 구분자를 입력해야 합니다.</p><ul><li>Tip : 요약(제목)의 [구분] 값을 라벨링이나 컴포넌트 구분자에 넣습니다.</li></ul><blockquote><strong><em>[번외] 테스트 시나리오의 활용</em></strong></blockquote><p>시스템 도구에 테스트 케이스 등록 시 습관과 같이 제목(요약)을 시나리오 성으로 작성하는 것은 테스트의 다른 방법의 하나입니다.</p><ul><li>예시) 로그인하기, 로그아웃하기 등등</li></ul><p>이것은 명확하게 테스트 케이스는 아니고, 시나리오 혹은 테스트 스위트(Suite)로 구분하여 별도의 테스트 커버리지를 높일 수 있는 항목으로 구분되어야 합니다.</p><figure><img alt="테스트 스윗을 통해 시나리오로 활용하기." src="https://cdn-images-1.medium.com/max/1024/1*o23DRkmzT7DqmwDPXl_0rQ.png" /><figcaption>테스트 자동화를 위한 시나리오(Xray : Test Set)</figcaption></figure><p>Zephyr와 Xray 모두 Suite로 구성할 수 있는 기능을 제공하고 있습니다.</p><p>Suite로 구성된 시나리오는 향후 테스트 자동화 시나리오로도 활용할 수 있습니다.</p><blockquote><strong><em>누구나 쉽게 이해하고 수행할 수 있는 테스트 케이스</em></strong></blockquote><p>시스템 도구를 활용했을 때 테스트 케이스를 누구나 쉽게 이해하고 수행하려면 다음 3가지를 꼭 기억하시길 바랍니다.</p><ol><li>기능의 위치를 명확히 보여주기 : 요약(제목) 활용</li><li>요구 추적이 가능하도록 작성하기 : 링크 활용</li><li>유지 보수가 원활할 수 있도록 작성하기 : 구분자 활용</li></ol><h3>테스트 케이스 리뷰하기</h3><p>테스트 케이스 리뷰해 보셨나요? 개발자들이 코드 리뷰를 하듯이 QA나 테스트 엔지니어, 그리니까 테스트 케이스를 작성하는 직군은 테스트 케이스 리뷰를 한다는 이야기는 한 번쯤 들어 보셨을 거라 생각합니다.</p><figure><img alt="테스트케이스 리뷰를 통해 요구사항을 포함하는지 확인해야 한다." src="https://cdn-images-1.medium.com/max/1024/1*l3pOjSflBkHOrnxGC9U75Q.jpeg" /><figcaption>테스트 케이스 리뷰</figcaption></figure><p>하지만 일이 많아서? 바빠서? 라는 이유로 하지 못했던 게 현실이었을 거라 생각됩니다. 업무와 연계하여 테스트 케이스 리뷰를 하나의 업무로 가져가는 방법을 공유해 드리고자 합니다.</p><p>우선 스터디를 하나 만들었습니다. 스터디의 제목은 아주 유치하게 “테스트 케이스 작성 달인 되기”로 결정하였습니다. QA 위클리 미팅 시간에 스터디의 목적과 목표를 설정하고 스터디를 진행하기로 했습니다.</p><p>회사에서 스터디를 한다고 하면 “업무 시간에 스터디를 한다고?” 윗분들께 눈치 보이고 그러셨을 텐데요. 회의 시간의 10분만 투자하면 충분합니다.</p><p><strong>테스트 케이스 리뷰 절차</strong></p><ol><li>프로젝트의 수행 시 요구 문서를 기준으로 테스트 케이스 작성</li><li>테스트 케이스 작성 완료 시 리뷰(혹은 중간중간 일정 간격을 두고 리뷰)</li><li>프로젝트 종료 후 리뷰 내용 반영</li><li>다음 프로젝트에 리뷰 내용을 반영한 테스트 케이스 작성</li><li>1~4번 반복</li></ol><p>프로젝트를 수행하게 되면 요구 문서에 대한 검증을 위해 테스트 케이스를 작성합니다. 테스트 케이스 리뷰의 내용은 컨플런스(스터디 스페이스)에 정리를 하였습니다.</p><figure><img alt="리뷰에 대한 피드백 반영으로 고도화된 테스트케이스를 작성한다." src="https://cdn-images-1.medium.com/max/1024/1*l0PTb2l3WKp2fsIbCiNH2A.png" /><figcaption>테스트 케이스 리뷰 및 피드백</figcaption></figure><p>바로 적용할 수 있는 것은 바로바로 적용하였고, 많은 부분을 수정해야 하는 경우에는 프로젝트 종료 후 반영하는 방법을 택했습니다. 리뷰 내용을 모두 반영하면 스터디의 프로젝트를 종료로 업데이트했습니다.</p><p>리뷰어는 별도의 시간을 투자해서 리뷰 내용을 정리해야 하는 것은 사실입니다. 많은 시간이 필요한 것은 아니기 때문에 그동안의 노하우를 후배에게 알려준다는 마음으로 접근하면 즐겁게 리뷰 내용을 정리할 수 있을 거라 생각합니다.</p><h3>OKR(Objectives 와 Key Results) 활용하기</h3><p>테스트 케이스를 작성해서 수행하는 가장 중요한 이유는 ‘품질률’을 측정하기 위한 모수로 활용되기 때문입니다. ‘품질률’은 단순한 단어이지만 많은 내용을 담고 있기 때문에 다음 세션에 자세히 다뤄 보도록 하겠습니다.</p><figure><img alt="목표 중심의 관리는 테스트케이스를 체계적으로 관리할 수 있다." src="https://cdn-images-1.medium.com/max/1024/1*kgFhAKvb4nfkulNB-lLxCQ.jpeg" /><figcaption>테스트 케이스의 OKR 수립</figcaption></figure><p>테스트 케이스를 OKR로 설정하기 위해서는 로드맵이 나와야 합니다. 운영 중인 서비스를 분석해서 테스트 케이스 작성이 필요한 영역을 전체 모수로 설정해서 진척을 관리해야 합니다.</p><p>테스트 케이스의 진척 관리는 [작성 완료 항목 / 전체 항목]으로 진척률을 측정합니다.</p><figure><img alt="핵심 결과를 통해 커버리지를 측정한다." src="https://cdn-images-1.medium.com/max/1024/1*ZuaKECgl8HfUBi8vDzNTjA.png" /><figcaption>크몽 QA의 실제 OKR 항목</figcaption></figure><p>OKR의 목표는 분기별 혹은 반기별로 목표를 설정하고, 명확한 수치로 작성하는 것이 좋습니다.</p><p>예외적인 상황으로 테스트 케이스의 모수는 명확히 정해져 있는 것이 아니고 중간에 모수가 늘어나거나 줄어들 수 있기 때문에 Objectivs 변경 시에는 명확한 사유와 함께 공유될 수 있도록 해야 합니다.</p><p>가장 좋은 방법은 최초 계획된 OKR과 변경된 OKR을 비교해서 측정하는 것도 좋은 방법입니다.</p><p>테스트 케이스를 설계하고 작성하고 수행하는 것은 하나의 주요 업무로써 회사의 품질 목표와 싱크를 맞추고 함께 움직일 수 있도록 해야 합니다.</p><h4>마무리</h4><p>테스트 케이스를 누구나 이해하기 쉽게 작성하기는 사실 매우 어려운 작업입니다. 내 기준에는 쉽다고 생각했지만, 다른 사람이 보았을 땐 어렵게 느껴질 수 있기 때문입니다.</p><p>그래서 테스트 케이스 리뷰를 통해 수정하고, 보완해 나가는 작업이 꼭 필요합니다. 지금은 스터디로 테스트 케이스를 리뷰하고 있지만 하나의 업무 프로세스로 자리 잡아야 할 만큼 매우 중요한 활동이라는 것을 다시 한번 말씀드립니다.</p><figure><img alt="리뷰는 선택아닌 필수로 할 때 좋은 개발 문화를 만들 수 있다." src="https://cdn-images-1.medium.com/max/1024/1*2KYZRs9Hpu-f5xDS93PXBA.jpeg" /><figcaption>체계적인 리뷰 문화 만들기</figcaption></figure><p>테스트 케이스를 어렵게 작성한다고 해서 누가 뭐랄 사람은 없습니다. 내가 작성한 테스트 케이스가 나도 이해하기 어려우면 테스트 케이스를 가장 많이 사용하는 내 자신부터 힘들어질 거라는 것을 알고 최대한 쉽게 작성될 수 있도록 고민해 보시길 바랍니다.</p><p>다음 세션은 ‘품질률’에 대해서 이야기해 볼까 합니다.</p><p>긴 글 읽어 주셔서 감사합니다.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=7de66e7ef5b0" width="1" height="1" alt=""><hr><p><a href="https://blog.kmong.com/%EB%88%84%EA%B0%80-%EB%B4%90%EB%8F%84-%EC%9D%B4%ED%95%B4%EB%90%98%EB%8A%94-%EC%89%AC%EC%9A%B4-%ED%85%8C%EC%8A%A4%ED%8A%B8-%EC%BC%80%EC%9D%B4%EC%8A%A4-%EC%9E%91%EC%84%B1%ED%95%98%EA%B8%B0-7de66e7ef5b0">누가 봐도 이해되는 쉬운 테스트 케이스 작성하기</a> was originally published in <a href="https://blog.kmong.com/">kmong</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[크몽 개발팀 Jira 사용기 : 응용 편]]></title>
            <link>https://blog.kmong.com/%ED%81%AC%EB%AA%BD-%EA%B0%9C%EB%B0%9C%ED%8C%80-jira-%EC%82%AC%EC%9A%A9%EA%B8%B0-%EC%9D%91%EC%9A%A9-%ED%8E%B8-7bcab004a96?source=rss-2f11563a285d------2</link>
            <guid isPermaLink="false">https://medium.com/p/7bcab004a96</guid>
            <category><![CDATA[jira]]></category>
            <category><![CDATA[qa]]></category>
            <category><![CDATA[administration]]></category>
            <category><![CDATA[process]]></category>
            <category><![CDATA[kmong]]></category>
            <dc:creator><![CDATA[James]]></dc:creator>
            <pubDate>Tue, 07 Mar 2023 01:56:15 GMT</pubDate>
            <atom:updated>2023-03-07T02:01:37.777Z</atom:updated>
            <content:encoded><![CDATA[<h3>크몽 개발팀 Jira 사용기 : 응용 편</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/900/1*VaQ_04m--qeSolsnQ8EZxg.png" /></figure><p>안녕하세요. 크몽에서 QA를 담당하고 있는 제임스입니다.</p><p>이번 세션에는 ‘크몽 개발팀 Jira 사용기 : 극대화 편’에 이어 배포 관리 프로세스에 대한 ‘응용 편’을 준비했습니다. 이전 글을 아직 보지 못하신 분은 아래 링크를 참고해 주세요.</p><ul><li><a href="https://blog.kmong.com/%ED%81%AC%EB%AA%BD-%EA%B0%9C%EB%B0%9C%ED%8C%80-jira-%EC%82%AC%EC%9A%A9%EA%B8%B0-81224416448e">크몽 개발팀  Jira 사용기</a></li><li><a href="https://medium.com/@james_34049/%ED%81%AC%EB%AA%BD-%EA%B0%9C%EB%B0%9C%ED%8C%80-jira-%EC%82%AC%EC%9A%A9%EA%B8%B0-%EA%B7%B9%EB%8C%80%ED%99%94-%ED%8E%B8-88439965a9bf">크몽 개발팀 Jira 사용기 : 극대화 편</a></li></ul><blockquote><strong><em>배포 관리 프로세스를 개선하기 위한 바이블!</em></strong></blockquote><ul><li>간단히 살펴보기 : Jira와 프로세스의 관계</li><li>상세히 알아보기(1) : 신규(추가) 세팅하기</li><li>상세히 알아보기(2) : 개선점 반영하기</li><li>마무리</li></ul><h3>간단히 살펴보기</h3><blockquote><strong><em>Jira와 프로세스의 관계?</em></strong></blockquote><p>크몽 서비스의 구조와 개발 조직의 규모는 점점 커지고 좋아지고 있으나 이와 반대로 품질의 위험도는 점점 높아지고 있습니다. 그래서 효과적이고 효율적으로 업무를 수행하고 협업하는 것은 더욱 중요한 부분이 되었습니다.</p><p>‘업무 프로세스’는 하나 이상의 입력을 받아들여 고객에게 가치 있는 결과를 산출하는 행동들의 집합을 의미합니다.</p><p>그렇다면 ‘업무 프로세스’와 Jira는 어떤 연관 관계가 있을까요?</p><p>품질 평가 모델(ISO/IEC 25010)을 통해 간단하게 확인해 보도록 하겠습니다.</p><p>ISO/IEC 25010(기존 9126–4)에 명시되어 있는 품질 평가 모델은 크게 2가지이며, <strong>프로세스 품질</strong>과 <strong>제품 품질</strong>(내부/외부 품질, 사용 품질)로 구분합니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/986/1*wddVw8Vbf78sR1SyhuvypQ.png" /><figcaption>개정된 ISO/IEC 25010</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/980/1*txDQi-d0wxC1KZDeCMMreQ.png" /><figcaption>기존 ISO/IEC 9126</figcaption></figure><p>여기서 <strong>Jira의 활용은 프로세스 품질</strong>의 영역을 담당합니다.</p><p>소프트웨어 개발 프로세스로 폭포수 모델의 확장된 형태인 V 모델(V-model)은 <strong>제품 품질</strong>의 영역을 담당합니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/702/1*8kp2poeR9ggU6pZjOpSLhQ.jpeg" /><figcaption>출처 : 위키백과- V모델</figcaption></figure><p>결과적으로 프로세스 품질이 안정화되지 않은 상태에서 내부/외부/사용 품질을 확보한다거나 안정화/고도화하는 것은 현실적으로 불가능한 부분이라 생각합니다.</p><p>그래서 Jira나 혹은 다른 도구를 사용하여 업무 프로세스를 시각화하고 부서 간 정해진 일련의 정책? 약속?을 통해 정립해야 하는 것입니다.</p><h3>상세히 살펴보기(1)</h3><blockquote><strong><em>신규(추가) 세팅하기</em></strong></blockquote><ul><li><a href="https://medium.com/@james_34049/%ED%81%AC%EB%AA%BD-%EA%B0%9C%EB%B0%9C%ED%8C%80-jira-%EC%82%AC%EC%9A%A9%EA%B8%B0-%EA%B7%B9%EB%8C%80%ED%99%94-%ED%8E%B8-88439965a9bf">‘크몽 개발팀 Jira 사용기 : 극대화 편’</a>에서 해결하지 못한 문제점</li></ul><p>초기 Jira 세팅 당시에 크몽은 조직 구조가 매트릭스로 구성되어 있어서 Jira의 보드 구성을 유연하게 하기가 매우 어려웠습니다. 이와 더불어 버전 관리의 문제점을 다방면으로 해결해 보고자 했었는데요.</p><p>프로세스를 개선하면서 버전 관리의 문제점을 Jira 세팅으로 어떻게 해결하였는지 정보를 공유해 드리려 합니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Aqpwlh3UpG8xnFefKQR-Wg.png" /><figcaption>크몽의 Team/Chapter-매트릭스 구조</figcaption></figure><p>Jira 프로젝트 LNB 메뉴에 있는 Release(릴리즈)를 통해 버전을 관리해 보고자 했습니다. 하지만 여러 가지 문제점들이 발생하였습니다.</p><p><strong>Phase 1)</strong></p><ul><li><strong>문제점</strong> : Team에서 버전을 생성하면 Chapter에서 버전 관리의 부재가 발생한다.</li><li><strong>개선 포인트</strong> : Chapter에서 버전을 관리하자.</li></ul><p><strong>Phase 2)</strong></p><ul><li><strong>문제점</strong> : Chapter에서 버전을 관리하니 Team에서 생성한 티켓에 버전 입력이 불가능하다.</li><li><strong>개선 포인트</strong> : Team과 Chapter에서 동시에 버전을 관리 할 수 있는 방법이 필요하다.</li></ul><blockquote><strong><em>Work Automation으로 문제점 해결하기</em></strong></blockquote><p><a href="https://www.atlassian.com/software/jira/features/automation">Jira에는 업무 자동화를 위한 기능</a>을 제공합니다. 컨셉은 노코딩으로 코드 없는 규칙 빌더라고 아틀라시안에서 이야기하고 있으며 업무 자동화를 구축할 수 있도록 기능이 제공되고 있습니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*RFEuc_Whh-VA8DDyXdQ8nA.png" /><figcaption>Jira Work Automation</figcaption></figure><blockquote><strong><em>[1] 가장 먼저 시도해본 Team ↔︎ Chapter로 Release 버전 클론하기</em></strong></blockquote><ul><li>Team의 Release 버전명에 b_,f_, a_, i_ 등(유니크 값)이 포함되는 경우 Automation이 동작하여 Chapter의 Release 버전에 동일한 버전을 생성하도록 설정함</li><li>반대의 경우(Chapter &gt; Team)도 동일하게 동작하도록 설정함</li></ul><pre>Team A 경우 &gt; Team B / Team C 도 세팅됨<br> if 버전명에 f_가 포함된 경우<br>    FrontEnd Chapter에 Team A와 동일한 버전 생성<br> if else 버전명에 fAB_가 포함된 경우<br>    FrontEnd Chapter에 Team A와 Team B에 동일한 버전 생성<br> --------------- 이하 챕터별 동일 ---------------   </pre><ul><li>예시) A Team Release 버전 b_1.0.0을 생성하면 BackEnd Chapter의 Release에 동일 버전이 생성됨</li><li>버전 생성 규칙 : {챕터 키}_{프로젝트 키}_{버전} → ex) a_MUS_1.0.0</li></ul><p>버전 목록 페이지의 [Release] 버튼을 클릭하면, 연결된 Slack ‘#채널’에 알림이 발생하도록 설정하였습니다.</p><pre>@channel Version: {{version.name}} 릴리즈되었습니다. <br>ReleaseDate: {{now.jqlDateTime}}<br><br><br>-------- 반영 티켓 목록 --------<br><br>{{#lookupIssues}}<br>ㄴ &lt;{{url}}|[{{key}}]&gt; {{summary}}<br>{{/}}</pre><p>Release를 통해 버전 관리를 하게 되면 장점은 이슈 유형의 ‘배포’라는 이슈를 생성하지 않아도 된다는 점과 Release Note를 따로 작성하지 않아도 된다는 점입니다. 또한, Affect Version과 Fixed Version을 명확하게 관리할 수 있습니다.</p><blockquote><strong><em>[2] Team 별 동일 버전에 대한 자동 배포 알림 설정하기</em></strong></blockquote><p>[1] 번과 같이 업무를 수행하면서 불편한 점은 Team 별 동일 버전이 생성되었을 때 Team 별 Release 버튼을 모두 눌러 줘야 한다는 불편한 점이 발생하였습니다. 많게는 3 Team 모두 눌러야 하는 상황도 발생하였습니다.</p><p>이 문제도 Work Automation을 세팅하여 중복된 버전이 있는 경우를 체크하여 Team에서든 Chapter에서든 [Release] 버튼을 클릭하면 동일한 버전에 대한 알림이 발생하도록 설정하였습니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/762/1*rexDxAjngc9j8FUVQtL7Cg.png" /></figure><ul><li><strong>주의해야 할 점</strong>은 Team과 Chapter에서 <strong>전역으로 Automation이 동작하는 경우</strong> Jira 라이센스 등급에 따라 <strong>동작 횟수가 정해져 </strong>있기 때문에 꼭 검토해야 합니다. <strong>개별(Team or Chapter) 동작은 무제한</strong>입니다.</li></ul><blockquote><strong><em>[3] [1] ~ [2]의 버전 관리 문제점</em></strong></blockquote><p>1개월 정도 사용 후 실사용자(개발자)들의 피드백입니다.</p><ul><li>하나의 프로젝트에 하나의 버전이라는 Jira 프로젝트 사용 목적에 맞지 않아 형상의 정보와 Jira 버전 생성의 갭이 발생함.</li><li>개선이라고 하면 편리함이 느껴져야 하는데 생각보다 손이 더 많이 감.</li><li>업무 자동화를 하였으나 사용법이 익숙지 않아 어려움.</li><li>이전 버전의 정보를 한눈에 볼 수 없어서 영향을 받는 버전(Affect version)을 입력하기 어려움.</li></ul><p>아쉽지만 1~2개월의 고민은 Fail로 결론을 냈습니다.</p><h3>상세히 살펴보기(2)</h3><blockquote><strong><em>이대로 포기할 수 없다! : 개선점 반영하기</em></strong></blockquote><p>위의 사례를 바탕으로 새로운 개선 목표를 수립하였습니다.</p><p><strong>Phase 3)</strong></p><ol><li>개발자가 최소한의 액션으로 #Slack 알림을 할 수 있게 하는 것.</li><li>쪼개져 있는 Repository에 대한 버전을 한눈에 볼 수 있게 하는 것.</li><li>FrontEnd의 고민(BackEnd 배포도 함께할 때)을 해결하는 것.</li><li>형상의 Repository가 늘어날 때 유동적으로 확장성 있게 구성하는 것.</li></ol><p>Release 메뉴는 미련은 좀 남았지만, 과감히 포기하였습니다. 그리고 ‘배포’ 관리를 위한 새로운 프로젝트를 생성(프로젝트명 : “[Integration] Release List”)하였습니다.</p><p>프로젝트의 이슈 유형부터 워크플로우를 재정의하였고, 이슈 생성 시 필수로 입력해야 하는 필드를 추가하였습니다.</p><blockquote><strong><em>[1] 이슈 유형은 아래와 같이 정의하였습니다.</em></strong></blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/207/1*mqMnKlWkx8jOlr1BSND4gg.png" /><figcaption>Issue type</figcaption></figure><ul><li>FontEnd Release : 프론트엔드 배포 유형</li><li>BackEnd Release : 백엔드 배포 유형</li><li>Android Release : AOS 배포 유형</li><li>iOS Release : iOS 배포 유형</li><li>Multi Release : 다중 레파지토리 배포 유형</li><li>Epic : 스프린트별 배포 목록으로 확인하기 위한 유형(로드맵)</li></ul><blockquote><strong><em>[2] 워크플로우는 아래와 같이 정의하였습니다.</em></strong></blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/339/1*zK00HZGw8agSlCjdO5dcMQ.png" /><figcaption>Release Workflow</figcaption></figure><ul><li>Project Release : 스프린트 내에 개발 항목 배포</li><li>Operation Release <strong>: </strong>VOC 및 운영 개발 항목 배포</li><li>HotFix Release : 긴급 배포</li><li>Forced Update : 오픈 마켓 강제 업데이트</li><li>Holding : 배포 보류</li></ul><blockquote><strong><em>[3] [OOO Release] 상태 변경 시 #Slack 채널에 알림이 발생하도록 설정하였습니다.</em></strong></blockquote><ul><li>상태 변경 시 #Slack 자동 알림 : Backlog → Project Release | Operation Release | HotFix Release | Forced Update |Holding</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/524/1*fWdypKBER0-Q6h2dBEKlrg.png" /><figcaption>Slack Alarm</figcaption></figure><blockquote><strong><em>[4] 대시보드를 세팅하여 Release 상태를 한눈에 확인할 수 있도록 세팅하였습니다.</em></strong></blockquote><ul><li>대시보드는 Team과 Chapter에서 확인할 수 있도록 세팅</li><li>배포 유형/버전/배포일 등이 확인할 수 있도록 세팅</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*aT46Y2OiVh6K8rn4MNYNKw.png" /><figcaption>Dashboard Setting</figcaption></figure><h3>마무리</h3><p>결과적으로 지난해 11월쯤 위와 같이 세팅을 완료하고 현재 배포 관리 및 정보 공유가 원활히 수행되고 있습니다.</p><p>Jira에서 배포에 대한 세팅은 <strong>선택 아닌 필수</strong>입니다. 배포 정보는 내/외부에서 매우 중요한 정보이고 최대한 공유되어야 하는 정보이기 때문입니다.</p><p>QA는 테스트 시 영향 범위를 분석해서 변경 점에 대한 집중 테스트와 리그레이션 테스트를 하기 위함이며, 유관 부서에서는 변경 점에 대해 인지하고 이슈 발생 시 최대한 빠르게 대응하기 위한 것이 가장 큰 목적이 있다고 생각합니다.</p><p>이후 QA Chapter에서는 배포 정보를 기반으로 Hotfix Release 혹은 Force Update의 추이를 확인하여 좀 더 테스트에 집중해야 하는 플랫폼이 무엇인지도 추적해 볼 계획입니다.</p><p>다음 편은 개발 그룹 외 부서들은 Jira를 어떻게 활용하면 좋을지에 대한 내용으로 ‘번외 편’에서 찾아뵙도록 하겠습니다.</p><p>긴 글 읽어 주셔서 감사합니다. 😊</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=7bcab004a96" width="1" height="1" alt=""><hr><p><a href="https://blog.kmong.com/%ED%81%AC%EB%AA%BD-%EA%B0%9C%EB%B0%9C%ED%8C%80-jira-%EC%82%AC%EC%9A%A9%EA%B8%B0-%EC%9D%91%EC%9A%A9-%ED%8E%B8-7bcab004a96">크몽 개발팀 Jira 사용기 : 응용 편</a> was originally published in <a href="https://blog.kmong.com/">kmong</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[크몽 개발팀 Jira 사용기 : 극대화 편]]></title>
            <link>https://blog.kmong.com/%ED%81%AC%EB%AA%BD-%EA%B0%9C%EB%B0%9C%ED%8C%80-jira-%EC%82%AC%EC%9A%A9%EA%B8%B0-%EA%B7%B9%EB%8C%80%ED%99%94-%ED%8E%B8-88439965a9bf?source=rss-2f11563a285d------2</link>
            <guid isPermaLink="false">https://medium.com/p/88439965a9bf</guid>
            <category><![CDATA[kmong]]></category>
            <dc:creator><![CDATA[James]]></dc:creator>
            <pubDate>Thu, 21 Jul 2022 08:24:43 GMT</pubDate>
            <atom:updated>2022-07-22T01:33:27.919Z</atom:updated>
            <content:encoded><![CDATA[<h3>크몽 개발팀 Jira 사용기 : 극대화 편</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*fvF0TXXrAHuOdtkMCIcvNg.jpeg" /></figure><p>기존 ‘크몽 개발팀 Jira 사용기’에 이어 ‘극대화 편’을 준비하였습니다. 이전 글을 아직 보지 못하신 분은 아래 링크를 참고해 주세요.</p><p><a href="https://blog.kmong.com/%ED%81%AC%EB%AA%BD-%EA%B0%9C%EB%B0%9C%ED%8C%80-jira-%EC%82%AC%EC%9A%A9%EA%B8%B0-81224416448e">크몽 개발팀  Jira 사용기</a></p><p>크몽 마켓은 다양한 분야의 프리랜서 재능을 만나 볼 수 있는 서비스로 누적 거래 완료 건수 304만 건, 누적 회원 수 217만 명 이상의 국내 №1 프리랜서 마켓입니다.</p><p>크몽의 조직 문화는 ‘Work Happy’의 비전을 가지고 행복하고 즐겁게 일하는 것이며, 회사의 규모가 커진다고 해서 프로세스와 정책을 늘리기보다는 역량이 뛰어난 직원 스스로가 결정하는 문화를 만들어 가고 있습니다.</p><p>또한, 개발 조직의 규모가 점점 커지면서 효율적으로 조직이 운영될 수 있도록 많은 변화와 시도를 하였습니다. 그 중의 하나가 2020년 Jira를 도입한 것인데요. 이후에도 개발 조직은 더 커졌고 앞으로 더 커질 것을 예상하여 좀 더 유연하게 업무를 수행할 수 있도록 Jira의 사용성을 개선하게 되었습니다.</p><h3>Jira 사용성 개선 계획</h3><p>기존에도 Jira를 잘 사용하고 있었지만 좀 더 잘 사용해보고자 하는 의견이 많았습니다. 그래서 간단하게 Task를 정리하여 계획을 작성하였습니다.</p><ol><li>현재 Jira 사용 분석</li><li>이슈 유형/워크플로우/이슈 화면 정리</li><li>이슈 유형/워크플로우/이슈 화면 재정의</li><li>보드 구성(메트릭)</li><li>리뷰 및 피드백 반영</li><li>모니터링 및 개선 활동</li></ol><p>첫 번째, 무엇인가를 개선하기 위해서는 분석 활동이 매우 중요합니다. 무엇이 잘 되고 있는지 혹은 무엇이 부족한지를 판단하는 중요한 근거 자료를 발견할 수 있기 때문입니다.</p><p>현재 Jira를 어떻게 사용하고 있는지 Admin 권한을 받아서 살펴보았고 Jira 활용도가 높은 구성원의 인터뷰를 통해 평소 불편한 점과 좀 더 잘해보고자 하는 부분을 듣고 정리하였습니다. 이와 더불어 어떻게 구성하는 것이 좋을지 제 생각과 지식 또한 정리하고 공유하였습니다.</p><p>두 번째, 기존 Admin 페이지에는 사용하지 않는 일명 쓰레깃값들이 관리되고 있지 않았습니다. 앞으로 체계적인 관리를 위해서는 불필요한 값들을 선 정리하는 작업이 필요했습니다.</p><p>Jira의 강점 중의 하나는 삭제 시 유효성이 동작한다는 점으로 매우 논리적으로 구성되어 있기 때문에 그냥 삭제할 수 있는 데이터는 아무도 사용하지 않는다는 의미이기도 합니다.</p><p>세 번째, 인터뷰를 통해 얻은 결과물을 통해 이슈 유형/워크플로우/이슈 화면을 재정의합니다. 사용성 개선 활동의 가장 핵심적인 부분입니다.</p><p>네 번째, Jira를 사용하기 위한 속성값이 모두 정의되면 보드를 구성합니다. 보드 구성은 업무의 효율성을 극대화할 수 있도록 구성해야 합니다. Jira에서는 효율성을 최대화하기 위해 다양한 보드를 지원하는 것이 이런 연유에서입니다.</p><p>마지막으로 적용된 영역에 대해서 기존 구성원들에게 공유하고, 리뷰합니다. 그리고 피드백을 받아서 추가로 개선하거나 정해진 부분을 프리징합니다. 바로 모든 것을 포용할 수 없기 때문에 지속해서 모니터링하는 것도 개선 활동의 매우 중요한 부분입니다.</p><h3>현재 Jira 사용 분석</h3><h4><strong>#1 크몽팀의 조직 구성</strong></h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*lhNwATQNIae5PTY_tkhBAg.png" /><figcaption>Kmong Product Group’s Matrix</figcaption></figure><p>크몽팀의 조직 구성은 이외에도 다른 부서가 있지만 현재 크몽 마켓을 개발하고 운영하는 부서의 모습입니다. 특이한 점은 목적 조직(Team)과 기능 조직(Chapter)으로 구분되어 있으면서 유연한 업무를 수행하기 위해 메트릭의 구조로 되어 있는 것인데요.</p><p>이번에 Jira 사용성을 높이고 더욱 유연하게 업무를 수행할 수 있도록 Jira 보드 구성에 크몽팀의 메트릭을 구성해 보았습니다.</p><h4><strong>#2 마인드맵 활용</strong></h4><p>Team과 Chapter 사이의 유기적인 관계를 이해하기 위해서 항상 마인드맵을 활용하였습니다. 평소 알마인드만 사용하다가 이번에 처음 검색해서 <a href="https://gitmind.com/kr/">GitMind</a>라는 걸 사용해 보았는데 테마도 많고 좋았습니다. 필요하시면 한 번 사용해 보시길 바랍니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*xah4PbvmBDp8va6hU8axRg.png" /><figcaption>Jira board mind map with metrix analysis</figcaption></figure><p>가장 고민을 많이 했던 부분은 스크럼 보드와 칸반 보드의 구분입니다. 기존 사용하던 보드를 참고해서 스프린트 관리 여부를 확인 했습니다. Team은 스프린트 보드를 매우 잘 활용하고 있기 때문에 스크럼 보드로 구성하고, 좀 더 유연하게 업무를 수행하는 Chapter는 칸반 보드로 구성하기로 결정하였습니다.</p><p>마인드맵에서 추가적으로 확인 가능한 정보는 Operation Team에서 생성하는 VOC 이슈에 대한 각 Team 별, Chapter 별 업무에 대한 Co-work 노드를 확인할 수 있습니다.</p><h4>#3 인터뷰</h4><p>Jira 개선을 위해서 많은 분들이 다양한 의견을 주셨습니다. 이런 의견을 바탕으로 개선 방향성을 세우고, 세워진 방향성을 기준으로 Jira를 구성하게 됩니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*V5D54eFhQLgZsmrriAzB3A.png" /><figcaption>Interview with members</figcaption></figure><p>이와 추가적으로 Jira의 사용성 개선을 위해 평소 알고 있던 지식과 고민하던 부분을 공유하여 인터뷰 시에 도움이 되는 정보를 정리하였습니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*lixIvJF7uqrkfI8OFt48HA.png" /><figcaption>Summarize commonly known knowledge necessary for improvement</figcaption></figure><h3>이슈 유형/워크플로우/이슈 화면 정리</h3><p>기존에 Admin은 생성하고 삭제나 변경에 대한 관리가 되지 않았습니다. 새로운 이슈 유형이나 워크플로우, 그리고 이슈 화면을 생성하고 사용하기에는 매우 복잡한 상태였습니다.</p><p>대부분 Jira를 사용하는 기업의 Admin은 비슷할 거라 생각합니다. 생성과 변경만 하고 사용자 익명화와 같은 정리 작업을 하지 않기 때문입니다.</p><p>그래서 기존 사용하던 이슈 유형, 워크플로우, 이슈 화면을 Old Scheme로 구성하여 한 곳에 모아두는 작업을 하였습니다. 이렇게 작업할 때 좋은 점은 사용자들은 바뀐 것도 모르고 업무를 수행하는 데 아무런 영향이 없으면서 정리가 가능한 방법입니다.</p><p>사용하지 않거나 불필요한 항목을 삭제해야 하는 경우는 삭제 가능 여부를 판단하기 위해서 해당 이슈 유형이나 워크플로우를 직접 사용하는 구성원에게 개별 문의를 해야만 했습니다. 자칫 잘못 삭제하게 되면 현재 업무에 영향을 줄 수 있기 때문에 삭제 작업을 할 때는 <strong>꼭 현재 사용 중인지 미사용 중인지를 확인하고 삭제</strong>하시기 바랍니다.</p><h3>이슈 유형/워크플로우/이슈 화면 재정의</h3><h4>#1 이슈 유형 재정의</h4><p>이슈의 유형은 업무의 방식에 따라 직관적으로 확인할 수 있도록 재정의하였고, 이슈 유형만 보더라도 어떤 업무인지 알 수 있도록 하였습니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*VmVX_y-0P-PrSVOnfLHhHA.png" /><figcaption>Redefining issue types</figcaption></figure><h4>#2 워크플로우 재정의</h4><p>이슈의 유형에 따라 워크플로우를 재정의하였고, 비슷한 워크플로우는 통합하여 사용할 수 있게 Scheme 작업을 하였습니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*feO3Es-fJZhjGPA0juMWQA.png" /><figcaption>Redefining workflow</figcaption></figure><p>워크플로우 구성 시 하나 더 고민했던 점은 이슈를 Resolved 할 때(상태가 변경될 때) 필수 입력받도록 팝업을 띄우는 것이었습니다. 그래서 주요 스테이터스가 변경되는 시점에는 상태 변경에 대한 트리거(팝업)를 삽입하여 필수 입력을 받을 수 있도록 구성하였습니다.</p><p>필수 입력에 대한 선택은 내부적으로 꼭 입력되어야 하는 약속된 값이고, 향후 Jira Report나 Dashboard에서 의미 있는 데이터로 활용하기 위함입니다.</p><h4>#3 이슈 화면 재정의</h4><p>이슈 화면 재정의는 선택 사항입니다. 해도 좋고 안 해도 되지만 사용성을 높이기 위한 목적이라면 반드시 해야 합니다. 이슈 유형에 따라 보이는 카테고리를 조사하고 이슈 등록 시 필요한 카테고리만 보일 수 있도록 구성하는 것입니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*6qJ69OK3tCuVI90spvT18Q.png" /><figcaption>Redefining issue screen</figcaption></figure><p>그리고 입력 카테고리는 기본 입력과 옵션으로 구분하는 것이 좋습니다. 필수 입력에 대한 기본 입력만 설정하면 향후 이슈 수정 시 카테고리가 안 보일 수 있기 때문에 옵션에는 반드시 카테고리가 있어야 합니다. 이슈 등록 시에는 탭으로 보이게 구분할 수 있습니다.</p><h3><strong>보드 구성(메트릭)</strong></h3><p><em>‘프로젝트의 보드를 어떻게 구성해야 메트릭 형태로 구성할 수 있을까?’</em></p><p>이슈 유형을 재정의하고 워크플로우도 재정의하면서 보드 구성에 대한 고민을 지속해서 했습니다. 왜냐하면 크몽팀의 조직 구성이 메트릭 구조이기 때문에 프로젝트를 이동하지 않으면 나의 할 일(Backlog)이나 Co-work 티켓을 확인할 수 없기 때문인데요.</p><p>하지만 아주 간단한 방법으로 문제를 해결할 수 있었는데 그것은 바로 <strong>Jira 프로젝트 내의 보드 추가 기능</strong>을 통해서입니다.</p><p>먼저, 분석에서 확인된 보드의 유형에 따라 프로젝트를 생성합니다. 크몽팀은 스크럼 프로젝트 6개(Team), 칸반 프로젝트 6개(Chapter)를 생성하였습니다. 메트릭의 구조상 12개의 프로젝트 내에서 유연하게 업무를 수행할 수 있도록 구성할 방법이 필요했습니다.</p><p>그래서 Team 스크럼 프로젝트 내에 Chapter 칸반 보드를 추가하였습니다. 예를 들어 A Team 보드에는 6개의 Chapter 보드를 볼 수 있도록 추가하고, B Team 보드에도 6개의 Chapter 보드를 볼 수 있도록 추가한 것입니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*jNSoP8mibxDeUy_6JpprsQ.png" /><figcaption>Create additional chapter boards in project</figcaption></figure><p>이렇게 구성하기 위해서는 보드 내의 필터를 약간 수정 해야 합니다. 특히, 키 값과 같은 역할의 구분자를 사용해야 하는데 크몽팀의 경우 Team 명과 Chapter 명을 구분자로 사용하였습니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*_vjV_afcvBk_hPbOYxq4hg.png" /><figcaption>jQuery that makes the board into a metrix</figcaption></figure><p>구분자를 해당 Team이나 Chapter의 구성원으로 해도 되지 않느냐? 는 질문을 받은 적이 있습니다. 물론 상관없습니다. 충분히 가능합니다. 하지만 사용자의 경우 들어오고 나가고의 변수가 작용하기 때문에 향후 관리에 대한 문제가 발생할 수 있는 점은 참고 바랍니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*UHQcJApySNdB9FXpn-85xg.png" /><figcaption>Organizational Relevance</figcaption></figure><p>결과적으로 모든 Team 프로젝트에서는 Chapter 보드의 업무를 볼 수 있게 되었고, Chapter 보드에서는 Team 업무(Team의 구분 없이 자신이 해야 할 일)를 볼 수 있게 되었습니다. 별도의 프로젝트를 이동하지 않아도 유연하게 서로의 업무의 상태를 공유할 수 있게 되었습니다.</p><p>리뷰와 피드백을 받은 내용은 따로 언급하지 않겠습니다.</p><p>현재도 진행 중이고 앞으로도 많은 부분이 개선될 것이기 때문인데요. Jira를 메트릭 형태로 구성하는 것은 저에게도 큰 도전이었고, 잘 될지 안 될지 모르는 상황이었지만 믿고 적극적으로 피드백 주신 크몽팀이 있었기에 좋은 결과물이 나올 수 있던 것 같습니다.</p><p>추가로 현재 버전 관리에 대한 문제점이 발견되었습니다. 이는 Jira의 정책상 모순되는 부분이라 Admin 내에서 해결할 수 없습니다. 메트릭 구조상 Product Team에서 버전을 관리하는 것이 맞는다고 생각했는데 업무를 수행하다 보니 실질적으로 Chapter 내에서 빌드/배포를 수행하고 있었기 때문입니다.</p><p>그래서 이 부분은 현재 Jira Work Automation으로 문제를 해결한 상태이고 테스트를 진행하고 있습니다. 문제 해결에 대한 자세한 내용과 추가로 개선된 내용은 ‘응용 편’에서 찾아뵙도록 하겠습니다.</p><p>긴 글 읽어 주셔서 감사합니다.😊</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=88439965a9bf" width="1" height="1" alt=""><hr><p><a href="https://blog.kmong.com/%ED%81%AC%EB%AA%BD-%EA%B0%9C%EB%B0%9C%ED%8C%80-jira-%EC%82%AC%EC%9A%A9%EA%B8%B0-%EA%B7%B9%EB%8C%80%ED%99%94-%ED%8E%B8-88439965a9bf">크몽 개발팀 Jira 사용기 : 극대화 편</a> was originally published in <a href="https://blog.kmong.com/">kmong</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>