dev.jung

볼링 앱 제작기 마무리: 기능보다 중요한 운영 설계

Strike Log는 단순히 볼링 점수를 기록하는 앱으로 시작했지만, 만들다 보니 생각보다 많은 기능이 필요했습니다. 점수를 입력하고 저장하는 기능만 있으면 끝날 줄 알았지만, 실제 사용 흐름을 생각하면 평균 점수, 최고 점수, 경기 기록, 클럽 운영, 실시간 경기방, 배지, 출석 streak, 푸시 알림까지 자연스럽게 이어졌습니다.이번 글은 Strike Log 제작기 마지막 편입니다. Flutter와 NestJS로 앱을 만들며 구현한 내용을 돌아보고, 실제 앱에서 기능 구현만큼 중요했던 운영 설계를 정리해보겠습니다.기능은 연결될 때 진짜 서비스가 된다앱을 만들 때 각각의 기능은 따로 보면 단순해 보입니다. 점수 입력 화면은 볼링 규칙을 계산하면 되고, 로그인은 JWT로 처리하면 됩니다. 게임 기록은 A..

Railway와 Firebase로 Flutter 앱 백엔드 운영하기

앱을 만드는 일과 운영하는 일은 조금 다르다. 로컬에서 잘 돌아가는 Flutter 앱도 실제 사용자에게 배포하려면 서버 주소, 데이터베이스, 환경변수, 오류 추적, 푸시 설정까지 하나씩 맞춰야 한다.Strike Log도 처음에는 기능 구현이 중심이었다. 점수 계산, 클럽, 실시간 경기방, 배지, 알림까지 만들고 나니 다음 질문은 자연스럽게 “이걸 어디에 올리고 어떻게 유지할 것인가?”였다. 이번 편에서는 Railway와 Firebase를 중심으로 Flutter 앱 백엔드를 운영 환경에 올린 과정을 정리한다.Railway에 서버와 MySQL을 올린 이유Strike Log의 백엔드는 Node.js 기반 API 서버와 MySQL로 구성했다. 직접 VPS를 구성할 수도 있었지만, 초기 운영 단계에서는 배포와 D..

FCM 푸시와 인앱 알림을 함께 연결하기

앱 알림을 만들 때 처음에는 “푸시만 보내면 되지 않을까?”라고 생각하기 쉽다. 하지만 실제로 써보면 푸시는 알림의 입구일 뿐이다. 사용자가 앱을 열었을 때 지난 알림을 다시 볼 수 있어야 하고, 읽음 상태도 남아야 하며, 알림을 눌렀을 때 정확한 화면으로 이동해야 한다.Strike Log에서는 이 문제를 FCM 푸시와 인앱 알림 DB를 함께 쓰는 방식으로 풀었다. FCM은 사용자를 다시 앱으로 불러오는 역할을 맡고, 인앱 알림은 기록과 읽음 상태를 책임지게 했다.알림을 DB에 먼저 남긴 이유Strike Log의 알림은 notifications 테이블에 먼저 저장된다. 여기에는 사용자 ID, 알림 타입, 제목, 본문, 이동 대상 ID, 읽음 여부가 들어간다.예를 들어 클럽 가입 신청, 가입 승인, 체험판..

배지와 출석 streak로 다시 켜고 싶은 앱 만들기

볼링 점수 기록 앱은 한 번 입력하고 끝나면 쉽게 잊힙니다. 그래서 Strike Log에는 “기록을 남겼다”에서 멈추지 않고, 사용자가 다시 앱을 켜고 싶어지는 장치를 넣고 싶었습니다.이번 편에서는 Strike Log에 넣은 배지 시스템과 출석 streak를 정리해보겠습니다. 핵심은 단순합니다. 사용자가 게임을 저장하거나, 시리즈를 끝내거나, 클럽에 참여했을 때 앱이 작은 성취를 즉시 알려주는 구조입니다.왜 배지가 필요했나처음에는 평균 점수, 최고점, 최근 경기 기록만 있어도 충분하다고 생각했습니다. 하지만 실제로 앱을 계속 쓰게 만들려면 “내가 조금씩 쌓아가고 있다”는 느낌이 필요했습니다.볼링은 점수가 오르락내리락합니다. 매번 최고점을 갱신하기 어렵고, 어떤 날은 기록을 남기는 것 자체가 성과일 때도 ..

클럽 운영 기능 만들기: 가입 승인제와 1인 1클럽 정책

볼링 점수 기록 앱을 만들다 보면 처음에는 “내 점수만 잘 저장하면 되지 않을까?”라고 생각하기 쉽습니다. 하지만 실제 볼링은 혼자보다 클럽, 지인, 정기전처럼 함께 치는 경우가 많습니다.Strike Log에서도 그래서 클럽 기능을 넣었습니다. 다만 단순히 “클럽 만들기” 버튼 하나로 끝내면 운영 문제가 바로 생깁니다. 아무나 클럽을 만들 수 있으면 중복 클럽이 늘어나고, 아무나 가입할 수 있으면 실제 클럽 운영자가 멤버를 관리하기 어렵습니다.이번 글에서는 Strike Log에서 클럽 운영 기능을 어떻게 설계했는지 정리해보겠습니다.클럽 기능의 핵심 정책Strike Log의 클럽 기능은 크게 세 가지 정책을 기준으로 만들었습니다.첫 번째는 클럽 생성 승인제입니다. 일반 사용자가 바로 클럽을 생성하는 대신,..

