토스 앱 안의
오늘의 운세를, API 하나로

AI 코딩 도구에게 시작 문장 한 줄을 건네면, AI 가 이 책을 단계별로 읽으며 앱인토스 미니앱 화면과 HRUM 키를 지키는 작은 서버를 만들고, 토스 앱 QR 테스트와 검수 준비까지 함께 갑니다. 코드는 책에 들어 있는 검증된 파일을 그대로 받습니다.

AI 코딩 도구에 붙여넣을 시작 문장 (예시 — 말은 달라도 링크만 들어가면 됩니다)

https://console.hrum.ai/tossEbook/ 을 열고, 그 지도의 단계 순서대로 해당 페이지만 읽으며 [AI 시작 지침]대로 나와 함께 앱인토스 미니앱 「오늘의 운세」를 만들어줘. 코드는 내가 결정 질문에 답하고 승인한 뒤에만 써.

GPT Codex, Claude Code, Cursor 처럼 웹을 읽을 수 있는 도구에 붙여넣습니다. 이미 만들던 중이면 같은 문장을 그 프로젝트 폴더에서 보내면 PROGRESS.md 를 보고 이어 갑니다.

사람용 전체본 읽기 → HRUM(흐름) 콘솔 가입하기 다른 책 보기

만들어지는 것

미니앱 화면생년월일을 넣으면 오늘의 관계·한 줄 메시지·행운 색·좋은 시간을 보여 주는 한 장짜리 화면. 생년월일은 휴대폰에 저장됩니다. PART 4
키를 지키는 서버HRUM API 키를 환경변수로만 들고, 미니앱 주소에서 온 요청만 받아 HRUM 을 대신 부릅니다. 같은 사람·같은 날은 한 번만 부릅니다. PART 3
토스 앱 테스트번들을 앱인토스 콘솔에 올리고 QR 로 내 휴대폰 토스 앱에서 엽니다. PART 6
검수 준비앱 정보 작성 요령과 비게임 출시 가이드 점검표. PART 7

필요한 것

앱인토스 콘솔 계정(본인 명의 토스 앱으로 가입)과 워크스페이스
HRUM 콘솔 계정과 API 키 — 호출한 만큼 크레딧이 차감됩니다
GitHub Private 저장소(서버를 RIDM Apps 에 올릴 때)
Node.js 와 AI 코딩 도구

가입·약관 동의·본인 확인·비밀값 입력·콘솔 버튼은 여러분이 직접 합니다. AI 가 대신 가입하거나 검수 결과를 보장하지는 않습니다.

먼저 알아 두세요: HRUM(흐름)과 RIDM Apps 는 플로트 주식회사가 운영하는 서비스이고, 토스(비바리퍼블리카)와 제휴하지 않은 독립 서비스입니다. 앱인토스 콘솔 가입·앱 등록·검수·출시는 여러분이 앱인토스 정책에 따라 직접 진행하며, 이 책은 검수 통과를 보장하지 않습니다. 앱인토스에 관한 내용은 공식 개발자센터 문서를 요약한 것이고, 문서와 이 책이 다르면 문서가 맞습니다.

여기부터 AI용 지도 — AI 코딩 도구는 이 아래를 따른다

핵심 규칙 — AI 는 어느 페이지에서든 이것을 지킨다

