프로젝트 소개2026.10.27 기준 · 1.2.77(104)

ONLY24

취향 사진으로 상대를 찾고,
24시간 동안 대화하는 앱

ONLY24 앱 아이콘

Flutter와 Firebase로 구성한 iOS·Android 소셜 매칭 앱입니다.
매칭 후 채팅을 시작하고, 친구 요청으로 대화를 이어갈 수 있습니다.

앱
Flutter · Riverpod · go_router
서버
Firebase Cloud Functions · TypeScript
데이터·통신
Firestore · Storage · WebRTC · FCM
지원 환경
iOS · Android / 한국어 · 영어 · 일본어

주요 기능

일반·사진 매칭 / 24시간 채팅 / 친구 / 영상통화 / 피드 / 우편함·쿠폰

A4 세로 · 210 × 297mm · 8페이지

01 · 사용 순서

로그인에서 대화까지

로그인과 본인인증은 별도 단계입니다. 본인인증을 마친 뒤 매칭과 대화를 이용합니다.

  1. 1

    카카오·Apple로 로그인

    기존 계정의 로그인과 새 계정 생성을 구분합니다.

  2. 2

    성인 본인인증

    지원하는 인증서를 선택하고 인증서 앱에서 승인합니다. 서버가 승인 결과와 만 19세 여부 등을 확인합니다.

  3. 3

    일반 매칭 또는 사진 매칭 시작

    사진 매칭은 선택한 사진의 취향을 분석해 상대를 찾습니다. 상대를 찾는 데 걸리는 시간은 대기 인원과 조건에 따라 달라집니다.

  4. 4

    양쪽이 준비되면 채팅 시작

    대화가 시작된 시점부터 24시간을 계산합니다.

  5. 5

    친구 요청으로 대화 이어가기

    친구 관계는 기본 7일입니다. 연장은 별도 이용 조건을 따릅니다.

사용 중 막혔을 때

  • 인증창을 닫은 경우: 진행 중인 요청을 보존하고 서버에서 결과를 다시 확인합니다.
  • 첫 사진 매칭: 사진 선택 → 검색 → 대화 시작 순서로 안내합니다.
  • 우편으로 받은 쿠폰: 본문에서 코드를 선택·복사한 뒤 설정에서 등록합니다.
02 · 주요 기능

현재 앱에서 할 수 있는 일

기능과 이용 조건을 함께 정리했습니다.

기능동작과 조건
일반·사진 매칭일일 횟수 제한은 없습니다. 양쪽 거리 설정, 차단, 계정 상태는 확인합니다.
24시간 채팅양쪽 준비가 끝나 채팅을 시작한 시점부터 24시간입니다. 읽음·리액션·이모티콘을 지원합니다.
영상통화매칭 참여자 모두 기본 발신 2회, 통화당 최대 3분입니다. 광고·쿠폰 추가 횟수는 별도로 유지합니다.
친구요청·수락 후 친구 채팅을 이용합니다. 기본 관계 기간은 7일이며 정원과 연장 조건을 서버에서 검사합니다.
피드·AI 도움게시물·좋아요·댓글을 지원합니다. AI 코치는 대화 주제와 표현을 추천합니다.
우편함·혜택우편 제목·본문의 선택 복사, 쿠폰 등록, 구독·광고 보상을 제공합니다. 사용·지급·만료는 서버에서 처리합니다.

무료 기능과 구독 조건

  • 매칭과 기본 영상통화는 구독 여부와 무관하게 제공합니다.
  • 이모티콘은 모든 사용자가 전송할 수 있습니다.
  • 일부 첨부·AI 추천·친구 슬롯은 성별·구독·개별 이용 조건을 적용합니다.
03 · 앱 구조

화면과 서버의 역할

앱은 사용자 입력과 화면 상태를 관리합니다. 인증·매칭·결제처럼 권한 검사가 필요한 작업은 서버가 처리합니다.

Flutter 앱입력·표시·상태 관리
Cloud Functions권한·조건·상태 검사
Firebase 데이터Auth·Firestore·Storage
구분기술맡은 일
앱Flutter, Riverpod, go_router화면, 상태 관리, 화면 이동
실시간 통신Firestore, WebRTC, FCM채팅, 영상통화, 푸시 알림
서버TypeScript, Node.js 22매칭, 본인인증, 친구·통화 상태 변경
사진·AIVertex AI, OpenAI사진 임베딩·해시태그, 대화 추천
운영Analytics, Crashlytics, Remote Config진행 단계 확인, 오류 추적, 설정 관리

서버에서 확인하는 것

  • 누가 요청했는가: 로그인 UID와 요청·채팅방의 소유자 또는 참여자를 확인합니다.
  • 지금 가능한 작업인가: 매칭·친구·통화의 상태와 만료 시각을 확인합니다.
  • 무엇을 바꿀 수 있는가: 인증·보상·관계 상태 같은 보호 필드는 서버에서만 변경합니다.

주 데이터 저장소는 Firestore입니다. Supabase 초기화 구성도 저장소에 남아 있습니다.
Cloud Functions의 주요 리전: asia-northeast3

04 · 문제 해결 — 매칭

매칭 중복 생성을 막는 방법

대기열 처리와 채팅방 생성을 같은 트랜잭션으로 묶었습니다.

문제
검색을 다시 시작하거나 서버 작업이 겹치면, 오래된 대기열 정보로 같은 사용자를 중복 연결할 수 있었습니다.
원인
대기열을 읽은 뒤 실제 방을 만들기까지 사용자가 검색을 취소하거나 조건을 바꿀 수 있습니다. 알림 이후 대기열을 지우면 새 검색까지 삭제할 위험이 있습니다.
수정
  • 검색을 새로 시작할 때 sessionId를 바꿔 이전 검색과 구분합니다.
  • 최신 검색·사용자·거리 조건을 검사하고, 대기열 처리와 matches/chats 생성을 하나의 트랜잭션에서 처리합니다.
  • 매칭 완료 알림은 데이터 저장이 끝난 뒤 보냅니다.
