본문으로 건너뛰기

4주차 사례게시

하양파파

2026.10.29

소개

시도하고자 했던 것과 그 이유

저는 대학원생이에요. 연구, 수업, 개인 목표가 뒤섞이면서 "이번 주에 나는 뭘 했지?"를 돌아보기가 늘 어려웠어요. 종이 플래너(타임트래커 노트)로 하루를 30분 단위로 나눠 계획한 시간과 실제 쓴 시간을 적어 보니 효과가 좋았어요. 그런데 손으로 합산하고 돌아보는 게 번거로워서 오래 이어가지 못했어요.

그래서 이 흐름을 앱으로 만들어 보기로 했어요.

  • 누가: 삶의 방향성을 고민하고 실천하려는 사람이

  • 언제: 한 주 해야 할 일을 정리해야 할 때

  • 무엇을: 한 주의 성과를 쉽게 정리할 수 있도록 돕는 앱

결과물은 토스 미니앱 「인생도서관」이에요. 한 주는 책 한 권, 하루는 한 챕터, 할 일은 한 페이지예요. 한 주를 마치면 책을 서가에 꽂고, 사서인 나무늘보 교수가 AI 피드백 메모를 남겨줘요.

[이미지: 앱 홈 화면 / 요약 카드]


진행 방법

사용한 도구

단계

도구

한 일

기획 · 프롬프트

Claude (Claude Code / Cowork)

앱 이름, 사용자 한 문장, 세계관, 화면 구성, 프롬프트 초안

디자인

Figma + Figma MCP

갈색 1안 → 인디고·민트 2안 화면 디자인, 사서 캐릭터(나무늘보 교수)

개발

Claude Code, HTML/CSS/JS, Vite

파일럿 앱 구현, Figma 2안 디자인 코드 적용

미니앱 연동

앱인토스 SDK @apps-in-toss/web-framework

토스 내비게이션 바, 뒤로가기 처리, .ait 번들 빌드

출시

앱인토스 콘솔 + Claude in Chrome

등록 정보 입력, 번들 업로드, 검토 요청

AI 기능

OpenAI gpt-4o-mini + Cloudflare Workers

API 키를 숨기는 프록시 서버

1) 프롬프트로 첫 파일럿 만들기

앱 이름, 사용자 한 문장, 세계관, 색, 세 화면 구성을 정리한 뒤 아래 프롬프트로 첫 번째 파일럿을 만들었어요.

[이미지: 세계관 도표 / 세 화면 목업]

markdown

# 역할
너는 토스 미니앱(앱인토스) 개발 경험이 있는 시니어 프론트엔드 엔지니어이자 프로덕트 디자이너야.

# 작업 폴더
LifeLibrary
- 모든 파일은 이 폴더 안에서만 생성·수정해.
- 폴더가 비어 있으면 프로젝트 구조부터 제안하고 진행해.
- img/ 폴더의 목업 이미지 3장을 디자인 레퍼런스로 참고해.

# 이번 턴 목표
첫 번째 파일럿 프로그램 생성
- 실제로 실행해서 눌러볼 수 있는 최소 동작 버전을 만든다.
- 범위는 아래 "세 화면 구성"까지. 그 외 기능은 만들지 말고 TODO로만 남겨.
- 데이터는 로컬 저장으로 처리하고, 서버·로그인·결제는 이번 턴에서 제외.
- AI 피드백은 실제 API 연동 없이 더미 응답으로 자리만 잡아.

# 제품 정의
- 앱 이름: 인생도서관 (Life Library)
- 누가: 삶의 방향성에 대해 고민하고 실천하는 사람이
- 언제: 한 주 해야 할 일을 정리해야 할 때
- 무엇을: 한 주의 성과를 쉽게 정리할 수 있도록 돕는 앱

# 세 화면 구성
1. 홈(대시보드 · 나의 도서관): 이번 주 성과 요약 — 목표별 달성률, 예측 대비 실측 시간, 요일별 오차
2. 진행(기록 · 오늘의 챕터)
   - 이번 주 이루고 싶은 가치/목표를 적고 우선순위를 정한다
   - 세부 task를 30분 단위로 예측 시간과 실측 시간을 기록한다
   - 하루 단위로 예측과 실측의 차이를 돌아본다
3. 결과(정리 · 책을 서가에 꽂기): 한 주 성과 정리 + 가장 어긋난 페이지 + AI 피드백(사서의 메모, 더미)

# 세계관: 도서관
- 앱 전체를 "나만의 도서관"으로 은유한다.
- 한 주 = 책 한 권, 하루 = 한 챕터, task = 한 페이지, 목표 = 서가,
  주간 성과 정리 = 책을 서가에 꽂기, AI 피드백 = 사서의 메모
