케이스 스터디
ELANFIT — AI 음성 코치 피트니스 앱
운동 · 식단 · 인바디 기록과 AI 코치를 한 앱에 — React Native 레거시를 Flutter + FastAPI로 재구축하고, 4.0에서 실시간 음성 코치 · 에너지 과금 · 네이티브 호출어까지 붙인 피트니스 앱
숫자로
7.7초 → 3.5초
사진 분석 지연 (같은 사진 세트, 적용 후 재측정)
93.8%
캐시 적중 (개발 서버 실측)
420/420 성공
무중단 배포 중 요청
5개 국어
지원 언어
개요
ELANFIT은 AI 코칭, 운동 · 식단 · 인바디(체성분) 트래킹, 커뮤니티 피드를 한 앱에 담은 피트니스 모바일 앱입니다. 2026년 2월 첫 출시 이후 iOS · Android에서 운영 중이며, 기획부터 모바일 · 백엔드 · 어드민 · 클라우드 인프라까지 직접 설계 · 개발 · 운영합니다.
기존 React Native + Expo 레거시를 Flutter + FastAPI 스택으로 전면 재구축하고, 온프레미스 서버에서 GCP로 인프라를 무중단 이전했습니다.
2026년 9월에는 3.2.0(9/12) · 4.0.0(9/23) · 4.0.2(9/28)를 연달아 출시했고, 10월 1일 App Store에 4.0.3을 냈습니다. 4.0은 말로 기록하고 말로 코칭받는 앱으로 바뀐 버전입니다 — 실시간 음성 코치, 엔진을 바꿔 끼울 수 있는 음성 구조, 모든 AI 사용량을 재화 하나로 모은 에너지 과금, Swift로 만든 호출어 엔진과 잠금화면 Live Activity가 들어갔습니다.
3.2.0부터는 앱 · API · 웹 · 인프라 작업을 코딩 에이전트 네 갈래로 병렬 진행하고, 통합자(본인)가 계약 · 커밋 · 배포 · 검증 기록을 맡는 방식으로 개발합니다. 작업마다 검증 수단을 미리 정하고, 증거가 검증 기록에 없으면 완료로 보지 않습니다.
AI로 만든 기능
- 01
라이브 음성 코치
운동하면서 말로 기록하고 코칭받습니다. 음성 모델은 듣고 말하기만 하고, 기록 · 조회 · 사진 분석 같은 실제 일은 서버가 넘겨받아 처리한 뒤 결과를 읽어 줍니다. 음성 엔진은 gpt-live-1과 gemini-3.8-live 중에서 고르고, "엘란!" 하고 부르면 바로 음성 모드로 이어집니다.
- 02
사진 · 말 한마디로 식단 분석
음식 사진을 올리거나 먹은 것을 말하면 칼로리 · 영양소를 추정해 식단에 기록합니다. 사진은 비전 모델이 읽고, "괜찮음 · 주의 · 초과" 판정과 남은 칼로리는 모델이 아니라 서버가 하루 목표로 계산합니다. 목표는 신체 정보 · 활동량 · 그날 운동으로 정합니다.
- 03
인바디 결과지 판독
인바디 결과지 사진에서 체성분 숫자를 읽어 추세로 이어 붙입니다. 기록이 많으면 CSV로 한꺼번에 가져옵니다.
- 04
나에게 맞춘 운동 추천
오늘의 체크인(컨디션 · 시간 · 부위)을 받으면 규칙 엔진이 운동 목록에서 루틴을 짜고, 최근 완료율 · 수면 · 피로에 맞춰 세트와 강도를 조정합니다. 이 부분은 LLM이 아니라 규칙 엔진이라 같은 입력이면 같은 루틴이 나오고, AI 코치와 PT 사전 상담을 하면 코치가 제안한 계획을 사용자가 동의할 때 저장합니다.
- 05
기억하고 찾아보는 AI 코치
코치가 기록 · 조회 · 정정 · 되돌리기 도구를 직접 부르고(한 턴의 호출 수에 상한), 지난 상담을 요약한 장기 메모리와 운동 · 영양 지식 DB 검색으로 답을 보강합니다. 앱과 무관한 질문은 모델을 부르기 전에 규칙 분류기가 거릅니다.
- 06
모델을 효율적으로 고르는 구조
대화는 가벼운 gpt-6-luna, 사진 · 결과지 판독은 gpt-6-sol로 나눴습니다. 어려운 턴만 상위 모델로 올리는 승급은 만들었지만 실제 원가가 커서 꺼 두었고, 판단만 돌려주는 모델 제브(Jev)가 턴마다 가벼운 모델로 충분한지 고르는 선택기를 개발 버전에서 시험하고 있습니다(운영 미적용).
AI와 함께 개발한 방식
앱 · 서버 · 어드민 · 인프라를 코딩 에이전트와 함께 만듭니다. Claude Code · Codex · Gemini CLI · Cursor가 같은 작업 규칙 문서(AGENTS.md)를 읽고 일하고, 나눠 한 결과를 합쳐 배포 · 스토어 제출하는 일은 본인이 맡습니다.
- API 계약 파일을 먼저 고치고 앱과 서버가 그 계약을 따르게 해, 에이전트가 나눠 일해도 둘이 어긋나지 않게 합니다. 계약 검사 · 테스트 · 작업 기록을 맡는 에이전트를 따로 둡니다.
- 작업마다 검증 수단(테스트 · 시뮬레이터 캡처 · 실기기 · 운영 실측)을 미리 정하고, 증거가 기록에 없으면 완료로 보지 않습니다.
- 체크리스트를 따라 구현 → 검증 → 커밋을 반복하는 무인 실행 도구를 직접 만들어 씁니다.
흐름
- 인증 — 소셜 로그인(구글 · 애플 · 페이스북) → 백엔드가 ID 토큰 검증 후 자체 JWT(슬라이딩 토큰) 발급
- 트래킹 — 운동 · 식단 · 인바디 · 신체 둘레 · 루틴 기록. 오프라인이면 로컬 큐에 먼저 쓰고 복귀 시 멱등키로 재전송. 건강앱(HealthKit · Health Connect) 연동
- 음성 — 실시간 음성 모델(gpt-live-1 · gemini-3.8-live)과 대화. 서버가 같은 세션에 붙어 도구 호출을 가로채 권한 · 확인 · 상한을 집행
- AI 코치 — 사용자 메시지를 ReAct 루프로 처리해 도구(기록 생성 · 요약 조회 · 피드 검색 · 설정 변경 등)를 호출하고 지식 DB 검색으로 보강
- 비전 — 음식 사진은 하루 누적 기준으로 판정, 인바디 결과지는 사진 판독 또는 CSV 전체 가져오기
- 과금 — 모든 모델 사용량을 "토큰 → 모델 단가 → 원가"로 모아 에너지 하나로 차감. 인앱결제는 서버에서 검증(App Store · Google Play)
구성
모바일 앱 (Flutter + Swift)
5탭(SHOP · TRACK · AI · FEED · ME), Riverpod, 5개 국어. 호출어 엔진과 잠금화면 Live Activity는 Swift 네이티브 모듈.
API 서버 (FastAPI)
async SQLAlchemy + PostgreSQL, 도메인별 라우터. 결과 봉투(envelope) 패턴과 슬라이딩 JWT. 구버전 앱 호환을 위해 변경은 가산식으로만.
실시간 음성 코치
음성 입출력은 모델, 판단은 서버. 엔진 차이를 전송 방식 · 도구 경로 두 축으로 모아 서버가 엔진 목록을 내려주고 앱은 그리기만.
어드민 콘솔 (React)
React 19 + Vite. 역할 위계 기반 회원 · 공지 · 구독 · 쿠폰 · 문의 관리와 KPI 대시보드. 문의는 접수 시점 플랜으로 우선순위 · 응답 기한을 정함.
과금 · 결제
에너지 단일 재화. App Store · Google Play 영수증 서버 검증과 Apple 서버 알림 처리. 보상형 광고 적립은 서버 측 검증.
클라우드 인프라
Terraform IaC로 GCP VM에 Caddy(자동 HTTPS) · Docker Compose · PostgreSQL. 롤링 배포, 일일 백업, 운영/개발 백엔드 분리.
AI 활용
실시간 음성 코치 (gpt-live-1)
운동 중 화면을 보지 않고 말로 기록합니다. 서버가 같은 음성 세션에 따로 붙어 도구 호출을 가로채고, 권한 · 확인 · 상한을 서버에 둡니다. 별도 화면 없이 채팅창 안에서 이어집니다.
음성 엔진 교체 구조
gpt-live-1과 gemini-3.8-live를 같은 구조로 돌립니다. 앱이 모르는 전송 방식이 오면 조용히 넘어가지 않고 거절합니다.
모델 배분 실측 (gpt-6)
대화는 gpt-6-luna, 사진 · 인바디 · 음성 기록 도구는 gpt-6-sol. 운영 코드 경로 실측으로 사진 호출의 추론 설정 결함을 찾아 고쳐 사진 분석 지연을 7.7초 → 3.5초(적용 후 재측정)로 줄이고 빈 결과를 0으로 만들었습니다. 대화 승급은 실제 턴 원가가 벤치의 10배라 꺼 둠.
프롬프트 캐시 재설계
고정 지시문만 시스템 프롬프트에 두고 턴 맥락은 마지막 사용자 메시지 앞으로 옮겨, 개발 서버 실측 캐시 적중 93.8%.
AI 코치 방어막
도구 결과와 장기 메모리는 격리 태그로 감싸 데이터임을 못박고, 피드 검색 결과는 제어문자를 무력화해 프롬프트 주입을 막습니다. 한 턴 도구 호출 수 · 사용자당 동시 1턴 · 분당 빈도 · 출력 토큰에 상한.
사진 · 결과지 판독
음식 사진은 하루 누적 기준으로 "괜찮음 · 주의 · 초과"를 판정하고, 목표 칼로리 계산은 코치 도구와 같은 함수 하나를 씁니다. 인바디 결과지는 고해상도 비전 판독 또는 CSV 전체 가져오기.
자동화 · 운영
에너지 단일 과금
분당 정액 엔진과 토큰 과금 엔진을 "사용 토큰 → 모델 단가 → 원가"로 정규화. 가격표가 규칙과 어긋나면 서버가 시작 단계에서 멈춥니다.
원가 누수 차단
무음 자동 종료, 워치독, 세션 시간 상한, 연속 실패 차단, 서비스 전체 하루 원가 킬스위치.
Shorebird 코드 푸시
4.0.2부터 도입(2026.09.28 App Store 출시). 승인된 릴리스 위 Dart 수정은 심사 없이 패치, 네이티브 · 권한 · 에셋이 바뀌면 정식 심사.
무중단 롤링 배포
배포 중 1초 간격 420회 요청 전부 200을 확인.
오프라인 큐 · 멱등
로컬 큐 → 복귀 시 멱등키 재전송. 형식이 틀린 키는 거부하지 않고 멱등만 포기해 큐가 막히지 않게.
병렬 에이전트 개발 체계
앱 · API · 웹 · 인프라로 소유 경로를 나누고, 검증 수단(테스트 · 시뮬레이터 캡처 · 실기기 · 브라우저 · 운영 실측 · 스토어 API)의 증거가 기록에 있을 때만 완료로 인정.
연혁
- 2026.02 — 첫 출시 (iOS · Android)
- 2026.09 초 — 3.1: 문의 · 푸시 · 체크인 · AI 코치 방어막
- 2026.09.12 — 3.2.0 iOS 출시: HealthKit · Health Connect, 오프라인 기록 큐, 계측
- 2026.09.23 — 4.0.0 iOS 출시: 실시간 음성 코치 · 에너지 과금 · SHOP 탭 · 호출어 · Live Activity
- 2026.09.23 — gpt-6 모델 전환과 프롬프트 캐시 재설계(서버), 4.0.2 심사 제출(Shorebird 도입)
- 2026.09.28 — 4.0.2 App Store 출시 · Google Play 운영 반영: 식단 목표 계산 통합, Shorebird 코드 푸시 첫 릴리스
- 2026.10.01 — 4.0.3 App Store 출시: 호출어 응답 · 오탐 개선, 식단 한글 입력, 제미나이 엔진 음량 · 즉시 말하기
기술 스택
모바일
- Flutter
- Dart
- Riverpod
- go_router
- Swift
- SpeechAnalyzer
- Live Activity
백엔드
- FastAPI
- async SQLAlchemy
- PostgreSQL
- PyJWT
- Firebase Admin
AI / LLM
- gpt-live-1
- gemini-3.8-live
- gpt-6-luna
- gpt-6-sol
- Gemini 임베딩
- WebRTC
어드민 · 프론트
- React 19
- Vite
- React Router
- Playwright
인프라 · 운영
- GCP
- Terraform
- Docker Compose
- Caddy
- Shorebird
결제 · 인증
- App Store Server API
- Google Play 검증
- 소셜 로그인
- AdMob SSV
핵심 역할 · 성과
- 기획 · 모바일 · 백엔드 · 어드민 · 인프라까지 직접 설계 · 개발 · 운영 — 2026년 9월 한 달에 3.1 · 3.2.0 · 4.0.0 · 4.0.2 출시
- 음성 모델이 바뀌어도 앱을 고치지 않는 엔진 교체 구조 — gpt-live-1과 gemini-3.8-live를 같은 구조로
- 운영 코드 경로 실측으로 사진 호출의 추론 설정 결함을 찾아 지연 7.7초 → 3.5초, 빈 결과 0
- 서로 다른 과금 단위를 원가 하나로 정규화한 에너지 과금과 원가 누수 차단 장치
- Flutter 한계를 Swift 네이티브 모듈로 넘은 잠금화면 호출어 · Live Activity