프로젝트 배경
예약금·잔금 분리 결제, 동시 예약 충돌, 포인트 차감·복원 원장 등 공유미용실 운영의 핵심 리스크 시나리오를 먼저 파악하고, PostgreSQL Advisory Lock·Append-Only 원장·RBAC PII 마스킹까지 실제 동작하도록 사전 구현했습니다. 예약 확정 → 이중예약 차단 → 잔금 요청 → 카드+포인트 혼합 결제 → 정산 완료까지 4단계 시나리오를 검증해둔 덕분에, 착수 즉시 현장에서 바
프로젝트 성과
동시 예약 충돌 방지 (Advisory Lock)
PostgreSQL Advisory Lock으로 같은 슬롯 10명 동시 시도 시 1건만 확정, 9건 실패. 락 이벤트 실시간 Inspector 표시
결제 웹훅 중복 수신 방지 (Idempotency)
webhookId 기반 중복 체크로 동일 웹훅 재전송 시 중복 반영 0건. Webhook Replay Inspector로 실시간 확인
포인트+카드 혼합 결제 및 원장 불변성
카드 40,000원+포인트 20,000원 혼합 결제, PAYMENT→POINT_USE→REFUND→POINT_RESTORE 순 Append-Only 원장 보장
역할별 RBAC + PII 마스킹
고객·디자이너·관리자 3단계 권한 분리, 디자이너 응답에서 고객 이름·전화번호 뒤 4자리만 노출. 범위 외 API 403 반환
3-패널 시연 시나리오 데모
고객·디자이너·관리자 3개 패널이 동시에 표시되며 4단계 비즈니스 스토리를 비개발자도 이해할 수 있는 언어로 시연
핵심 기능
진행 단계
공고 분석 및 핵심 리스크 시나리오 정의
2026.06.
26개 요구사항 도출, 동시 예약·웹훅 중복·원장 불변성·RBAC 핵심 리스크 우선 정의
프로젝트 상세
동시 예약 충돌 방지, 결제 웹훅 중복 처리, 포인트 혼합 결제, 역할별 권한·PII 마스킹, 정산 원장 불변성을 Next.js+PostgreSQL로 구현한 공유미용실 통합 파일럿입니다.







