앱인토스 미니앱 체중 다이어리 화면 세 장
|

앱인토스 미니앱 11 – 체중 다이어리

앱인토스 미니앱 제작기 열한 번째는 체중 다이어리입니다. 오늘 체중을 적고 최근 흐름을 보는, 기능이 많지 않은 앱이에요.

이 앱에서 잡은 기준은 두 가지입니다. 빨리 적을 수 있을 것, 그리고 흐름을 판정 없이 보여줄 것. 이 글은 그 두 가지를 화면과 코드로 옮긴 기록입니다.

로컬에서 앱을 직접 실행해 찍은 시연 영상. 체중 값은 시연용으로 넣은 예시입니다 (소리 없음)

체중 다이어리는 어떤 앱인토스 미니앱인가

체중 다이어리 첫 화면. 오늘 체중 62.1kg이 저장돼 있고 줄이기와 늘리기 버튼, 어제와 같은 값 버튼, 최근 7일 평균이 보인다
오늘 기록
주간 요약 시트. 9월 28일부터 10월 4일까지 6일 기록, 평균 62.6kg, 이전 주와의 평균 차이가 나와 있다
주간 요약
체중 흐름 시트의 30일 그래프. 기록한 날짜만 점으로 찍혀 있고 날짜가 비는 곳은 선이 끊겨 있다
30일 그래프

화면은 오늘 기록 홈 하나에, 주간 요약과 그래프, 설정이 시트로 올라오는 구조입니다. 그래프 탭이나 설정 탭을 따로 두지 않았어요.

위 화면의 체중 값은 시연용으로 넣은 예시입니다.

숫자를 치지 않고 적는다

숫자를 처음부터 입력하지 않고, 마지막에 적은 값에서 시작합니다.

  1. 앱을 열면 마지막 기록이 미리 채워져 있다
  2. 빼기와 더하기 버튼으로 0.1kg씩 조정한다
  3. “오늘 기록”을 누른다

어제 기록이 있으면 “어제와 같은 62.3kg” 버튼이 따로 나옵니다. 숫자를 직접 입력할 수도 있어요. 저장한 직후에는 “방금 저장한 기록 되돌리기”가 보여서, 잘못 눌렀을 때 바로 되돌릴 수 있습니다.

함께 읽기앱인토스 미니앱 1 – 물마시기앱인토스 미니앱 물마시기 제작기입니다. 화면 하나짜리 기록 앱을 어떻게 짰는지, 핵심 코드 세 조각과 사용자가 일곱 배로 늘어난 진짜 이…

체중 다이어리 개선 기획에서 덜어 낸 것

이 글의 체중 다이어리는 원래 있던 앱을 개선 기획으로 다시 손본 버전입니다. 예전 앱 소개에는 0.1kg씩 올리고 내리는 버튼과 함께 BMI, 목표까지 남은 kg, 다이어트 격려가 같이 적혀 있었어요. 개선 기획에서는 하루 변동을 평가하거나 의료 판정처럼 읽힐 수 있는 표현을 걷어 내고, 빨리 적는 것과 긴 흐름을 보는 것을 앱의 중심에 두기로 했습니다.

덜어 낸 것

  • BMI 수치와 판정 라벨
  • 내일 체중 맞히기
  • 리그, 배지, 연속 기록
  • 기본 공유 카드, 다른 사람과의 순위

남긴 것

  • 마지막 값에서 시작하는 빠른 기록
  • 7일·30일·전체 그래프
  • 다 끝난 주끼리 비교하는 주간 요약
  • 직접 정했을 때만 보이는 목표 체중

앱 소개 문구도 여기에 맞췄어요. 한 줄 소개는 “체중을 기록하고 최근 흐름을 차분히 확인해요”로 바꾸고, 검색 키워드에서도 BMI와 다이어트 효과에 관한 말을 뺐습니다.

