CH02 · 재미있는 웹앱 만들기

2-1. 기획 · 데이터 설계

설명 영상이 챕터를 영상으로 먼저 훑어보세요 · 6분 2초

멋진 도구는 코드가 아니라 '설계'에서 시작됩니다. 이번 클립에서는 여러분이 만들 습관 트래커가 어떤 정보를 다룰지 그림을 그리고, 큰 목표를 작은 단계로 쪼개고, AI가 길을 잃지 않도록 요구사항을 또렷하게 묘사하는 법을 함께 익힙니다.


1. 왜 '장난감'에서 '쓸모'로 넘어가야 할까요

1장에서 만든 뽀모도로 타이머는 멋졌지만, 사실 장난감에 가깝습니다. 새로고침하면 모든 게 처음으로 돌아가고, 어제 무엇을 했는지 기억하지 못하니까요. 진짜 업무에 쓰이는 웹앱과 장난감을 가르는 경계선은 딱 세 가지입니다. 이 세 가지를 갖추는 순간, 여러분의 결과물은 "신기한 데모"에서 "매일 켜는 도구"로 바뀝니다.

① 데이터 (Data)

앱이 다루는 정보입니다. 습관 트래커라면 "운동하기", "물 마시기" 같은 습관 이름과 요일별 달성 여부가 데이터입니다.

② 로직 (Logic)

데이터를 가지고 무언가를 계산하고 판단하는 규칙입니다. "이번 주 7일 중 5일 했으니 달성률 71%" 같은 계산이 로직입니다.

③ 영속성 (Persistence)

껐다 켜도 데이터가 살아남는 능력입니다. 영속성(=데이터가 사라지지 않고 계속 유지되는 성질)이 없으면 매번 처음부터 다시 입력해야 합니다.

이번 시간의 목표

이 세 가지를 AI 에이전트와 대화하며 한 번에 하나씩 쌓아 올려, 새로고침해도 살아있는 진짜 습관 트래커(Habit Tracker)를 완성합니다.

이 세 가지가 어떻게 맞물려 돌아가는지 그림으로 보면 한눈에 들어옵니다. 사용자가 화면에서 무언가를 하면(데이터 변경) → 로직이 즉시 계산하고 → 화면을 다시 그리고 → 그 결과를 LocalStorage가 붙잡아 둡니다(영속성). 새로고침해도 LocalStorage에서 데이터를 다시 꺼내 와 화면을 복원합니다.

💡 잠깐, LocalStorage가 뭐냐면: 브라우저가 내 컴퓨터 안에 마련해 둔 그 사이트 전용 '작은 메모장'입니다. 보통 자바스크립트 변수는 새로고침 한 번에 전부 사라지지만(임시 기억), LocalStorage에 적어 두면 새로고침은 물론 브라우저를 껐다 켜도 남아 있습니다. 글자(문자열)만 저장돼서 습관 목록 같은 덩어리 데이터는 저장할 때 글자로 바꿨다가 꺼낼 때 되돌리는데, 이 변환 코드는 에이전트가 알아서 짜줍니다. 단, 그 브라우저·그 기기에만 저장돼 다른 사람과는 공유되지 않습니다(그게 필요하면 4-3의 진짜 DB로 갑니다). 실제 저장·복원 붙이는 법은 다음 클립 2-2에서 다룹니다.

데이터 습관 이름 · 요일별 체크 상태
로직 달성률 계산 · 상태 판단
화면 목록 · 체크박스 · 게이지 바
LocalStorage 껐다 켜도 기억 (영속성)

💡 용어 정리: '에이전트'는 내 컴퓨터의 파일을 직접 읽고 쓰고, 터미널(검은 명령 입력 창) 명령까지 대신 실행해 주는 AI 비서입니다. 우리는 코드를 직접 타이핑하는 게 아니라, 한국어 프롬프트(지시문)로 이 비서를 지휘합니다.

2. 요구사항 설계 및 구체화 — 마일스톤을 쪼개세요