현재 검색 확인양쪽 조건 검사대기열 처리 + 방 생성

확인한 시나리오

  • 두 서버 작업이 같은 후보를 동시에 처리하는 경우
  • 검색 취소·재시작 후 이전 요청이 실행되는 경우
  • 대기 중 거리 설정을 바꾸는 경우

구현: functions/src/photo-match.ts · matching.ts
검증: photo-match-critical.emulator.test.ts · PHOTO_MATCH_CRITICAL_FIXES_2026_10_16.md

05 · 문제 해결 — 본인인증

인증 화면은 열렸는데,
요청이 시작되지 않았습니다.

시작 버튼을 첫 화면으로 옮기고, 빈 SDK 응답 뒤 멈추는 로딩을 수정했습니다.

관찰
서버에는 인증 화면을 연 기록이 있었지만, 다음 SDK 요청 단계는 보이지 않았습니다. 이 기록만으로 사용자가 포기했다고 판단할 수는 없었습니다.
재현
작은 WebView에서 안내문이 길어 시작 버튼이 화면 아래에 있었습니다. SDK가 빈 응답을 반환할 때 로딩이 끝나지 않는 경우도 재현했습니다.
수정
  • 인증서 선택과 시작 버튼을 안내문 위로 옮겼습니다.
  • 요청 전인지 결과를 기다리는 중인지 화면에 표시했습니다.
  • 빈 응답 후 이동도 없으면 제한 시간 뒤 재시도를 안내합니다.
시작 버튼 하단 위치1,103px345px375 × 500 CSS px WebView 재현 결과. 가입 전환율 수치는 아닙니다.

인증 완료는 따로 확인합니다.

상태의미
READY인증 플랫폼에 요청이 등록됨. 휴대폰 알림 도착을 뜻하지는 않음.
VERIFIED인증사 승인 결과. 이후 서버가 소유권·나이·CI·성별 등을 검증.
사용자 문서 반영서버 검증을 마친 인증 상태. 앱에서 이 결과를 읽고 다음 단계로 이동.

검증: 작은 화면 레이아웃, 빈 SDK 응답·재시도 fixture, Emulator 권한 검사.
실제 인증서 앱의 알림 수신·본인 승인은 계정 소유자의 직접 확인이 필요합니다.
근거: IDENTITY_STARTUP_RECOVERY_2026_10_27.md · RELEASE_1_2_77.md

06 · 문제 해결 — 채팅

기기를 바꾸면 채팅이 막히던 문제

1.2.69부터 새 메시지의 암호화 키 대기를 제거했습니다.

문제
기기 변경 후 키 복구를 기다리느라 대화 진입·전송이 막히거나, 이전 메시지가 ‘복호화 불가’로 보였습니다.
선택
새 대화가 키 복구 때문에 멈추지 않도록, 신규 매칭·친구 메시지와 사진 캡션은 평문 저장으로 바꿨습니다.
유지
  • 기존 암호문과 키를 삭제하거나 일괄 변환하지 않았습니다.
  • 기존 메시지의 읽기 호환 코드를 유지했습니다.
  • 로그아웃의 캐시 해제와 계정 삭제의 키 제거를 구분했습니다.

계속 검사하는 권한

  • 로그인 여부와 해당 방의 참여자인지 확인합니다.
  • 메시지 작성자와 본문은 수정할 수 없게 제한합니다.
  • 읽음 상태와 허용된 리액션만 변경할 수 있습니다.
당시 검증

Flutter 테스트 2,970개 · 평문 메시지 권한 검사 57개 통과

2026.10.17, 1.2.69 릴리스 기록

키를 잃어버린 과거 암호문은 이 변경만으로 복원되지 않습니다.
앱·스토어·개인정보 안내의 E2E 표현도 실제 저장 방식에 맞췄습니다.
근거: docs/RELEASE_1_2_69.md

07 · 검증·배포

어디까지 확인했는가

자동 테스트로 확인한 범위와, 실제 기기·서비스에서 확인해야 할 범위를 나눠 기록합니다.

2026.10.27 본인인증 시작 복구 작업의 검증 기록
검증결과확인 범위
Functions1,481개 통과
64개 테스트 묶음
회귀·정책·상태 전이
TypeScript 빌드
Emulator9개 통과
3개 테스트 묶음
새 요청·인증 결과·권한
브라우저320 / 375 / 390 / 768px시작 버튼·빈 응답·재시도
관리자 진단 화면
Flutter분석 오류 0건
Android debug 빌드 통과
기존 경고·정보 277건은
별도 유지

해당 작업 당시의 결과입니다. 실제 인증서 앱의 알림 수신·개인 승인을 자동 테스트로 대신 확인한 것은 아닙니다.

배포할 때 확인하는 순서

  1. 소스와 파일 고정

    커밋·버전·빌드 번호와 서명·파일 해시를 남깁니다.

  2. 변경한 부분만 반영

    함수·Hosting을 선택 배포하고 실제 배포된 파일과 비교합니다.

  3. 스토어에서 다시 확인

    Apple 빌드 처리·심사 상태와 Play 게시 개요를 조회합니다. 업로드 성공과 공개 출시를 구분합니다.

데이터 처리 기준

신규 채팅은 평문 저장, 접근은 참여자 권한으로 제한합니다. 매칭 대화의 24시간 이용 만료와 서버의 실제 정리 시점은 구분합니다.