모바일 앱 백엔드, API와 오프라인 동기화: 언제나 작동하는 앱을 위한 아키텍처

이 가이드는 앱의 서버 측을 기획하는 CTO, 기술 책임자 및 제품 책임자를 위한 것입니다. 모바일 제품 개발 가이드에서는 발견부터 확장까지 전체 여정을 간략히 다루고 있으며, 이 페이지는 백엔드, API 계약 및 오프라인 동기화를 더 깊이 살펴봅니다. 앱 자체를 구축하는 방법은 네이티브 vs 크로스 플랫폼 모바일 개발에서 비교합니다.

이 가이드의 내용

• 웹사이트와 달리 모바일 백엔드가 처리해야 하는 것
• 모바일 클라이언트를 위한 API 계약
• 오프라인 동기화: 4가지 모델
• 충돌과 결정 주체
• 로그인, 푸시 알림 및 기기 보안
• 백엔드 경로: 대안 및 선택 기준
• AI 기능과 백엔드
• 구축 계획
• Netbase의 모바일 백엔드 구축 방법
• 존재하는 납품 기록과 그렇지 않은 것
• 이 가이드의 한계
• 자주 묻는 질문
• 다음 단계

웹사이트와 달리 모바일 백엔드가 처리해야 하는 것

웹사이트는 배포하는 순간 모든 방문자에게 변경 사항이 적용됩니다. 모바일 앱은 그렇지 않습니다: 사용자는 원할 때 업데이트하며, 일부는 절대 하지 않습니다. 이로 인해 세 가지 결과가 백엔드를 형성합니다.

• 동시에 여러 클라이언트 버전 존재. 서버는 아직 지원하는 모든 앱 버전에 응답해야 하므로, 필드 이름 변경이나 새로운 필수 파라미터는 수천 개의 설치된 앱을 하룻밤 사이에 중단시킬 수 있습니다.
• 중간에 실패하는 네트워크. 요청이 서버에 도달하고 응답이 돌아오는 길에 손실될 수 있습니다. 앱이 재시도하면, 부주의한 백엔드는 두 번째 주문이나 두 번째 결제를 생성합니다.
• 서버 없이 이루어지는 작업. 현장 직원, 여행자, 지하에 있는 쇼핑객들은 신호 없이 앱을 열고 작동하기를 기대하며, 나중에 변경 사항이 다른 사람의 것을 덮어쓰지 않고 도착하기를 기대합니다.

모바일 클라이언트를 위한 API 계약

API를 웹 프론트엔드의 부산물이 아닌, 자체 규칙을 가진 제품으로 취급하십시오.

• 의도적으로 버전 관리하십시오. 필드를 자유롭게 추가하되, 지원하는 앱 버전이 읽는 동안에는 절대 제거하거나 이름을 바꾸지 마십시오. 호환성을 깨는 변경은 새 버전 뒤에 두고, 최소 지원 앱 버전을 게시하며, 백엔드가 구버전 앱에 업데이트를 알리도록 하십시오.
• 화면에 맞게 응답을 구성하십시오. 하나의 화면에 필요한 것을 정확히 조합하는 얇은 서비스인 BFF(Backend-for-Frontend) 레이어는 느린 네트워크에서 왕복 횟수를 줄이고 내부 시스템을 앱의 시야 밖에 둡니다.
• 커서로 페이지네이션하십시오. 오프셋이 아닌 커서로 목록을 페이지네이션하면 사용자가 스크롤하는 동안 추가된 레코드가 두 번 표시되거나 건너뛰어지지 않습니다.
• 생성 요청이 반복해도 안전하게 만드십시오. RFC 9110은 POST를 멱등성이 없는 것으로 정의하므로, 모든 생성 요청은 기기에서 생성된 멱등성 키를 포함합니다. 서버는 이를 결과와 함께 저장하고 재시도에 첫 번째 결과를 반환합니다.
• 기기에 필요한 것을 전송하십시오. 기기별로 이미지를 리사이즈하고, 응답을 압축하며, 앱의 마지막 동기화 마커 이후 변경된 레코드만 전송하십시오.
• 앱이 조치할 수 있는 오류를 반환하십시오. 안정적인 오류 코드는 앱에 재시도, 재인증 또는 중단 여부를 알려줍니다.

