#api
-
결제 웹훅 이중 디코딩 버그 수정으로 시그니처 검증 안정화
docs: Webhook API 가이드 v1.3 업데이트 Webhook 처리 로직에서 꽤 골치 아픈 이슈를 잡았음. 핵심은 이중 URL decode 문제임. 문제 발생 배경 결제대행사 Webhook은 POST body로 암호화된 필드를 넘겨주는데, 이 값이 URL-encoded 상태로 들어옴. 서버 프레임워크가 Content-Type: applic
읽기 → -
결제 Webhook 이중 디코딩 버그 수정으로 시그니처 검증 안정화
docs: Webhook API 가이드 수정 (trstnId 평문 기준으로 변경) Webhook 처리 로직에서 꽤 골치 아픈 이슈를 잡았음. 핵심은 이중 URL decode 문제임. 문제 발생 배경 결제대행사 Webhook은 POST body로 암호화된 필드를 넘겨주는데, 이 값이 URL-encoded 상태로 들어옴. 서버 프레임워크가 Conten
읽기 → -
키움페이 Webhook 이중 디코딩 버그 수정으로 결제 검증 안정화
feat: 스토어 테마 등록 및 키움페이 Webhook 연동 가이드 추가 Webhook 처리 로직에서 꽤 골치 아픈 이슈를 잡았음. 핵심은 이중 URL decode 문제임. 문제 발생 배경 결제대행사 Webhook은 POST body로 암호화된 필드를 넘겨주는데, 이 값이 URL-encoded 상태로 들어옴. 서버 프레임워크가 Content-Typ
읽기 → -
레거시 JSP에서 모바일 반응형 테이블 구현
feat: FAQ 초기 데이터 등록 및 키움페이 가상계좌 충전 기능 구현 JSP UI 작업은 레거시 환경에서 어떻게 사용성을 올릴 수 있는지 계속 고민하게 만듦. 테이블 레이아웃 개선 모바일에서 가로 스크롤 없이 보이게 하는 게 과제였음. 카드형 뷰로 폴백 처리함. jsp <%-- PC: 테이블 형태 --%> <div class="admin-ta
읽기 → -
패키지 구조 재편과 Service를 Util로 전환한 리팩토링 가이드
docs: 패키지 구조 및 Mapper XML 위치 규칙 문서화 리팩토링은 기능 변경 없이 코드 품질을 올리는 작업임. 이번엔 패키지 구조 정리와 Service 계층을 Util 방식으로 전환하는 게 핵심이었음. 패키지 구조 재편 기존: 기능별 패키지 내 Controller/Service/Mapper 혼재 개선: Controller(web)와 Ut
읽기 → -
금융 이상감지 이력 관리자 조회 기능 구축
feat: 이상감지 관리자 이력 조회 기능 추가 이상감지 기능은 금융 서비스에서 특히 중요함. 비정상 패턴을 자동으로 탐지하고 기록해두는 시스템을 구현했음. 이상 패턴 유형 | 패턴 | 조건 | 조치 | |------|------|------| | 단시간 대량 충전 | 1시간 내 N회 이상 | 경고 + 관리자 알림 | | 비정상 시간대 접근 | 새
읽기 → -
금융 서비스에 비정상 충전 패턴 이상감지 시스템 구축
feat: 이상감지 및 할당량 관리 기능 구현 이상감지 기능은 금융 서비스에서 특히 중요함. 비정상 패턴을 자동으로 탐지하고 기록해두는 시스템을 구현했음. 이상 패턴 유형 | 패턴 | 조건 | 조치 | |------|------|------| | 단시간 대량 충전 | 1시간 내 N회 이상 | 경고 + 관리자 알림 | | 비정상 시간대 접근 | 새벽
읽기 → -
디자인 토큰 통일과 모바일 스크롤 스냅으로 CSS 일관성 개선
docs: AI 서비스 및 스타일 가이드 문서 제거 CSS/SCSS 작업은 눈에 잘 안 보이지만 쌓이면 시스템 전체 일관성에 영향 줌. 이번엔 디자인 토큰 통일과 반응형 최적화가 메인이었음. CSS 변수 통일 작업 컴포넌트마다 4px, 6px, 8px, 12px이 혼재해있었음. 디자인 시스템 기준을 잡고 CSS 변수로 통일함. scss :root
읽기 → -
페이지빌더 개발 문서 체계 구축
feat: 페이지빌더 스킬 문서 추가 및 미리보기/입력 처리 개선 문서화 작업은 귀찮지만 나중을 위해 꼭 필요함. 특히 외부 API 연동 부분은 레퍼런스 없으면 매번 명세서 다시 뒤져야 함. 문서 구조 .claude/docs/ ├── api-reference.md 외부 API 엔드포인트 정리 ├── architecture.md
읽기 → -
수수료율 단계별 정산 관리 기능 추가
feat: 수수료율 관리 기능 및 JSP 추가 정산 및 수수료 로직은 버그 하나가 금전 오류로 직결되는 영역이라 신중하게 접근해야 함. 수수료 계산 구조 유통 단계별로 수수료가 누적되는 구조임. 최하위 파트너가 가장 높은 요율을 부담하고, 상위로 갈수록 낮아지며 그 차액이 각 단계의 수익임. | 단계 | 요율 | 수익 | |------|-----
읽기 → -
수수료 정산 구조·멱등성·검증 방법 문서 삭제
docs: 수수료 구현 및 검증 문서 삭제 정산 및 수수료 로직은 버그 하나가 금전 오류로 직결되는 영역이라 신중하게 접근해야 함. 수수료 계산 구조 유통 단계별로 수수료가 누적되는 구조임. 최하위 파트너가 가장 높은 요율을 부담하고, 상위로 갈수록 낮아지며 그 차액이 각 단계의 수익임. | 단계 | 요율 | 수익 | |------|------|
읽기 → -
서비스 계층을 정적 유틸로 전환해 패키지 구조 개선
feat: 스킬 리팩토링 및 작업 프로세스 위임 로직 구현 리팩토링은 기능 변경 없이 코드 품질을 올리는 작업임. 이번엔 패키지 구조 정리와 Service 계층을 Util 방식으로 전환하는 게 핵심이었음. 패키지 구조 재편 기존: 기능별 패키지 내 Controller/Service/Mapper 혼재 개선: Controller(web)와 Util(
읽기 → -
상품 주문 결제 트랜잭션 원자성 보장
feat: 구독 관리 기능 및 결제 처리 로직 구현 상품 목록부터 주문까지 이어지는 흐름을 정비했음. 특히 상품 옵션 처리와 페이징, 카테고리 필터가 한 번에 엮이는 부분이 까다로웠음. 상품 옵션 처리 구조 java // 옵션 유무 분기 if (product.hasOption()) { model.addAttribute("options", p
읽기 → -
파트너 위저드에 전화번호 필수·계정발급·수수료 계층 검증 추가
feat: 파트너 위저드 계정발급 및 전화번호 필수화 구현 파트너 관리 기능 정비 작업임. 계정 발급, 레벨 설정, 수수료 설정이 한 화면에서 유기적으로 동작해야 해서 꼼꼼히 짜야 했음. 파트너 등록 필수값 | 필드 | 필수 여부 | 검증 | |------|--------|------| | 상호명 | 필수 | NOT NULL | | 대표자명 | 필
읽기 → -
관리자 페이지 백엔드 로직 안정성
feat: 관리자 페이지 품질 감사 단계 완료 및 사용자 피드백 반영 수정 이번 작업의 핵심은 기존 기능 안정화와 코드 일관성 확보였음. 변경 범위가 여러 레이어에 걸쳐있어서 영향 범위를 꼼꼼히 체크했음. 변경 영역 | 레이어 | 파일 수 | 주요 변경 | |--------|--------|---------| | 백엔드 로직 | 2개 | 핵심 처리
읽기 → -
공급 체인 환불 검증 로직 추가
feat: 공급 체인 환불 가능 여부 검증 로직 추가 이번 작업의 핵심은 기존 기능 안정화와 코드 일관성 확보였음. 변경 범위가 여러 레이어에 걸쳐있어서 영향 범위를 꼼꼼히 체크했음. 변경 영역 | 레이어 | 파일 수 | 주요 변경 | |--------|--------|---------| | 백엔드 로직 | 1개 | 핵심 처리 로직 개선 | | 화
읽기 → -
웰컴페이 API 레퍼런스 문서 체계 정비
docs: 웰컴페이 API 서비스 명세서 V1.6 추가 문서화 작업은 귀찮지만 나중을 위해 꼭 필요함. 특히 외부 API 연동 부분은 레퍼런스 없으면 매번 명세서 다시 뒤져야 함. 문서 구조 .claude/docs/ ├── api-reference.md 외부 API 엔드포인트 정리 ├── architecture.md 시스템 구
읽기 → -
웰컴페이 KYC 본인인증 연동
feat: 웰컴페이 PostMessage 공통 유틸리티 도입 및 중복 코드 제거 KYC(본인인증) 연동 작업에서 CI/DI 처리가 핵심이었음. 결제대행사 쪽에서 본인인증 완료 후 PostMessage로 CI, DI 값을 넘겨주는 구조임. KYC 플로우 정리 1. 사용자 → 본인인증 페이지 오픈 (iframe/popup) 2. 결제대행사 SDK →
읽기 → -
주문 결제 트랜잭션 정합성 개선
feat: 주문 결제 트랜잭션 정합성 수정 상품 목록부터 주문까지 이어지는 흐름을 정비했음. 특히 상품 옵션 처리와 페이징, 카테고리 필터가 한 번에 엮이는 부분이 까다로웠음. 상품 옵션 처리 구조 java // 옵션 유무 분기 if (product.hasOption()) { model.addAttribute("options", produc
읽기 → -
결제 도메인 완성하고 퇴사한 달의 기록
278개. 2월 커밋 수. 역대 최고치를 경신했다. 이전 회사 마지막 달이기도 했다.
읽기 →