매칭 플랫폼 — 개발 진행 가이드

서비스 접속 정보

사용자 앱 #1 (Flutter Web) — 호스트

사용자 페이지 https://match.habyapps.com/app/ 열기

테스트 ID user@match.local

비밀번호 Test1234!

역할 HOST (매치 등록자)

사용자 앱 #2 (Flutter Web) — 참여자

사용자 페이지 https://match.habyapps.com/app/ 열기

테스트 ID user2@match.local

비밀번호 Test1234!

역할 USER (매치 신청·참여)

관리자 웹 (Vue 3)

서비스 match.habyapps.com/admin 열기

관리자 ID superadmin@match.local

비밀번호 ChangeMe!2026

역할 SUPERADMIN

QA QA 결과

단계별 개발 진행 현황

Phase 0 — 사전 준비 및 블로커 해소

Sprint 1 · D-13 회신 확보, 결정 항목 정리, 개발 환경 세팅

6/6 ✅

Sprint 1 — 사전 준비 (2026-W21 ~ W22)

D-13 토스페이먼츠 서브몰+에스크로 동시 사용 가부 회신 확보 · 개발 환경 초기화 · CI 구성

T-001D-13 서면 회신 확보 및 분기 RFC 작성

T-002단기 결정 항목 정리 (D-02~D-17: 수수료율·환불정책·연령제한·만료기간 등)

T-003백엔드 스캐폴딩 (Express + Prisma + 디렉토리 구조 + .env.example)

T-004Flutter 프로젝트 초기화 + Feature-first 구조 설정

T-005Vue 3 + Vite + TypeScript 관리자 웹 초기화

T-006CI 파이프라인 초기 구성 (lint + test + prisma validate)

Phase 1 — 도메인 기반 (DB · API · 채팅)

Sprint 2~4 · Prisma 스키마 18개 테이블 · REST API · Socket.IO 채팅

21/21 ✅

Sprint 2 — DB 스키마 확정, M-01 (2026-W23 ~ W24)

Prisma schema.prisma 18개 모델 · 마이그레이션 · 시드 스크립트 · DB_SCHEMA.md

T-007Prisma 스키마 18개 모델 정의 (users, matchings, payments, escrow_holds, settlements, disputes 등)

T-008초기 마이그레이션 생성 및 MariaDB 10.11 적용

T-009Prisma 시드 스크립트 (약관 v0.1 · SUPERADMIN · 샘플 장소 5건)

T-010DB_SCHEMA.md 컬럼 상세 문서화

Sprint 3 — 회원·매칭·신청 API, M-02 (2026-W25 ~ W26)

JWT 인증 · 소셜 로그인 · 매칭 CRUD · HOST 자동 승격 · PENDING 만료 스케줄러

T-011인증 API (signup/login/refresh/logout) + JWT 미들웨어 (AccessToken 15분 · RefreshToken 14일)

T-012소셜 로그인 OAuth 2.0 (카카오 · 구글 · 네이버)

T-013사용자 API + 서브몰 등록 (HOST 자동 승격 · 계좌번호 마스킹)

T-014약관 API + 동의 기록 (SERVICE · PRIVACY v0.1-dev)

T-015매칭 등록/조회/수정/삭제 API (cursor 페이지네이션 · 카테고리/날짜 필터)

T-016매칭 신청 API (중복 409 · 정원 초과 422 · 자기-매칭 403 차단)

T-017장소 등록/조회 API (승인 워크플로: PENDING → APPROVED/REJECTED)

T-018PENDING 자동 만료 스케줄러 (D-11 결정값 적용)

Sprint 4 — Socket.IO 채팅 + 양측 확정, M-03 (2026-W27 ~ W28)

1:1 채팅 영속화 · 양측 확정 race 차단 · 확정 토글 · outbox 패턴 · 이미지 업로드

T-019Socket.IO /chat 네임스페이스 + JWT handshake 미들웨어

T-020채팅 메시지 영속화 + REST 보완 조회 (재연결 시 누락 메시지)

T-021양측 확정 트랜잭션 + race 차단 (accepted_request_id UNIQUE NULL)

T-022확정 토글 정책 구현 (D-17: ACCEPTED 전이 전까지 자유 토글)