홈 화면은 위에서부터 오늘 체중 입력과 저장 버튼, 배너 광고, 최근 기록 흐름, 주간 요약과 체중 그래프로 가는 버튼 순서로 놓았습니다. 설정은 오른쪽 위 톱니바퀴 버튼으로 열고요. 체중은 0.1kg부터 999.9kg까지 받고, 그 밖의 값을 넣으면 저장하지 않은 채 “0.1~999.9kg 사이로 입력해 주세요.”라고 알려 줍니다.

하루에 기록은 하나

같은 날 두 번 저장하면 기록이 두 개 생기는 게 아니라 그날 값이 바뀝니다.

weightState.tsts
/** Pure state update. The caller persists the returned value and handles storage errors. */
export function recordWeight(state: WeightState, weight: number, date = getToday()): WeightState {
  if (!validateWeight(weight) || !isCalendarDate(date)) {
    throw new RangeError('체중과 날짜를 확인해 주세요.');
  }
  const rounded = Math.round(weight * 10) / 10;
  const records = [...recordMap(state.records).values()];
  const existingIndex = records.findIndex((record) => record.date === date);
  const record = { date, weight: rounded };
  if (existingIndex >= 0) records[existingIndex] = record;
  else records.push(record);
  records.sort((a, b) => a.date.localeCompare(b.date));
  return { ...state, records, startWeight: state.startWeight || rounded, isOnboarded: true };
}

값을 0.1kg 단위로 반올림하고, 그 날짜의 기록이 이미 있으면 바꾸고 없으면 더합니다. 화면의 버튼도 여기에 맞춰 이름이 바뀌어요. 오늘 기록이 없으면 “오늘 기록”, 있으면 “오늘 기록 수정”입니다.

계산과 저장을 나눈다

이 함수는 새 상태를 만들어 돌려주기만 하고 기기에 쓰지는 않습니다. 저장은 부른 쪽에서 따로 하고, 실패하면 “기기에 저장하지 못했어요”라고 알려요. 저장이 안 됐는데 화면에 저장됐다고 나오는 일을 막으려는 구조입니다. 경조사 봉투장부에서 쓴 것과 같은 생각이에요.

함께 읽기앱인토스 미니앱 5 – 경조사 봉투장부앱인토스 미니앱 경조사 봉투장부 제작기입니다. 축의금과 부의금을 기록하고 다음 경조사 때 다시 찾는 앱을 만들면서 정한 기준과, 기록을…

빠진 날짜를 지어내지 않는다

이 앱은 연속 기록을 요구하지 않고, 빠진 날을 실패로 표시하지도 않습니다. 그러면 기록이 듬성듬성할 때 평균을 어떻게 낼지를 정해야 하는데, 기준은 “입력한 값만 쓴다”로 잡았습니다.

weightState.tsts
function average(records: WeightRecord[]): number | null {
  if (records.length < 3) return null;
  return records.reduce((total, record) => total + record.weight, 0) / records.length;
}

기록이 3개보다 적으면 평균을 내지 않습니다. 화면은 이때 평균 대신 “기록이 3회 모이면 7일 평균을 보여드려요”라고 안내합니다. 평균을 보여줄 때도 “최근 7일 중 기록한 6일 평균”처럼 며칠 치인지 같이 적어요.

그래프도 마찬가지입니다. 위 세 번째 화면을 보면 선이 중간중간 끊겨 있는데, 기록이 없는 날을 건너뛰고 점을 이으면 그 사이에도 값이 있었던 것처럼 보이기 때문에 일부러 잇지 않았습니다.

주간 비교는 끝난 주끼리만

주간 요약은 지난주와 그 전 주의 평균을 비교합니다. 여기서 “이번 주”는 넣지 않아요.

weightState.tsts
/** Compares the two most recent complete Monday–Sunday weeks; never includes the current partial week. */
export function getCompletedWeeklyComparison(state: WeightState, today = getToday()): WeeklyComparison {
  const currentWeekStart = addDays(mondayOfWeek(today), -7);
  const currentWeekEnd = addDays(currentWeekStart, 6);
  const previousWeekStart = addDays(currentWeekStart, -7);
  const previousWeekEnd = addDays(previousWeekStart, 6);
  const current = summarizePeriod(state, currentWeekStart, currentWeekEnd);
  const previous = summarizePeriod(state, previousWeekStart, previousWeekEnd);
  const difference = current.average === null || previous.average === null
    ? null
    : current.average - previous.average;
  return { current, previous, difference };
}