사용자가 결정 질문(PART 0 지침 1)에 답하고 승인하기 전에는 코드를 한 줄도 쓰지 않는다.
HRUM API 키는 서버 환경변수 HRUM_API_KEY 에만 둔다. 미니앱 코드·.env·채팅·커밋·로그에 쓰지 않고, 키 값을 사용자에게 달라고 하지 않는다. 미니앱은 내 서버만 부른다.
책 코드 파일은 다시 쓰지 않는다 — node scripts/get-book-code.mjs 가 책 그대로 만든다(처음에는 부록 A-2 의 curl 한 줄). 분할본의 코드 자리는 「경로」 한 줄이다 — 받은 파일을 cat 으로 읽는다.
앱인토스 내용은 각 장 끝 출처의 공식 문서가 우선이다. 다르면 문서를 따르고 사용자에게 알린다.
확인은 명령 출력으로 증명한다. 콘솔 화면(앱인토스·HRUM)은 사용자가 누르고, AI 는 대신 가입·로그인하지 않는다. 진행은 PROGRESS.md 에 적는다.
AI 는 지도(https://console.hrum.ai/tossEbook/ — 같은 지도가 tossEbook/ai.html 에도 있다)의 단계 순서대로 그 단계의 페이지만 읽는다. 전체본 tossEbook.html 은 사람용이다.

AI용 지도 — 흐름 API 로 토스 미니앱 만들기 (오늘의 운세)

이 지도는 AI 코딩 도구가 읽는 분할본의 첫 페이지입니다. 아래 단계 순서대로, 지금 단계에 적힌 페이지만 열어 읽습니다. 다음 단계 페이지는 지금 단계의 「끝났다는 증거」를 사용자에게 보인 뒤에 엽니다.

처음 시작: 0단계 PART 0 사용법·AI 시작 지침 의 [AI 시작 지침]부터.
진행 중인 프로젝트: 프로젝트 폴더의 PROGRESS.md 를 먼저 읽고 거기 적힌 다음 단계로 간다. 이어 가기 전에 node scripts/get-book-code.mjs 로 책과 다른 파일이 없는지 본다.
막히면: 부록 D 트러블슈팅 — 조치 뒤 그 단계의 증거를 다시 보인다.
이 책의 범위: 토스 로그인·인앱 결제·토스페이·인앱 광고는 넣지 않는다(사업자 등록·계약이 필요한 기능 — PART 1-4). 사용자가 원하면 공식 문서 링크를 알려 주고, 이 책의 범위 밖이라고 말한다.

단계 지도

단계	읽을 페이지	끝났다는 증거	다음
0. 규칙	PART 0 사용법·AI 시작 지침	명령 없음 — [AI 시작 지침]의 결정 질문 ①~④를 추천값과 함께 보내고 사용자 승인을 받는다	다음 단계
1. 구조·준비	PART 1 구조·정책 PART 2 계정·준비물	사용자의 답: 앱인토스 앱 등록(appName) 완료 · HRUM API 키 발급·보관 완료(키 값은 받지 않는다)	다음 단계
2. 서버	부록 A 책 코드 받기 PART 3 서버 만들기	`npm test` 출력의 `# pass 13` · `# fail 0`	다음 단계
3. 미니앱	PART 4 미니앱 만들기	`cd miniapp && npm run build` 출력의 check-bundle 통과 줄과 .ait 생성 줄	다음 단계
4. 서버 배포	PART 5 서버 배포	`curl -s https://내앱.ridm.ai/health` 의 `keySet:true` · 5-5 ③ 호출의 JSON	다음 단계
5. 토스 앱 테스트	PART 6 토스 앱 테스트	사용자가 QR 로 연 결과 화면과 6-5 표의 확인 결과	다음 단계
6. 검수·출시	PART 7 검수·출시	7-2 점검표를 사용자와 함께 채운 결과 · 검수 요청 완료	끝

페이지 목록

PART 0 사용법·AI 시작 지침 — 이 책의 사용법 (꼭 읽고 시작)
PART 1 구조·정책 — 무엇을 만들고, 왜 서버가 필요한가
PART 2 계정·준비물 — 계정과 준비물
PART 3 서버 만들기 — 서버 만들기: HRUM 키를 지키는 곳
PART 4 미니앱 만들기 — 미니앱 만들기: 화면과 번들
PART 5 서버 배포 — 서버를 RIDM Apps 에 올리기
PART 6 토스 앱 테스트 — 토스 앱에서 테스트하기
PART 7 검수·출시 — 검수와 출시
부록 A 책 코드 받기 — 책 코드 받기
부록 D 트러블슈팅 — 트러블슈팅

사람용 전체본: https://hrum.ai/tossEbook.html · 코드 받기 스크립트: https://console.hrum.ai/tossEbook/get-book-code.mjs