통근 알람 앱 개발 가이드: 지하철부터 버스까지
2026.08.12
소개
신분당선 통근자용 출발 알람 앱 "지금고"를 만들고 있습니다. 사용자는 "언제까지 어디 도착"만 정하고, 앱이 열차를 역산해서 "지금 나가세요" 하나만 알려주는 앱이에요. 1편에서 기획과 워크플로를, 2편에서 로그인 붙이기를 다뤘고, 이번이 마지막 편입니다.
마지막 주에 한 일은 4주 중 가장 어려웠던 작업이었습니다 — 지하철 전용이던 앱에 수도권 버스를 넣는 것. 제 실제 통근이 "버스 → 지하철" 형태라, 매일 직접 쓰면서 검증하려면 피할 수 없는 일이었어요.
버스가 어려운 이유는 지하철과 데이터 조건이 다르기 때문입니다. 지하철은 시간표에 역별 도착 시각이 있어서 "마감 전에 도착하는 가장 늦은 열차"를 역산하면 되는데, 버스는 정류장별 도착 시각표가 없습니다(기점 출발 시각표만 있어요). 그래서 역산 엔진 내부를 바꿔야 했습니다.
이 글의 주제는 하나입니다. 단위 테스트 325건이 전부 통과하는 동안 앱은 잘못 동작하고 있었고, 그 결함들을 테스트가 아닌 다른 방법으로 잡았다는 것.
진행 방법
도구는 계속 Claude Code입니다. 이번 편의 핵심은 프롬프트가 아니라 검증을 4단계로 나눠서 쌓은 것이에요.
1단계 단위 테스트 — 로직에 모순이 없는지 (합성 데이터로)
2단계 회귀 테스트 — 코드를 바꾼 전후로 계산 결과가 안 변했는지 (실제 노선 데이터로)
3단계 실데이터 대조 — 코드의 가정이 실제 API 응답과 맞는지
4단계 실기기 조작 — 폰 화면에 뜨는 값이 계산값과 같은지
1단계만으로 안 되는 이유를, 이번 주에 단계마다 하나씩 겪었습니다.
엔진을 바꾸기 전에 회귀 테스트부터 만들었다 (2단계)
기존 테스트는 환승 0회 경우만 보는 것과 합성 시간표만 쓰는 것뿐이었습니다. 이 상태에서는 엔진 내부를 바꾸다 알람 시각이 3분 밀려도 테스트가 전부 통과합니다.
그래서 코드를 건드리기 전에, 실제 노선 10개의 데이터로 역산 결과 216건(구간 12 × 날짜 3 × 마감 3 × 환승여유 2)을 테스트로 고정했습니다. 이후 모든 커밋은 "이 216건이 한 건도 안 변했다"가 통과 조건이었어요.
여기서 중요했던 건 자동 생성한 기대값을 검토 없이 커밋하지 않은 것입니다. 지금 코드에 버그가 있으면 그 버그의 출력이 그대로 "정답"으로 저장되고, 이후 테스트는 그 버그를 보호하는 방향으로 동작하니까요. 그래서 기대값 일부를 손으로 풀어서 대조했습니다.
실제로 손검증 중에 이상해 보이는 값이 하나 나왔어요. 환승 여유를 1분 늘렸는데 집 출발 시각이 6분 당겨진 겁니다. 버그인 줄 알았는데 계산을 풀어 보니 맞는 값이었습니다 — 1분 때문에 원래 타려던 열차를 못 타게 되고, 한 대 이른 열차로 넘어가는데, 그 열차와의 간격이 6분(신분당선 배차 간격)이었던 거예요. 출발 시각은 1분 단위로 움직이는 게 아니라 배차 간격 단위로 건너뜁니다. 이걸 이때 확인 안 했으면, 나중에 같은 값을 보고 정상인 코드를 고쳤을 겁니다.
실제 API 응답이 코드의 가정과 달랐다 (3단계)
AI가 짠 코드의 단위 테스트는 내내 통과했습니다. 그런데 공공 API(국토부 TAGO)를 실제로 호출해서 값을 확인하니:
"전국" 대중교통 API에 서울이 없었습니다. 도시코드 138개에 서울(코드 11)이 없고, 조회하면 0건이 나옵니다. 서울시는 버스 정보 시스템을 따로 운영해서 국가 센터에 연계하지 않기 때문인데, API 이름에 "전국"이 들어 있다는 이유로 서울도 되는 줄 알았던 게 실수였습니다.
버스 주행시간이 60% 부풀어 있었습니다. 노선 전체에 같은 속도를 적용했더니 광역버스 구간이 127분으로 계산됐어요(실제 약 80분). 원인은 API가 주는 데이터 안에 이미 있었습니다:
1.3 1.1 0.5 0.7 0.6 7.8 14.8 8.9 7.2 (구간 길이, km)
└───── 도심 ─────┘ └───── 고속도로 ─────┘
구간 길이를 보면 어디부터 고속도로인지 알 수 있는데, 균일 속도 계산은 이 정보를 안 쓰고 고속도로 38km를 도심 속도로 계산했습니다. 구간 길이에 따라 속도를 다르게 주니 79분이 나왔어요.
정류장 목록에도 확인 없이는 못 쓰는 항목이 많았습니다. 어떤 노선은 정류장 77개 중 45개가 "(미정차)" 표시 — 버스가 서지 않는 정류장이고, 목록 자체가 왕복(기점→종점→기점)으로 오고, 같은 응답 안에서 첫차 시각은 문자열 "0530"인데 막차는 숫자 2240으로 타입이 섞여 있습니다.
전부 에러 없이 잘못된 값을 내는 종류라서 단위 테스트로는 못 잡습니다. 테스트용 가짜 데이터는 만드는 사람의 가정대로 만들어지니까, 그 가정 자체가 틀렸는지는 확인해 주지 못해요.
이 조사들을 다시 하게 만든 건 정교한 지시가 아니라 제가 던진 짧은 질문 3개였습니다. "버스도 시간표 있지 않나?"(→ AI가 "버스는 시간표가 없다"고 정리했던 게 부정확했고, 기점 출발표는 있다는 걸 확인) / "1분마다 요청하는데 괜찮아?"(→ 실제로는 45초 간격이었고, 서울 API 하루 한도 1,000회로는 테스터 12명도 감당이 안 돼서 폴링 간격 설계를 바꿈) / "출시 후엔 공짜야?"(→ 무료지만 출시 후 활용사례 등록이 필요). AI가 조사해 온 결과를 그대로 받지 않고 상식선에서 되물은 것이 각각 설계를 바꿨습니다.
폰에서 직접 눌러야 보이는 결함이 있었다 (4단계)
백엔드와 엔진 테스트가 다 통과한 뒤 폰에서 편집 화면을 실제로 조작했는데, 결함 둘이 바로 나왔습니다.
첫째, 문자열 템플릿이 동작하지 않고 있었습니다.
PlacesApi.search("${'$'}station역") // → 변수가 아니라 문자 그대로 "$station역"으로 검색된다
파이썬 스크립트로 코드를 넣을 때 쓴 이스케이프가 남은 건데, Kotlin에서 ${'$'}는 문자 $ 자체를 만듭니다. 컴파일도 되고 테스트도 통과하는데, 앱은 "$station역"이라는 검색어로 출발역 좌표를 엉뚱한 곳으로 잡은 상태에서 버스를 찾고 있었어요. 발견 단서는 로그에 ${usable.size} 같은 문자열이 치환되지 않고 그대로 찍힌 것이었습니다.
둘째, 앱이 사실과 다른 안내를 하고 있었습니다. 화면이 "집 근처에서 청계산입구역까지 한 번에 가는 버스가 없어요"라고 했는데, 실제로는 그 구간에 서울 버스가 다닙니다. 위에서 말한 대로 API에 서울 데이터가 없어서 정류장을 못 받은 것뿐인데, 앱은 그걸 "버스가 없다"로 말한 거예요. 설계 문서에 "'노선이 없음'과 '데이터를 못 받음'을 다르게 안내한다"고 적어 놓고, 세 번째 경우(해당 지역 미지원)를 구분하지 않은 겁니다. "이 동네 버스는 아직 준비 중이에요"로 고쳤습니다.
테스트가 실행해 본 적 없는 경로에서 크래시를 찾았다
마지막 날, 실시간 보정 코드를 연결하러 들어갔다가 알람 등록 코드에서 이 줄을 발견했습니다.
scheduleCorrection(..., (schedule.route.first() as RouteLeg.Rail).line)
환승만 있던 시절엔 경로의 첫 구간이 항상 철도라서 이 캐스트가 항상 성공했는데, 버스 타입이 추가되면서 조건이 깨졌습니다. 버스로 시작하는 스케줄을 저장하는 순간 ClassCastException이 나고, 이 등록 루프에는 예외를 받아주는 코드가 없어서 등록 작업 전체가 중단됩니다. 문제의 스케줄만이 아니라 다른 스케줄과 캘린더 알람까지 등록이 안 된 채로 남아요. 알람 앱에서 가장 심각한 종류의 사고입니다.
sealed 타입에 하위 타입을 추가하면 when 분기는 컴파일 에러로 알려주지만, as 캐스트는 컴파일러가 아무 경고도 하지 않습니다. 타입을 확장하는 작업에서 위험한 건 새로 쓰는 코드가 아니라, 기존 코드에 남아 있는 as 캐스트였어요.
이 크래시는 테스트 325건도, 실기기 검증도 못 잡았습니다. 이유는 명확했어요 — 서울 API가 막혀 있어서 버스 스케줄을 한 번도 저장해 본 적이 없었고, 그래서 이 코드 경로가 한 번도 실행된 적이 없었던 겁니다. 캐스트 대신 타입 판정을 when이 들어간 별도 값으로 바꿔서, 다음에 교통수단이 또 늘면 컴파일 단계에서 걸리게 했습니다.
결과와 배운 점
먼저 솔직한 회고 하나. 이번 주 결함들의 공통 원인은 하나였습니다 — AI를 믿고, 값을 제 눈으로 확인하는 단계를 건너뛴 것. AI가 코드를 짜고 테스트가 통과하면 저는 그대로 다음 일을 시켰고, 로그나 API 응답을 직접 열어 본 적이 없었어요. $station역이 로그에 치환도 안 된 채 찍히고 있었으니 로그를 한 번만 봤으면 바로 잡혔을 거고, API도 초반에 한 번 직접 호출해 봤으면 서울 데이터가 없다는 걸 설계 전에 알았을 겁니다. AI도 자기가 만든 출력을 의심하지 않았으니, 둘 다 놓친 거죠. 위의 4단계는 결국 "사람이 값을 직접 보는 지점"을 작업 순서에 강제로 넣은 겁니다.
결과: 지하철 전용이던 엔진이 버스 구간을 처리하게 됐고, 그동안 기존 지하철 알람 시각은 회귀 216건으로 "한 건도 안 변했음"을 확인하며 진행했습니다. 최종 테스트는 백엔드 217건 + 앱 JVM 329건 + 계측 22건. 실기기(갤럭시 폴드)에서 DB 마이그레이션과 알람 재등록까지 확인했고, 릴리스 빌드는 스토어 업로드 직전입니다.
배운 점 & 나만의 꿀팁
1. AI에게 일은 시켜도 값 확인은 위임하지 않는다. 로그 한 줄, API 응답 한 번을 직접 보는 게 테스트 수백 건보다 결함을 빨리 잡을 때가 있다.
2. 엔진 내부를 바꾸는 작업은 회귀 테스트를 먼저 만든다. 자동 생성한 기대값은 일부라도 손으로 풀어 대조한다 — 안 그러면 지금 있는 버그가 정답으로 저장된다.
3. 합성 데이터 테스트는 로직의 모순만 잡는다. 가정 자체가 틀린 건 실데이터를 호출해 봐야 안다. 외부 API를 쓰는 기능은 개발 초반에 실제 응답부터 확인한다.
4. AI의 조사 결과에는 짧은 질문으로 되묻는다. "버스도 시간표 있지 않나?" 한 줄이 조사 결론을 두 번 뒤집었다.
5. 타입을 확장할 때는 새 코드보다 기존 코드의 as 캐스트를 먼저 찾는다. when은 컴파일러가 잡아주고 as는 안 잡아준다.
6. "테스트 통과"와 "검증 완료"는 다르다. 단위 테스트 / 회귀 / 실데이터 / 실기기가 잡는 결함의 종류가 각각 다르고, 테스트가 실행하지 않은 경로는 검증된 게 아니다.
시행착오 (증상 → 원인 → 교훈)
- 알람이 60% 일찍 울리게 계산됨 → 균일 속도 가정이 구간 길이 정보를 안 씀 → API가 주는 데이터에 이미 답이 있는지 먼저 본다.
- "버스가 없어요"라는 사실과 다른 안내 → "없음 / 못 받음 / 지역 미지원" 세 경우를 안내 문구에서 구분 안 함 → 실패의 종류를 화면 문구까지 나눠서 내려보낸다.
- 알람 등록 전체를 중단시키는 크래시를 마지막 날 발견 → 한 번도 실행된 적 없는 코드 경로에 무검사 캐스트 → 실행 안 해 본 경로는 통과가 아니라 미확인으로 취급한다.
앞으로의 계획
서울 구간 데이터가 해결되면 버스 포함 통근으로 실사용 검증을 마치고, Play 스토어 v0.1 심사에 들어갑니다. 4주 전엔 "내 폰에서만 도는 알람"이었는데, 지금은 스토어 업로드 직전까지 왔습니다. (노선 확장 순서 같은 구체 로드맵은 아직 공개 전이라 여기까지만.)
마지막으로, 스터디원들께 남기고 싶은 건 하나입니다. 이 글에서 보셨듯 저도 계속 실수했습니다. 그래도 4주 동안 진도가 나온 방법은 단순했습니다 — 귀찮아도 설계를 같이 하고, 진행 상황과 값을 중간에 확인하고, 틀린 게 나오면 그 자리에서 고치는 것. 이 반복이 도구를 얼마나 잘 다루느냐보다 결과를 더 좌우했습니다. 4주 동안 감사했습니다.


