딱 12회씩 3세트에 집중하고 싶어서: 헬스 앱을 만든 이유
헬스 앱을 만든 이유는 단순했습니다. 무료로, 심플하게 쓰고 싶었습니다. 운동할 때 필요한 기록을 남기고, 지금 해야 할 세트에 집중할 수 있으면 좋겠다고 생각했습니다.
제가 하고 싶었던 운동도 명확했습니다. 빡세게, 딱 12회씩 3세트. 근력과 근육량을 늘리는 것을 목표로, 운동하는 시간을 효율적으로 쓰고 싶었습니다. 여기서 12회와 3세트는 제가 기록하며 운동하고 싶었던 기준입니다. 앱에서 모든 운동을 그 숫자로 고정하려는 뜻은 아닙니다.
몇 kg으로 몇 번 했는지, 지금 몇 세트째인지, 지난번에는 어떻게 했는지. 이런 내용을 간단히 확인할 수 있는 도구를 만들기 시작했고, 그것이 FitTracker Pro가 됐습니다.
1. 운동보다 기록이 복잡해지지 않았으면 했습니다
운동 기록에 필요한 것은 생각보다 분명합니다. 오늘 할 종목을 정하고, 세트별 중량과 횟수를 적고, 마친 세트를 표시하는 것입니다. 다음에 같은 운동을 할 때 지난 기록을 참고할 수 있으면 더 좋습니다.
FitTracker Pro는 날짜별로 운동을 추가하고 세트마다 중량, 반복 횟수, 완료 여부를 기록하도록 구성했습니다. 세트 사이에는 휴식 타이머를 쓰고, 쌓인 기록은 운동량 차트로 돌아볼 수 있습니다.
앱에 숫자가 쌓이는 것 자체가 목적은 아닙니다. 이전에 어떻게 운동했는지 기억하는 부담을 줄이고, 오늘 할 운동에 집중하는 데 도움이 됐으면 했습니다.
2. 같은 운동을 매번 다시 입력하지 않도록 했습니다
운동 구성을 반복해서 입력하는 일도 줄이고 싶었습니다. 그래서 추천 루틴을 가져오거나 운동 코드를 복사해 사용하는 기능을 연결했습니다.
이때 중요한 구분이 있습니다. 다른 사람의 운동 구성을 가져오는 것과 그 운동을 완료한 것은 다릅니다. 종목과 중량, 횟수, 휴식 시간은 참고할 수 있지만 완료 표시까지 복사하면 제가 이미 운동한 것처럼 보이게 됩니다.
가져오기 기능에서는 완료 상태를 초기화하고, 기존에 같은 이름의 운동이 있으면 건너뛰도록 했습니다. 새 기능을 추가하면서도 이미 적어둔 기록이 뜻하지 않게 바뀌지 않도록 신경 쓴 부분입니다.
3. 화면은 가볍게, 기록은 이어서 쓸 수 있게 구성했습니다
현재 프로젝트의 웹 화면은 HTML, CSS와 일반 JavaScript로 만들었습니다. 차트에는 Chart.js를 사용하고, 브라우저의 localStorage에도 운동 기록을 저장합니다.
계정과 서버 데이터는 별도로 운영하는 Admin 프로젝트와 연결됩니다.
웹 화면: HTML, CSS, JavaScript, Chart.js
서버 API: Admin의 Next.js와 TypeScript
데이터베이스: Prisma를 통한 PostgreSQL
계정 연결: 카카오 로그인과 서버 세션
웹 배포: Cloudflare Workers의 정적 자산 배포
앱 화면: Android의 Kotlin·WebView, iOS의 SwiftUI·WKWebView 코드
앱에서는 웹 화면을 보여주는 구조를 사용합니다. 일반적인 화면 수정은 웹 배포로 반영할 수 있지만, 네이티브 로그인 연결이나 공유 기능을 바꾸면 앱 빌드도 필요합니다. iOS 코드가 있다는 사실과 스토어에 출시됐다는 것은 별개입니다.
Firebase 인증과 Firestore를 사용하는 코드도 남아 있습니다. 다만 카카오 계정을 기준으로 기기간 운동 기록을 맞추는 중심은 Admin 서버입니다.
4. 기록을 저장하는 것보다 맞추는 일이 더 까다로웠습니다
휴대폰에서 오늘 운동을 기록한 다음, 한동안 쓰지 않은 다른 기기에서 로그인한다고 생각해 보면 문제가 보입니다. 오래된 기기의 기록을 서버에 먼저 올리면 최신 기록이 덮일 수 있습니다.
그래서 동기화는 서버 기록을 먼저 읽고, 기기의 기록과 병합한 뒤 업로드하는 순서로 구성했습니다. 그렇다고 서버 기록을 무조건 덮어씌울 수도 없습니다. 기기에서 방금 수정했지만 아직 서버에 보내지 못한 내용이 있을 수 있기 때문입니다.
현재 구현에는 업로드하지 않은 날짜별 변경을 보호하고, 요청 도중 계정이 바뀌면 이전 계정의 늦은 응답을 적용하지 않는 처리도 들어 있습니다.
삭제한 운동이 다시 나타나는 문제도 있었습니다. 예전 저장 위치에서 데이터를 넓게 찾아 합치면 이미 지운 운동까지 가져올 수 있었습니다. 현재 기록을 우선하고, 삭제한 날짜도 병합 과정에서 고려하도록 정리했습니다.
기록 앱에서는 저장 버튼만 잘 동작한다고 끝이 아니었습니다. 사용자가 수정하고 지운 의도까지 이어져야 했습니다.
5. 운동 기록과 공개는 따로 선택하게 했습니다
운동을 끝낸 뒤 공유할 수 있는 오운완 커뮤니티도 연결했습니다. 다만 운동을 기록하는 일과 다른 사람에게 공개하는 일은 구분했습니다.
커뮤니티에 들어갔다고 과거 기록이 곧바로 공개되는 방식이 아니라, 오늘의 세트를 모두 마친 뒤 공유를 선택하는 흐름입니다. 자동 공유 역시 사용자가 직접 켜도록 구성했습니다.
개인 기록 전체를 그대로 보여주기보다 공개하기로 한 내용을 별도 게시물로 다룹니다. 다른 사람의 운동을 참고할 수는 있어도, 내 기록을 어디까지 보여줄지는 직접 정할 수 있어야 한다고 생각했습니다.
6. 처음 만든다면 이렇게 요청할 수 있습니다
다음은 현재 기능과 개발 계기를 바탕으로 다시 정리한 시작 프롬프트입니다. 개발 당시의 대화 원문은 아닙니다.
무료로 심플하게 사용할 개인 운동 기록 앱을 만들고 싶어.
나는 12회씩 3세트를 기준으로 운동을 기록하고 싶지만, 종목마다 횟수와 세트 수를 수정할 수 있게 해줘.
날짜별로 종목, 중량, 반복 횟수와 완료 여부를 기록하고 지난 운동을 참고할 수 있으면 좋겠어.
먼저 HTML, CSS, JavaScript로 모바일에서 쓰기 편한 화면을 만들고, 새로고침해도 기록이 남도록 해줘.
휴식 타이머를 추가하고, 운동 중에는 적은 조작으로 세트를 완료할 수 있게 해줘.
로그인과 기기간 동기화는 기본 기록 기능을 만든 뒤 단계적으로 연결해줘.
구현한 기능과 아직 남은 작업을 구분해서 설명해줘.
운동할 때 계속 쓰게 되는 도구를 만들고 싶습니다
시작은 무료로 쓸 수 있는 심플한 기록 도구였습니다. 지금은 루틴과 동기화, 공유 기능까지 붙었지만 처음 원했던 것은 여전히 같습니다. 기록 때문에 흐름이 끊기지 않고, 해야 할 운동에 집중할 수 있는 앱입니다.
12회씩 3세트를 했는지, 어떤 중량을 사용했는지, 다음에 참고할 기록이 남았는지. 그 기본을 편하게 확인할 수 있도록 계속 다듬으려고 합니다. 앞으로 이 카테고리에는 운동 기록을 저장하고 연결하면서 고민한 내용과 실제로 바꾼 기능을 하나씩 남기겠습니다.


댓글 (0)