AI용 분할본 · 지도 5단계(토스 앱 테스트) · 이 페이지 전에 읽을 페이지: PART 0 사용법·AI 시작 지침, PART 4 미니앱 만들기, PART 5 서버 배포 · 코드 파일은 여기 없다 — 코드 자리의 줄을 따른다(폴더에 책 파일이 하나도 없는 처음이면 부록 A-2 의 curl 한 줄부터)

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

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

PART 6 — 토스 앱에서 테스트하기

6-1. 테스트 환경 정리

6-2. 실제 서버 주소로 번들 만들기

  1. miniapp/.env.production 파일에 한 줄: VITE_API_BASE=https://<이름>.ridm.ai (PART 5 주소. 비밀이 아니라 커밋해도 됩니다)
  2. miniapp 폴더에서 npm run build → check-bundle 통과 줄과 <appName>.ait 생성을 확인합니다
  3. 번들은 압축 해제 기준 100MB 이하만 올릴 수 있습니다. 이 앱의 번들은 아주 작습니다

6-3. 번들 올리기

콘솔에서 — 앱인토스 콘솔 → 내 앱 → 앱 출시 메뉴 → 등록하기 → 앱 번들(.ait)을 올립니다. 업로드가 안 되면 npm run build 로 만든 번들인지, appName 이 콘솔과 같은지 봅니다.

명령줄에서(선택) — 앱인토스 「미니앱 테스트하기」 문서의 CI/CD 명령입니다. 앱인토스 콘솔 → 워크스페이스 → 왼쪽 메뉴 키에서 API 키를 발급한 뒤:

명령 (miniapp 폴더)
npx ait token add
npx ait deploy -m "첫 테스트"

이 키는 앱인토스 키이고 HRUM 키와 다릅니다. token add 가 물어볼 때 여러분이 직접 넣고, 저장소·채팅에 쓰지 않습니다. 정상적으로 올라가면 테스트용 앱 스킴이 나옵니다.

6-4. QR 로 토스 앱에서 열기

번들을 올린 뒤 오른쪽의 토스앱 테스트 버튼을 누르면 QR 이 나옵니다. 휴대폰으로 찍으면 토스 앱에서 미니앱이 열립니다. 조건은 셋입니다: 토스 앱에 로그인돼 있을 것, 워크스페이스 멤버일 것, 만 19세 이상일 것.

6-5. 휴대폰에서 확인할 것

직접 확인 필요: 이 책을 쓸 때는 실제 휴대폰 토스 앱에서 QR 로 여는 테스트를 아직 하지 않았습니다(앱인토스 콘솔 계정이 필요한 단계). 아래 표는 문서와 책 코드로 정한 기대 결과이니, 여러분의 휴대폰에서 하나씩 확인합니다.
확인기대
첫 화면바로 열리고, 아무 창도 저절로 뜨지 않음
입력 → 오늘의 운세 보기결과 화면(서버가 잠들어 있었다면 몇 초 걸릴 수 있음)
미니앱을 닫았다 다시 열기생년월일이 채워져 있음(Storage)
뒤로가기·닫기내비게이션 바로 정상 동작, 첫 화면에서 뒤로가기면 종료. 안드로이드 시스템 백버튼도 동작
비행기 모드에서 버튼「연결이 원활하지 않아요」 안내, 앱이 멈추지 않음
버튼 연타요청 하나만 감(콘솔 → 사용량에서 늘어난 건수 확인)

6-6. 웹 디버그 툴즈

로컬에서 되던 것이 토스 앱에서만 안 되면, QR 로 연 미니앱 오른쪽 위 내비게이션 바의 더보기 → 웹 디버그 툴즈를 엽니다. Network 탭에서 /api/today 요청과 응답(상태 코드)을, Log 탭에서 console.log 를 볼 수 있습니다. 로그를 더 보고 싶으면 코드에 남긴 뒤 번들을 다시 만들어 올립니다 — 단, 생년월일 같은 개인 정보는 로그에 남기지 않습니다.

출처

앱인토스 내용은 2026-10-28 에 앱인토스 개발자센터 문서를 직접 읽고 요약했고, 2026-10-30 에 문서와 다시 대조했습니다. 정책·화면은 바뀔 수 있으니 시작 전에 원문을 다시 확인하세요.

AI용 분할본 · 지도 5단계(토스 앱 테스트) · 이 페이지 전에 읽을 페이지: PART 0 사용법·AI 시작 지침, PART 4 미니앱 만들기, PART 5 서버 배포 · 코드 파일은 여기 없다 — 코드 자리의 줄을 따른다(폴더에 책 파일이 하나도 없는 처음이면 부록 A-2 의 curl 한 줄부터)