환전·해외송금 프로젝트 PRD

작성일: 2026-10-21 · 버전: 1.0 · 상태: 현재 작업본 기반 제품 정의 및 신규 디자인 기준

디자인 개정: 2026-10-21 사용자 제공 Bottari 브랜드 가이드 및 UI 컴포넌트를 신규 Figma 시안에 반영했다. 디자인 브랜드는 Bottari로 표시하며, 앱 정체성 설정의 변경은 이번 문서·디자인 작업 범위 밖이다. 출처와 적용 결정을 참조한다.

1. 목적과 근거

보유 통화와 필요한 통화를 명확히 등록하고, 진행 중인 환전을 관리하며, 별도 해외송금 흐름에서는 비용과 처리 상태를 확인한다. 첫 진입은 환전 등록에 집중한다. 기존 송금인·심사역·정산 담당·운영 관리자 체험도 유지한다.

이 문서는 실행 결과를 인증하는 문서가 아니다. 저장소의 현재 코드와 문서에서 확인한 기능, 이번 디자인 제안, 후속 미구현 기능을 구분한다. 제품명은 identity.yaml을 따르며 새 이름은 확정하지 않는다.

근거 우선순위:

  1. 최근 환전 결정: exchange-onboarding-decisions.md, 환전 기능 README, 실제 모델·저장소.
  2. 송금 요구사항: FR 고정 스냅샷, 기존 설계 기록.
  3. 최근 셸 결정: 로그인·데모 도구 정리. 기존 스냅샷의 상시 데모 배너 요구보다 최신 결정을 우선한다.
  4. 브랜드: brand.md. 디자인의 면·선 규칙은 사용자가 요청한 skills PR #552의 하우스 스타일을 따른다. 기존 구현의 카드 외곽선은 새 시안에서 면 대비로 정리하는 제안이다.

2. 문제와 대상

대상 상황 해결할 문제 성공한 경험
환전 등록자 보유한 외화를 다른 통화로 바꾸려 함 통화 방향 혼동, 같은 요청 중복, 완료와 삭제 혼동 방향·금액을 확인하고 한 번 등록, 동일 ID 수정, 완료 이력 보존
송금인 해외 가족 등의 수취인에게 송금 체험 수수료·실수령액·보류 이유가 분산 제출 전 비용 확인, 접수 후 상태와 다음 행동 확인
심사역 접수·보류 요청을 검토 판단 근거와 서류 연결이 불명확 송금·서류·한도·사유를 확인하고 권한 내 결정
정산 담당 승인된 송금을 처리 심사 결정과 지급 처리 혼동 승인 건에만 정산·송금·도착 기록
운영 관리자 한도·대장 관리 설정 변경이 어디에 적용되는지 불명확 정책 변경 후 다음 판정에 반영

핵심 행동: 보유 통화 → 받을 통화 → 보유 금액을 확인해 환전 요청을 등록한다.

3. 범위와 단계

범위 현재 근거 이번 PRD·디자인에서의 취급
환전 첫 등록, 목록, 수정, 완료, 중복 처리 현재 작업 트리에 exchange/app 존재 최우선 사용자 흐름
해외송금 견적·접수·추적·증빙·알림 기존 기능 번들 존재 별도 송금 영역으로 유지
심사·정산·수취인 대장·한도·플래그 console 번들 존재 운영 흐름 정의, 대표 화면 디자인
환율 API, 실제 환전 체결, 실지급 환전 기능에 없음 이번 범위 제외
상품 검색·매칭·채팅·거리 정렬 최근 결정에 후속 요구로 기록 후속 MVP 후보, 현재 화면에서 작동처럼 표시 금지
정확한 위치, CCTV 정보 제공처·정책 미정 수집·안전 보증 기능 제외
법률·약관·KYC/AML 운영 체계 별도 확정 필요 출시 전 별도 검토, 본 문서는 법률 기준을 제시하지 않음

현재 환전은 localOnly 데모다. 서버 API·실거래·기기 간 동기화를 제공한다고 표현하지 않는다. 기존 송금의 가상 견적과 환전 등록을 혼동하지 않도록 메뉴와 안내를 분리한다.

