본문으로 건너뛰기

게이트킷(gatekit)으로 냉장고 재료 레시피 추천 서비스 구현하고 검증하기

이재희

2026.10.20

소개

지난 과제에서는 냉장고 속 재료로 만들 수 있는 요리를 추천해 주는 서비스 **'한끼픽'**을 기획했습니다.

요리를 잘 모르는 사람도 냉장고 사진이나 장 본 영수증, 주문 내역을 올리면 재료를 인식하고, 그 재료로 만들 수 있는 요리를 추천받는 서비스예요.

지난번에는 Gatekit을 활용해 서비스 기획과 화면 설계까지 진행했고, 이번에는 설계한 내용을 실제 작동하는 웹서비스로 구현하는 것을 목표로 했습니다.

개발 경험이 거의 없어 직접 코드를 작성하기보다는 Claude Code와 Gatekit을 활용해 제작부터 검증까지 진행해 봤습니다.

진행 방법

1. 사용한 도구

  • VS Code + Claude Code: 실제 서비스 코드 제작 및 수정

  • Gatekit: 서비스 기획, 화면 설계, 구현 및 검증 과정 진행

2. 화면 설계 검토 및 수정

본격적인 제작에 앞서 기존 화면 설계를 다시 검토하고 수정했습니다.

특히 S3 '재료 확인' 화면을 중점적으로 살펴봤어요.

이 화면은 사진에서 인식한 재료가 맞는지 확인하고, 빠진 재료를 추가하거나 필요 없는 재료를 삭제한 뒤 추천 조건을 설정하는 화면입니다.

초기 설계에서는 정보가 여러 영역으로 나뉘어 있어 사용자가 재료를 확인하고 수정하기에 적절한 구조인지 고민이 됐습니다.

여러 방식을 비교하면서 다음과 같이 정리했습니다.

  • 재료는 칩 형태로 표시하고 삭제할 수 있도록 구성

  • 빠진 재료를 직접 추가할 수 있는 기능 제공

  • 기본 양념도 사용자가 확인하고 삭제할 수 있도록 구성

  • 1~6인분 선택 기능을 가로 스크롤 형태로 적용

  • 못 먹는 재료를 입력해 추천에서 제외할 수 있도록 구성

  • 불필요한 팝업이나 복잡한 UI 상태는 최소화

이 과정에서 단순히 화면을 예쁘게 구성하는 것뿐 아니라, 사용자가 어떤 순서로 정보를 확인하고 행동하는지도 함께 생각하게 됐습니다.

📸 [이미지 1: S3 재료 확인 화면 설계 또는 수정 전후 이미지 첨부]

3. Claude Code와 Gatekit으로 실제 서비스 제작

화면 설계를 어느 정도 정리한 후, Gatekit을 활용해 실제 서비스 구현을 진행했습니다.

프로젝트 기본 구조와 공통 UI 컴포넌트를 만들고, 이후 각 화면을 구현하는 방식으로 작업이 진행됐습니다.

주요 구현 내용

  • 공통 버튼, 헤더, 재료 칩 등 UI 컴포넌트

  • 서비스에 사용할 디자인 값과 이미지

  • S1 사진 올리기

  • S2 재료 분석 중

  • S3 재료 확인

  • S4 추천 결과

  • S5 레시피 상세

  • 하루 10회 이용 제한 및 기타 기본 화면

기획 단계에서 정했던 디자인 요소들도 실제 코드에 함께 반영됐습니다.

직접 코드를 작성하지 않아도 화면과 기능이 구현되는 과정이 신기했지만, 원하는 결과물을 얻기 위해서는 화면별 동작과 예외 상황을 구체적으로 정의해야 한다는 점도 느꼈습니다.

📸 [이미지 2: Claude Code에서 서비스 구현 중인 화면 첨부]

4. Gatekit으로 구현 결과 검증

