PART 4 · 만든 웹서비스를 Android와 iPhone 앱으로 확장합니다13장

웹서비스를 앱으로 만들기 전에 알아야 할 것들

앱에 넣을 기능과 재사용·보안·완료 기준을 결정합니다.

이어갈 프로젝트 · ai-stock-briefing

12장까지의 서버와 웹서비스가 있습니다.

이번 장의 준비와 서비스

필요한 도구 · 기존 프로젝트 · 설계 문서

이미 준비한 계정과 기능은 그대로 이어갑니다.

아직 Android·iPhone 앱을 구현하거나 불필요한 로그인·알림·권한을 추가하지 않습니다.

순서대로 입력하는 커맨드

현재 단계와 입력 위치를 확인한 뒤 하나씩 복사하세요.

01시작 전 확인

Claude Code·Codex에 입력튜터 요청

현재 장을 시작하거나 다시 이어갈 때

먼저 확인 · 현재 장과 실제 프로젝트를 확인. 기존에 확인한 맥락은 재사용.

13장 시작해.

02기존 프로젝트를 그대로 이어갑니다

Claude Code·Codex에 입력실습

기존 서비스 재사용 조사

먼저 확인 · 12장 서비스와 앱 확장 목적 확인.

기존 `ai-stock-briefing` 프로젝트를 수정하지 말고 먼저 조사해줘.

웹에서 사용 중인 시장·검색·종목·차트·공시·AI 브리핑 가운데 Android와 iPhone에서도 그대로 재사용할 수 있는 것과 새로 필요한 것을 나눠서 설명해줘.

금융위원회·OpenDART·Gemini·Database·Cache를 앱마다 다시 구현하지 않는 방향을 우선해줘.

내부 파일과 데이터 구조를 나열하기보다, 내가 앱의 범위를 결정할 수 있도록 화면·기능·보안 경계로 나눠 쉬운 말로 요약해줘. 아직 구현하지 마.

03세 화면에서 숫자의 의미를 같게 유지합니다

Claude Code·Codex에 입력실습

공통 데이터·품질 계획

먼저 확인 · 독자가 포함·제외 기능과 작은 화면 우선순위를 결정했는지 확인.

Android와 iPhone이 웹과 같은 데이터 의미와 품질 기준을 사용하게 해줘.

가격의 기준일과 단위, DART 원문으로 가는 길, AI 브리핑의 근거·출처·한계가 빠지지 않아야 해.

기존 기능을 최대한 재사용하고, 내부 연결 방식과 데이터 구조는 현재 프로젝트를 조사한 뒤 적절하게 선택해줘.

외부 서비스의 Secret이나 사용자에게 필요 없는 내부 정보는 앱으로 보내지 마. 아직 구현하지 말고 다음 장에서 검증할 계획으로 정리해줘.

04Claude가 계획을 정리하고 다시 확인합니다

Claude Code·Codex에 입력실습

결정한 앱 계획 문서화

먼저 확인 · 앱 목적·범위·화면·권한·완료 기준에 대한 독자 결정 확인.

지금까지 결정한 내용을 다음 Android와 iPhone 작업에서 사용할 짧은 계획으로 정리해줘.

정리한 계획은 대화로만 남기지 말고 프로젝트 안에 문서 파일로 저장해줘.

앱을 만드는 목적, 넣을 기능과 뺄 기능, 스마트폰 화면에서 중요한 순서, 기존 서버 재사용, Secret·개인정보·기기 권한, 공통 완료 조건과 이번에 검증하지 않을 범위를 포함해줘.

기존 프로젝트를 다시 조사해 실제 구현과 모순되는 부분이 없는지도 확인해줘.

내부 API 구조·파일 구성·기술 선택은 Claude가 구현할 때 결정하고 검증할 항목으로 남겨줘. 아직 앱 코드는 만들지 마.

05Claude가 계획을 정리하고 다시 확인합니다

Claude Code·Codex에 입력실습

확인한 계획 Git 기록

먼저 확인 · 계획 검토 결과와 현재 변경 확인.

이번 작업을 마무리해줘.

GitHub에 보내지는 말고 Git 기록까지만 해줘.

06이 장을 마쳤는지 확인합니다

Claude Code·Codex에 입력튜터 요청

이번 장 완료 조건을 확인할 때

먼저 확인 · 현재 장과 실제 프로젝트를 확인. 기존에 확인한 맥락은 재사용.

장 완료 확인해줘.

이 장에서 막혔을 때

디버깅 → 내 정상 기록으로 복구 → 장별 Source로 재시작