- 은유는 문구·아이콘·빈 화면 안내에만 가볍게 쓰고,
  버튼·입력 등 기능 라벨은 누구나 바로 이해할 수 있는 말로 유지해.
- 분위기: 조용하고 차분함, 집중, 쌓여가는 기록.

# 색: 갈색
- 메인 #6B4A2B, 보조 #8A6540 / #C9B89F, 배경 #F6F0E4, 텍스트 #3A2718, 강조 1색 #B8573A
- 강조색은 예측/실측 비교처럼 구분이 필요한 곳에만 써.
- 색상은 토큰(변수)으로 정의해서 나중에 한 번에 바꿀 수 있게 해.
- 텍스트와 배경의 명도 대비를 충분히 확보해.

# 작업 방식
1. 먼저 폴더 구조, 화면 구성, 데이터 구조를 짧게 계획으로 보여줘.
2. 내가 확인하면 구현을 시작해.
3. 끝나면 실행 방법, 만든 것, 다음 턴에 할 일을 5줄 이내로 정리해.

# 제약
- 모바일 세로 화면 기준, 한 손 조작.
- 한 화면에 한 가지 일만 하도록 단순하게.
- 내가 요청하지 않은 기능이나 라이브러리는 추가하지 마.

프롬프트 포인트

  • 범위를 "세 화면"으로 못 박고, 나머지는 TODO로만 남기게 했어요.

  • 세계관은 문구에만 쓰고, 버튼은 쉬운 말로 쓰게 했어요.

  • 색은 토큰으로 정의하게 해서, 나중에 디자인을 바꿀 때 tokens.css 한 파일만 고치면 됐어요.

2) Figma로 디자인을 바꾸고 코드에 적용

Figma MCP로 화면 디자인을 요청했어요. 처음 갈색 톤이 너무 무거워서 인디고·민트·보라 조합의 2안으로 다시 디자인했어요. 이어서 “Screens 페이지 디자인을 코드에 적용해줘”라고 요청해 색 토큰과 컴포넌트를 바꿨어요. 사서 캐릭터 나무늘보 교수도 이때 함께 만들었어요.

[이미지: Figma 1안 → 2안 비교]
[이미지: 나무늘보 교수 캐릭터]

3) 앱인토스 SDK 연동과 콘솔 등록

  • apps-in-toss.config.ts에 앱 이름, 대표 색, 내비게이션 바를 설정했어요.

  • npm run build(vite build → ait build)로 .ait 번들을 만들었어요.

  • 출시 체크리스트에 걸리는 자체 뒤로가기 버튼을 없앴어요. 대신 토스 내비게이션 바의 뒤로가기(backEvent)를 앱 안에서 처리하도록 바꿨어요.

  • 콘솔 등록 정보는 Claude in Chrome으로 함께 채웠어요. 약관 동의와 최종 제출은 제가 직접 했어요.

[이미지: 앱인토스 콘솔 앱 출시 화면]

4) AI 기능 붙이기: API 키는 서버에만

배포 후 AI가 엉뚱하게 답한다는 걸 알게 됐어요. API 키가 없어서 규칙 기반 기본 답변으로만 돌고 있었던 거예요. 키를 앱 코드에 넣으면 누구나 꺼내 쓸 수 있어서, Cloudflare Workers에 프록시 서버를 두고 키는 거기에만 보관했어요.

javascript

// server/openai-proxy/worker.js (핵심 부분)
export default {
  async fetch(request, env) {
    if (request.method !== 'POST') return new Response('POST only', { status: 405 });

    const body = await request.json();
    const messages = (body.messages || [])
      .filter(m => m.role === 'system' || m.role === 'user')
      .slice(0, 6);                                   // 메시지 수 제한

    const res = await fetch('https://api.openai.com/v1/chat/completions', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        Authorization: `Bearer ${env.OPENAI_API_KEY}` // 키는 Cloudflare 비밀 변수에만
      },
      body: JSON.stringify({
        model: 'gpt-4o-mini',                         // 모델 고정
        max_tokens: 1500,                             // 답변 길이 제한
        messages,
        response_format: body.response_format
      })
    });
    return new Response(res.body, {
      status: res.status,
      headers: { 'Content-Type': 'application/json', 'Access-Control-Allow-Origin': '*' }
    });
  }
};

javascript

// js/config.js · 앱에는 키 없이 프록시 주소만
LL.config = {
  gpt: {
    apiKey: '',
    model: 'gpt-4o-mini',
    endpoint: 'https://life-library-ai.<계정>.workers.dev'
  }
};
  • 남용을 막으려고 사용자(IP)당 하루 60회 호출 제한(Cloudflare KV)도 걸었어요.

  • 배포, 키 등록, 주소 교체, 빌드를 PowerShell 스크립트 하나(deploy-ai.ps1)로 묶었어요.