T-023시스템 메시지 outbox 패턴 + 재시도 큐 (트랜잭션 커밋 후 dispatch)

T-024CONFIRMED 30분 미결제 자동 취소 스케줄러 (D-14)

T-025Socket.IO /matching 네임스페이스 (confirmed·completed·cancelled 브로드캐스트)

T-026채팅 이미지 업로드 (magic bytes 검증 · 도메인 화이트리스트)

T-027API.md 회원·매칭·신청·채팅 도메인 문서화

Phase 2 — 결제 통합 (에스크로 · 정산)

Sprint 5~6 · 토스페이먼츠 마켓플레이스 · 에스크로 · 정산 · 환불 · 분쟁

14/14 ✅

Sprint 5 — 결제 + 에스크로 + Webhook, M-04 전반부 (2026-W29 ~ W30)

토스페이먼츠 결제창 · 에스크로 HELD · Webhook 멱등성(transmission_id INSERT IGNORE) · 결제 만료 스케줄러

T-028토스페이먼츠 API 클라이언트 래퍼 (test/live 환경 분기)

T-029결제 요청 API + client_idempotency_key UNIQUE 보장

T-030Webhook 수신 (서명 timing-safe · IP 화이트리스트 · transmission_id 멱등성)

T-031에스크로 HELD 생성 + outbox 시스템 메시지 (트랜잭션 커밋 후)

T-032결제 만료 스케줄러 + EXPIRED ↔ SUCCEEDED 복귀 전이

T-033매칭 IN_PROGRESS/COMPLETED 전이 (에스크로 HELD 상태 검증)

Sprint 6 — 정산 + 환불 + 분쟁, M-04 후반부 (3주: 2026-W31 ~ W33)

에스크로 승인/취소 · settlements 상태 머신 · 7일 보류 윈도우 · PRE/POST_SETTLEMENT 분쟁 · 신고 어뷰징 방지 · 감사 로그

T-034에스크로 승인/취소 API (HELD → APPROVED | CANCELLED)

T-035settlements 상태 머신 + 사후 분쟁 윈도우 7일 스케줄러 (D-15)

T-036환불 API + 케이스별 환불율 자동 적용 (D-03: 주최자 취소 100% · 노쇼 0% 등)

T-037분쟁 API + PRE/POST_SETTLEMENT 분기 처리 (원자적 트랜잭션)

T-038신고 API + 어뷰징 방지 (일일 10건 · 동일 대상 7일 내 중복 차단)

T-039감사 로그 자동 기록 미들웨어 (관리자 모든 처리 행위)

T-040결제 → 정산 → 분쟁 E2E 통합 테스트 (정상/취소/분쟁 시나리오)

T-041API.md 결제·정산·환불·분쟁·신고 도메인 문서화

Phase 3 — 클라이언트 (Flutter 앱 + Vue 관리자 웹)

Sprint 7~8 · Flutter 15개 화면 · Vue 10개 관리자 화면

21/21 ✅

Sprint 7 — Flutter 앱 핵심 화면, M-05 (2026-W33 ~ W34)

Riverpod · Dio · Socket.IO · GoRouter · 온보딩/홈피드/채팅/결제/마이페이지 15개 화면

T-042Flutter 코어 (Riverpod + Dio + Socket.IO Client + GoRouter + Theme 토큰)

T-043인증 기능 (온보딩 · 로그인 · 회원가입 · 약관 동의 화면)

T-044매칭 기능 (홈 피드 카드 그리드 · 매칭 등록 · 상세 · 신청)

T-045채팅 기능 (실시간 메시지 · 시스템 메시지 · 양측 확정 버튼 · 결제 버튼)

T-046결제 기능 (토스페이먼츠 WebView · 결과 화면 · 콜백 5종 시나리오)

T-047정산/결제 내역 화면 (결제·정산 탭 통합)

T-048리뷰 작성 화면 (별점 + 텍스트 500자)

T-049신고 작성 · 내 신고 내역 화면

T-050마이페이지 (프로필 편집 · 서브몰 등록 · 로그아웃 · 회원 탈퇴)

T-051Flutter 위젯 테스트 + golden test (9개 파일)

Sprint 8 — Vue 관리자 웹 화면 구현, M-06 (2026-W36 ~ W37)