서비스의 기본 화면을 만든 뒤에는 /gatekit-verify를 활용해 검증을 진행했습니다.

검증 과정에서는 다음 항목을 확인했습니다.

  • 자동 테스트 및 타입 검사

  • 실제 배포를 위한 빌드 검사

  • S1부터 S5까지 전체 이용 흐름 테스트(E2E)

  • 브라우저 화면 캡처를 통한 디자인 확인

  • 기능 및 코드 검토

검증 결과, 자동 검사 21개 항목이 모두 통과했고 화면 캡처도 8장 생성됐습니다.

다만 자동 검사가 통과했다고 모든 작업이 끝난 것은 아니었습니다.

실제 화면을 검토하는 과정에서 몇 가지 문제가 발견됐습니다.

  • 메인 버튼 색상이 의도보다 옅게 표시되는 현상

  • S3 화면에서 입력 영역이 하단 고정 버튼에 가려지는 문제

  • 일부 텍스트와 색상이 디자인 명세와 다른 문제

  • 서비스에서 사용하지 않기로 한 표현이 이용약관에 포함된 문제

이후 발견된 항목을 수정하고 다시 검증하는 작업을 진행했습니다.

📸 [이미지 3: Gatekit 검증 결과 21/21 통과 화면 첨부]

📸 [이미지 4: 검증 중 발견된 UI 문제 화면 첨부]

5. 사용한 명령어

이번 작업에서는 Gatekit의 구현·검증 과정을 활용했습니다.

사용한 명령어

/gatekit-build
/gatekit-verify

구현과 검증을 분리해 진행했고, 검증 결과 수정이 필요한 항목은 다시 구현 단계에서 수정하도록 했습니다.

※ 최초 구현에 사용한 프롬프트 전문은 현재 정리한 자료에 포함되어 있지 않아, Claude Code 대화 기록에서 확인한 뒤 추가할 예정입니다.

결과와 배운 점

1. 결과

이번 작업을 통해 한끼픽의 주요 화면과 기본 기능을 실제 웹서비스 코드로 구현했습니다.

자동 테스트 21개 항목이 모두 통과했고, 브라우저를 이용한 화면 검증까지 진행했습니다.

현재는 검증 과정에서 발견된 일부 UI 문제를 수정하는 단계입니다.

아직 실제 사진을 인식하고 레시피를 생성하는 API는 연결하지 않았으며, 이후 실제 데이터를 활용한 테스트가 필요합니다.

2. 배운 점

① 기획과 화면 설계가 구체적일수록 구현 과정이 수월해진다.

처음에는 화면만 어느 정도 설계하면 구현할 수 있을 거라 생각했는데, 실제로는 버튼을 눌렀을 때의 동작이나 데이터가 없는 경우처럼 생각해야 할 부분이 많았습니다.

AI가 코드를 대신 작성해 주더라도 무엇을 만들고 어떤 기준으로 동작해야 하는지는 사람이 결정해야 한다는 걸 느꼈습니다.

② 기능이 정상 작동하는 것과 디자인이 의도대로 구현되는 것은 별개다.

자동 테스트가 모두 통과했지만, 실제 화면에서는 버튼 색상이 다르거나 입력 영역이 가려지는 문제가 발견됐습니다.

그래서 자동 검증뿐 아니라 실제 화면을 직접 확인하는 과정도 중요하다는 걸 알게 됐습니다.

③ AI에게 작업을 맡기는 것만큼 결과를 검토하는 능력도 중요하다.

개발 경험이 없어도 서비스를 구현할 수 있다는 점은 좋았지만, 만들어진 결과물이 적절한지는 결국 직접 판단해야 했습니다.

특히 화면 구조나 사용 흐름을 검토하면서 직접 사용해 보는 관점에서 결과물을 판단하는 과정이 중요하다는 걸 느꼈습니다.

함께 이야기해요 0

로그인하고 댓글을 남겨 주세요

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기