ONLY24
취향 사진으로 상대를 찾고,
24시간 동안 대화하는 앱
Flutter와 Firebase로 구성한 iOS·Android 소셜 매칭 앱입니다.
매칭 후 채팅을 시작하고, 친구 요청으로 대화를 이어갈 수 있습니다.
- 앱
- Flutter · Riverpod · go_router
- 서버
- Firebase Cloud Functions · TypeScript
- 데이터·통신
- Firestore · Storage · WebRTC · FCM
- 지원 환경
- iOS · Android / 한국어 · 영어 · 일본어
주요 기능
일반·사진 매칭 / 24시간 채팅 / 친구 / 영상통화 / 피드 / 우편함·쿠폰
중점적으로 설명할 세 가지
A4 세로 · 210 × 297mm · 8페이지
로그인에서 대화까지
로그인과 본인인증은 별도 단계입니다. 본인인증을 마친 뒤 매칭과 대화를 이용합니다.
- 1
카카오·Apple로 로그인
기존 계정의 로그인과 새 계정 생성을 구분합니다.
- 2
성인 본인인증
지원하는 인증서를 선택하고 인증서 앱에서 승인합니다. 서버가 승인 결과와 만 19세 여부 등을 확인합니다.
- 3
일반 매칭 또는 사진 매칭 시작
사진 매칭은 선택한 사진의 취향을 분석해 상대를 찾습니다. 상대를 찾는 데 걸리는 시간은 대기 인원과 조건에 따라 달라집니다.
- 4
양쪽이 준비되면 채팅 시작
대화가 시작된 시점부터 24시간을 계산합니다.
- 5
친구 요청으로 대화 이어가기
친구 관계는 기본 7일입니다. 연장은 별도 이용 조건을 따릅니다.
사용 중 막혔을 때
- 인증창을 닫은 경우: 진행 중인 요청을 보존하고 서버에서 결과를 다시 확인합니다.
- 첫 사진 매칭: 사진 선택 → 검색 → 대화 시작 순서로 안내합니다.
- 우편으로 받은 쿠폰: 본문에서 코드를 선택·복사한 뒤 설정에서 등록합니다.
현재 앱에서 할 수 있는 일
기능과 이용 조건을 함께 정리했습니다.
| 기능 | 동작과 조건 |
|---|---|
| 일반·사진 매칭 | 일일 횟수 제한은 없습니다. 양쪽 거리 설정, 차단, 계정 상태는 확인합니다. |
| 24시간 채팅 | 양쪽 준비가 끝나 채팅을 시작한 시점부터 24시간입니다. 읽음·리액션·이모티콘을 지원합니다. |
| 영상통화 | 매칭 참여자 모두 기본 발신 2회, 통화당 최대 3분입니다. 광고·쿠폰 추가 횟수는 별도로 유지합니다. |
| 친구 | 요청·수락 후 친구 채팅을 이용합니다. 기본 관계 기간은 7일이며 정원과 연장 조건을 서버에서 검사합니다. |
| 피드·AI 도움 | 게시물·좋아요·댓글을 지원합니다. AI 코치는 대화 주제와 표현을 추천합니다. |
| 우편함·혜택 | 우편 제목·본문의 선택 복사, 쿠폰 등록, 구독·광고 보상을 제공합니다. 사용·지급·만료는 서버에서 처리합니다. |
무료 기능과 구독 조건
- 매칭과 기본 영상통화는 구독 여부와 무관하게 제공합니다.
- 이모티콘은 모든 사용자가 전송할 수 있습니다.
- 일부 첨부·AI 추천·친구 슬롯은 성별·구독·개별 이용 조건을 적용합니다.
화면과 서버의 역할
앱은 사용자 입력과 화면 상태를 관리합니다. 인증·매칭·결제처럼 권한 검사가 필요한 작업은 서버가 처리합니다.
| 구분 | 기술 | 맡은 일 |
|---|---|---|
| 앱 | Flutter, Riverpod, go_router | 화면, 상태 관리, 화면 이동 |
| 실시간 통신 | Firestore, WebRTC, FCM | 채팅, 영상통화, 푸시 알림 |
| 서버 | TypeScript, Node.js 22 | 매칭, 본인인증, 친구·통화 상태 변경 |
| 사진·AI | Vertex AI, OpenAI | 사진 임베딩·해시태그, 대화 추천 |
| 운영 | Analytics, Crashlytics, Remote Config | 진행 단계 확인, 오류 추적, 설정 관리 |
서버에서 확인하는 것
- 누가 요청했는가: 로그인 UID와 요청·채팅방의 소유자 또는 참여자를 확인합니다.
- 지금 가능한 작업인가: 매칭·친구·통화의 상태와 만료 시각을 확인합니다.
- 무엇을 바꿀 수 있는가: 인증·보상·관계 상태 같은 보호 필드는 서버에서만 변경합니다.
주 데이터 저장소는 Firestore입니다. Supabase 초기화 구성도 저장소에 남아 있습니다.
Cloud Functions의 주요 리전: asia-northeast3
매칭 중복 생성을 막는 방법
대기열 처리와 채팅방 생성을 같은 트랜잭션으로 묶었습니다.
- 문제
- 검색을 다시 시작하거나 서버 작업이 겹치면, 오래된 대기열 정보로 같은 사용자를 중복 연결할 수 있었습니다.
- 원인
- 대기열을 읽은 뒤 실제 방을 만들기까지 사용자가 검색을 취소하거나 조건을 바꿀 수 있습니다. 알림 이후 대기열을 지우면 새 검색까지 삭제할 위험이 있습니다.
- 수정
- 검색을 새로 시작할 때
sessionId를 바꿔 이전 검색과 구분합니다. - 최신 검색·사용자·거리 조건을 검사하고, 대기열 처리와
matches/chats생성을 하나의 트랜잭션에서 처리합니다. - 매칭 완료 알림은 데이터 저장이 끝난 뒤 보냅니다.
- 검색을 새로 시작할 때
확인한 시나리오
- 두 서버 작업이 같은 후보를 동시에 처리하는 경우
- 검색 취소·재시작 후 이전 요청이 실행되는 경우
- 대기 중 거리 설정을 바꾸는 경우
구현: functions/src/photo-match.ts · matching.ts
검증: photo-match-critical.emulator.test.ts · PHOTO_MATCH_CRITICAL_FIXES_2026_10_16.md
인증 화면은 열렸는데,
요청이 시작되지 않았습니다.
시작 버튼을 첫 화면으로 옮기고, 빈 SDK 응답 뒤 멈추는 로딩을 수정했습니다.
- 관찰
- 서버에는 인증 화면을 연 기록이 있었지만, 다음 SDK 요청 단계는 보이지 않았습니다. 이 기록만으로 사용자가 포기했다고 판단할 수는 없었습니다.
- 재현
- 작은 WebView에서 안내문이 길어 시작 버튼이 화면 아래에 있었습니다. SDK가 빈 응답을 반환할 때 로딩이 끝나지 않는 경우도 재현했습니다.
- 수정
- 인증서 선택과 시작 버튼을 안내문 위로 옮겼습니다.
- 요청 전인지 결과를 기다리는 중인지 화면에 표시했습니다.
- 빈 응답 후 이동도 없으면 제한 시간 뒤 재시도를 안내합니다.
인증 완료는 따로 확인합니다.
| 상태 | 의미 |
|---|---|
| READY | 인증 플랫폼에 요청이 등록됨. 휴대폰 알림 도착을 뜻하지는 않음. |
| VERIFIED | 인증사 승인 결과. 이후 서버가 소유권·나이·CI·성별 등을 검증. |
| 사용자 문서 반영 | 서버 검증을 마친 인증 상태. 앱에서 이 결과를 읽고 다음 단계로 이동. |
검증: 작은 화면 레이아웃, 빈 SDK 응답·재시도 fixture, Emulator 권한 검사.
실제 인증서 앱의 알림 수신·본인 승인은 계정 소유자의 직접 확인이 필요합니다.
근거: IDENTITY_STARTUP_RECOVERY_2026_10_27.md · RELEASE_1_2_77.md
기기를 바꾸면 채팅이 막히던 문제
1.2.69부터 새 메시지의 암호화 키 대기를 제거했습니다.
- 문제
- 기기 변경 후 키 복구를 기다리느라 대화 진입·전송이 막히거나, 이전 메시지가 ‘복호화 불가’로 보였습니다.
- 선택
- 새 대화가 키 복구 때문에 멈추지 않도록, 신규 매칭·친구 메시지와 사진 캡션은 평문 저장으로 바꿨습니다.
- 유지
- 기존 암호문과 키를 삭제하거나 일괄 변환하지 않았습니다.
- 기존 메시지의 읽기 호환 코드를 유지했습니다.
- 로그아웃의 캐시 해제와 계정 삭제의 키 제거를 구분했습니다.
계속 검사하는 권한
- 로그인 여부와 해당 방의 참여자인지 확인합니다.
- 메시지 작성자와 본문은 수정할 수 없게 제한합니다.
- 읽음 상태와 허용된 리액션만 변경할 수 있습니다.
Flutter 테스트 2,970개 · 평문 메시지 권한 검사 57개 통과
2026.10.17, 1.2.69 릴리스 기록키를 잃어버린 과거 암호문은 이 변경만으로 복원되지 않습니다.
앱·스토어·개인정보 안내의 E2E 표현도 실제 저장 방식에 맞췄습니다.
근거: docs/RELEASE_1_2_69.md
어디까지 확인했는가
자동 테스트로 확인한 범위와, 실제 기기·서비스에서 확인해야 할 범위를 나눠 기록합니다.
| 검증 | 결과 | 확인 범위 |
|---|---|---|
| Functions | 1,481개 통과 64개 테스트 묶음 | 회귀·정책·상태 전이 TypeScript 빌드 |
| Emulator | 9개 통과 3개 테스트 묶음 | 새 요청·인증 결과·권한 |
| 브라우저 | 320 / 375 / 390 / 768px | 시작 버튼·빈 응답·재시도 관리자 진단 화면 |
| Flutter | 분석 오류 0건 Android debug 빌드 통과 | 기존 경고·정보 277건은 별도 유지 |
해당 작업 당시의 결과입니다. 실제 인증서 앱의 알림 수신·개인 승인을 자동 테스트로 대신 확인한 것은 아닙니다.
배포할 때 확인하는 순서
- 소스와 파일 고정
커밋·버전·빌드 번호와 서명·파일 해시를 남깁니다.
- 변경한 부분만 반영
함수·Hosting을 선택 배포하고 실제 배포된 파일과 비교합니다.
- 스토어에서 다시 확인
Apple 빌드 처리·심사 상태와 Play 게시 개요를 조회합니다. 업로드 성공과 공개 출시를 구분합니다.