오늘이 수요일이면 이번 주는 사흘 치밖에 없습니다. 그래서 월요일부터 일요일까지 다 지난 주 두 개만 놓고 봅니다. 두 주 모두 기록이 3개 이상이어야 차이를 계산하고, 한쪽이라도 모자라면 차이를 보여주지 않아요.

차이를 보여주는 말투도 정해 뒀습니다. 두 주의 평균과 함께 “두 주 평균 차이 -0.5kg”이라고 적을 뿐, 잘했다거나 분발하라는 말은 붙이지 않습니다. 색으로 좋고 나쁨을 가르지도 않아요. 하루하루의 변동을 평가하거나 건강 판정처럼 읽힐 표현을 피하려는 겁니다. 화면에 보이는 두 평균을 직접 빼면 0.1kg쯤 다를 수 있는데, 앱은 반올림하기 전 값으로 차이를 계산합니다.

남에게 보이지 않는 기록

체중은 남에게 보이고 싶지 않은 숫자입니다. 그래서 공유 기능을 만들지 않았고, 순위나 다른 사람과의 비교도 없습니다. 기록은 이 기기에만 저장되고 자동으로 동기화되지 않아요.

목표 체중도 기본으로는 보이지 않습니다. 설정에서 직접 정한 사람에게만 표시돼요.

기록과 기본 요약, 그래프는 전면 광고 없이 쓸 수 있습니다. 30일을 구간별로 나눈 평균 요약을 더 보고 싶을 때만 광고 안내가 나옵니다.

목표와 지난 기록은 설정에서

설정 시트에는 목표 체중, 알림 수신 설정, 저장된 기록, 기기 기록 초기화가 차례로 들어 있습니다.

체중 다이어리 설정 시트. 목표 체중 칸에 60.0kg을 넣고 저장한 뒤 아래에 목표 끄기 링크가 나타난 모습
목표 체중 저장
저장된 기록 목록에서 휴지통을 누르자 기록을 삭제할까요라는 확인 창에 2026.10.06 · 62.3kg이 표시된 모습
기록 하나 지우기

목표 체중 칸 위에는 “직접 정한 경우에만 홈에 보여요. 목표를 설정하지 않아도 모든 기록 기능을 이용할 수 있어요.”라고 적혀 있어요. 저장하면 홈의 기록 칸 아래에 “설정한 목표 60.0kg”처럼 한 줄이 생기고, “목표 끄기”를 누르면 다시 사라집니다. 목표까지 몇 kg 남았는지는 따로 계산해 보여주지 않아요. 화면의 목표 60.0kg도 시연용으로 넣은 값입니다.

저장된 기록 목록에서는 날짜별 값을 하나씩 지울 수 있습니다. 휴지통을 누르면 지울 날짜와 값을 담은 확인 창이 먼저 뜨고, “삭제”를 눌러야 지워져요. 전체 초기화도 “기록을 초기화할까요?”라는 확인을 거치는데, 창 안에 “초기화 후에는 되돌릴 수 없어요”라고 밝혀 뒀습니다. 시트 맨 아래에는 “자동 동기화나 기기 변경 시 복구 기능은 제공하지 않아요.”라는 문구가 있고요.

알림 칸에는 “체중값과 목표값은 알림 문구에 표시하지 않아요.”라는 한 줄이 있습니다. 기획안에서 알림 제목과 본문, 잠금 화면 미리보기에 체중값이나 증감량을 넣지 않기로 정했거든요.

기록을 못 읽으면 새 기록으로 덮지 않는다

체중 다이어리는 저장된 기록을 읽은 결과를 ‘비어 있음’, ‘정상’, ‘오류’로 나눕니다. 처음 쓰는 사람이면 비어 있음, 기록이 있으면 정상이에요. 저장소에 접근하지 못했거나 저장된 내용을 해석하지 못하면 오류로 보고, 빈 상태로 바꿔 시작하지 않고 아래 화면을 띄웁니다.

