-
이커머스 PG 플랫폼에 주문상세·매출전표 추가
feat: 이커머스 PG 플랫폼 매출전표/주문상세 페이지 추가 및 반응형 수정 상품 목록부터 주문까지 이어지는 흐름을 정비했음. 특히 상품 옵션 처리와 페이징, 카테고리 필터가 한 번에 엮이는 부분이 까다로웠음. 상품 옵션 처리 구조 java // 옵션 유무 분기 if (product.hasOption()) { model.addAttribu
읽기 → -
주문 페이지 모바일 반응형
feat: 주문 페이지 모바일 반응형 스타일 추가 상품 목록부터 주문까지 이어지는 흐름을 정비했음. 특히 상품 옵션 처리와 페이징, 카테고리 필터가 한 번에 엮이는 부분이 까다로웠음. 상품 옵션 처리 구조 java // 옵션 유무 분기 if (product.hasOption()) { model.addAttribute("options", pr
읽기 → -
KYC 본인인증 연동
feat: PG 설정 추가 (KYC 미완성 시 Welcomepay 비활성화) KYC(본인인증) 연동 작업에서 CI/DI 처리가 핵심이었음. 결제대행사 쪽에서 본인인증 완료 후 PostMessage로 CI, DI 값을 넘겨주는 구조임. KYC 플로우 정리 1. 사용자 → 본인인증 페이지 오픈 (iframe/popup) 2. 결제대행사 SDK → 인
읽기 → -
결제 웹훅 이중 디코딩 버그 수정으로 시그니처 검증 안정화
feat: KYC 재이행 알림 배치 작업 추가 Webhook 처리 로직에서 꽤 골치 아픈 이슈를 잡았음. 핵심은 이중 URL decode 문제임. 문제 발생 배경 결제대행사 Webhook은 POST body로 암호화된 필드를 넘겨주는데, 이 값이 URL-encoded 상태로 들어옴. 서버 프레임워크가 Content-Type: application/
읽기 → -
관심 카테고리·쿠폰 조회 기록 API 신규 추가
feat: 관심 카테고리 선택/저장 기능 및 쿠폰 조회 기록 API 추가 문서화 작업은 귀찮지만 나중을 위해 꼭 필요함. 특히 외부 API 연동 부분은 레퍼런스 없으면 매번 명세서 다시 뒤져야 함. 문서 구조 .claude/docs/ ├── api-reference.md 외부 API 엔드포인트 정리 ├── architecture.md
읽기 → -
선물 만료 자동 배치에 멱등성·모니터링 설계 적용
feat: 선물 만료 자동 배치 작업 추가 배치 작업은 운영 중에 터지면 치명적이라 스케줄링 설계를 꼼꼼히 해야 함. 배치 설계 원칙 - 멱등성: 동일 조건으로 여러 번 돌아도 같은 결과 - 실패 로그: 어떤 건이 실패했는지 추적 가능해야 함 - 부분 성공: 일부 실패해도 나머지는 처리 계속 - 알림: 오류 발생 시 담당자에게 즉시 알림 스케줄
읽기 → -
KYC 본인인증 CI/DI 연동 오류 수정과 웰컴페이 안정화
feat: KYC 본인인증 CI/DI 처리 및 웰컴페이 연동 개선 KYC(본인인증) 연동 작업에서 CI/DI 처리가 핵심이었음. 결제대행사 쪽에서 본인인증 완료 후 PostMessage로 CI, DI 값을 넘겨주는 구조임. KYC 플로우 정리 1. 사용자 → 본인인증 페이지 오픈 (iframe/popup) 2. 결제대행사 SDK → 인증 완료 후
읽기 → -
KYC 본인인증 자동화와 CI·DI 연동 오류 해결
feat: KYC 본인인증 자동 실행 및 PostMessage 기반 처리 로직 추가 KYC(본인인증) 연동 작업에서 CI/DI 처리가 핵심이었음. 결제대행사 쪽에서 본인인증 완료 후 PostMessage로 CI, DI 값을 넘겨주는 구조임. KYC 플로우 정리 1. 사용자 → 본인인증 페이지 오픈 (iframe/popup) 2. 결제대행사 SDK
읽기 → -
KYC 본인인증 연동
feat: 웰컴페이 회원 상태 조회/변경 기능 및 PostMessage 처리 개선 KYC(본인인증) 연동 작업에서 CI/DI 처리가 핵심이었음. 결제대행사 쪽에서 본인인증 완료 후 PostMessage로 CI, DI 값을 넘겨주는 구조임. KYC 플로우 정리 1. 사용자 → 본인인증 페이지 오픈 (iframe/popup) 2. 결제대행사 SDK
읽기 → -
파트너 충전 한도 조회와 소속 회원 목록 기능 추가
feat: 파트너 충전 한도 및 소속 회원 목록 조회 기능 추가 포인트/잔액 관련 로직은 정합성이 핵심임. 동시성 이슈와 소수점 처리를 특히 조심해야 함. 포인트 차감 순서 무상 포인트 먼저 차감 → 부족하면 유상에서 차감 (세금 처리, 환불 정책과 연관됨) 동시성 처리 sql -- 비관적 락으로 잔액 차감 SELECT balance FR
읽기 → -
JSP 관리자 화면 모바일 대응
fix: OG 이미지 기본 경로 수정 및 이미지 파일 추가 JSP UI 작업은 레거시 환경에서 어떻게 사용성을 올릴 수 있는지 계속 고민하게 만듦. 테이블 레이아웃 개선 모바일에서 가로 스크롤 없이 보이게 하는 게 과제였음. 카드형 뷰로 폴백 처리함. jsp <%-- PC: 테이블 형태 --%> <div class="admin-table-wrap
읽기 → -
Apple 소셜 로그인 콜백 세션 유실
fix(oauth): Apple 연동 후 로그인 세션 재설정 Apple OAuth가 구글/카카오랑 달리 까다로운 이유가 있음. form_post 방식을 강제하기 때문에 콜백이 POST로 들어오고, 이 과정에서 세션이 끊기거나 CORS 문제가 발생함. Apple OAuth 특이사항 - 콜백이 GET이 아닌 POST (form_post) - 봇 차단
읽기 → -
웰컴페이 KYC 본인인증 연동
feat: 웰컴페이 KYC 본인인증 연동 기능 추가 및 처리 로직 구현 KYC(본인인증) 연동 작업에서 CI/DI 처리가 핵심이었음. 결제대행사 쪽에서 본인인증 완료 후 PostMessage로 CI, DI 값을 넘겨주는 구조임. KYC 플로우 정리 1. 사용자 → 본인인증 페이지 오픈 (iframe/popup) 2. 결제대행사 SDK → 인증 완
읽기 → -
Apple OAuth form_post 콜백 세션 유실로 SNS 연동 실패
fix(oauth): Apple form_post 세션 유실로 SNS 연동 실패 수정 Apple OAuth가 구글/카카오랑 달리 까다로운 이유가 있음. form_post 방식을 강제하기 때문에 콜백이 POST로 들어오고, 이 과정에서 세션이 끊기거나 CORS 문제가 발생함. Apple OAuth 특이사항 - 콜백이 GET이 아닌 POST (form
읽기 → -
Apple OAuth 콜백 CORS 차단
fix(oauth): Apple OAuth 콜백 CORS 차단 해제 Apple OAuth가 구글/카카오랑 달리 까다로운 이유가 있음. form_post 방식을 강제하기 때문에 콜백이 POST로 들어오고, 이 과정에서 세션이 끊기거나 CORS 문제가 발생함. Apple OAuth 특이사항 - 콜백이 GET이 아닌 POST (form_post) - 봇
읽기 → -
Apple OAuth 콜백 차단·세션 유실 문제 해결
fix(oauth): Apple OAuth 콜백 봇 차단 필터 예외 추가 Apple OAuth가 구글/카카오랑 달리 까다로운 이유가 있음. form_post 방식을 강제하기 때문에 콜백이 POST로 들어오고, 이 과정에서 세션이 끊기거나 CORS 문제가 발생함. Apple OAuth 특이사항 - 콜백이 GET이 아닌 POST (form_post)
읽기 → -
Apple OAuth 콜백 오류와 세션 유실 문제 해결
feat: Apple OAuth 설정 및 수수료 정산 로직 확장 Apple OAuth가 구글/카카오랑 달리 까다로운 이유가 있음. form_post 방식을 강제하기 때문에 콜백이 POST로 들어오고, 이 과정에서 세션이 끊기거나 CORS 문제가 발생함. Apple OAuth 특이사항 - 콜백이 GET이 아닌 POST (form_post) - 봇 차
읽기 → -
수수료 정산 멱등성·상태 전환 로직 개선
feat: Tree 구조 추가, 수수료 정산 로직 및 탭 관리 기능 개선 정산 및 수수료 로직은 버그 하나가 금전 오류로 직결되는 영역이라 신중하게 접근해야 함. 수수료 계산 구조 유통 단계별로 수수료가 누적되는 구조임. 최하위 파트너가 가장 높은 요율을 부담하고, 상위로 갈수록 낮아지며 그 차액이 각 단계의 수익임. | 단계 | 요율 | 수익
읽기 → -
등급별 수수료 정책 조회와 정산 멱등성 처리 개선
refactor: 불필요한 pageTitle 속성 제거 및 등급별 수수료 정책 조회 쿼리 추가 정산 및 수수료 로직은 버그 하나가 금전 오류로 직결되는 영역이라 신중하게 접근해야 함. 수수료 계산 구조 유통 단계별로 수수료가 누적되는 구조임. 최하위 파트너가 가장 높은 요율을 부담하고, 상위로 갈수록 낮아지며 그 차액이 각 단계의 수익임. | 단
읽기 → -
포인트 차감 순서·동시성·파트너 수수료 정산 구조 개선
feat: 포인트/파트너 허브 메뉴 통합 및 권한 설정 개선 포인트/잔액 관련 로직은 정합성이 핵심임. 동시성 이슈와 소수점 처리를 특히 조심해야 함. 포인트 차감 순서 무상 포인트 먼저 차감 → 부족하면 유상에서 차감 (세금 처리, 환불 정책과 연관됨) 동시성 처리 sql -- 비관적 락으로 잔액 차감 SELECT balance FROM
읽기 →