4. 정보 구조와 권한

고객 모바일 메뉴: 내 환전 / 송금 / 받는 사람 / 알림. 설정은 계정 메뉴로 접근한다. 이는 신규 디자인 제안이며 라우트·권한은 기존 계약을 보존한다. 웹은 동일 메뉴의 사이드바와 본문을 쓴다.

운영 메뉴: 심사 큐 / 플래그 / 정산 / 수취인 대장 / 한도 정책. 역할에 허용된 항목만 노출하고, 직접 URL 접근도 거부한다.

기능 고객 심사역 정산 담당 운영 관리자
내 환전 등록·수정·완료 자신의 항목 없음 없음 없음
송금 신청·고객 취소 자신의 송금, 상태 조건 적용 없음 없음 없음
심사 결정·서류 요청 없음 허용 상태에서 가능 없음 역할 계약에 따름
송금·도착 처리 없음 없음 승인 이후 가능 역할 계약에 따름
한도 정책 관리 없음 보기 범위 확인 보기 범위 확인 변경

운영 관리자에게 모든 권한을 추론해 부여하지 않는다. 실제 권한 정본은 전이 정책·scope 검사다. 결제 주체는 실결제가 없는 데모이므로 해당 없음이다.

5. 주요 여정

환전 첫 등록

빈 목록 → 보유 통화·받을 통화 선택 → 보유 금액 입력 → 등록 내용 확인 → 등록 → 진행 중 목록. 온보딩 완료 자체가 첫 등록이며 같은 내용을 다시 등록시키지 않는다.

수정·중복·완료

목록 → 수정 → 기존 값 불러오기 → 확인 → 동일 ID 갱신. 취소하면 원본 유지.

새 등록/수정 → 동일 방향 진행 항목 존재 → 기존 항목 수정 또는 완료 확인. 완료는 자동 실행하지 않는다. 완료 후 새 요청도 별도로 확인하고 등록한다.

진행 중 목록 → 완료 처리 → 대상 방향·금액과 이력 보존 안내 → 완료 확정 → 완료 목록. 완료를 실제 환전 체결이나 대금 지급의 증거로 표시하지 않는다.

해외송금과 운영

받는 사람 → 견적 → 목적·자금 출처 → 제출 확인 → 한도·증빙 → 상태 추적. 보류이면 사유 확인 → 샘플 서류 제출 → 재심사 요청. 심사역 결정 후 정산 담당이 승인된 건의 송금·도착을 기록한다.

6. 기능 요구사항과 수용 조건

새 ID EX-*는 환전 요구사항이며 기존 FR-001~024를 재번호화하지 않는다.

