2-2. 로직 & 데이터 저장
화면과 CRUD를 갖췄다면, 이제 앱에 '기억'과 '똑똑함'을 넣을 차례입니다. 새로고침해도 데이터가 살아남게 하고, 달성률을 스스로 계산해 게이지 바로 보여주고, 막혔을 때 오작동을 정확히 신고하는 법까지 — 진짜 도구로 거듭나는 마지막 단계를 함께 밟아봅니다.
1. 3단계 — 영속성(LocalStorage)으로 '기억' 부여하기
여기서 거의 모든 초보자가 똑같은 충격을 받습니다. 열심히 습관을 추가하고 체크했는데, 새로고침(F5) 한 번에 전부 사라지는 것이죠. 당황하지 마세요. 버그가 아니라 원래 그렇게 동작하는 것이 정상입니다. 지금까지 데이터는 컴퓨터의 임시 기억 공간에만 있었고, 페이지를 다시 그리는 순간 그 기억은 초기화되기 때문입니다.
이걸 해결하는 도구가 LocalStorage입니다. LocalStorage란 브라우저가 내 컴퓨터 안에 마련해 둔 작은 메모장이라고 생각하면 됩니다. 여기에 데이터를 적어 두면 브라우저를 껐다 켜도 그 내용이 남아 있습니다. 우리 데이터가 브라우저에 기억될 수 있도록 에이전트에게 다음과 같이 추가 요건을 피드백합니다.
"방금 만든 습관 목록 데이터와 완료 체크 데이터가 브라우저를 껐다 켜도 날아가지 않게 LocalStorage 연동 코드를 추가해줘. 페이지가 처음 켜질 때 저장된 데이터가 있으면 화면에 알아서 그려주도록 해줘."
💡 성공하면 이런 화면이 보입니다: 습관 몇 개를 추가하고 체크한 뒤 브라우저를 완전히 껐다가 다시 열어 보세요(또는 새로고침). 방금 입력한 습관과 체크 상태가 그대로 살아 있으면 성공입니다. 이제 여러분의 앱은 '기억'을 갖게 되었고, 매일 켜는 진짜 도구가 되었습니다.
★ 테스트할 때 시크릿/Incognito 창은 피하세요: LocalStorage 연동을 분명히 했는데도 "새로고침하면 또 다 날아가요"라고 호소하는 분들이 있습니다. 원인은 대부분 시크릿(크롬은 Incognito, 사파리는 개인정보 보호) 창에서 테스트한 경우입니다. 시크릿 창은 창을 닫는 순간 LocalStorage를 일부러 비우도록 설계되어 있어서, 코드가 멀쩡해도 데이터가 유지되지 않습니다. 영속성 테스트는 반드시 일반(보통) 브라우저 창에서 하세요. 일반 창에서 새로고침했는데도 날아간다면, 그때 비로소 진짜 버그를 의심하면 됩니다.
2. 비즈니스 로직 확장 — 달성률과 실시간 게이지 바
마지막은 '계산'을 넣어 앱을 똑똑하게 만드는 단계입니다. 사람이 매번 "이번 주에 며칠 했더라" 세는 대신, 앱이 알아서 달성률을 계산해 보여 주게 하는 것이죠. 계산의 핵심은 딱 한 줄로 표현됩니다.
// 달성률 계산 (에이전트가 짜 줄 코드의 핵심 한 줄)
const completionRate = Math.round((completedDays / 7) * 100);
★ 이 코드를 어디에 붙여넣어야 하나요? — 아무 데도 붙여넣지 않습니다. 이 강의에서 여러분은 코드를 직접 타이핑하지 않습니다. 이 한 줄을 여기 적어 둔 이유는 붙여넣기 위해서가 아니라, 에이전트가 짜 준 코드를 '읽고 검증할 줄 알게' 하기 위해서입니다. 나중에 게이지 바가 안 움직일 때, 이 줄을 읽어 본 사람은 "아,
completedDays가 안 늘어나는 거구나"라고 원인을 콕 집어 말할 수 있고, 그렇지 못한 사람은 "이상해요"밖에 말하지 못합니다. 그 차이가 곧 실력입니다.
이 한 줄을 풀어 읽으면 이렇습니다. completedDays(이번 주 체크된 날 수)를 7로 나눠 비율을 구하고, 거기에 100을 곱해 퍼센트로 바꾼 뒤, Math.round로 소수점을 반올림해 깔끔한 정수로 만듭니다. 예를 들어 7일 중 5일을 했다면 5÷7×100 = 71.4...가 되고, 반올림하면 71%가 됩니다.
그런데 가장 중요한 질문이 남았습니다. 그 completedDays(체크된 날 수)는 누가, 어떻게 채워 넣을까요? 여러분이 직접 입력하는 숫자가 아닙니다. 바로 그 습관 줄에 있는 7개의 요일 체크박스 중 '켜진(체크된)' 동그라미의 개수입니다. 월·수·목 세 개를 켰다면 completedDays는 자동으로 3이 됩니다. 즉, 동그라미를 누르는 행동 하나하나가 곧 이 숫자를 만드는 재료인 셈입니다. 이 연결고리를 머릿속에 그려 두는 것이 핵심입니다.
이 네 칸이 톱니바퀴처럼 맞물려 끊김 없이 돌아갈 때, 우리는 게이지 바가 '실시간으로' 움직인다고 말합니다. 반대로 동그라미를 눌렀는데 막대가 안 움직인다면, 이 사슬 중 어느 한 칸의 연결이 끊긴 것입니다(예: 클릭은 되는데 '다시 셈/다시 그림'이 호출되지 않음). 어디가 끊겼는지 정확히 짚는 방법은 바로 아래 3번 '4칸 버그 신고 템플릿'에서 다룹니다. 지금은 이 사슬이 한 번에 완성되도록, 단순한 숫자가 아니라 눈에 보이는 막대 그래프(게이지 바)로 실시간으로 차오르게 만들어 달라고 요청해 봅시다. 게이지 바는 달성률이 높을수록 길게 채워지는 가로 막대입니다.
"각 습관마다 이번 주 달성률을 'completedDays / 7 × 100' 공식으로 계산해서, '이번 주 달성률 71%' 같은 텍스트와 그 옆에 가로 게이지 바를 보여줘. 체크박스를 클릭해서 상태가 바뀔 때마다 이 숫자와 게이지 바가 실시간으로 다시 계산되어 움직이게 해줘. 게이지 바 색은 바이올렛으로 하고, 채워지는 애니메이션을 부드럽게 넣어줘."
💡 성공하면 이런 화면이 보입니다: 각 습관 줄에 "이번 주 달성률 71%" 같은 글자와 그 비율만큼 채워진 바이올렛 막대가 나타납니다. 체크박스를 하나 더 누르는 순간, 숫자가 바뀌고 막대가 스르륵 늘어나거나 줄어듭니다. 이것이 바로 데이터 → 로직 → 화면이 살아 움직이는 '비즈니스 로직'의 실체입니다.
3. 막히면 이렇게 — '오작동을 정확히 묘사하는 법'
대화식 빌드를 하다 보면 반드시 한 번은 막힙니다. 버튼이 안 눌리거나, 게이지 바가 안 움직이거나, 새로고침하면 또 데이터가 날아갈 수 있습니다. 이때 "안 돼요", "이상해요"라고만 말하면 에이전트는 무엇을 고쳐야 할지 모릅니다. 좋은 디버깅(=오류를 찾아 고치는 일)의 90%는 증상을 정확히 묘사하는 것에서 끝납니다. 다음 4칸 템플릿을 그대로 채워서 에이전트에게 전달해 보세요.
무엇을 했는가: "습관을 3개 추가하고 그중 하나의 월요일 체크박스를 클릭했어."
기대한 결과: "달성률 숫자가 14%로 바뀌고 게이지 바가 조금 차오를 거라고 기대했어."
실제 결과: "그런데 숫자는 0% 그대로이고 게이지 바도 전혀 안 움직여."
에러 메시지: "키보드 F12를 눌러 개발자 도구의 Console 탭을 봤더니 빨간 글씨로 'XXX is not defined'라고 떠 있어." (없으면 "에러 메시지는 없어"라고 적기)
"버그 신고할게. 1) 습관을 3개 추가하고 하나의 월요일 체크박스를 클릭했어. 2) 달성률이 14%로 바뀌길 기대했어. 3) 그런데 숫자가 0% 그대로이고 게이지 바도 안 움직여. 4) F12 콘솔에는 빨간 글씨로 '...'라고 떠 있어. 원인을 찾아서 고쳐줘."
💡 콘솔(Console) 여는 법: 브라우저 화면에서 키보드
F12(Mac은Cmd+Option+J)를 누르면 개발자 도구가 열립니다. 위쪽 탭에서 Console을 클릭하면, 코드가 멈춘 이유가 보통 빨간 글씨로 적혀 있습니다.
그런데 콘솔을 처음 열면 글씨가 여러 줄, 여러 색으로 잔뜩 떠 있어서 "이 중에 뭘 복사해야 하지?" 하고 막힙니다. 색과 줄만 구분할 줄 알면 됩니다.
| 색 | 뜻 | 어떻게 할까 |
|---|---|---|
| 🔴 빨강 (Error) | 코드가 진짜 멈춘 진짜 문제 | 이것만 복사하세요. 범인은 거의 항상 빨간 줄입니다. |
| 🟡 노랑 (Warning) | "이건 좀 그렇지만 일단 돌아감" 정도의 잔소리 | 대부분 무시해도 됩니다. 앱이 멈춘 원인이 아닙니다. |
빨간 에러는 보통 이렇게 생겼습니다. 맨 윗줄에 메시지가 있고(예: Uncaught ReferenceError: renderHabits is not defined), 그 줄 오른쪽 끝에 파란 글씨로 app.js:42처럼 '파일명:줄번호'가 적혀 있습니다. 그 아래로는 회색 글씨 at ...가 여러 줄 이어지는데(이걸 '스택 트레이스'라고 부릅니다), 여기는 복사하지 않아도 됩니다.
💡 어디까지 복사할까 — 딱 두 가지: ① 빨간 메시지 맨 윗줄(예:
XXX is not defined)과 ② 그 옆 파란파일명:줄번호. 이 두 가지만 그대로 복사해 3번 템플릿의 4번 칸에 붙여넣으면 충분합니다. 회색at ...줄까지 다 긁어 와도 틀리진 않지만, 핵심은 맨 윗줄 한 줄이라는 걸 기억하세요. 빨간 줄이 아예 없다면 망설이지 말고 "에러 메시지는 없어"라고 적으면 됩니다 — 그것도 중요한 단서입니다.
4. 오늘의 미션
💡 여기까지 왔다면 미션 2의 절반은 끝났습니다: 데이터·로직·영속성이 도는 '작동하는' 습관 트래커가 완성됐어요. 다만 최종 제출은 다음 클립(2-3)에서 UI/UX까지 다듬은 뒤에 합니다. 지금은 새로고침해도 데이터가 살아남는지만 확인하고 넘어가세요.
오늘 우리가 한 줄의 코드도 직접 타이핑하지 않았다는 사실에 주목하세요. 그럼에도 작동하는 앱이 나온 이유는 데이터 모델을 미리 그리고, 마일스톤을 쪼개고, 요구사항을 구체적으로 묘사하고, 오작동을 정확히 신고했기 때문입니다. AI 시대의 진짜 실력은 코드 문법이 아니라 '무엇을 어떤 순서로 만들지 설계하는 의도와 기획'입니다. 도구는 계속 바뀌어도, 이 기획력은 어떤 에이전트에서도 그대로 통합니다.