[이미지: AI 코칭 화면]


결과와 배운 점

결과

  • 토스 미니앱 「인생도서관」 첫 버전을 출시했어요. 홈, 오늘, 이번 주, 이번 달, 서재 화면이 있어요.

  • AI 코칭(실천 계획 도우미, 월간 검토, 주간 계획 추천)을 연결한 새 버전으로 검토를 요청했어요. [ 검토 결과 ]

  • 수익은 아직 0원이에요. 광고 노출수와 eCPM도 아직 없어요.

시행착오

  1. API 키를 앱 코드에 넣을 뻔했어요. 로컬에서 테스트하려고 config.js에 키를 넣어 둔 채로 빌드할 뻔했어요. 웹앱 코드는 사용자 폰으로 그대로 내려가니, 키는 무조건 서버에 둬야 해요.

  2. 화면 안의 뒤로가기 버튼이 출시 기준에 걸렸어요. 토스 내비게이션 바와 중복되면 안 돼요. 앱 안 뒤로가기는 backEvent로 처리해야 해요.

  3. 콘솔 등록에서 막힌 것들이 있었어요.

    • 기능 영문명은 단어 첫 글자를 대문자로 써야 해요(Monthly Goals).

    • 스크린샷은 세로와 가로를 섞을 수 없어요.

    • 이메일 필드가 비어 있으면 임시저장이 안 돼요.

  4. Cloudflare 첫 배포에서 두 번 막혔어요. 하나는 이메일 인증, 다른 하나는 workers.dev 하위 도메인 등록이에요.

  5. PowerShell이 경고 메시지를 오류로 받아 스크립트가 중간에 멈췄어요. 그래서 .ait 파일 날짜가 그대로였어요. 빌드가 됐는지 확인하려면 파일 수정 날짜를 꼭 보세요.

  6. 일정 관리. 대학원 스케줄 때문에 SNS 운영 미션은 제대로 따라가지 못해 아쉬웠어요.

나만의 꿀팁

  • 프롬프트에 ”이번 턴 목표"와 "만들지 말 것"을 같이 적으면 결과가 훨씬 깔끔해요.

  • 색은 처음부터 토큰 파일 하나로 관리하세요. 디자인을 갈아엎을 때 빛을 발해요.

  • AI 기능은 키가 없을 때 쓸 규칙 기반 기본 답변을 먼저 만들어 두세요. API가 끊겨도 앱이 멈추지 않아요.

  • 콘솔 작업처럼 반복 입력이 많은 일은 브라우저 에이전트에 맡기세요. 다만 약관 동의와 최종 제출은 직접 하세요.

도움이 필요한 부분

  • 토스 로그인 연동(개인사업자 등록 필요)과 서버 저장 구조를 어떻게 잡으면 좋을지 궁금해요.

  • 미니앱 초기 사용자를 모으는 방법도 경험이 있으면 공유 부탁드려요.

앞으로의 계획

  • AI 버전 검토를 통과하면 바로 출시할 거예요.

  • 토스 로그인을 붙여 기록을 서버에 저장하려고 해요. 기기를 바꿔도 서재가 유지되게요.

  • SNS에 사용법과 개발 과정을 올려 첫 사용자를 모을 거예요.


도움 받은 글 (옵션)

  • 앱인토스 개발자 문서: WebView 미니앱, @apps-in-toss/web-framework, 출시 체크리스트

  • Cloudflare Workers 문서: Wrangler, Secrets, KV

  • 타임트래커 노트: 30분 단위 계획과 실제 기록 방식에서 아이디어를 얻었어요.

  • [ 참고한 지피터스 글 링크 ]

1

함께 이야기해요 1

로그인하고 댓글을 남겨 주세요

뽀짝이 프로필 이미지
뽀짝이2026.10.29

하양파파님, 종이 타임트래커로 효과를 본 흐름을 "한 주=책 한 권, 하루=한 챕터" 세계관으로 앱까지 옮기신 과정이 인상적이에요.

특히 "API 키가 없어서 규칙 기반 기본 답변으로만 돌고 있었다"는 걸 배포 후에 알아채고 Cloudflare Workers 프록시로 키를 서버에만 두신 대목, 그리고 PowerShell이 경고를 오류로 받아 빌드가 중간에 멈췄는데 .ait 파일 수정 날짜로 확인하셨다는 시행착오가 같은 길을 가는 분들께 큰 도움이 될 것 같아요. 프롬프트에 "이번 턴 목표"와 "만들지 말 것"을 함께 적는 팁도 바로 써먹고 싶어지네요.

AI 버전 검토 통과와 토스 로그인 연동까지 잘 이어지길 응원할게요. 꼬리 탁! 치고 가요 🐈‍⬛

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기