BarBear
운동과 건강 기록을 연결하는 앱 — 모듈 구성부터 동기화·저장·성능·기록 내보내기까지
- 첫 기여
- 2026.02.20
- 확인된 최근 기여
- 2026.10.08
- 담당 범위
- 앱 · 데이터 · 배포
기본 브랜치에 반영된 작성자 기여 이력 기준. 최초 기여 2026.02.20 · 최근 확인된 기여 2026.10.08 · 이력 확인 2026.11.04. 최근 기여일은 프로젝트 종료일이 아닙니다.

프로젝트와 맡은 역할
BarBear는 운동·식단·체성분·러닝·등산 기록을 연결해 일상의 건강 관리를 돕는 앱입니다. 앱 기반과 기능 모듈 구성, 기기 간 동기화, 데이터 저장과 복원, 성능 진단, 기록 내보내기와 배포 절차의 개발·개선에 기여했습니다. 아래에는 기여 이력에서 확인한 주요 문제와 기술적 선택을 정리했습니다.
2026.02.20 · 앱 기반과 기능 모듈 구성
기능별 변경 범위를 나누는 구조
확인된 첫 기여는 2026.02.20의 README 등록이며, 같은 날 첫 앱 코드 등록이 이어졌습니다. 화면·도메인·저장소의 책임을 나누고 기능을 확장할 수 있도록 Tuist 기반으로 App·Core·Data·Domain·Services와 기능 모듈을 구성했습니다.
- UIKit·SnapKit으로 화면을 구성하고 RxSwift로 화면과 데이터 흐름을 연결했습니다.
- 운동 기록·식단·러닝·등산 등의 기능을 모듈로 나누고 앱에서 의존성을 조립했습니다.
- 후속 기능 확장에 맞춰 공통 UI와 디자인 토큰을 정리하고 여러 화면에서 재사용했습니다.
확인 근거: README 최초 등록과 앱 소스 등록을 구분해 확인했으며, 이후 커밋에서도 기능별 모듈과 공통 구성의 확장을 확인했습니다.
2026.06.25 · 로컬 우선 저장과 기기 간 동기화
로컬 기록을 기준으로 기기 사이의 변경을 연결
각 기기의 GRDB를 기록의 기준으로 두고 CloudKit Private DB가 변경분을 전달하는 로컬 우선 구조를 구성했습니다. 사용자 입력을 로컬에 저장하는 흐름과 기기 사이에서 변경을 주고받는 흐름을 분리했습니다.
- 변경 추적용 outbox와 CKSyncEngine을 연결해 저장·수정·삭제를 동기화했습니다.
- 충돌 처리와 원격 변경의 재전송 방지, 백업 복원 뒤의 재동기화를 다뤘습니다.
- iPad·Mac Catalyst 지원을 추가하고 HealthKit 등 플랫폼별 지원 차이를 분기했습니다.
- 동기화가 가동되지 않는 환경에서도 로컬 저장을 유지하도록 구성했습니다.
검증: 동기화 매핑과 DB 마이그레이션 테스트를 추가하고, 후속 검토에서 발견한 복원 중 데이터 손실과 관찰·라이프사이클 문제를 수정했습니다.
2026.08.28–30 · 배포 준비와 TestFlight 절차 자동화
배포할 소스와 작업 중인 변경을 분리
여러 브랜치에서 작업하더라도 배포 기준을 명확히 유지하도록 기본 브랜치 기준의 별도 작업 공간에서 아카이브를 만드는 절차를 구성했습니다. 버전 설정부터 아카이브 검증·업로드까지 이어지는 과정을 자동화했습니다.
- Tuist 생성과 fastlane·Xcode 아카이브 절차를 정리했습니다.
- 앱과 확장 타깃의 버전·표시 이름을 검사하고 중복 배포를 방지하도록 보완했습니다.
- 업로드가 성공한 뒤 릴리스 이력을 기록하도록 구성했습니다.
검증: 배포 자동화 커밋에 기록된 아카이브 생성·검사 결과를 확인했습니다. 빌드 없이 실행 계획을 확인할 수 있는 절차도 함께 마련했습니다.
2026.09.01 · 기록이 쌓여도 다룰 수 있는 저장 구조
목록 조회와 무거운 원본 데이터 로딩을 분리
러닝·등산 경로를 기록 목록과 함께 한 덩어리로 보관하면 일부 기록을 열거나 수정할 때도 전체 데이터를 읽고 다시 저장해야 했습니다. 요약과 경로를 나누고, 사진과 동기화 대기 기록의 크기도 제어하도록 개선했습니다.
- UserDefaults의 GPS 경로를 별도 파일로 옮기고 상세 화면에서 필요한 경로를 불러오도록 바꿨습니다.
- 사진을 저장할 때 용도별 해상도 상한을 적용하고 이미지 캐시 갱신을 보완했습니다.
- 같은 레코드의 반복 변경을 outbox 한 건으로 모아 불필요한 적재를 줄였습니다.
- 이전 형식의 원본을 보존하며 기록을 이전하고 저장 공간 확인·정리 화면을 추가했습니다.
검증: 러닝·등산 기록 저장소와 경로 인코딩 테스트를 추가하고, 이전 형식의 기록을 읽어 복원하는 마이그레이션 검증을 진행했습니다.
2026.09.04 · DB 성능 개선과 진단 기반 마련
느린 구간을 관찰하고 조회 비용을 줄이기
기록이 늘면서 조회가 서로 기다리거나 전체 데이터를 읽는 경로를 개선했습니다. 동시에 느린 작업의 위치를 확인할 수 있도록 앱 실행·화면·DB·이미지·네트워크 구간에 진단 수단을 마련했습니다.
- GRDB DatabasePool과 WAL을 적용하고 조회 조건에 맞는 인덱스와 범위 조회를 보완했습니다.
- 사용할 때 탭 화면을 생성하도록 바꾸고 DB의 불필요한 재생성을 줄였습니다.
- 원격 요청에 시간 제한과 캐시 정책을 적용해 응답이 늦는 소스의 영향을 줄였습니다.
- signpost·MetricKit·메인 스레드 진단과 앱 내부의 성능 진단 화면을 연결했습니다.
검증: 조회 계획, DB 읽기·쓰기, 연속 기록 계산과 대용량 데이터의 회귀 테스트를 추가했습니다.
2026.09.15 · 기록 내보내기와 데이터 표현의 정확성
화면 밖에서도 기록의 의미를 유지
사용자가 자신의 기록을 보관하거나 상담 자료로 활용할 수 있도록 기간과 항목을 선택해 PDF·XLSX·CSV로 내보내는 기능을 구현했습니다. 기록을 조립하는 책임을 화면에서 분리하고 형식마다 날짜·수치·누락값의 의미가 달라지지 않도록 보완했습니다.
- 도메인 모델과 기록 조립기를 두고 선택한 항목의 데이터만 조회하도록 연결했습니다.
- PDF 표의 페이지·열 분할과 XLSX·CSV 파일 작성을 구현했습니다.
- 실측값과 추정값을 구분하고 기간·출처·누락값의 표기를 정리했습니다.
- CSV 줄바꿈, XLSX 날짜 정밀도, 긴 문자열과 ZIP 처리에서 발견한 오류를 수정했습니다.
검증: 기록 조립과 파일 작성 테스트에 더해 대량의 합성 기록을 내보내고 생성한 파일을 다시 읽는 회귀 테스트를 추가했습니다.
질문 & 답변
궁금한 점을 남겨주세요 — GitHub 로그인이 필요해요.