31. 다음 프로젝트와 도움이 필요한 순간
이번에 배운 것을 돌아보기
이 책에서 만든 것은 작은 소개 페이지와 링크 모음입니다. 하지만 배운 과정은 다른 주제에도 쓸 수 있습니다. 누가 무엇을 하려는지 정하고, 필요한 내용을 설명하고, 결과를 확인하고, 잘 작동한 상태를 보관하는 순서입니다.
다음 프로젝트를 정할 때 새로운 기술 이름부터 모을 필요는 없습니다. 내가 반복해서 겪는 작은 불편을 찾아 한 문장으로 적습니다. ‘모임 자료가 여러 채팅방에 흩어져 있어 찾기 어렵다’면 필요한 것은 우선 목록과 검색일 수 있습니다. 모든 사람의 계정과 실시간 알림까지 처음부터 필요한 것은 아닙니다.
기능 하나를 더할 때 달라지는 것
한 브라우저에서 쓰던 목록을 여러 기기에서 쓰려면 자료를 공유할 공간이 필요합니다. 여러 사람이 각자의 비공개 목록을 쓰려면 사용자를 확인하고 다른 사람의 자료에 접근하지 못하게 해야 합니다. 로그인 화면은 그 과정의 일부이며, 화면만 만들었다고 보호가 완성되지 않습니다.
Supabase 같은 서비스가 데이터베이스와 인증 기능을 제공하더라도, 어떤 사용자가 어떤 자료를 읽고 바꾸는지는 따로 정해야 합니다. 서비스를 연결했다는 사실이 설계와 확인을 대신하지 않습니다. 이번 책에서 이름과 역할을 먼저 구분한 이유이기도 합니다.
혼자 판단하기 어려운 범위
실제 결제, 민감한 개인정보, 여러 사용자의 접근 권한, 중요한 자료의 삭제와 복구처럼 잘못되었을 때 영향이 큰 기능은 경험 있는 사람의 검토가 필요할 수 있습니다. 이때 도움을 받는 것은 배우는 데 실패했다는 뜻이 아닙니다. 확인해야 할 범위가 달라졌다는 뜻입니다.
도움을 요청할 때는 아이디어만 길게 설명하기보다 현재 작동하는 것, 원하는 변화, 자료의 종류, 실제 사용자를 정리합니다. 오류라면 발생 순서와 메시지도 함께 전달합니다. 개인정보와 비밀값은 제외합니다. AI에게도 같은 방식으로 설명하면 질문의 범위가 분명해집니다.
다음 첫 버전의 크기
다음 프로젝트에서도 첫 버전을 작게 정합니다. 행사 안내라면 일정과 장소와 신청 링크, 독서 기록이라면 책 제목과 짧은 메모부터 시작할 수 있습니다. 멋진 완성 그림이 있더라도 처음 확인할 행동은 하나나 둘로 줄입니다.
새 기능을 요청하기 전에는 무엇을 그대로 둘지 함께 적습니다. 잘되던 검색을 유지하면서 분류만 더하는 식입니다. 변경 뒤 확인할 기준과 되돌아갈 상태를 남기면 규모가 조금 커져도 작업 흐름을 잃지 않습니다.
앞으로의 배움
코드가 궁금해지면 내가 만든 작은 페이지의 한 부분부터 설명해 달라고 할 수 있습니다. 글과 동작이 어떻게 연결되는지 알아보는 것이 목적 없는 문법 암기보다 자신의 질문에 가까울 수 있습니다. 스마트폰 앱을 만들고 싶다면 설치와 기기 기능, 배포 방식처럼 웹과 달라지는 주제를 별도로 배웁니다.
이 책의 끝에서 중요한 것은 모든 서비스를 아는 것이 아니라, 작은 것을 만들고 무엇을 확인해야 하는지 아는 것입니다. 완성한 결과와 확인한 범위를 자기 말로 설명할 수 있다면 다음 작업을 시작할 기준을 갖춘 것입니다.
여러 사람에게 쓰게 하기 전에
나 혼자 예시 자료로 쓸 때와 다른 사람이 실제 자료를 넣는 상황은 다릅니다. 자료가 사라졌을 때 어떻게 안내할지, 누가 접근할 수 있는지, 문의를 받으면 어떻게 대응할지를 생각해야 합니다. 작동하는 화면이 있다는 것만으로 운영 준비가 모두 끝난 것은 아닙니다.
특히 서로 다른 사람의 비공개 자료를 다루면 사용자 구분과 접근 확인이 중요해집니다. 내 화면에서 내 자료만 보이는 것뿐 아니라, 다른 사람의 자료를 임의로 볼 수 없는지도 검토해야 합니다. 이런 범위는 경험 있는 사람의 확인을 받는 것이 필요할 수 있습니다. 도움을 요청할 때 어떤 자료를 누가 쓰는지 먼저 설명합니다.
다음 프로젝트를 정하거나 도움받을 때
도움을 요청할 때 남겨 둘 설명
다음 프로젝트가 막혔을 때는 ‘처음부터 전부 봐 주세요’보다 현재 범위를 짧게 정리한 설명이 유용합니다. 누구를 위한 것인지, 지금 되는 기능 세 가지, 안 되는 행동 하나, 그 행동을 확인한 환경을 적습니다. 이렇게 정리하는 동안 문제를 더 작게 나눌 수 있고, 도움을 주는 사람도 무엇부터 봐야 할지 알 수 있습니다.
만약 앞으로 여러 사람이 쓸 예정이라면 그 사실을 처음부터 함께 말합니다. 나 혼자 예시 자료로 쓰는 도구와 실제 고객의 자료를 받는 서비스는 같은 화면을 가졌어도 검토할 내용이 다릅니다. 첫 버전에서 무엇을 하지 않았는지 알고 있으면 확장할 때 빠진 부분을 더 정확히 질문할 수 있습니다. 완성한 작은 결과는 다음 작업의 출발점이지, 모든 범위를 이미 해결했다는 증명은 아닙니다.
같은 주제로 다음 단계를 정하기
링크 모음을 완성한 뒤 곧바로 전혀 다른 큰 앱을 만들 필요는 없습니다. 지금 쓰면서 자주 느끼는 불편 하나를 골라 개선할 수 있습니다. 이름을 잘못 적었을 때 고치고 싶다면 항목 수정 기능, 자주 보는 링크를 먼저 보고 싶다면 순서나 즐겨찾기를 생각할 수 있습니다. 실제 사용에서 생긴 필요를 기준으로 고릅니다.
이때도 새 기능이 저장 자료에 어떤 영향을 주는지 봅니다. 항목 이름만 고치는지, 자료 형식에 새 값이 생기는지, 이전 자료도 계속 읽을 수 있는지 질문합니다. 이미 만든 기능을 잘 유지하면서 확장하는 일이 새로운 화면을 그리는 것보다 중요할 수 있습니다.
AI에게 설명을 배우는 방법
완성한 코드가 궁금하다면 전체를 한 번에 해설해 달라고 하기보다 내가 방금 사용한 동작 하나를 골라 볼 수 있습니다. ‘검색어를 지웠을 때 전체 목록이 나오는 부분을 쉬운 말로 설명해 줘’처럼 묻습니다. 실제 화면의 행동과 코드의 역할을 연결하면 낯선 내용도 질문의 맥락이 생깁니다.
설명을 들었다면 내가 이해한 말로 다시 정리해 볼 수 있습니다. 단어를 그대로 외우는 것보다 어떤 입력에서 어떤 변화가 일어나는지 설명하는 데 집중합니다. 이해되지 않는 부분은 더 작은 예를 요청할 수 있습니다. 처음부터 모든 언어 문법을 배우는 계획으로 확대하지 않아도 됩니다.
새로운 도구로 옮길 때 가져갈 것
다른 AI 도구를 시험하거나 다른 공개 서비스를 사용할 때는 현재 결과 파일과 프로젝트 목적, 확인 상태를 가져갈 수 있습니다. 계정과 서비스 연결이 자동으로 옮겨지는 것은 아닐 수 있습니다. 새 환경에서 미리보기와 보관, 공개 방식이 어떻게 되는지 다시 확인합니다.
옮긴 뒤에는 기존 결과와 같은지 대표 행동을 시험합니다. 소개글과 링크, 검색과 저장 같은 핵심입니다. 화면이 비슷하다는 이유만으로 모든 동작도 같다고 가정하지 않습니다. 도구는 바뀌어도 내가 확인할 기준이 있으면 작업을 이어 가기 쉽습니다.
“다음에는 코딩 문법부터 공부해야 하나요?”
어떤 결과를 만들고 싶은지에 따라 필요한 배움이 달라집니다. 지금 만든 페이지의 동작이 궁금하다면 그 부분의 코드를 읽는 데서 시작할 수 있습니다. 여러 사람의 자료를 다루고 싶다면 보관과 권한의 원리를 더 알아야 할 수 있습니다. 모든 문법을 먼저 끝낸 뒤에만 다음 작업을 할 수 있는 것은 아닙니다.
반대로 계속 AI에게만 부탁하면서 기본 원리를 전혀 묻지 않으면 결과를 판단하기 어려운 순간이 올 수 있습니다. 그때는 막힌 기능을 작은 예로 줄여 설명을 듣고 실제 동작과 연결해 보는 것이 도움이 됩니다. 무엇이 필요한지 모른 채 공부 목록을 무작정 늘리는 것보다 자신의 질문을 기준으로 삼습니다.
스마트폰 앱으로 넘어간다면 설치, 기기 기능, 권한, 배포 방식처럼 새로운 주제가 생깁니다. 웹페이지에서 배운 것을 그대로 적용할 수 있는 부분과 새로 확인해야 할 부분을 구분합니다. 첫 책에서 익힌 목적·범위·요청·확인·보관의 흐름은 그다음 배움에도 기준으로 남습니다.
꼭 기억하세요
다음 프로젝트도 작은 목적에서 시작합니다. 자료와 사용자의 범위가 커지면 필요한 도움과 검증도 함께 늘립니다.