동일한 백엔드가 웹사이트, 파트너 및 내부 시스템도 제공하는 경우, 해당 흐름에 대한 규칙은 엔터프라이즈 시스템 통합 가이드에 있습니다.

오프라인 동기화: 4가지 모델

데이터 종류별로 모델을 선택하십시오: 카탈로그, 초안 양식, 결제는 각각 다른 보장이 필요합니다.

• 읽기 캐시가 있는 온라인 전용. 앱은 마지막으로 가져온 데이터를 표시하고 오프라인 상태에서 변경을 차단합니다. 가격, 재고 및 최신 정보가 필요한 모든 것에 적합합니다.
• 대기열 쓰기. 변경 사항은 발신 큐에 저장되고 연결이 복구될 때 순서대로 전송됩니다. Android의 오프라인 우선 가이드는 분석 이벤트 및 로그와 같은 데이터에 이 패턴을 나열합니다.
• 로컬 우선 데이터. 앱은 로컬 데이터베이스를 읽고 쓰며, 동기화 프로세스가 서버와 변경 사항을 교환합니다. Android 가이드는 로컬 소스를 "앱의 신뢰할 수 있는 데이터 소스"로 설명합니다. 메모, 검사 및 현장 기록에 적합합니다.
• 관리형 동기화 서비스. 플랫폼이 로컬 데이터베이스와 서버 복사본을 동기화하고 충돌 처리를 제공하지만, 해당 데이터 모델을 채택해야 합니다.

동기화 자체는 요청 시(풀) 또는 서버가 앱에 변경 사항을 알리는 방식(푸시)으로 실행됩니다. Android 가이드는 짧은 오프라인 기간에는 풀을, 긴 오프라인 기간과 관련 데이터에는 푸시를 권장합니다.

충돌과 결정 주체

두 사람이 한 명이 오프라인 상태에서 동일한 레코드를 변경하면, 누군가가 이겨야 합니다. 첫 번째 빌드 전에 필드별로 서면으로 결정하십시오.

• 마지막 쓰기 우선. 각 변경에는 타임스탬프가 포함되고 최신 것이 유지됩니다. 간단하며, 프로필이나 초안처럼 한 사람이 소유하는 데이터에 적합합니다.
• 서버 규칙. 백엔드는 기기가 본 버전이 레코드에 여전히 있을 경우에만 변경을 수락합니다. 그렇지 않으면 앱이 현재 상태를 표시하고 사용자에게 묻습니다.
• 필드별 병합. 다른 필드에 대한 변경은 모두 유지되며, 동일한 필드의 충돌에만 규칙이 필요합니다.
• 오프라인 불가. 결제, 재고 예약 및 승인은 앱의 나머지 부분이 무엇을 하든 온라인 상태에서 서버에 의해 확인됩니다.

지원팀이 레코드에 무슨 일이 있었는지 설명할 수 있도록 기기, 사용자, 버전 및 결과에 대한 서버 동기화 로그를 유지하십시오.

로그인, 푸시 알림 및 기기 보안

로그인. 모바일 앱은 비밀을 지킬 수 없습니다. IETF RFC 8252는 네이티브 앱을 퍼블릭 클라이언트로 분류하고 OAuth에 PKCE 확장을 요구하며, 로그인 페이지는 임베드된 웹 뷰가 아닌 시스템 브라우저에서 열립니다. 단기 액세스 토큰과 플랫폼의 보안 저장소에 보관된 리프레시 토큰을 사용하고, 생체 인증 잠금 해제를 추가로 제공하십시오.

푸시 알림. Firebase Cloud Messaging은 자신을 크로스 플랫폼 메시징 솔루션으로 설명하며, 시스템이 표시하는 알림 메시지와 앱이 직접 처리하는 데이터 메시지를 제공합니다. 앱에 동기화를 알리려면 데이터 메시지를, 사용자가 반드시 봐야 할 것에는 알림을 전송하고, 사용자가 이해하는 순간에 권한을 요청하십시오.

