AI용 분할본 · 지도 6단계(검수·출시) · 이 페이지 전에 읽을 페이지: PART 0 사용법·AI 시작 지침, PART 6 토스 앱 테스트 · 코드 파일은 여기 없다 — 코드 자리의 줄을 따른다(폴더에 책 파일이 하나도 없는 처음이면 부록 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 7 — 검수와 출시

7-1. 앱 정보 채우기

앱인토스 콘솔 → 앱 출시 → 등록하기에서 나머지 앱 정보를 넣고 검토를 요청합니다. 항목은 임시 저장할 수 있습니다.

7-2. 비게임 출시 가이드 점검표

체크리스트를 지키지 않았거나 다크패턴이 확인되면 검수가 승인되지 않습니다. 아래는 이 앱에 해당하는 항목만 옮긴 것입니다 — 원문 전체를 한 번 읽습니다.

원문 항목(요약)이 앱에서 확인하는 방법
미니앱이 정상적으로 열리고, 「앱 내 기능」으로 소개한 기능을 미니앱에서 똑같이 쓸 수 있음QR 로 열어 입력 → 결과(6-5)
등록한 스킴이 정상 연결, 스킴으로 들어온 뒤 뒤로가기 정상주요 기능 주소로 열어 뒤로가기
앱인토스 내비게이션 바 사용, 자체 뒤로가기와 동시에 보이지 않음, 파트너 자체 로고 추가 불가책 코드에 자체 뒤로가기·로고 없음
앱 브릿지(SDK API)를 과도하게·반복해서 부르지 않음, 실패 시 재시도 횟수·간격 제어Storage 는 열 때 1번·누를 때 1번, 자동 재시도 없음
외부 코드 실행(eval 등) 불가, 토스 도메인 밖 콘텐츠 렌더링 불가, SSR 불가(CSR·SSG 만)정적 번들(CSR), 외부 화면을 불러오지 않음
API 통신은 HTTPS 만서버 주소가 https://…ridm.ai
안드로이드 시스템 백버튼으로 뒤로가기·종료, 제스처 확대·축소 비활성6-5, viewport 설정(4-2)
라이트 모드, 인터랙션 반응이 2초 이상 지연되지 않음버튼을 누르면 「불러오는 중」이 바로 보임
비속어·은어·과도한 유행어 없음문구를 바꿨다면 다시 읽기
진입하자마자 바텀시트가 자동으로 뜨지 않음, 모든 화면에서 나가는 방법이 명확, CTA 결과를 예측할 수 있음버튼 문구가 「오늘의 운세 보기」
자사 서비스 이동·자사 앱 설치 유도 없음외부 링크 없음
사용자 식별자 값을 확인해 저장하고, 다시 접속해도 필요한 데이터가 유지됨(사용자 식별키 발급)이 앱은 로그인·사용자 식별키를 쓰지 않고 생년월일만 기기 Storage 에 둡니다. 이 구조가 검수에서 문제 된 사례는 확인되지 않았습니다(문서·사례 모두) — 검수 의견이 오면 그에 따릅니다

7-3. 검수 요청 → 출시하기

  1. 토스 앱 테스트를 한 번 이상 마친 뒤 검토를 요청합니다
  2. 검수 결과는 콘솔과 이메일로 옵니다. 검토 기간은 문서마다 다르게 적혀 있습니다 — 「미니앱 등록하기」는 영업일 기준 3~7일, 「자주 묻는 질문」은 영업일 기준 3~5일(주말·공휴일에는 검수하지 않음)입니다. 검토 요청은 번들 하나만 걸 수 있어, 검토 중에 오류를 찾았다면 요청을 취소하고 다시 올린 뒤 요청합니다. 반려되면 사유대로 고친 뒤 출시 관리의 「재검수 요청」을 누릅니다. 나중에 인앱 결제를 붙인다면 정산 정보 검토가 따로 있고, 문서 기준 영업일 평균 2~3일입니다(인앱 결제 가이드)
  3. 승인되면 콘솔의 출시하기 버튼을 눌러야 사용자에게 공개됩니다. 출시하면 1시간 뒤 토스 미니앱 리스트에 반영됩니다

7-4. 출시 뒤

7-5. 밖에서 홍보할 때

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

출처

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

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