CatBreath / 사용설명서
가볍게 시작하는 기록
측정부터 과거 기록 가져오기까지, 필요한 내용을 골라 보세요.
우리 고양이
- 측정 탭의 고양이 등록 또는 설정 → 우리 고양이를 여세요.
- 이름을 입력하세요. 생일·성별·품종·메모는 나중에 추가해도 돼요.
- 측정이 끝나면 고양이를 선택하고 저장하세요. 이 화면에서도 새 고양이를 등록할 수 있어요.
- 기록에서 고양이를 선택하면 해당 고양이의 측정값·이벤트·그래프만 보여요.
- 삭제하려면 설정 → 우리 고양이에서 카드를 바로 왼쪽으로 밀고 휴지통 아이콘을 누르세요. 수정을 먼저 누를 필요는 없어요. 수정을 누른 뒤 고양이 카드를 열어 저장 아래의 고양이와 기록 삭제를 눌러도 돼요. 두 방법 모두 확인창에서 삭제를 확정해야 해요.
- 고양이를 삭제하면 해당 고양이의 측정값·이벤트·약·투약 기록·사진·사용자 측정 항목도 함께 삭제되며 되돌릴 수 없어요. 다른 고양이와 미지정 기록은 유지돼요.
1. 호흡수 측정
- 측정 탭에서 고양이의 가슴이나 배가 오르내리는 것을 보세요.
- 첫 호흡에 누르면 0회로 시작해요. 다음 호흡부터 한 번씩 누르세요.
- 30초가 되면 측정이 자동으로 끝나요. 설정 → 호흡 측정 시간에서 20초·30초·60초 중 고를 수 있고, 그 전에 끝내려면 측정 종료를 누르세요.
- 큰 숫자인 분당 호흡수(정수)를 확인하고, 수면 중·휴식 중을 고른 뒤 고양이를 선택해 저장하세요.
2. 과거 측정값 직접 입력
- 기록 → 측정 항목을 열고 왼쪽 +를 누르세요.
- 새 측정 항목은 측정 옆 +에서 추가하세요. 이름을 입력하고 단위/회/백분율을 고른 뒤 단위를 입력하세요. 회·백분율은 고정 단위(회·%)를 확인하면 돼요. 마지막으로 표시 방식(총합 / 평균)을 고릅니다. 총합은 하루 기록을 더하고 평균은 하루 기록의 평균을 보여줘요. 개별 기록은 그대로 유지돼요.
- 기존 항목은 기록 상세의 항목 제목 옆 수정을 누르세요. 측정·기록 목록을 수정 중일 때 각 항목의 수정 버튼이나 설정 → 측정 항목 관리에서도 같은 화면을 열 수 있어요. 이름·단위·총합/평균을 바꾸고 저장하세요. 값 종류는 고정되며, 기본 체중은 단위만 바꿀 수 있어요.
- 사용자 측정 항목은 측정·기록의 카드를 바로 왼쪽으로 밀거나, 항목 수정 화면의 저장 아래 항목 삭제를 눌러 지울 수 있어요. 확인창에서 이름과 삭제 범위를 확인하세요. 기록이 있는 항목은 그 항목의 모든 측정값도 함께 삭제하며 되돌릴 수 없어요. 다른 항목·고양이의 기록은 유지되고, 기본 항목은 삭제할 수 없어요.
- 총합/평균을 바꾸면 과거 그래프도 다시 계산되며 원본 기록은 유지돼요. 같은 날 2.5와 4.5는 총합 7, 평균 3.5로 표시돼요. 단위를 바꾸면 표시만 달라지고 수치가 환산되지는 않아요.
- 화면에 표시된 단위에 맞춰 값을 입력하세요.
- 실제 측정한 날짜·시간을 입력하고 고양이를 선택한 뒤 저장을 누르세요.
- 기록 탭에는 측정값이 먼저 나와요. 숫자 아래에 최근 기록(날짜)인지 하루 합계인지 표시돼요. 이벤트 기록은 위쪽 버튼으로, 투약 기록은 아래 접힌 카테고리에서 확인하세요.
3. CSV·표 가져오기
- 기록 → 측정 항목 → 과거 기록 가져오기를 여세요.
- CSV 파일을 선택하거나 아래 열 순서에 맞춘 표를 붙여넣으세요.
- 가져올 기록 확인을 누르고, 오류가 표시된 행을 고치세요.
- 고양이를 선택하고 날짜와 값을 확인한 뒤 저장을 누르세요.
date,time,value
2026-01-15,09:30,4.6
2026-01-16,18:00,4.7| 열 | 형식 / 예시 |
|---|---|
| date | 측정 날짜. YYYY-MM-DD 형식으로 월·일을 두 자리로 적으세요. 예: 2026-01-15. 1980-01-01부터 입력할 수 있어요. |
| time | 측정 시간. 24시간제 HH:mm 형식이며 콜론이 필요해요. 예: 09:30, 18:05. 0930이나 오전/오후 표기는 사용할 수 없어요. |
| value | 측정값. 예: 4.6, 25, 0. 소수점은 마침표(.)를 쓰고 kg, mL, % 같은 단위나 천 단위 쉼표는 넣지 마세요. |
CSV 작성 규칙
- 첫 행은 반드시 영문 헤더 date,time,value여야 하며, 이후 모든 행도 날짜·시간·값의 세 열 순서를 지켜야 해요. 고양이 이름·항목 이름·메모 등 다른 열을 추가하지 마세요.
- 쉼표로 구분한 UTF-8 CSV 파일을 선택하거나, Excel·Numbers에서 헤더를 포함한 세 열을 복사해 탭으로 구분된 표로 붙여넣으세요. .xlsx나 .numbers 파일은 먼저 UTF-8 CSV로 내보내야 해요.
- 한 번에 선택한 고양이의 한 측정 항목만 가져와요. 파일에 고양이나 단위 열은 없으며 화면에서 고른 고양이와 표시된 단위가 적용돼요. 단위를 자동 변환하지 않으므로 값부터 맞춰 주세요.
- 날짜와 시간은 기기의 현재 시간대로 해석해요. 시간대나 UTC 표시를 붙이지 마세요. 실제로 존재하지 않는 날짜·시간, 미래 시각, 빈 날짜·시간·값은 오류예요.
- 값은 0 이상의 숫자로 적으세요. 횟수는 정수만, 백분율은 0~100만 가능하고 기본 호흡수·체중은 0보다 커야 해요. 음수·수식·지수 표기(1e3)는 사용할 수 없어요.
- 파일은 최대 1 MB, 기록은 헤더를 제외하고 최대 1,000행이에요. 더 많으면 여러 파일로 나누세요. 예시의 날짜와 값은 실제 측정한 내용으로 바꿔 주세요.
- 가져올 기록 확인에서 날짜·값·오류 행을 확인하세요. 오류가 하나라도 있으면 저장할 수 없으므로 원본이나 붙여넣은 내용을 고친 뒤 다시 확인하세요. 확인만 해서는 저장되지 않아요.
- 같은 고양이·항목·측정 시각·값이 모두 같은 기록은 파일 안에서도, 이미 저장된 기록과 비교할 때도 중복으로 건너뛰어요. 시각이 같아도 값이 다르면 별도 기록으로 추가되며 기존 값을 덮어쓰지 않아요.
- 설정의 기록 내보내기로 만든 전체 백업 CSV는 이 세 열 형식과 달라요. 전체 백업은 설정 → 내 기기의 기록 → 앱 백업 가져오기에서 복원하세요.
4. 기록 함께보기
- 그래프 위에서 기간을 고르세요. 두 손가락으로 벌려 확대하고, 확대한 상태에서 끌어 이동하세요.
- 날짜를 누르면 값과 이벤트가 표시돼요. ? 버튼에서 그래프 설명을, ⤢ 버튼에서 전체 화면을 볼 수 있어요. 전체 화면에서는 휴대폰을 어느 방향으로 돌려도 됩니다.
- 그래프 위 항목 이름을 누르면 그 항목을 그리거나 뺄 수 있어요. 추이는 항목마다 다른 색으로, 비율은 두 항목의 비율 옆에 함께 그려요. 순서는 아래 수정에서 바꾸세요.
- 측정 항목 그래프 위에서, 같이보기는 수정할 때 항목 옆에서 선이나 캔들을 고르세요. 두 곳은 따로 기억해요. 설정의 그래프에서는 새 측정 항목의 기본값과 선을 하루 평균으로 묶을지 전부 표시할지 고르고, 모든 그래프를 한 번에 바꿀 수 있어요. 캔들의 선은 하루의 최솟값부터 최댓값까지, 상자는 평균에서 위아래로 표준편차만큼, 점선은 중앙값이에요.
- 두 항목의 비율은 비율, 같은 날 두 값의 관계는 연관성에서 보세요.
5. 이벤트 메모
- 기록 위쪽의 이벤트 기록, 또는 측정의 이벤트 기록 → 이벤트를 여세요. +로 메모를 추가하고, 메모를 왼쪽으로 밀면 삭제할 수 있어요.
- 날짜를 선택하고 사료 변경, 병원 방문 등의 메모를 남기세요.
- 그래프에서 선택한 날짜에도 메모를 추가할 수 있어요.
6. 투약과 스케줄러
- 측정 → 투약을 여세요. +로 약을 추가하고, 수정을 누른 뒤 약을 누르면 정보를 바꿀 수 있어요. 약을 왼쪽으로 밀면 숨기기·삭제가 나와요.
- 스케줄러에서 날짜를 고른 뒤 +를 누르면 그날이 약의 기본 시작일이 돼요. 약 목록을 거쳐 새 약을 추가하거나 기존 약의 투약 기록을 열어도 고른 날짜가 이어져요. 기존 약 정보 수정에서는 저장된 시작일을 유지해요.
- 기존 약의 수정 화면에서도 저장 아래 삭제 버튼을 사용할 수 있어요. 투약 기록이 있으면 기록을 보존하는 숨기기와 약·투약 기록을 영구 삭제하는 기록과 함께 삭제를 구분해 선택하세요. 수정 중 숨긴 약도 복원·수정하거나 왼쪽으로 밀어 삭제할 수 있어요.
- 약물명과 시작 날짜를 입력하세요. 용량·하루 횟수·기간은 선택입니다.
- 하루 1~4회는 하루 횟수 아래 아침·점심·저녁·밤으로 투약 시간을 정해요. 색이 칠해진 첫 칸이 첫 투약이라, 오늘 오후에 시작하면 저녁부터예요. 칸을 누르면 시간대가 추가·제거되고, 칠해진 칸을 끌어 옮기면 첫 투약이 바뀌어요. 저녁에 시작한 7일분은 8일째 아침에 끝나요. 하루 5회 이상은 회차 번호로 표시해요. 나중에 시간대를 바꾸면 오늘부터(오늘 체크한 것이 있으면 내일부터) 적용되고, 지난 날짜의 이름은 그대로예요.
- 기간을 입력하거나, 끝나는 날이 없는 약이면 무기한을 켜면 하루 체크리스트로 만들지 물어봅니다.
- ‹ ›는 하루씩 옮겨요. 날짜를 누르면 연·월·일 다이얼이 열리고, 고른 뒤 확인을 누르세요. 주간·월간은 달력 범위를 바꾸고, 오늘을 누르면 오늘 날짜로 돌아가요.
- 날짜를 고르면 그날의 투약이 나와요. 체크 안 한 항목은 목록에, 완료한 항목은 기본 접힘인 완료된 항목 더 보기에 들어가요.
- 투약이 있는 날에는 점이 하나 찍혀요. 점의 색은 그날 약이 몇 개인지를 나타내고, 그날 것을 다 끝내면 색이 채워져요.
7. 사진 피드
- 스케줄러 달력 위에서 투약을 피드로 바꾸세요. 달력과 날짜 이동은 그대로 쓰고, 점의 색은 그날 올린 사진 수를 나타내요.
- +를 눌러 사진을 고르거나 사진 찍기로 바로 찍고, 날짜·메모·고양이를 정한 뒤 저장하세요. 고른 사진만 앱에 전달되므로 사진 보관함 권한은 묻지 않아요. 사진 찍기는 처음 한 번 카메라 권한을 묻고, 찍은 사진은 CatBreath에 저장돼요. 사진 앱에는 직접 저장할 때만 들어가요.
- 사진을 누르면 전체 화면으로 열리고, 그 화면에서 두 손가락으로 확대·축소해요. 아래의 사진 앱에 저장을 누르면 사진 앱에 저장되고, 처음 한 번은 사진 추가 권한을 물어요. 수정을 누른 뒤 카드를 누르면 바꾸거나 삭제할 수 있어요.
- 사진을 아래로 내려 보면 고른 날짜가 위쪽 바에 남아요. 바를 누르면 달력으로 돌아가요.
8. 화면과 언어
- 설정에서 다크·밝은 화면을 고르세요. 기본은 다크 모드예요.
- iOS 설정 → 앱 → CatBreath → 언어에서 한국어·영어·일본어를 선택하세요. 지원하지 않는 언어는 영어로 표시돼요.
- 측정·기록의 +로 새 항목을 추가하세요. 수정에서 순서·표시를 바꾸세요. 단위를 누르면 저장·취소가 나와요. 단위는 한 번에 하나만 수정하며 고양이는 편집이 끝날 때까지 고정돼요. 사용자 항목은 수정 모드와 관계없이 왼쪽으로 밀어 삭제할 수 있어요. 항목은 고양이마다 따로예요.
9. 기록 보관과 문제 해결
- 기록은 이 기기에 저장돼요. 클라우드 동기화·계정 백업이 없으니 직접 보관할 사본을 내보내 두세요.
- 설정 → 내 기기의 기록 → 기록 내보내기에서 모든 고양이·측정 항목·측정값·이벤트·약·개별 투약·사진 카드를 CSV 파일 하나로 저장할 수 있어요. 사진 파일까지 옮기려면 사진 포함 내보내기를 쓰세요.
- 같은 곳의 앱 백업 가져오기에서 내용을 먼저 확인하고, 이 기기에 없는 기록을 복원하세요. 이미 있는 기록은 현재 내용을 유지해요.
- 항목별 기록 목록에서 기록을 왼쪽으로 밀면 삭제할 수 있어요. 삭제는 되돌릴 수 없어요. 앱을 지우면 기록도 함께 지워지니, 다시 설치하기 전에 꼭 내보내세요.
- 기록·항목·프로필·약 입력은 모두 저장 버튼으로 확정해요. 저장 후 화면 갱신만 실패하면 입력은 잠기고, 다시 시도는 저장한 결과만 다시 불러와요. 저장 전 화면을 나갈 때는 폐기 여부를 확인하며 취소하면 입력을 유지해요.
- 그래프가 열리지 않으면 다시 시도하거나 기간·종류를 바꿔 보세요. 반복되면 에러코드와 당시 동작을 적어 두세요.
전체 백업 CSV 형식
- 설정 → 내 기기의 기록 → 기록 내보내기로 만든 원본 CSV를 선택하세요. 여러 고양이의 측정 항목·기록·이벤트·약·투약을 함께 복원하며, 항목별 date,time,value 파일과는 다른 형식이에요.
- 최신 백업의 첫 행은 kind,cat,type,unit,date,time,value,note,backup입니다. 앞의 8열은 표에서 읽는 용도이고 마지막 backup 열에는 복원에 필요한 식별자·시간·투약 일정·표시 방식 등이 들어 있어요. 열을 삭제하거나 원본을 편집하지 마세요.
- 파일은 UTF-8 CSV, 최대 100 MB까지예요. 선택 후 미리보기에서 고양이·측정값·투약 등의 개수를 확인하고 복원을 누르세요. 기기에 없는 항목만 추가하고 기존 기록이나 수정 내용은 덮어쓰지 않아요. 손상된 파일은 복원하지 않습니다.