#claude
-
아키텍처·API 레퍼런스 문서 체계 정비
docs: 문서 업데이트 및 개선 (Redis, 아키텍처, 스킬 정의) 문서화 작업은 귀찮지만 나중을 위해 꼭 필요함. 특히 외부 API 연동 부분은 레퍼런스 없으면 매번 명세서 다시 뒤져야 함. 문서 구조 .claude/docs/ ├── api-reference.md 외부 API 엔드포인트 정리 ├── architecture.md
읽기 → -
OMC 심볼릭 링크 스킬을 깃이그노어로 관리하도록 정리
chore: OMC 심볼릭 링크 스킬 gitignore 처리 이번 작업의 핵심은 기존 기능 안정화와 코드 일관성 확보였음. 변경 범위가 여러 레이어에 걸쳐있어서 영향 범위를 꼼꼼히 체크했음. 변경 영역 | 레이어 | 파일 수 | 주요 변경 | |--------|--------|---------| | 백엔드 로직 | 0개 | 핵심 처리 로직 개선 |
읽기 → -
이커머스 결제 플랫폼 사용자 페이지 모바일 레이아웃
fix : 이커머스 PG 플랫폼 사용자페이지 QA 버그 수정 JSP UI 작업은 레거시 환경에서 어떻게 사용성을 올릴 수 있는지 계속 고민하게 만듦. 테이블 레이아웃 개선 모바일에서 가로 스크롤 없이 보이게 하는 게 과제였음. 카드형 뷰로 폴백 처리함. jsp <%-- PC: 테이블 형태 --%> <div class="admin-table-wra
읽기 → -
Apple OAuth 콜백 차단·세션 유실 문제 해결
feat: QR 프로모션 관리 및 랜딩 페이지 기능 추가 Apple OAuth가 구글/카카오랑 달리 까다로운 이유가 있음. form_post 방식을 강제하기 때문에 콜백이 POST로 들어오고, 이 과정에서 세션이 끊기거나 CORS 문제가 발생함. Apple OAuth 특이사항 - 콜백이 GET이 아닌 POST (form_post) - 봇 차단 필터
읽기 → -
정산 수수료 누적 구조와 멱등성·상태 전환 설계 정리
feat: 정산 및 웰컴페이(payment/settlement) 스킬 문서 추가 정산 및 수수료 로직은 버그 하나가 금전 오류로 직결되는 영역이라 신중하게 접근해야 함. 수수료 계산 구조 유통 단계별로 수수료가 누적되는 구조임. 최하위 파트너가 가장 높은 요율을 부담하고, 상위로 갈수록 낮아지며 그 차액이 각 단계의 수익임. | 단계 | 요율 |
읽기 → -
수수료 단계별 정산 로직과 멱등성 처리 구현
docs: 수수료 시스템 구현 지시서 및 결과 보고서 추가 정산 및 수수료 로직은 버그 하나가 금전 오류로 직결되는 영역이라 신중하게 접근해야 함. 수수료 계산 구조 유통 단계별로 수수료가 누적되는 구조임. 최하위 파트너가 가장 높은 요율을 부담하고, 상위로 갈수록 낮아지며 그 차액이 각 단계의 수익임. | 단계 | 요율 | 수익 | |-----
읽기 → -
파트너 실시간 문의용 PIP 채팅 위젯 구현
feat: PIP 채팅 위젯 기능 추가 관리자 채팅 기능 추가 작업임. 파트너가 관리자에게 실시간으로 문의할 수 있는 PIP 채팅 위젯 구현. 채팅 아키텍처 WebSocket 대신 Polling 방식으로 구현함. 실시간성이 중요한 채팅이 아니라 문의/답변 형태여서 30초 폴링으로 충분함. javascript // 30초마다 새 메시지 확인 set
읽기 → -
사용자 정보·위젯 관리 코드 품질 개선
feat: 사용자 정보 및 위젯 관리 기능 확장 이번 작업의 핵심은 기존 기능 안정화와 코드 일관성 확보였음. 변경 범위가 여러 레이어에 걸쳐있어서 영향 범위를 꼼꼼히 체크했음. 변경 영역 | 레이어 | 파일 수 | 주요 변경 | |--------|--------|---------| | 백엔드 로직 | 0개 | 핵심 처리 로직 개선 | | 화면 (
읽기 → -
위젯 스타일 디자인 토큰 통일
feat: 신규 SCSS 기반 위젯 스타일 추가 CSS/SCSS 작업은 눈에 잘 안 보이지만 쌓이면 시스템 전체 일관성에 영향 줌. 이번엔 디자인 토큰 통일과 반응형 최적화가 메인이었음. CSS 변수 통일 작업 컴포넌트마다 4px, 6px, 8px, 12px이 혼재해있었음. 디자인 시스템 기준을 잡고 CSS 변수로 통일함. scss :root {
읽기 → -
디자인 토큰 통일과 모바일 카드 스크롤 UX 개선
feat: HTML 자동 sanitize 로직 추가 및 SQL/Java 스타일 문서 경로 수정 CSS/SCSS 작업은 눈에 잘 안 보이지만 쌓이면 시스템 전체 일관성에 영향 줌. 이번엔 디자인 토큰 통일과 반응형 최적화가 메인이었음. CSS 변수 통일 작업 컴포넌트마다 4px, 6px, 8px, 12px이 혼재해있었음. 디자인 시스템 기준을 잡고
읽기 → -
이커머스 결제 API 문서 전면 보완으로 코드 불일치까지 해결
이커머스 결제 연동 플랫폼 API 명세 전체 보완 및 신규 섹션 추가 2026-02-06. API 문서 작업. 코드가 아무리 잘 짜여 있어도 문서가 없으면 다른 사람이, 또는 미래의 내가 쓰기 어려움. 문서화 범위 - **API 엔드포인트**: 경로, HTTP 메서드, 요청/응답 스펙 - **파라미터 명세**: 필수/선택 여부, 타입, 유효성 규칙
읽기 → -
이커머스 결제 연동 서비스 전체 레이어 신규 구현
이커머스 결제 연동 플랫폼 Pay 서비스 전체 구현 (Controller + Mapper + JSP + DDL) 2026-02-05. 비즈니스 로직 레이어에 실제 동작하는 로직을 심는 작업이었음. 기술적 접근 요구사항 분석 후 다음 순서로 진행했음: 1. **스키마/모델 정의** — 어떤 데이터를 어떻게 저장할지 먼저 결정 2. **핵심 로직 구
읽기 → -
기술 부채 청산으로 코드 가독성과 유지보수성 개선
아이콘 변경 및 충전 알림 URL 추가 2026-02-02. 내부 구조 정리 작업. 기능은 안 바뀌지만 앞으로의 유지보수를 위한 투자임. 정리 대상 코드 리뷰나 기능 추가 작업을 하다 보면 '이 부분 나중에 꼭 정리해야지'라고 생각하는 곳들이 쌓임. 이번에 그 기술 부채를 정리했음. - 컨트롤러: 역할이 불명확한 부분 분리 - 서비스 레이어: 중
읽기 → -
정산 계산과 지갑 서비스 로직을 컨트롤러부터 뷰까지 구현
정산 계산 서비스 및 지갑 관련 로직 추가 2026-02-02. 컨트롤러, 서비스 레이어 레이어에 실제 동작하는 로직을 심는 작업이었음. 기술적 접근 요구사항 분석 후 다음 순서로 진행했음: 1. **스키마/모델 정의** — 어떤 데이터를 어떻게 저장할지 먼저 결정 2. **핵심 로직 구현** — 컨트롤러부터 시작 3. **API 연결** — 외
읽기 → -
컨트롤러 중복 코드를 공통 유틸로 통합해 수정 비용 절감
CommonUtil로 중복 유틸 메서드 통합 2026-02-01에 진행한 코드베이스 정리. 당장 눈에 띄는 효과는 없지만 장기적으로 개발 속도를 유지시켜 주는 핵심 작업임. 리팩토링 원칙 이번 작업에서 적용한 원칙들: 1. **단일 책임**: 하나의 함수/클래스는 하나의 일만 2. **DRY**: 중복 코드는 반드시 추출 3. **명확한 이름**
읽기 → -
운영 서버 컨트롤러에 스킬 명령어 로직 구현
운영 서버 관리 및 스킬 명령어 추가 2026-02-01. 컨트롤러 레이어에 실제 동작하는 로직을 심는 작업이었음. 기술적 접근 요구사항 분석 후 다음 순서로 진행했음: 1. **스키마/모델 정의** — 어떤 데이터를 어떻게 저장할지 먼저 결정 2. **핵심 로직 구현** — 컨트롤러부터 시작 3. **API 연결** — 외부에서 호출 가능하게
읽기 → -
판다인터 UI와 공지사항 처리 로직을 전 레이어에 구현
판다인터 UI 개선 및 고정 레이아웃 시스템 공지사항 처리 추가 2026-01-30. 컨트롤러, 유틸리티, 뷰 템플릿 레이어에 실제 동작하는 로직을 심는 작업이었음. 기술적 접근 요구사항 분석 후 다음 순서로 진행했음: 1. **스키마/모델 정의** — 어떤 데이터를 어떻게 저장할지 먼저 결정 2. **핵심 로직 구현** — 컨트롤러부터 시작 3
읽기 → -
관리자·사용자 리다이렉트 URL에 대상 시스템 ID 추가
관리자 및 사용자 redirect URL에 targetSysId 추가 2026-01-30. 컨트롤러 레이어에 실제 동작하는 로직을 심는 작업이었음. 기술적 접근 요구사항 분석 후 다음 순서로 진행했음: 1. **스키마/모델 정의** — 어떤 데이터를 어떻게 저장할지 먼저 결정 2. **핵심 로직 구현** — 컨트롤러부터 시작 3. **API 연결
읽기 → -
정산 자동화 로직과 테스트 시나리오 명세 신규 구현
정산 테스트 시나리오 명세서 추가 및 자동 정산 로직 구현 2026-01-30. 테스트, 컨트롤러 레이어에 실제 동작하는 로직을 심는 작업이었음. 기술적 접근 요구사항 분석 후 다음 순서로 진행했음: 1. **스키마/모델 정의** — 어떤 데이터를 어떻게 저장할지 먼저 결정 2. **핵심 로직 구현** — 테스트부터 시작 3. **API 연결**
읽기 → -
Font Awesome 아이콘을 Iconoir로 전면 교체
Font Awesome 아이콘을 Iconoir 아이콘으로 전체 교체 2026-01-29. 뷰 템플릿 레이어에 실제 동작하는 로직을 심는 작업이었음. 기술적 접근 요구사항 분석 후 다음 순서로 진행했음: 1. **스키마/모델 정의** — 어떤 데이터를 어떻게 저장할지 먼저 결정 2. **핵심 로직 구현** — 뷰 템플릿부터 시작 3. **API 연
읽기 →