복잡한 기능을 구현할 때는 AI에게 한 번에 무리한 지시를 내리기보다는 핵심 기능 위주로 마일스톤을 쪼개어 요청하는 것이 성공률을 높입니다. 왜 그럴까요? 사람도 "집을 통째로 지어줘"라는 말보다 "먼저 기초를 다지고, 그다음 벽을 세우고, 마지막에 지붕을 올려줘"라는 말을 들었을 때 실수 없이 짓습니다. 에이전트도 똑같습니다. 한 단계의 요구가 작고 명확할수록, AI가 중간에 길을 잃지 않고 성공할 확률이 올라갑니다.

1

구조 정의: 화면 레이아웃과 데이터 모델 설계 (습관 항목명, 요일별 달성 여부 등) — 먼저 '뼈대'를 세웁니다.

2

CRUD 로직 구현: 습관을 추가/조회/수정/삭제하고 클릭해서 상태를 바꾸는 핵심 로직 작동 — '움직임'을 넣습니다.

3

영속성 연동: 페이지를 새로고침해도 데이터가 유지되도록 LocalStorage 세이브/로드 추가 — '기억'을 부여합니다.

이 순서가 중요합니다. 뼈대(구조) 없이 움직임(로직)을 만들 수 없고, 움직임 없이 기억(영속성)을 저장할 게 없습니다. 한 단계가 화면에서 제대로 작동하는 것을 두 눈으로 확인한 뒤에 다음 단계를 요청하세요. 이렇게 하면 문제가 생겼을 때 "방금 추가한 그 부분이 원인이구나"라고 범위를 좁힐 수 있습니다.

3. 1단계 — 데이터 모델 정하고 화면 만들기

가장 먼저 정할 것은 데이터 모델입니다. 데이터 모델이란 어렵게 생각할 것 없이, "이 앱이 어떤 정보를 어떤 모양으로 저장할 것인가"를 미리 정해 둔 설계도입니다. 우리 습관 트래커의 데이터 모델은 이렇게 간단합니다.

저장할 정보예시 값설명
습관 이름"아침 스트레칭"사용자가 추가한 습관의 제목
요일별 달성 여부[월✓ 화✗ 수✓ 목✓ 금✗ 토✗ 일✓]7개의 체크박스 상태(켜짐/꺼짐)
달성률57%7일 중 체크된 날의 비율(로직으로 계산)

이 설계도를 머릿속에 그린 채로, 에이전트에게 화면과 데이터 구조를 만들어 달라고 요청할 차례입니다. 그 전에, 1-1의 설치를 마쳤다면 1장의 다른 내용을 잠시 잊었거나 건너뛰셨더라도 여기서부터 그대로 따라오기만 하면 출발점에 설 수 있도록 환경 준비 단계를 한 번 더 짚고 가겠습니다. 핵심은 단 하나, "오늘 만들 앱만 담을 빈 폴더 하나를 새로 만들고, 터미널의 위치를 그 폴더로 옮긴 뒤 에이전트를 깨운다"입니다.

💡 먼저 확인 — 아직 설치를 안 했다면: 아래 claude는 Claude Code(또는 codex·agy)가 이미 설치돼 있어야 동작합니다. 설치가 안 됐다면 이 명령은 command not found(명령을 찾을 수 없음)라고만 뜹니다. 그런 경우 먼저 1-1로 돌아가 설치를 마치고 오세요. 설치 여부가 헷갈린다면, 터미널에 node -v를 입력해 Node.js(에이전트 설치에 필요)가 깔려 있는지부터 확인하세요. v20.x.x처럼 버전 숫자가 보이면 준비된 것이고, command not found가 뜨면 1-1의 안내대로 Node.js LTS부터 설치하면 됩니다.

💡 1장 복습 — 새 폴더에서 에이전트 깨우기: 터미널(검은 명령 입력 창)을 열고 아래 세 줄을 한 줄씩 입력하세요. mkdir은 새 폴더(=디렉터리)를 만들고, cd는 터미널의 현재 위치를 그 폴더 안으로 옮기는 명령입니다.