ID 우선순위 요구사항 수용 조건
EX-01 P0 첫 환전 등록 빈 계정에서 유효한 입력을 확인·등록하면 진행 중 항목 1개가 생성된다. 첫 등록을 재요청하지 않는다.
EX-02 P0 통화 방향 KRW/USD/JPY/EUR/GBP/CNY를 코드와 이름으로 표시. 같은 통화끼리 등록 불가. 통화 변경이 UI 언어를 바꾸지 않는다.
EX-03 P0 금액 검증 보유 통화 기준 정수 1~999,999,999,999만 허용. 0·음수·소수·범위 초과·빈 입력은 필드 오류, 저장 없음.
EX-04 P0 확인 단계 보유 통화·받을 통화·보유 금액을 다시 표시. 수정으로 돌아가도 입력 유지. 실시간 환율·받을 금액 미제공 안내.
EX-05 P0 중복 방지 owner+have+want가 같은 진행 중 항목이 있으면 금액과 무관하게 거부. 반대 방향은 허용. 수정 대상 자신은 제외.
EX-06 P0 수정 자신의 진행 중 항목만 수정. ID 유지, revision 증가. 취소 시 원본 불변.
EX-07 P0 완료 확인 없이 완료하지 않음. 완료 이력 보존, 완료 후 수정 불가. 같은 방향 신규 등록은 별도 확인 후 허용.
EX-08 P0 오래된 화면 revision 불일치 시 덮어쓰지 않고 최신 항목 재열기 안내. 입력 실패를 성공으로 표시하지 않는다.
EX-09 P0 소유권·진입 제한 고객 자신의 기록만 조회/변경. 비고객·서버 모드에서 환전 등록 불가.
EX-10 P0 저장·초기화 웹은 기존 DemoWorld snapshot과 함께 복원/초기화. 비웹 메모리 정책 명시. 멀티탭은 마지막 저장 우선이며 서버 동시성 보장으로 간주하지 않음.
EX-11 P1 목록 상태 진행 중/완료를 구분. 빈 상태는 등록 진입 행동 제공. 완료 목록은 이력임을 명확히 표시.
EX-12 P1 만남 안내 사람이 많고 밝은 공공장소를 권고. CCTV 존재·거래 안전·상대 신뢰를 보증하지 않음.
RM-01 P0 기존 견적 계약 보존 FR-006: 원금 1,000,000원 + 수수료 5,000원 − 할인 2,000원 = 1,003,000원. 가상 환율 1원=17.85동, 수령 17,850,000동. 만료 시 다음 단계 차단.
RM-02 P0 송금 상태·주체 분리 FR-007012, FR-021022: 고객의 신청·취소와 운영자의 심사·정산 행동을 분리. 선택한 수취인·견적이 다음 화면으로 전달됨.
OP-01 P0 심사 근거 FR-015~017: 송금 요약·서류·한도·사유를 함께 확인. 보류 사유와 요청 서류가 없으면 보류 확정 불가.
OP-02 P0 정산과 정책 FR-018~020: 정산 합계는 라인에서 계산. 한도는 데모 정책으로 표시하고 실제 법정 기준처럼 안내하지 않음.

기존 FR 전체의 세부 AC는 고정 스냅샷을 그대로 참조한다. 이 문서가 생성 스냅샷이나 기존 게이트를 덮어쓰지 않는다.

7. 화면 목록과 이번 시안

코드 화면 결정 정보 / 주요 행동 신규 시안 범위
C-01 체험 진입 역할, 체험용이며 실거래 없음 공통 화면
EX-01 내 환전 진행 중/완료, 방향, 보유 금액 Mobile/Web 기본, 빈 상태
EX-02 환전 등록·수정 보유 통화, 받을 통화, 보유 금액, 통화와 언어 분리 Mobile 기본·입력 오류
EX-03 등록 내용 확인 방향, 금액, 등록 효과, 환율 미제공 Mobile 기본·중복
EX-04 완료 확인 대상 방향·금액, 이력 보존, 수정 불가 Mobile 확인 대화상자
A-05 송금 견적 수취인, 원금, 수수료, 할인, 총액, 가상 환율·수령액, 유효성 Mobile 기본·만료
A-08 송금 추적 참조번호, 상태 이력, 다음 행동 Mobile 기본
O-01 심사 큐 대상, 금액, 상태, 보류 사유·증빙 Web 기본
O-02 정산 승인 상태, 정산 라인, 합계·다음 처리 Web 기본

EX/C/O 코드는 이 문서에서 정의한 디자인 추적용이다. 기존 코드의 UseCase 이름을 자동으로 변경하지 않는다. 기존 나머지 기능 화면은 요구사항 범위에는 포함되며 이번 리디자인은 위 대표 여정에 집중한다. 상세 시안 커버리지는 디자인 보고서에 기록한다.

8. 데이터와 상태

ExchangeRecord: id, ownerId, have, want, amount(정수), completed(bool), revision. 진행 중 → 완료 단방향. 읽기는 상태를 바꾸지 않는다. 환율·수령액·위치·상대방·매칭 상태는 현재 모델에 없다.

송금은 기존 TransferRecord와 전이 정책을 유지한다. 금액은 minor unit, 환율은 분자/분모 기반 계약을 따른다. 운영 전이의 revision·멱등·권한 검사도 보존한다.