Pinia · Axios · Vue Router · Tailwind · 대시보드·회원·매칭·결제·분쟁 등 10개 화면

T-052Vue 코어 (Pinia + Axios + Router + Tailwind 디자인 토큰)

T-053관리자 로그인 + 인증 가드 (httpOnly 쿠키 · withCredentials)

T-054대시보드 (가입자·매칭 성사율·결제 총액·신고 건수 + 기간 필터)

T-055회원 관리 (목록 · 검색 · 상세 · 정지 · 탈퇴)

T-056매칭 관리 (테이블/카드 토글 + 카테고리/상태 필터 + 강제 취소)

T-057결제·정산 관리 (결제 원장 · 에스크로 상태 · 정산 내역 3탭)

T-058장소 승인 워크플로 (PENDING 목록 + 승인/반려)

T-059신고 큐 (유형/상태 필터 + 처리)

T-060분쟁 처리 (분쟁 목록 · decision 선택 · note 입력 · RESOLVED_REFUND/RELEASE)

T-061감사 로그 뷰어 (SUPERADMIN 전용)

T-062관리자 계정 관리 (SUPERADMIN 전용)

Phase 4 — QA · 운영 키 전환 · 알파

Sprint 9~10 · 통합 검증 · 부하 테스트 · CD 파이프라인 · 실결제 E2E

12/12 ✅

Sprint 9 — 통합 검증 + QA + CD 구축, M-07 (2026-W38 ~ W39)

Flutter↔백엔드↔Vue 7개 시나리오 · QA 75개 케이스 · k6 부하 테스트 · Pino 로깅 · CD 파이프라인

T-063통합 검증 주간 (Flutter↔백엔드↔Vue 7개 시나리오 · INTEGRATION_TEST_REPORT.md)

T-064QA 시나리오 문서 작성 + 실행 (TC-001~TC-075, 75개 케이스)

T-065부하 테스트 (k6 5개 파일 · D-18 목표 · 베이스라인 확정)

T-066Pino 로깅 + Webhook 재처리 도구 (webhook-replay.js)

T-067에스크로 상태 정합성 배치 도구 (DB ↔ 토스 응답 비교 · escrow-reconcile.js)

T-068PM2 클러스터 설정 + MariaDB 백업 정책 (R-07)

T-069CD 파이프라인 구축 (스테이징 자동 배포 + secret manager 키 주입 · RUNBOOK.md)

T-070P0/P1 버그 수정 (Flutter use_build_context_synchronously · dart fix 18건 · 백엔드 55/55 통과)

Sprint 10 — 운영 키 전환 + 알파, M-04b (2026-W40 ~ W41)

RUNBOOK §8 운영 키 체크리스트 · 실결제 E2E(100원) · 클로즈드 알파 관측 · L-항목 청소

T-071토스페이먼츠 운영 키 전환 체크리스트 + RUNBOOK §8 (실제 키 전환은 PO/Infra 수동)

T-072운영 환경 실결제 E2E (소액 100원 · 스태프 계정 · PRODUCTION_E2E_TEST.md)

T-073클로즈드 알파 1주 관측 + 알파 리포트 (ALPHA_REPORT.md)

T-074L-항목 청소 (L-01 SUPERADMIN BCP · L-03 magic bytes 이미지 검열 · L-04 리뷰 14일 기한)

Phase 5 — 내부 베타 런칭, M-08

Sprint 11 · 약관 v1.0 · 베타 사용자 초대 · KPI 측정 · 런칭 회고

3/3 ✅

Sprint 11 — 내부 베타 + KPI 측정, M-08 (2026-W42 ~ W43)

약관 v1.0 게시 · 베타 사용자 20~50명 초대 · KPI 주간 측정 · MVP 런칭 회고 · 2단계 RFC

T-075약관 v1.0 게시 + KPI 측정 시작 (TERMS.md · PRIVACY.md v0.9 초안 · 법률 검토 필요)

T-076내부 베타 사용자 초대 + 베타 가이드 문서 (BETA_GUIDE.md)

T-077M-08 런칭 회고 + 2단계 RFC 계획 (MVP_LAUNCH_RETROSPECTIVE.md)