#settlement
-
계층별 수수료 정산 로직 검증 강화
일일 정산 Discord Embed 리포트 발송 2026-03-25에 수수료 계산 또는 정산 관련 로직을 작업했음. 수수료 구조는 유통 계층별로 요율이 다르게 설정되는 차등 모델임. 하위 계층이 상위 계층보다 높은 요율을 부담하고, 그 차액이 상위 계층의 수익이 되는 구조임. 수수료 계층 예시 | 계층 | 요율 | 비고 | |---|---|---
읽기 → -
정산 유니크 제약 누락으로 중복 적재되던 문제 수정
dump.rdb 가 또 올라왔음 로컬에서 캐시 띄워놓고 작업하다 보면 워킹 디렉토리에 dump.rdb 가 슬쩍 생김. 평소엔 잘 피해다녔는데 다른 변경이랑 같이 add 되면서 한번 커밋에 따라 들어간 적이 있었음. 수십 MB 바이너리가 히스토리에 박히면 클론할 때마다 짜증나고, 무엇보다 캐시 스냅샷에 뭐가 들었는지 모르니 보안적으로도 찜찜함. 그래서
읽기 → -
파트너 정산 이중 차감과 화면별 잔액 오차 수정
정산 중복 처리, 또 너냐 파트너 정산 화면에서 같은 건이 두 번 차감되는 이슈. 결제 플랫폼 쪽에선 흔한 패턴이긴 한데, 이번엔 정산·대시보드·파트너 어드민·파트너 화면 컨트롤러 4개를 동시에 손봐야 했음. 한 곳만 고치면 다른 화면에서 다시 어긋나서, 결국 합계 산식을 원장 수준에서 한 번에 정리함. 무엇이 문제였나 - 충전 수수료, 결제 수수
읽기 → -
결제 웹훅 원장·잔액 대조 배치로 정산 분쟁 추적 가능해짐
웹훅 원장 기록부터 깔았음 결제대행사 웹훅이 들어올 때 처리만 하고 흘려보내던 구조였는데, 정산 분쟁 한 번 터지고 나니 "그때 그 웹훅 진짜 왔었냐"는 질문에 답을 못 했음. 헤더, 페이로드, 서명검증 결과, 처리 결과까지 전부 원장으로 적재하기로 했음. - 들어온 원본은 가공 없이 그대로 저장 - 처리 단계별 상태 코드 분리 (수신완료 / 검증완료
읽기 → -
에이전트 산출물 디렉터리를 깃이그노어로 차단해 PR 노이즈 제거
.omc/ 를 .gitignore 에 박은 이유 작업 도중 워킹트리에 .omc/ 디렉터리가 슬금슬금 늘어나는 걸 발견함. 에이전트 상태, 노트패드, 프로젝트 메모리, 플랜 초안, 로그까지 죄다 그 안에 쌓이고 있었음. 깜빡하고 한 번 커밋했다가 PR 디프가 본질 변경 30줄에 부산물 800줄로 부풀어버려서, 리뷰어가 "이거 뭐냐"고 물어본 게 트리거였음
읽기 → -
README 정비로 팀 문서화 기준 확립
README.md 추가 문서 작업은 다들 대충 하고 넘어가는데 나중에 후회함. README를 제대로 정리하면서 프로젝트 구조도 같이 다시 봤음. README에 반드시 들어가야 할 것들 markdown 프로젝트 개요 어떤 문제를 해결하는지 1-2줄로 설치 방법 복붙 가능한 명령어 위주로 환경 변수 | 키 | 설명 | 필수 여부 | 아키텍
읽기 → -
스토어 랜딩 페이지 반응형 레이아웃
style: 스토어 관련 CSS/SCSS 스타일 및 JSP 구조 개선 스토어 랜딩 페이지 UI 구현 작업임. 앱 다운로드 유도 + FAQ + 연락처 섹션으로 구성했음. 페이지 구조 [Hero Section] - 메인 카피 + CTA [Feature Cards] - 주요 기능 소개 [App Download] - App Store / Google P
읽기 → -
웰컴페이 API 레퍼런스 문서 체계 정비
docs: 웰컴페이 API 서비스 명세서 V1.6 추가 문서화 작업은 귀찮지만 나중을 위해 꼭 필요함. 특히 외부 API 연동 부분은 레퍼런스 없으면 매번 명세서 다시 뒤져야 함. 문서 구조 .claude/docs/ ├── api-reference.md 외부 API 엔드포인트 정리 ├── architecture.md 시스템 구
읽기 → -
Apple 소셜 로그인 콜백 세션 유실
fix(oauth): Apple 연동 후 로그인 세션 재설정 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 구조 추가, 수수료 정산 로직 및 탭 관리 기능 개선 정산 및 수수료 로직은 버그 하나가 금전 오류로 직결되는 영역이라 신중하게 접근해야 함. 수수료 계산 구조 유통 단계별로 수수료가 누적되는 구조임. 최하위 파트너가 가장 높은 요율을 부담하고, 상위로 갈수록 낮아지며 그 차액이 각 단계의 수익임. | 단계 | 요율 | 수익
읽기 → -
관리자 페이지 사이드바 자동 스크롤과 브레드크럼 개선
fix: breadcrumb 링크 대상 관리자 대시보드로 수정 관리자 페이지 네비게이션 정비 작업임. 사이드바 메뉴 구조 개편과 breadcrumb 개선이 핵심이었음. 사이드바 자동 스크롤 javascript const activeMenu = document.querySelector('.sidebar-menu .active'); if (active
읽기 → -
인덱스 무효화 쿼리를 범위 조건으로 개선해 SQL 성능 최적화
SQL 및 메뉴 구조 최적화 SQL 최적화와 쿼리 구조 개선 작업임. 실행 계획 확인 없이 작성된 쿼리들이 문제가 됐음. 인덱스 활용 패턴 sql -- 비효율: 함수 적용으로 인덱스 무효화 WHERE DATE(created_at) = '2026-03-01' -- 효율: 범위 조건으로 인덱스 활용 WHERE created_at >= '2026-03
읽기 → -
관리자 스타일 디자인 토큰 통일
feat: 파트너 전자계약서 스타일 추가 및 관리자 반응형 레이아웃 수정 CSS/SCSS 작업은 눈에 잘 안 보이지만 쌓이면 시스템 전체 일관성에 영향 줌. 이번엔 디자인 토큰 통일과 반응형 최적화가 메인이었음. CSS 변수 통일 작업 컴포넌트마다 4px, 6px, 8px, 12px이 혼재해있었음. 디자인 시스템 기준을 잡고 CSS 변수로 통일함.
읽기 → -
정산 수수료 누적 구조와 멱등성·상태 전환 설계 정리
feat: 정산 및 웰컴페이(payment/settlement) 스킬 문서 추가 정산 및 수수료 로직은 버그 하나가 금전 오류로 직결되는 영역이라 신중하게 접근해야 함. 수수료 계산 구조 유통 단계별로 수수료가 누적되는 구조임. 최하위 파트너가 가장 높은 요율을 부담하고, 상위로 갈수록 낮아지며 그 차액이 각 단계의 수익임. | 단계 | 요율 |
읽기 → -
파트너 수수료 정산 현황·영수증 상세 페이지 추가
feat: 파트너 수수료 현황 및 영수증 상세 페이지 추가 정산 및 수수료 로직은 버그 하나가 금전 오류로 직결되는 영역이라 신중하게 접근해야 함. 수수료 계산 구조 유통 단계별로 수수료가 누적되는 구조임. 최하위 파트너가 가장 높은 요율을 부담하고, 상위로 갈수록 낮아지며 그 차액이 각 단계의 수익임. | 단계 | 요율 | 수익 | |-----
읽기 → -
수수료 단계별 정산 로직과 멱등성 처리 구현
docs: 수수료 시스템 구현 지시서 및 결과 보고서 추가 정산 및 수수료 로직은 버그 하나가 금전 오류로 직결되는 영역이라 신중하게 접근해야 함. 수수료 계산 구조 유통 단계별로 수수료가 누적되는 구조임. 최하위 파트너가 가장 높은 요율을 부담하고, 상위로 갈수록 낮아지며 그 차액이 각 단계의 수익임. | 단계 | 요율 | 수익 | |-----
읽기 → -
파트너 실시간 문의용 PIP 채팅 위젯 구현
feat: PIP 채팅 위젯 기능 추가 관리자 채팅 기능 추가 작업임. 파트너가 관리자에게 실시간으로 문의할 수 있는 PIP 채팅 위젯 구현. 채팅 아키텍처 WebSocket 대신 Polling 방식으로 구현함. 실시간성이 중요한 채팅이 아니라 문의/답변 형태여서 30초 폴링으로 충분함. javascript // 30초마다 새 메시지 확인 set
읽기 → -
정산 수수료 단계별 누적 구조와 멱등성 처리 개선
feat: 정산 로직(수수료/마진) 및 Pay 정책 등급 기반 개선 정산 및 수수료 로직은 버그 하나가 금전 오류로 직결되는 영역이라 신중하게 접근해야 함. 수수료 계산 구조 유통 단계별로 수수료가 누적되는 구조임. 최하위 파트너가 가장 높은 요율을 부담하고, 상위로 갈수록 낮아지며 그 차액이 각 단계의 수익임. | 단계 | 요율 | 수익 | |
읽기 → -
파트너 포털 디자인 토큰 통일
style: 파트너 포털 전용 SCSS 파일 추가 및 Welcome 연동 가이드 문서 생성 CSS/SCSS 작업은 눈에 잘 안 보이지만 쌓이면 시스템 전체 일관성에 영향 줌. 이번엔 디자인 토큰 통일과 반응형 최적화가 메인이었음. CSS 변수 통일 작업 컴포넌트마다 4px, 6px, 8px, 12px이 혼재해있었음. 디자인 시스템 기준을 잡고 CS
읽기 →