Socket.IO로 클럽 실시간 볼링 경기방 만들기

볼링 점수 기록 앱 Strike Log 제작기 5편입니다. 이번 글에서는 Flutter 앱과 NestJS 백엔드를 Socket.IO로 연결해 클럽 실시간 경기방을 만든 과정을 정리합니다. 핵심은 단순히 소켓을 붙이는 것이 아니라, 인증된 사용자만 방에 들어오게 하고, 점수 변경을 방 전체에 브로드캐스트하며, 모바일 환경의 일시적인 연결 끊김까지 감안하는 것입니다.왜 REST API만으로는 부족했나점수 저장 자체는 REST API로 충분합니다. 사용자가 경기를 끝낸 뒤 /games 같은 엔드포인트로 기록을 저장하면 됩니다. 하지만 클럽 경기방은 성격이 다릅니다.누군가 방을 만들면 다른 사람이 바로 참가해야 합니다.한 명이 점수를 입력하면 참가자 전체 화면이 갱신되어야 합니다.호스트가 게임을 시작하면 모두 ..

NestJS와 TypeORM으로 볼링 기록 API 설계하기

Strike Log 제작기 네 번째 글입니다. 앞선 글에서는 Flutter에서 10프레임 볼링 점수를 입력하고 계산하는 흐름을 다뤘습니다. 하지만 앱이 실제 기록 앱이 되려면 계산 결과가 화면에만 머물러서는 안 됩니다. 사용자가 친 게임을 저장하고, 다시 불러오고, 평균과 최고점 같은 통계를 보여줄 수 있어야 합니다.그래서 이번 단계에서는 NestJS와 TypeORM으로 볼링 기록 API를 설계했습니다. 핵심은 단순히 점수 하나를 저장하는 것이 아니라, 나중에 통계, 시리즈, 클럽 경기까지 확장할 수 있는 구조를 만드는 것이었습니다.Flutter 화면 뒤에는 기록 API가 필요했다점수 입력 화면에서 총점이 계산되면 사용자는 자연스럽게 그 기록이 남기를 기대합니다. Strike Log의 백엔드는 이 흐름을..

Dio와 JWT로 게임 기록 저장하기: 실패해도 UX가 무너지지 않게

Strike Log 제작기 3번째 글입니다. 지난 글에서는 볼링 점수를 입력하고 10프레임 규칙에 맞게 계산하는 과정을 다뤘습니다. 점수 계산이 끝나면 자연스럽게 다음 단계는 저장입니다. 그런데 실제 앱에서 저장은 단순히 서버에 POST 요청을 보내는 일로 끝나지 않았습니다.로그인한 사용자의 기록이어야 하고, 인증 토큰이 만료될 수도 있습니다. 네트워크가 잠깐 끊길 수도 있고, 서버가 응답하지 않을 수도 있습니다. 클럽 기능에서는 체험판 만료처럼 일반 실패와 다르게 처리해야 하는 상황도 생깁니다. 그래서 Strike Log에서는 게임 저장을 화면 코드에 직접 넣지 않고, ApiClient와 GameSaveService로 책임을 나눴습니다.Dio 기반 ApiClient로 인증 처리를 모으기Strike Lo..

Flutter 볼링 점수 입력 화면: 10프레임 계산 로직

1편에서는 Strike Log가 어떤 앱인지, 그리고 Flutter 앱과 NestJS API를 어떤 구조로 나눴는지 소개했습니다. 이번 2편에서는 앱의 가장 핵심 기능인 볼링 점수 입력과 계산 로직을 정리해보겠습니다.볼링 점수 앱에서 어려운 부분은 단순히 숫자를 입력받는 것이 아닙니다. 스트라이크와 스페어는 다음 투구 결과에 따라 점수가 나중에 확정되고, 10프레임은 조건에 따라 세 번째 투구까지 생깁니다. 그래서 UI 안에 계산 규칙을 섞어두면 화면 코드가 금방 복잡해집니다.Strike Log에서는 이 문제를 해결하기 위해 점수 계산을 BowlingScorer라는 순수 계산 모듈로 분리했습니다.점수 입력 화면과 계산 로직을 분리한 이유Flutter의 점수 입력 화면은 사용자가 프레임별로 핀 수를 입력하..

볼링 점수 기록 앱 Strike Log 제작기: Flutter와 NestJS로 시작하기

Flutter와 NestJS로 만든 볼링 점수 기록 앱 Strike Log 제작기볼링을 치다 보면 생각보다 기록하고 싶은 데이터가 많습니다. 오늘 점수가 몇 점이었는지, 평균이 오르고 있는지, 스트라이크가 얼마나 나왔는지, 같이 치는 사람들과 기록을 공유할 수 있는지 같은 것들입니다.처음에는 단순히 “볼링 점수를 저장하는 앱” 정도로 생각했습니다. 하지만 실제로 만들다 보니 점수 계산, 게임 기록, 시리즈 관리, 클럽 기능, 실시간 경기방, 배지, 푸시 알림까지 이어지는 꽤 큰 앱이 되었습니다.이번 글부터는 제가 만든 볼링 기록 앱 Strike Log의 제작 과정을 하나씩 정리해보려고 합니다. 1편에서는 앱의 전체 방향과 기술 구조를 먼저 소개합니다.Strike Log는 어떤 앱인가Strike Log는 ..