먼저 이 지도로 큰 흐름을 잡고, 위 탭을 다음 →으로 넘기며 단계별 설명과 용어사전을 펼쳐 보세요. 지도의 박스나 카드의 용어 칩을 누르면 관련 설명으로 바로 이동해요.
| PoC (개념 증명) | 프로토타입 | MVP | |
|---|---|---|---|
| 답하려는 질문 | "기술적으로 되나?" | "이 흐름이 쓸 만한가?" | "시장이 원하나?" |
| 형태 | 실험 코드·스크립트 (버려도 됨) | 동작하는 척하는 화면 모형 | 핵심 기능만 담은 진짜 제품 |
| 보는 사람 | 나 (개발팀) | 나 + 예비 사용자 몇 명 | 실제 사용자 |
| 아이토피 예 | 식약처 API로 성분 조회 성공률 실험 (지금!) | 와이어프레임을 클릭되게 만든 화면 | 프로필+검색+판정+리스트만 있는 첫 출시판 |
| 네이티브 | 크로스플랫폼 | 하이브리드 | PWA | |
|---|---|---|---|---|
| 만드는 법 | OS 전용 언어 (Kotlin/Swift) | 한 코드로 양쪽 (Flutter, React Native) | 웹으로 만들고 앱 껍데기 | 웹 자체에 앱 기능 부여 |
| 장점 | 성능·기능 최고 | 한 번에 두 OS | 웹 기술 재활용 | 스토어 없이 즉시 배포, 수정 즉시 반영 |
| 약점 | 비용·난이도 최대 | 전용 기술 학습 | 성능 한계 | 일부 기기 기능 제한, iOS 저장 제약 |
| 스토어 등록 | 기본 | 기본 | 가능 | TWA·Capacitor로 감싸면 가능 |
| 프론트엔드 (보이는 곳) | 백엔드 (안 보이는 곳) | |
|---|---|---|
| 비유 | 홀 — 메뉴판·테이블·직원 응대 | 주방 — 재료 창고·조리·레시피 |
| 하는 일 | 화면, 버튼, 입력, 애니메이션 | 데이터 저장, 로그인, 계산, API 제공 |
| 대표 기술 | HTML · CSS · JS · React | 서버, DB(PostgreSQL), 인증 |
| 아이토피 | MVP는 거의 전부 프론트 (기기 저장) | S4에서 Supabase 도입 시 시작 |
| 것 | 한 줄 비유 | 예시 |
|---|---|---|
| 라이브러리 | 필요할 때 꺼내 쓰는 부품 상자 — 주도권은 내 코드 | React |
| 프레임워크 | 규칙이 정해진 조립 키트(뼈대) — 주도권은 틀 | Next.js |
| SDK | 특정 플랫폼용 공구 세트 (라이브러리+문서+도구) | 안드로이드 SDK |
| API | 프로그램끼리 말 거는 창구(주문 창구) | 식약처 공공 API |
| 개발 (Dev) | 스테이징 (Staging) | 프로덕션 (Production) | |
|---|---|---|---|
| 비유 | 연습실 | 최종 리허설 무대 | 본 공연 |
| 누가 보나 | 나만 (localhost) | 팀·테스터 (미리보기 주소) | 실제 사용자 전원 |
| Vercel에선 | 내 컴퓨터 실행 | Preview 배포 (브랜치마다 자동) | Production 배포 (본선 머지 시) |
| 단계 | 대상 | 목적 | 참고 |
|---|---|---|---|
| 알파 | 나·내부 사람 | 큰 버그 잡기 | 깨져도 되는 단계 |
| 비공개 베타 | 초대한 소수 | 실사용 피드백 | 구글 신규 개인 계정: 테스터 12명×14일 의무 [2026 기준, 변동 가능] |
| 공개 베타 | 원하는 누구나 | 규모 검증 | 스토어 '테스트 참여' 노출 |
| 정식 출시 | 전체 공개 | 본 운영 | 심사 통과 후 스토어 등재 |
| 지표 | 뜻 | 아이토피라면 |
|---|---|---|
| DAU / WAU / MAU | 하루/주/월 실사용자 수 | 월간 몇 가족이 쓰나 |
| 리텐션 | 다시 돌아오는 비율 (생존의 핵심) | 주 1회 재사용률 = 북극성 지표 ★ |
| 이탈률 (Churn) | 떠나는 비율 (리텐션의 반대) | 2주째 안 여는 가족 비율 |
| 퍼널 | 목표까지 단계별 생존율 (깔때기) | 검색 → 판정 도달률 |
| 전환율 | 원하는 행동을 한 비율 | 판정 후 리스트 저장 비율 |
막힘 AI에게 GitHub 저장소를 만들라고 하니 권한 거부(403)로 실패.
해결 사람이 GitHub 홈페이지에서 1분 만에 직접 만들고 "만들었어"라고 알려줌 → AI가 바로 이어서 작업.
배움 계정·권한이 필요한 일은 사람 몫. 나머지는 전부 AI가 한다 — 역할을 나누면 안 막힌다.
막힘 새 앱(바코가이드) 첫 화면이 이전 앱(사가미하라) 스타일로 나와 반려.
해결 "내 드라이브의 이 자료를 학습해서 그걸 근간으로 만들어" — 견본을 주는 지시로 손그림 UI 완성.
배움 원하는 결과물의 견본(예시)을 주는 지시가 가장 강력하다.
막힘 번역기 남/여 음성을 서버로 내보내려 5가지 방법을 시도 — 연결 불가·유료화로 전부 막힘.
해결 사람이 목표를 바꿔줌: "성별 옵션 빼고, 자연스러운 대화체만" → 한 번에 해결.
배움 기술이 계속 막히면 기능을 고집하지 말고 목표를 다시 정하기(피벗).
막힘 v2.9 다음을 v2.10, v2.11…로 8번 연속 오표기(규칙: v2.9 다음은 v3.0).
해결 사람이 발견해 "규칙 위반, 정정해" → 나아가 버전 올리는 전용 스크립트를 만들게 해서 실수 자체가 불가능해짐.
배움 반복 실수는 "조심하자"가 아니라 "실수 못 하게 만드는 장치를 만들어줘"라고 시키기.
막힘 스플래시를 하트→지브리풍→넷플릭스풍→크림톤… 만들 때마다 "이게 아닌데"의 반복.
해결 이후 관례 확립: "후보 시안 2~3개를 그림으로 먼저 보여줘, 고르면 만들자".
배움 큰 디자인은 구현 전에 시안부터 확정 — 총 시간이 훨씬 적게 든다.
막힘 악보 이미지가 AI 화면에선 멀쩡한데 사용자 폰에서만 안 뜸.
해결 사용자가 증상을 제보 → 원인 발견: 남의 사이트 이미지 직접 링크(핫링크)는 차단됨 → 내 저장소에 옮겨 해결.
배움 AI가 못 보는 문제는 사용자 실기기의 제보(스크린샷)가 진단의 열쇠.
막힘 파일이 생기기 전에 요청된 "404(없음)" 응답이 캐시에 박제돼, 올린 뒤에도 계속 안 뜸.
해결 주소 뒤에 ?v=버전을 붙여 새 주소로 요청 → 캐시 무력화, 즉시 표시.
배움 주소가 바뀌면 캐시는 무력화된다. 처음부터 붙이면 이 함정 자체가 안 생김.
막힘 코드를 올려도(push) 자동 배포가 반응 없음.
해결 내용 없는 빈 커밋을 한 번 더 push해 배포를 재시동.
배움 자동화도 가끔 멈춘다 — 콕 찔러주는 방법을 알아두면 당황하지 않는다.
막힘 보안 정책 때문에 AI 작업 환경에서 배포된 사이트·외부 자료에 접근 불가(403).
해결 ① 라이브 확인은 사용자 폰으로 분담 ② 접근 가능한 서버(수파베이스 함수)가 대신 접속해서 결과만 받아오는 우회 개발.
배움 내가 못 가는 곳은 갈 수 있는 친구(서버)에게 부탁한다.
막힘 문장 끝에 마침표가 없으면 구글 번역이 뒷절을 통째로 삭제하는 버그.
해결 번역 전에 몰래 마침표를 붙였다가, 결과에서 다시 떼는 트릭.
배움 버그의 원인을 알면 입력을 살짝 바꿔 피해 갈 수 있다.
막힘 출발까지 남은 날(D-day)이 위젯마다 D-50, D-49로 제각각 — 계산식이 두 개였음.
해결 계산 함수를 하나만 두고 모든 화면이 그걸 쓰게 통일.
배움 같은 값은 한 곳에서만 계산한다 — 프로그래밍의 황금률.
막힘 수험 노트를 글자로 옮기니(OCR) 원문이 왜곡됨 — 시험 앱이라 오타는 치명적.
해결 옮겨 적기를 포기하고 원본 스캔 이미지를 그대로 보여주는 방식으로 전환.
배움 정확성이 생명이면 변환하지 말고 원본을 보여주기.