공통 상태 11종 적용
빈 상태 환전/수취인/내역/큐의 0건
로딩 조회 중 구조 유지, 중복 행동 차단
진행 저장·제출 처리 중 버튼 잠금
성공 저장 결과와 목록 반영, 완료와 체결 구분
실패 실패 대상 + 보존되는 입력/원본 + 재시도 행동
한도 환전 금액 범위 및 송금 데모 한도
잠김 완료 항목 수정 불가, 오래된 revision 재열기
업그레이드 유료 플랜 없음, 해당 없음
권한 없음 역할·소유자·서버 모드 제한
오프라인 localOnly 자체 사용 가능. 서버 조회 실패와 구분
확인 대화상자 완료·취소 등 상태 변경 전 대상과 영향 표시

9. 비기능 요구사항

10. 측정 계획

다음은 신규 제안이며 현재 분석 도구에 구현됐다는 뜻이 아니다.

지표 정의 성공 기준
첫 등록 완료율 완료한 세션 / 등록 시작 세션 베이스라인 측정 후 목표 확정
확인 단계 이탈률 확인 진입 후 미등록 세션 / 확인 진입 세션 입력·문구 개선 전후 비교
중복 해결률 중복 안내 후 수정 또는 명시적 완료한 세션 / 중복 세션 이중 등록 0, 자동 완료 0
상태 이해 사용성 테스트에서 등록/완료와 실거래 차이를 설명한 인원 출시 검토 전 오해 사례 해소

이벤트 후보: exchange_started, exchange_reviewed, exchange_saved, exchange_duplicate_shown, exchange_edit_saved, exchange_completed. 금액·계좌·자유 입력·개인 ID는 이벤트 속성에 넣지 않는다.

11. 출시 단계와 미확정 사항

  1. 현재: PRD와 대표 여정 Figma 검토. 앱 코드 변경은 별도 작업.
  2. 다음: 시안 채택 후 CoUI 구현, 위 AC·기존 계약 게이트·골든·반응형·RTL 검증.
  3. 후속 MVP: 검색·매칭·채팅·거리 정렬의 데이터·권한·운영 정책을 별도 정의.
  4. 실서비스 전: 서비스명, 환율 공급자/비용/갱신/재배포 조건, 서버 저장·동시성, 위치 동의, 법률·약관·개인정보, 지급 체계, 도메인·인프라 확정.

검증 체크리스트: 빈 계정 첫 등록 / 6통화 / 같은 통화 거부 / 금액 경계 / 같은 방향 중복 / 반대 방향 허용 / 자기 수정 제외 / 취소 불변 / 완료 확인 / 완료 이력 / stale 거부 / 타인 격리 / 웹 복원 / 초기화 / 통화와 언어 독립 / 견적 만료 / 운영 주체 분리.

12. 디자인 산출물

시안은 미래 동작을 설명하는 프로토타입이며 실제 저장·송금·거래를 수행하지 않는다.

13. 추가 요구: CCTV Safe Zone 지도와 거래 장소 전달

2026-10-21 사용자 추가 결정: flutter_map: ^8.3.2, map_launcher: ^7.0.0을 사용하고, CCTV가 있는 Safe Zone 정보와 거래 장소를 쉽고 빠르게 전달한다. 기존 §3의 위치/CCTV 제외 범위를 ‘현재 미구현, 이번 신규 디자인 포함’으로 갱신한다. 환전 상대방의 현재 위치를 탐색하는 지도는 이번 요구의 중심이 아니다.

제품 흐름

내 환전 → 거래 장소 찾기 → 지역 검색 또는 내 위치 사용 → 지도 핀/목록에서 Safe Zone 선택 → CCTV 근거와 만남 지점 확인 → 거래 장소 공유하기. 길찾기는 보조 행동이며 설치·지원 지도 앱 선택 후 외부로 연다. 장소 공유는 합의 요청이며 상대가 동의했다고 표시하지 않는다.