체중 다이어리 기록 읽기 오류 화면. 기존 기록을 불러오지 못했어요라는 제목과 저장된 기록은 삭제하거나 초기 상태로 바꾸지 않았어요라는 설명, 다시 시도 버튼이 있다
저장된 값을 읽지 못했을 때

이 화면에는 “다시 시도” 버튼 하나만 둡니다. 기획안에 성공적으로 읽기 전에는 전체 초기화를 권하지 않는다고 적어 둔 대로예요. 위 화면은 로컬에서 저장된 값을 일부러 깨뜨려 놓고 찍었습니다.

읽을 때 검사도 꼼꼼한 편입니다. 날짜가 실제 달력에 있는 날인지, 체중이 0.1~999.9kg 안에 있는지를 기록마다 보고, 하나라도 맞지 않으면 그 기록만 슬쩍 빼지 않고 전체를 오류로 돌려요. 예전 형식으로 저장된 기록에 같은 날짜가 여러 번 들어 있으면 나중에 저장된 값 하나로 정리하고, 지금 화면에서 쓰지 않는 예전 항목은 지우지 않고 그대로 둡니다.

다음에 할 일

몇 주 운영한 뒤에 기록이 실제로 어떻게 쌓이는지 다시 확인해 볼 생각입니다.

11월 5일 2차 개선에서는 저장을 한 번의 탭으로 줄였습니다. 홈 첫 화면에서 “어제와 같아요”나 −0.2·−0.1·+0.1·+0.2 칩 하나를 누르면 오늘 기록이 바로 저장되고, 방금 저장한 기록을 되돌리는 버튼이 함께 나와요. 그 아래에는 기본값이 주 5일인 기록 목표와 연속 기록 일수가 붙었습니다. 앞에서 덜어 냈던 연속 기록을 다시 넣은 셈인데, 이번에는 체중값이 아니라 기록한 날의 수를 셉니다. 체중이 늘어도 기록하면 채워지는 구조라 감량을 재촉하거나 평가하지 않고, 빠진 날을 실패로 표시하지도 않아요.

체중 다이어리 홈. 11월 5일 목요일, 탭 한 번으로 저장 카드에 어제와 같아요 66.5kg 버튼과 −0.2부터 +0.2까지 칩, 이번 주 기록 목표 3/5일이 보인다
탭 한 번으로 저장 (시연 데이터)
저장 직후 화면. 오늘 66.5kg 저장과 방금 저장한 기록 되돌리기, 이번 주 기록 목표 4/5일과 남은 1일, 연속 11일·내 최고 12일이 보인다
이번 주 기록 목표와 연속 (시연 데이터)

프로젝트를 어떤 식으로 진행하는지는 프로젝트 진행 방식에, 매일 기록하는 또 다른 앱 이야기는 물마시기 글에 있습니다.

체중 다이어리 자주 묻는 질문

체중 다이어리는 어떤 앱인가요?

오늘 체중을 간편하게 기록하고 최근 7일·30일 흐름과 주간 요약을 확인하는 앱입니다. 목표 체중은 설정에서 직접 정했을 때만 표시됩니다.

기록을 빠뜨린 날은 어떻게 처리하나요?

빠진 날짜의 값을 추정해서 채우지 않습니다. 평균은 실제로 기록한 날의 값으로만 내고, 그래프에서는 날짜가 비어 있으면 점을 선으로 잇지 않습니다.

체중 기록은 어디에 저장되나요?

이 기기에만 저장되고 자동으로 동기화되지 않습니다. 공유 기능도 없습니다.

업무에 맞춘 AI 설계 상담은 AI특별시에서 받습니다.

이 글은 앱인토스 미니앱 「체중 다이어리」의 기록입니다. 앱인토스는 토스 앱 안에서 미니앱을 서비스하는 플랫폼이고, 공식 안내는 앱인토스 개발자센터에 있습니다.

이 글은 공식 자료와 실제 화면을 기준으로 정리했습니다. 정책·가격은 기준일 이후 바뀔 수 있습니다.

Similar Posts

2 Comments

답글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다