이 글의 순서
핵심 내용
건강 기록 앱을 의뢰할 때는 사용자가 직접 남기는 기록과 스마트폰의 건강 데이터를 가져오는 기능을 나누어 견적에 넣어야 합니다. 두 기능을 한 화면에 보여주더라도 입력 화면, 연동 권한, 값이 없는 상태의 처리와 서버 저장 범위는 서로 다릅니다.
첫 버전에서는 어떤 항목을 직접 입력하고 어떤 항목을 연동할지, 가져온 데이터를 앱에서만 볼지 서버에도 보관할지부터 정하면 됩니다. 이 글에서는 두 방식의 차이와 앱·서버가 맡을 작업을 비교하고, 개발사에 전달할 첫 범위를 정리합니다.
직접 기록과 건강 데이터 연동은 들어오는 경로가 다릅니다.
사용자가 오늘의 컨디션과 메모를 작성하는 것은 앱이 만든 입력 화면에서 시작합니다. 반면 걸음 수 등 건강 데이터를 읽으려면 대상 플랫폼에서 해당 데이터가 제공되는지, 사용자가 그 항목의 읽기 권한을 허용했는지 확인해야 합니다. 연결했다는 사실만으로 모든 수치가 들어오는 것은 아닙니다.
| 비교 항목 | 사용자가 직접 기록 | 건강 데이터 연동 |
|---|---|---|
| 데이터가 들어오는 곳 | 앱의 선택·입력 화면 | 스마트폰 건강 데이터의 제공 경로 |
| 앱에서 만드는 기능 | 입력 조건, 저장, 조회와 필요한 수정 | 지원 여부 확인, 항목별 권한, 읽기와 상태 표시 |
| 값이 없을 때 | 작성 전 상태와 기록 안내 | 권한 필요·제공된 자료 없음 등을 구분 |
| 서버 보관 | 저장 요청과 계정별 조회 범위를 구성 | 앱에서 읽은 뒤 보낼 항목과 보관 기간을 별도로 정함 |
| 변경 처리 | 누가 언제 수정할지 정함 | 새로 읽을 시점과 기존 값의 갱신 기준을 정함 |
두 방식을 병행한다면 직접 입력한 값과 연동한 값을 구분해 표시하는 편이 좋습니다. 같은 항목을 두 경로로 받는 경우 어느 값을 사용할지, 서로 덮어쓸지까지 정해야 합니다.
입력한 기록과 가져온 데이터의 출처를 구분해 보여줍니다.
오늘 기록 화면에는 사용자가 고른 컨디션과 작성한 메모를 보여줄 수 있습니다. 건강 데이터 화면에서는 가져온 걸음 수 등 항목의 값과 출처, 읽은 시각을 함께 표시합니다. 같은 날의 정보라도 무엇을 직접 작성했고 무엇을 연동했는지 구분할 수 있어야 합니다.
예를 들어 오늘의 컨디션은 직접 기록하고, 오늘 걸음 수는 Health Connect에서 가져와 함께 보여줄 수 있습니다. 연동이 안 된 상태에서도 직접 작성하는 기능을 계속 쓸지, 일부 항목만 허용했을 때 무엇을 보여줄지까지 화면 흐름에 넣습니다.
한 화면에 함께 보이는 것과 같은 방식으로 저장되는 것은 다릅니다. 화면 구성에 이어 서버에 어떤 항목을 남길지도 나눠 확인해야 합니다.
권한이 없는 상태와 기록이 없는 상태를 나눕니다.
연동 화면은 값이 정상적으로 들어오는 장면만 준비하면 부족합니다. 사용자는 일부 항목만 허용할 수 있고, 허용한 뒤에도 그날의 자료가 없을 수 있습니다. 숫자 대신 표시할 안내와 다음 동작도 개발 범위에 포함합니다.
| 현재 상태 | 화면에서 알려줄 내용 | 필요한 다음 동작 |
|---|---|---|
| 권한이 필요한 상태 | 어떤 항목을 읽을 권한이 필요한지 | 연동 안내나 권한 설정으로 이동 |
| 권한은 있으나 자료가 없음 | 선택한 항목·기간에 제공된 기록이 없다는 안내 | 기록 제공 경로를 확인하고 다시 읽기 |
| 자료 읽기 완료 | 항목의 값, 출처와 읽은 시각 | 정한 시점에 새로 읽기 |
| 연동 불가·읽기 실패 | 사용할 수 없거나 이번 요청이 실패했다는 안내 | 지원 여부 확인 또는 다시 시도 |
위 표는 Android Health Connect의 상태를 나눈 예시입니다. iPhone의 HealthKit은 읽기 권한의 허용·거절 여부를 앱이 직접 알 수 없으므로, 빈 조회 결과만으로 권한 거절을 단정하지 않고 플랫폼에 맞게 안내를 설계합니다.
자료가 없다는 상태를 무조건 0으로 바꾸면 ‘기록을 가져오지 못함’과 ‘실제로 0인 기록’이 섞입니다. 권한을 나중에 해제했을 때도 새로 읽기를 계속 시도하거나 이전 값을 최신 값처럼 보여주지 않도록 기준을 정합니다.
서버 보관과 날짜별 조회는 별도 범위로 정합니다.
직접 기록은 ‘입력 → 저장 요청 → 서버 저장 → 저장된 기록 조회’로 이어집니다. 화면에 저장 완료를 보여주는 것뿐 아니라 다시 열었을 때 같은 계정의 기록을 가져올 수 있어야 합니다.
건강 데이터는 휴대폰에서 읽었다고 서비스 서버에도 자동으로 저장되지 않습니다. 서버에 모아 날짜별 조회나 다른 기기에서 이어보기가 필요하다면, 전송할 항목·보관 기간·조회 기능을 함께 정합니다. 직접 작성한 기록과 가져온 데이터의 날짜·기준 시간도 맞춰야 합니다.
오늘 상태만 보는 앱과 지난 한 달을 날짜별로 비교하는 앱은 조회 범위가 다릅니다. ‘수면’도 오늘 자정부터의 기록을 볼지, 전날부터 이어진 수면을 한 번으로 묶을지에 따라 결과가 달라질 수 있습니다.
연동 데이터는 앱을 열었을 때 읽을지, 새로고침할 때 읽을지부터 선택할 수 있습니다. 앱이 닫힌 동안의 주기적인 읽기나 장기간의 과거 자료 조회는 플랫폼의 지원·권한 조건과 필요한 구현을 별도로 검토합니다.
HeadLog는 직접 기록과 연동 상태를 한 흐름에 연결했습니다.
HeadLog는 사용자가 두통 강도를 직접 기록하고, Android의 Health Connect 연동 상태와 건강·행동 정보를 확인하는 앱입니다. 두통 기록의 저장·조회 API를 연결하고, 리포트에서 날짜별 두통 기록을 살펴보도록 구성했습니다.
건강 데이터는 당일 요약과 출처·동기화 상태를 표시하고, 권한이 필요한 항목과 자료가 없는 항목을 구분합니다. 기록을 받는 기능뿐 아니라 연동이 되지 않는 상황에서도 사용자가 현재 상태를 이해할 수 있게 만드는 것이 개발 범위의 일부입니다.
첫 견적에는 항목·플랫폼·보관 범위를 적어주세요.
개발사에는 완성된 화면보다 먼저 다음 네 가지를 알려주세요.
- 직접 입력할 항목과 연동할 항목: 컨디션·메모·걸음 수 등 필요한 항목을 구분합니다.
- 지원할 플랫폼과 연결 경로: Android Health Connect, iPhone의 HealthKit 등 대상별 범위를 정합니다. 웨어러블을 직접 연결할 필요가 있다면 함께 알려주세요.
- 보여줄 기간과 새로 읽을 시점: 오늘 요약, 날짜별 기록, 앱 실행·새로고침 시 갱신 중 필요한 흐름을 적습니다.
- 서버에 남길 정보: 계정별 기록 보관, 다른 기기에서 조회, 수정·삭제가 필요한 항목을 정합니다.
처음에는 직접 기록과 필요한 한두 가지 연동 항목을 한 흐름으로 확인해도 됩니다. 지원 기기에서 권한 허용·거절, 자료 있음·없음, 저장 후 재조회까지 함께 확인하면 첫 출시 범위와 이후 추가할 기능을 나누기 쉬워집니다.
건강 기록 앱의 첫 개발 범위를 정리하고 싶다면, 직접 기록할 항목과 연결할 데이터를 알려주세요. 필요한 화면·연동·서버 보관 범위를 나누어 함께 살펴보겠습니다.
플랫폼 기준 확인: Android Health Connect · Apple HealthKit 권한