Git 명령을 외우거나 직접 입력할 필요는 없습니다. 아래 요청문을 그대로 붙여넣으면 Claude Code가 확인하고 처리합니다.

1. 디버깅 --- 먼저 무엇이 어긋났는지 그대로 말하고 고쳐봅니다. 대부분 여기서 해결됩니다.

지금 작업이 책과 다르게 진행됐어.
현재 상태와 화면에 나온 문제를 확인하고 원인을 찾아서 고쳐줘.

이 장에서 Claude가 앱 코드를 만들기 시작했다면 범위를 벗어난 것입니다.

이번 장에서는 앱 코드를 만들지 않고 계획만 정하는 거야.
지금까지 만든 것 가운데 계획이 아닌 것이 있으면 알려주고 되돌려줘.

계획 문서에 무엇이 빠졌는지 모를 때는 항목별로 확인하게 합니다.

지금 계획 문서에 목적, 넣을 기능과 뺄 기능, 화면 순서, 기존 서버 재사용,
Secret과 개인정보와 기기 권한, 공통 완료 조건, 검증하지 않을 범위가
각각 들어 있는지 하나씩 확인해서 알려줘. 빠진 것만 보태줘.

계획이 기존 서비스와 어긋난 것 같으면 다시 대조하게 합니다.

계획을 현재 프로젝트와 다시 대조해줘.
없는 기능을 이미 있다고 쓴 곳, 제외한 기능을 전제한 곳,
Secret이 앱으로 들어가는 방향이 있는지 확인해서 계획만 바로잡아줘.

2. 내 정상 기록으로 복구 --- 해결되지 않으면 실습하면서 내 프로젝트에 남겨둔 정상 기록으로 돌아갑니다. 지금까지 한 작업은 먼저 따로 보존합니다.

현재 작업은 잃지 않도록 먼저 별도로 보존해줘.
이 프로젝트에서 마지막으로 정상 동작했던 상태를 찾아 안전하게 복구해줘.

3. 장별 Source로 재시작 --- 그래도 이어갈 수 없을 때 사용합니다. 13장의 남은 실습은 건너뛰게 되므로 마지막 수단입니다.

내 현재 작업을 먼저 안전하게 보존해줘.
아래 13장 완성 Source에서 다시 시작해줘.
https://github.com/buildyourownai-lab/develop-like-a-pro-with-ai/tree/main/chapters/ch13/source/ai-stock-briefing
내 인증키와 Database, Cache 접속 정보를 입력할 자리를 알려주고
준비가 끝나면 13장을 마친 상태인지 확인해줘.

방향부터 확인하고, 더 필요할 때 다음 힌트를 펼치세요.

완료 확인인데 앱 파일이 없음

1단계 — 방향

이 장은 앱을 만드는 단계가 아닙니다.

2단계 — 범위

범위·재사용·보안·화면 기준 문서를 봅니다.

3단계 — 위치·원인 후보

다음 장의 구현 요청을 작성할 만큼 결정됐는지 확인합니다.

정답을 요청했을 때

계획과 완료 조건이 갖춰졌으면 이 장은 완료 가능합니다. 앱은14·15장에서 만듭니다.

검증 주의

이 설명만으로 원인이 확인됐거나 수정됐다고 말하지 않습니다. 현재 프로젝트의 근거를 먼저 대조합니다.

앱에 키도 넣어야 하나

1단계 — 방향

앱과 기존 서버가 맡는 일을 구분합니다.

2단계 — 범위

앱은 결과를 받고 서버가 외부 서비스와 연결하는 구조를 봅니다.

3단계 — 위치·원인 후보

설정이 앱 번들로 복사되는 경로가 없는지 계획을 확인합니다.

정답을 요청했을 때

서버 Secret을 유지하고 앱은 필요한 서버 주소와 결과만 사용하게 설계합니다.

검증 주의

이 설명만으로 원인이 확인됐거나 수정됐다고 말하지 않습니다. 현재 프로젝트의 근거를 먼저 대조합니다.

디버깅 → 정상 기록 복구 → 장별 소스로 재시작 →

이번 장의 완료 체크리스트

앱 필요 판단웹으로 충분한지와 앱 확장 목적 설명
재사용 조사서버와 새 화면을 구분해 조사
범위 결정넣을 기능과 뺄 기능을 문서화
화면 계획작은 화면의 우선순위·오류 상태 설계
보안 경계Secret은 서버에만·불필요 권한 제외
완료 기준다음 두 앱의 실제 확인 기준 확정

장 완료 확인해줘.

실제 프로젝트에서 튜터와 확인합니다. 사이트를 열어본 기록은 학습 완료가 아닙니다.

