무엇을 배우나요?
앱을 구현한 뒤 실제 검토 의견을 반영하고 출시 준비를 마무리하는 과정을 배웁니다. 사례는 **질문 5개로 사회초년생의 지원금 후보를 찾는 ‘놓친지원금찾기’**입니다. 결과는 공식 신청 페이지로 연결하며, 최종 자격 판단은 각 기관의 현재 안내에서 확인해야 합니다.
프로젝트 현황: 개발 완료와 출시 완료 구분
제공된 2026-10-19 현황 문서에 따르면 기획·MVP 개발·콘솔 등록·로고·홍보 영상 제작은 완료되었습니다. 1차 검토는 반려되었고 10월 12일 수정 번들을 만들었습니다. 수정본 업로드·재검토 결과는 확인 필요, 정식 출시는 대기 상태입니다.
| 구분 | 문서에 기록된 내용 |
|---|---|
| 이름 | 놓친지원금찾기 / Missed Benefits |
| 식별자 | missed-benefits |
| 구성 | React 18, TypeScript, Vite, TDS Mobile |
| SDK | @apps-in-toss/web-framework 3.7.0 — 이 프로젝트의 기록된 버전 |
| 데이터 | 지원금 13개 시드 항목, 공식 정보 대조 전 |
| 광고 | 그룹 등록 진행 중, 코드에는 테스트용 그룹 ID |
이 홈페이지는 사례를 설명하는 학습 자료입니다. 지원금 조회 기능이나 미니앱 출시 상태를 제공하는 서비스 화면은 아닙니다.
1. 질문과 화면을 설계하기
질문은 나이→지역→현재 상태→연 소득→주거 형태로 구성하고 한 화면에 하나씩 보여줍니다. 홈에는 서비스 소개와 지난 결과 다시 보기를 배치합니다. 마지막에는 입력 요약과 광고 안내를 거쳐 결과 카드로 이동합니다.
질문 5개를 차례대로 묻는 지원금 탐색 앱의 화면을 설계해줘.
질문은 한 화면에 하나씩 보여주고 현재 진행 단계를 표시해줘.
결과에는 공식 출처와 확인할 조건을 함께 보여줘.
검증되지 않은 지원금 데이터를 지급 확정 정보처럼 표현하지 마.
결과는 ‘바로 확인해 볼 혜택’과 ‘추가 조건 확인이 필요한 혜택’으로 구분합니다. 여러 제도의 최대 금액을 단순 합산하면 동시 수급 제한이나 자격 차이를 놓칠 수 있으므로, 합산 수치를 실수령 예상액으로 단정하지 않습니다.
2. 실제 반려 사유에서 배우기
| 1차 검토 의견 | 프로젝트에서 한 조치 | 다시 확인할 점 |
|---|---|---|
| 내비게이션 바와 화면 안 뒤로가기 중복 | 화면 안 이전 질문·처음으로 버튼 제거, 질문을 브라우저 히스토리와 연결 | 시스템 뒤로가기로 이전 질문이 정확히 복원되는지 |
| 예상하기 어려운 시점의 광고 노출 | 입력 요약·광고 안내 화면과 명시적 버튼 추가 | 버튼의 설명과 실제 광고 방식이 일치하는지 |
이는 이 프로젝트에서 받은 검토 의견과 수정 기록이며 모든 앱에 동일하게 적용되는 심사 결과를 뜻하지 않습니다. 구현 시 최신 앱인토스 가이드와 실제 검토 메시지를 대조합니다.
3. 광고 안내와 완료 이벤트 맞추기
문서에는 전면 광고 호출 코드와 리워드 광고 그룹 등록 작업이 함께 기록되어 있습니다. 출시 전 두 방식 중 실제 사용할 광고 상품을 정하고 코드를 일치시켜야 합니다.
- 테스트용
ait-ad-test-interstitial-id는 출시용 실제 그룹 ID로 교체합니다. - 광고가 준비되지 않거나 로드에 실패했을 때의 안내·재시도 흐름을 만듭니다.
- 리워드 방식이라면 지원 SDK 문서를 확인해 보상 완료 이벤트인
userEarnedReward에서만 보상 처리를 합니다. - 광고 시작·닫힘·보상 완료를 구분하며, 단순 닫힘을 시청 완료로 취급하지 않습니다.
광고를 붙였다는 사실만으로 심사 통과나 수익이 보장되지는 않습니다.
4. 출시 전에 남은 작업
- 수정된
.ait번들의 업로드·재검토 결과를 확인합니다. - 13개 지원금의 금액·대상·기간·공식 URL을 보조금24·복지로 등과 대조하고 확인일을 기록합니다.
- 광고 상품과 그룹 ID·완료 이벤트를 일치시킵니다.
apps-in-toss.config.ts의brand.displayName,brand.icon을 보완합니다.- 삭제한 버튼이 남아 있는 콘솔 스크린샷과 영상은 현재 화면으로 다시 만듭니다.
- 홍보용 Suno 음원의 상업적 이용 조건을 확인합니다.
프로젝트 문서는 로그인 없이 입력을 기기에만 저장하고, 공식 공공기관 링크만 연결하는 설계를 기록합니다. 실제 개인정보 안내는 배포본의 저장·전송 동작과 일치하는지 확인해야 합니다.
5. 소스와 번들의 역할
src/data/benefits.ts는 데이터, lib/match.ts는 후보 매칭, lib/storage.ts는 기기 저장, hooks/useInAppAds.tsx는 광고 연결을 담당합니다. 설정이나 데이터를 수정한 뒤에는 번들을 다시 만들어야 합니다.
# 아래는 제공된 미니앱 프로젝트에서 실행하는 명령입니다.
cd missed-benefits
npm run dev
npm run build
# 콘솔 업로드는 인증·앱 설정과 실제 배포 대상을 확인한 뒤 수행합니다.
npx ait deploy
직접 확인해보기
정상 입력, 질문 중 뒤로가기, 앱 재실행, 광고 로드 실패, 광고 닫기, 보상 완료를 각각 시험합니다. 사용자의 입력이 유지되는지, 결과 진입 조건이 맞는지, 오류 다음 행동이 보이는지를 기록하세요. 지원금 실제 수급 여부는 이 UX 테스트로 검증할 수 없습니다.
출처와 확인 범위
- 제공 문서: 「놓친지원금찾기 프로젝트 현황」, 2026-10-19. 코드·콘솔·지원금 원자료를 새로 감사한 결과는 아닙니다.
- 앱인토스 개발자센터
- 서비스 오픈 정책