주 행동은 장소 전달이다. 장소 상세 첫 화면에 장소명, 주소, 구체적 만남 위치(예: 정문 앞 안내판), CCTV 설치 정보, 확인 주체/확인일, 이용 가능 시간·출입 제한을 함께 둔다. 알 수 없는 항목은 ‘확인 필요’로 표시한다. CCTV의 설치 존재와 실시간 작동·촬영 범위·거래 안전 보장은 다른 정보다. ‘Safe Zone’ 명칭 옆에 CCTV 정보 기준이라는 설명을 둔다.

범위와 데이터

기능 요구사항

ID 우선순위 수용 조건
SZ-01 P0 GPS 권한 없이 지역 검색·지도 이동·목록 탐색 가능. ‘내 위치’ 선택 시에만 권한 요청. 거부 시 현재 화면 유지하고 지역 검색 제공.
SZ-02 P0 지도 핀과 목록이 같은 장소 ID를 가리킴. 선택 핀·선택 카드 동기화. 지도 이동 후 ‘이 지역에서 찾기’로 결과 갱신.
SZ-03 P0 상세에 장소명·주소·만남 지점·CCTV 상태·근거·확인일·이용 제한 표시. 미확인 정보를 확인 완료처럼 표시하지 않음.
SZ-04 P0 ‘거래 장소 공유하기’에서 공유 내용을 미리 확인. 장소명+주소+만남 지점+앱 링크로 OS 공유/복사. GPS·금액·계좌는 기본 제외. 공유창 취소를 전송 완료로 처리하지 않음.
SZ-05 P0 ‘길찾기’에서 실제 플랫폼 지원 지도만 제시. 선택한 장소 좌표·명칭 전달. 실패 시 재선택·주소 복사·웹 지도 대안 제공.
SZ-06 P0 CCTV 미확인/정보 오래됨/장소 닫힘 상태를 정상 상태와 구분. CCTV 작동 중·촬영 사각지대 없음·거래 안전을 추론하지 않음.
SZ-07 P1 지도 로딩/타일 실패 시 장소 목록 유지. 결과 0건은 지역 변경. 정보 수정 제보는 운영 검토 전까지 확인 상태를 바꾸지 않음.
SZ-08 P1 공유 링크 수신자는 로그인 전에도 공개 장소 정보만 확인. 장소 변경/폐쇄 시 최신 상태 안내. 앱 미설치 시 웹 장소 페이지 대안은 후속 구현 계약.

화면 추가

SZ-01 Safe Zone 지도(선택 핀과 장소 요약), SZ-02 장소 상세, SZ-03 공유 미리보기, SZ-04 지도 앱 선택, SZ-05 위치 권한 거부/지역 탐색, SZ-06 CCTV 확인 필요, SZ-07 결과 없음, SZ-08 지도 로딩 실패, SZ-09 OS 공유 인계, SZ-10 복사 완료. Mobile 중심, Web 지도+목록 대표안 추가. 전체 화면 링크 목록.

라이브러리 역할과 구현 인계

flutter_map은 지도 UI와 마커 계층을 맡는다. 지도 타일 자체와 CCTV/장소 데이터는 별도 공급원이 필요하다. 지도 하단에 실제 공급자 attribution이 가려지지 않는 자리를 둔다. 출처: flutter_map 8.3.2, TileLayer 공식 문서.

map_launcher 7.0.0은 마커/길찾기 등 외부 지도 열기를 맡고 플랫폼·지도별 지원이 다르다. 설치 앱 탐지는 모바일에 적용하며 웹/데스크톱은 지원 URL 방식으로 분기한다. 지도 서비스 목록을 고정적으로 모두 설치된 것처럼 노출하지 않는다. 출처: map_launcher 7.0.0 공식 패키지.

두 패키지만으로 GPS 권한·CCTV 공급·검색/지오코딩·OS 공유·채팅·거래 합의가 구현되지 않는다. 위치 권한 및 공유 구현 수단, 타일 공급자, 장소 API, 공개 딥 링크를 별도로 정한다. 이번 작업은 PRD·Figma 추가이며 pubspec 및 앱 코드는 변경하지 않는다.