장별 소스와 저자 검증 기록

저자는 12장을 끝낸 상태에서 13장 요청문만으로 계획 문서까지 갔습니다. 계획에는 목적, 넣을 기능과 뺄 기능, 작은 화면에서 중요한 순서, 기존 서버 재사용, 앱에 넣지 않을 Secret과 요청하지 않을 기기 권한, Android와 iPhone 공통 완료 조건, 이번에 검증하지 않을 범위가 모두 들어갔고, 기존 구현과 모순되는 내용은 없었습니다. 마지막 요청문까지 실행하면 계획 문서가 Git 기록에 남고 작업 폴더가 깨끗해지는 것도 확인했습니다. 이 장은 코드를 바꾸지 않으므로 새로 생긴 Test는 없고, Source 안의 Test는 12장과 같은 113개입니다. 근거는 verification/chapter-13/에 있습니다.

13장 완성 소스 ↗저자 검증 상세 기록 ↗

장별 소스는 해당 장까지의 기준 상태입니다. 정상 실습은 내 프로젝트를 이어가고, 완성 소스는 비교·복구할 때 사용합니다.

자료 판본 1c784213

이 장의 개발 용어

API: 프로그램이 다른 서비스와 정해진 방식으로 요청·응답을 주고받는 연결 방법.
Cache: 같은 조건에서 계산·생성한 결과를 일정 조건 동안 재사용하는 저장 방식.
Database: 자료를 구조적으로 저장하고 조회하는 곳.

튜터 사용 안내 실습 자료 업데이트

기존 `ai-stock-briefing` 프로젝트를 수정하지 말고 먼저 조사해줘. 웹에서 사용 중인 시장·검색·종목·차트·공시·AI 브리핑 가운데 Android와 iPhone에서도 그대로 재사용할 수 있는 것과 새로 필요한 것을 나눠서 설명해줘. 금융위원회·OpenDART·Gemini·Database·Cache를 앱마다 다시 구현하지 않는 방향을 우선해줘. 내부 파일과 데이터 구조를 나열하기보다, 내가 앱의 범위를 결정할 수 있도록 화면·기능·보안 경계로 나눠 쉬운 말로 요약해줘. 아직 구현하지 마.

Android와 iPhone이 웹과 같은 데이터 의미와 품질 기준을 사용하게 해줘. 가격의 기준일과 단위, DART 원문으로 가는 길, AI 브리핑의 근거·출처·한계가 빠지지 않아야 해. 기존 기능을 최대한 재사용하고, 내부 연결 방식과 데이터 구조는 현재 프로젝트를 조사한 뒤 적절하게 선택해줘. 외부 서비스의 Secret이나 사용자에게 필요 없는 내부 정보는 앱으로 보내지 마. 아직 구현하지 말고 다음 장에서 검증할 계획으로 정리해줘.

지금까지 결정한 내용을 다음 Android와 iPhone 작업에서 사용할 짧은 계획으로 정리해줘. 정리한 계획은 대화로만 남기지 말고 프로젝트 안에 문서 파일로 저장해줘. 앱을 만드는 목적, 넣을 기능과 뺄 기능, 스마트폰 화면에서 중요한 순서, 기존 서버 재사용, Secret·개인정보·기기 권한, 공통 완료 조건과 이번에 검증하지 않을 범위를 포함해줘. 기존 프로젝트를 다시 조사해 실제 구현과 모순되는 부분이 없는지도 확인해줘. 내부 API 구조·파일 구성·기술 선택은 Claude가 구현할 때 결정하고 검증할 항목으로 남겨줘. 아직 앱 코드는 만들지 마.

지금 계획 문서에 목적, 넣을 기능과 뺄 기능, 화면 순서, 기존 서버 재사용, Secret과 개인정보와 기기 권한, 공통 완료 조건, 검증하지 않을 범위가 각각 들어 있는지 하나씩 확인해서 알려줘. 빠진 것만 보태줘.

계획을 현재 프로젝트와 다시 대조해줘. 없는 기능을 이미 있다고 쓴 곳, 제외한 기능을 전제한 곳, Secret이 앱으로 들어가는 방향이 있는지 확인해서 계획만 바로잡아줘.

내 현재 작업을 먼저 안전하게 보존해줘. 아래 13장 완성 Source에서 다시 시작해줘. https://github.com/buildyourownai-lab/develop-like-a-pro-with-ai/tree/main/chapters/ch13/source/ai-stock-briefing 내 인증키와 Database, Cache 접속 정보를 입력할 자리를 알려주고 준비가 끝나면 13장을 마친 상태인지 확인해줘.