# 1) 'habit-tracker'라는 빈 폴더를 새로 만든다
mkdir habit-tracker

# 2) 터미널의 위치를 방금 만든 폴더 안으로 옮긴다
cd habit-tracker

# 3) 그 폴더 안에서 에이전트를 깨운다
claude

💡 그 폴더는 어디에 생기나요? 다음 날엔 어떻게 다시 들어가나요: 터미널을 처음 열면 보통 여러분의 홈 폴더(Mac은 /Users/내이름, Windows는 C:\Users\내이름)에 들어가 있습니다. 그래서 위치를 바꾸지 않은 채 mkdir habit-tracker를 하면 홈 폴더 안에 habit-tracker 폴더가 생깁니다. 내일 다시 작업할 때는 터미널을 새로 열고 cd habit-tracker 한 줄로 그 폴더로 들어간 뒤(이미 만든 폴더이니 mkdir은 다시 하지 마세요) claude를 입력하면 됩니다. 지금 내 위치가 헷갈리면 pwd(현재 폴더 경로 보기)로, 이 폴더에 무슨 파일이 있는지는 ls로 확인할 수 있습니다.

claude를 입력하면, 처음 한 번은 브라우저에 로그인 창이 자동으로 뜹니다. 본인 계정으로 로그인하면 터미널로 돌아왔을 때 한국어를 입력할 수 있는 프롬프트 줄(보통 > 모양)이 나타납니다. 여기에 글을 쓰면 그게 곧 에이전트에게 내리는 지시입니다. (Codex는 codex, Antigravity CLI는 agy로 깨웁니다 — 어떤 터미널 에이전트든 "빈 폴더 만들기 → 그 안으로 이동 → 실행 → 로그인"이라는 원리는 똑같습니다.) 이제 아래 프롬프트를 그대로 붙여넣어 보세요.

"습관 트래커 웹앱을 만들고 싶어. 먼저 화면 상단에 '새 습관 추가' 입력창이 있고, 아래에 습관 리스트가 보여야 해. 각 습관마다 월요일부터 일요일까지 7개의 체크박스 동그라미가 있어서, 완료 여부를 토글할 수 있게 짜줘. 메인 파일 이름은 반드시 소문자 index.html로 만들어줘. 디자인은 깔끔한 연한 회색/흰색 배경에 바이올렛 포인트 컬러로 해줘."

💡 성공하면 이런 화면이 보입니다: 에이전트가 파일을 만들고(메인 파일은 소문자 index.html), 터미널에 어떤 파일을 생성했는지 요약해 줍니다. 미리보기는 같은 폴더에서 npx live-server를 입력하면 됩니다(처음엔 설치할지 물어보는데 Enter로 진행). 잠시 뒤 기본 브라우저가 자동으로 열리며 http://127.0.0.1:8080(또는 localhost:8080) 주소에 화면이 뜹니다. 상단에 입력창 하나, 그 아래 (비어 있거나 예시) 습관 목록, 각 줄마다 7개의 동그라미가 보이고, 동그라미를 클릭하면 색이 채워졌다 비워졌다 합니다.

💡 미리보기가 안 뜨거나 화면이 하얗게(백지) 나올 때: 자동으로 브라우저가 안 열리면 직접 주소창에 localhost:8080을 입력하세요. 화면이 백지라면 십중팔구 두 가지 중 하나입니다. (1) 메인 파일 이름이 소문자 index.html이 아닌 경우(Index.html·main.html이면 live-server가 못 찾습니다), (2) 에이전트가 코드를 index.html·style.css·app.js 여러 파일로 나눠 만들었는데 이 파일들이 같은 폴더 안에 함께 있지 않은 경우입니다. 여러 파일로 나뉘었더라도 live-server로 여는 것은 언제나 index.html 하나이며(나머지는 index.html이 알아서 불러옵니다), 세 파일이 같은 폴더에 있기만 하면 됩니다. 에이전트에게 "메인 파일을 소문자 index.html로 하고, 모든 파일을 같은 폴더에 넣어줘"라고 한마디 덧붙이면 깔끔합니다.