보안. OWASP 모바일 애플리케이션 보안 검증 표준(MASVS)은 저장소, 암호화, 인증, 네트워크 통신 및 복원력에 대한 제어 그룹을 정의합니다. 서버에서는 앱이 표시하거나 숨기는 것과 관계없이 모든 엔드포인트가 사용자의 권한을 직접 확인합니다.

백엔드 경로: 대안 및 선택 기준

네 가지 기준이 결정합니다: 오늘 누가 데이터를 소유하는지, 제품이 얼마나 오프라인으로 작동하는지, 앱이 접근해야 하는 시스템 수, 그리고 누가 밤에 백엔드를 운영할 것인지. 백엔드가 스토어, ERP 및 CRM과도 통신해야 한다면, ERP, CRM 및 이커머스 통합 아키텍처로 해당 흐름을 먼저 설계하십시오. Netbase의 시스템 및 API 통합 서비스가 해당 레이어를 구축합니다.

Netbase의 모바일 백엔드 구축 방법

Netbase는 백엔드 플랫폼 페이지에 설명된 스택에서 React Native로 크로스 플랫폼 앱을 구축하며, 이는 오랫동안 채용해온 역할입니다. 분석가, 아키텍트, 개발자, QA 및 디자이너로 구성된 3명에서 30명 규모의 팀이 발견 단계 후 일반적으로 1~2주 내에 작업을 시작합니다. 대부분의 Netbase 프로젝트는 발견 후 합의된 고정가 계약으로 납품됩니다(전담팀 vs 고정가 계약 참조). 맞춤 개발에서는 클라이언트가 해당 IP를 소유합니다. 보안 관행은 보안 코드 리뷰, 전송 중 TLS 및 저장 시 AES, 역할 기반 액세스 제어 및 관리자 대시보드용 MFA를 포함합니다. 모바일 앱 개발 서비스를 확인하거나, 재사용 가능한 빌딩 블록이 적합한 경우 모바일 제품 가속기를 확인하십시오.

존재하는 납품 기록과 그렇지 않은 것

• 존재하는 것. RB Marketplace 기록은 API 감사 후 마켓플레이스 자체 API를 기반으로 구축된 고객 쇼핑 앱을 설명하며, 푸시 알림, 서버에 동기화된 위시리스트 및 오프라인 브라우징을 포함하고, Android로 시작하여 iOS는 확장 범위에 포함됩니다. Dey Page 기록은 웹 디렉토리와 동일한 백엔드에서 iOS 및 Android용 하나의 React Native 앱을 설명하며, 전화 OTP 계정, 푸시 및 딥 링크를 포함합니다. 오프라인 동기화가 포함된 현장 캡처는 모바일 웹 앱에서 실행됩니다. 리워드 숍 기록은 클라이언트 자체 앱을 위한 모바일 UI 컴포넌트와 웹훅 및 예약된 동기화를 통한 클라이언트 시스템과의 동기화를 설명합니다. 클라이언트 이름은 명시되지 않았습니다.
• 존재하지 않는 것. 이 기록들 중 어느 것도 다운로드 수, 사용량, 가동 시간, 동기화 볼륨 또는 오류율을 공개하지 않으며, RB Marketplace 기록은 프레임워크를 명시하지 않습니다. 어느 것도 하나의 동기화 모델 또는 백엔드 경로가 더 잘 작동한다는 증거로 제시되지 않습니다.

이 가이드의 한계

• 플랫폼 설명은 접근 날짜의 Android, IETF, Firebase 및 OWASP 페이지에서 가져왔습니다. 플랫폼은 변경되므로 현재 버전을 확인하십시오.
• 동기화 모델은 비즈니스, 커머스 및 현장 앱에 적합합니다. 실시간 협업 및 게임은 별도의 설계가 필요합니다.
• 보안 관행은 위험을 줄이지만, 어떤 앱이나 백엔드에 대한 보장이 아닙니다.

다음 단계

앱이 오프라인으로 유지해야 하는 데이터, 읽어오는 시스템, 현재 사용 중인 앱 버전을 공유해 주시면 솔루션 리뷰를 예약하여 API 계약과 데이터 유형별 동기화 모델을 매핑해 드리겠습니다. 모바일 앱 개발을 확인하거나 Netbase 인사이트를 더 보실 수도 있습니다.

관련 서비스 및 솔루션