4. '모호한 지시'와 '구체적인 지시'의 결정적 차이

여기가 이 강의 전체를 통틀어 가장 중요한 한 장면입니다. 똑같은 AI에게 똑같은 앱을 부탁해도, 어떻게 말하느냐에 따라 결과물이 하늘과 땅 차이로 갈립니다. 코딩 실력이란 결국 '원하는 것을 빠짐없이 묘사하는 능력'입니다.

❌ 모호한 지시

"습관 앱 만들어줘"

  • 화면이 어떻게 생겨야 하는지 정보가 없어 AI가 제멋대로 추측합니다.
  • 달력형으로 줄지, 리스트형으로 줄지, 영어로 줄지 매번 결과가 달라집니다.
  • "이게 아닌데..."를 반복하며 시간을 허비하게 됩니다.
  • 고치고 싶어도 무엇을 어떻게 바꿔야 할지 막막합니다.
✓ 구체적인 지시

"상단 입력창 + 7개 체크박스 + 바이올렛 컬러"

  • 레이아웃: 상단 입력창, 하단 습관 리스트.
  • 데이터: 습관마다 월~일 7개 체크박스.
  • 인터랙션: 클릭하면 완료 여부가 토글.
  • 스타일: 연회색/흰색 배경 + 바이올렛 포인트.

구체적인 지시에는 레이아웃(어디에 무엇이) · 데이터(무엇을 다루는가) · 인터랙션(누르면 어떻게 되는가) · 스타일(어떤 분위기인가) 네 가지가 모두 들어 있습니다. 좋은 프롬프트를 쓰는 비법은 거창하지 않습니다. 머릿속 화면을 마치 옆자리 신입에게 그려서 설명하듯 풀어 쓰면 됩니다. 막막할 땐 이 네 칸을 빈칸 채우듯 채워 보세요.

5. 2단계 — CRUD 로직 완성하기

화면이 만들어졌으니 이제 '움직임'을 넣을 차례입니다. 앱의 핵심 동작은 거의 다 CRUD라는 네 글자로 정리됩니다. CRUD는 데이터를 다루는 네 가지 기본 행동의 머리글자입니다.

C — Create (추가)

새 습관을 입력창에 적고 추가 버튼을 누르면 목록에 한 줄이 생깁니다.

R — Read (조회)

저장된 습관들이 화면 목록에 보입니다. 우리는 이걸 '화면에 그린다'고 표현합니다.

U — Update (수정)

체크박스를 클릭해 달성/미달성 상태를 바꾸거나, 습관 이름을 고칩니다.

D — Delete (삭제)

더 이상 추적하지 않을 습관 옆의 삭제 버튼(🗑️)을 눌러 목록에서 지웁니다.

1단계 프롬프트에서 이미 '추가'와 '체크 토글'은 어느 정도 만들어졌을 겁니다. 부족한 부분(특히 삭제)을 채우도록 다음과 같이 추가 요청을 보냅니다.

"각 습관 항목 오른쪽에 휴지통 모양의 삭제 버튼을 추가해줘. 그 버튼을 누르면 그 습관 한 줄만 목록에서 사라지게 해줘. 그리고 입력창이 비어 있는 상태에서 추가 버튼을 누르면 아무 일도 일어나지 않게(빈 습관이 추가되지 않게) 막아줘."

💡 성공하면 이런 화면이 보입니다: 각 습관 줄 끝에 휴지통 아이콘이 생기고, 클릭하면 그 줄만 깔끔하게 사라집니다. 입력창을 비운 채 추가 버튼을 눌러도 빈 줄이 생기지 않습니다. 이로써 추가·조회·수정·삭제(CRUD)가 모두 완성된 것입니다.

다음 클립
2-2. 로직 & 데이터 저장
이어보기 →