일기
회고 / 메모
-
수수료 단계별 정산 로직과 멱등성 처리 구현
docs: 수수료 시스템 구현 지시서 및 결과 보고서 추가 정산 및 수수료 로직은 버그 하나가 금전 오류로 직결되는 영역이라 신중하게 접근해야 함. 수수료 계산 구조 유통 단계별로 수수료가 누적되는 구조임. 최하위 파트너가 가장 높은 요율을 부담하고, 상위로 갈수록 낮아지며 그 차액이 각 단계의 수익임. | 단계 | 요율 | 수익 | |-----
읽기 → -
파트너 정산 수수료 구조와 멱등성 처리 설계 추가
docs: 정산 시스템 및 파트너 포털 통합 계획서 추가 정산 및 수수료 로직은 버그 하나가 금전 오류로 직결되는 영역이라 신중하게 접근해야 함. 수수료 계산 구조 유통 단계별로 수수료가 누적되는 구조임. 최하위 파트너가 가장 높은 요율을 부담하고, 상위로 갈수록 낮아지며 그 차액이 각 단계의 수익임. | 단계 | 요율 | 수익 | |------
읽기 → -
파트너 수수료 계층 구조와 외부 API 레퍼런스 문서 정비
docs: 파트너 매뉴얼 및 gitignore 업데이트 문서화 작업은 귀찮지만 나중을 위해 꼭 필요함. 특히 외부 API 연동 부분은 레퍼런스 없으면 매번 명세서 다시 뒤져야 함. 문서 구조 .claude/docs/ ├── api-reference.md 외부 API 엔드포인트 정리 ├── architecture.md 시스템 구
읽기 → -
패키지 구조 재편과 Service를 Util로 전환한 리팩토링
refactor: var → let 치환 및 경고/알림 메시지 처리 개선 리팩토링은 기능 변경 없이 코드 품질을 올리는 작업임. 이번엔 패키지 구조 정리와 Service 계층을 Util 방식으로 전환하는 게 핵심이었음. 패키지 구조 재편 기존: 기능별 패키지 내 Controller/Service/Mapper 혼재 개선: Controller(web
읽기 → -
대시보드 컨트롤러 리팩토링으로 코드 탐색·수정 비용 절감
대시보드 JSP 파일 삭제 2026-02-06에 진행한 코드베이스 정리. 당장 눈에 띄는 효과는 없지만 장기적으로 개발 속도를 유지시켜 주는 핵심 작업임. 리팩토링 원칙 이번 작업에서 적용한 원칙들: 1. **단일 책임**: 하나의 함수/클래스는 하나의 일만 2. **DRY**: 중복 코드는 반드시 추출 3. **명확한 이름**: 이름만 봐도 역
읽기 → -
이커머스 결제 API 문서 전면 보완으로 코드 불일치까지 해결
이커머스 결제 연동 플랫폼 API 명세 전체 보완 및 신규 섹션 추가 2026-02-06. API 문서 작업. 코드가 아무리 잘 짜여 있어도 문서가 없으면 다른 사람이, 또는 미래의 내가 쓰기 어려움. 문서화 범위 - **API 엔드포인트**: 경로, HTTP 메서드, 요청/응답 스펙 - **파라미터 명세**: 필수/선택 여부, 타입, 유효성 규칙
읽기 → -
파트너 포털 결제 API 문서 정비로 온보딩 시간 단축
Pay 관리 및 파트너 포털 관련 API 문서 업데이트 2026-02-06. 내부 문서 정비 작업. 신규 멤버가 왔을 때 온보딩 시간을 줄이는 게 목표였음. 왜 지금 했나 기능 개발이 어느 정도 안정됐고, 이 시점에 문서를 안 쓰면 나중에는 더 안 쓰게 됨. 코드를 짤 때의 맥락과 결정 이유는 시간이 지나면 희미해지기 때문에, 그 기억이 남아 있을
읽기 → -
뷰 템플릿 리팩토링으로 중복 제거와 책임 분리 완료
스타일 제거 및 메뉴 구조 업데이트 2026-02-06. 코드 품질 개선 작업. 기능은 그대로 유지하면서 구조를 다듬었음. 리팩토링 동기 기능이 계속 추가되면서 뷰 템플릿 영역의 코드가 비대해지기 시작했음. 하나의 함수가 너무 많은 일을 하거나, 같은 로직이 여러 파일에 흩어져 있거나, 네이밍이 실제 역할을 반영 못 하는 케이스들이 쌓였음. 무
읽기 → -
Controller 세 개 삭제로 기술 부채 해소하고 유지보수성 향상
주요 Controller 세 개 삭제로 불필요 코드 정리 2026-02-05. 내부 구조 정리 작업. 기능은 안 바뀌지만 앞으로의 유지보수를 위한 투자임. 정리 대상 코드 리뷰나 기능 추가 작업을 하다 보면 '이 부분 나중에 꼭 정리해야지'라고 생각하는 곳들이 쌓임. 이번에 그 기술 부채를 정리했음. - 비즈니스 로직: 역할이 불명확한 부분 분리
읽기 → -
이커머스 결제 연동 문서와 개발 환경 설정 한곳에 정비
신규 문서 추가 (아이콘, RBAC, Redis, 이커머스 결제 연동 플랫폼) 2026-02-05 기록. 개발 환경 설정이나 인프라 관련 작업. 배경 코드 품질 못지않게 개발 환경과 인프라가 안정적이어야 실제 개발 속도가 나옴. 툴링이 제대로 안 됐으면 작은 작업도 시간이 걸리고, 배포 스크립트 하나 잘못돼 있으면 릴리즈마다 스트레스를 받게 됨.
읽기 → -
브랜드 리브랜딩과 기술 부채 해소로 코드 구조 개선
PANDA INTER로 브랜드 리브랜딩 및 시스템 전반 수정 2026-02-04. 내부 구조 정리 작업. 기능은 안 바뀌지만 앞으로의 유지보수를 위한 투자임. 정리 대상 코드 리뷰나 기능 추가 작업을 하다 보면 '이 부분 나중에 꼭 정리해야지'라고 생각하는 곳들이 쌓임. 이번에 그 기술 부채를 정리했음. - 컨트롤러: 역할이 불명확한 부분 분리
읽기 → -
결제 연동 코드 리팩토링으로 중복 제거
결제대행사페이 notiUrl 제거 및 API V1.5 명세 반영 2026-02-03. 코드 품질 개선 작업. 기능은 그대로 유지하면서 구조를 다듬었음. 리팩토링 동기 기능이 계속 추가되면서 컨트롤러, 유틸리티, 서비스 레이어 영역의 코드가 비대해지기 시작했음. 하나의 함수가 너무 많은 일을 하거나, 같은 로직이 여러 파일에 흩어져 있거나, 네이밍이
읽기 → -
기술 부채 청산으로 코드 가독성과 유지보수성 개선
아이콘 변경 및 충전 알림 URL 추가 2026-02-02. 내부 구조 정리 작업. 기능은 안 바뀌지만 앞으로의 유지보수를 위한 투자임. 정리 대상 코드 리뷰나 기능 추가 작업을 하다 보면 '이 부분 나중에 꼭 정리해야지'라고 생각하는 곳들이 쌓임. 이번에 그 기술 부채를 정리했음. - 컨트롤러: 역할이 불명확한 부분 분리 - 서비스 레이어: 중
읽기 → -
컨트롤러·유틸리티 리팩토링으로 기술 부채 해소
JSP 파일 삭제 및 관련 페이지 제거 2026-02-02에 진행한 코드베이스 정리. 당장 눈에 띄는 효과는 없지만 장기적으로 개발 속도를 유지시켜 주는 핵심 작업임. 리팩토링 원칙 이번 작업에서 적용한 원칙들: 1. **단일 책임**: 하나의 함수/클래스는 하나의 일만 2. **DRY**: 중복 코드는 반드시 추출 3. **명확한 이름**: 이
읽기 → -
프론트엔드 기술 부채 정리로 코드 가독성과 유지보수성 향상
불필요한 SCSS 파일 _newbmc.scss 제거 2026-02-02. 내부 구조 정리 작업. 기능은 안 바뀌지만 앞으로의 유지보수를 위한 투자임. 정리 대상 코드 리뷰나 기능 추가 작업을 하다 보면 '이 부분 나중에 꼭 정리해야지'라고 생각하는 곳들이 쌓임. 이번에 그 기술 부채를 정리했음. - 뷰 템플릿: 역할이 불명확한 부분 분리 - 스타
읽기 → -
마이페이지 API 문서화로 엔드포인트 누락·불일치 수정
API 레거시 URL 리다이렉트 및 마이페이지 문서 추가 2026-02-02. API 문서 작업. 코드가 아무리 잘 짜여 있어도 문서가 없으면 다른 사람이, 또는 미래의 내가 쓰기 어려움. 문서화 범위 - **API 엔드포인트**: 경로, HTTP 메서드, 요청/응답 스펙 - **파라미터 명세**: 필수/선택 여부, 타입, 유효성 규칙 - **오류
읽기 → -
출금 요청 코드 기술 부채 정리로 유지보수성 개선
출금 요청 관련 변수명 및 쿼리 정리 2026-02-01. 내부 구조 정리 작업. 기능은 안 바뀌지만 앞으로의 유지보수를 위한 투자임. 정리 대상 코드 리뷰나 기능 추가 작업을 하다 보면 '이 부분 나중에 꼭 정리해야지'라고 생각하는 곳들이 쌓임. 이번에 그 기술 부채를 정리했음. - 컨트롤러: 역할이 불명확한 부분 분리 - SQL 쿼리: 중복
읽기 → -
출금 관리 코드 구조 개선으로 수정 포인트 명확해짐
출금 관리 로직 및 UI 개선 2026-02-01. 코드 품질 개선 작업. 기능은 그대로 유지하면서 구조를 다듬었음. 리팩토링 동기 기능이 계속 추가되면서 컨트롤러, SQL 쿼리, 뷰 템플릿 영역의 코드가 비대해지기 시작했음. 하나의 함수가 너무 많은 일을 하거나, 같은 로직이 여러 파일에 흩어져 있거나, 네이밍이 실제 역할을 반영 못 하는 케이스
읽기 → -
컨트롤러 중복 코드를 공통 유틸로 통합해 수정 비용 절감
CommonUtil로 중복 유틸 메서드 통합 2026-02-01에 진행한 코드베이스 정리. 당장 눈에 띄는 효과는 없지만 장기적으로 개발 속도를 유지시켜 주는 핵심 작업임. 리팩토링 원칙 이번 작업에서 적용한 원칙들: 1. **단일 책임**: 하나의 함수/클래스는 하나의 일만 2. **DRY**: 중복 코드는 반드시 추출 3. **명확한 이름**
읽기 → -
뷰 템플릿 리팩토링으로 중복 제거하고 수정 속도 개선
아이콘 클래스 이름 일괄 변경 2026-01-31. 코드 품질 개선 작업. 기능은 그대로 유지하면서 구조를 다듬었음. 리팩토링 동기 기능이 계속 추가되면서 뷰 템플릿 영역의 코드가 비대해지기 시작했음. 하나의 함수가 너무 많은 일을 하거나, 같은 로직이 여러 파일에 흩어져 있거나, 네이밍이 실제 역할을 반영 못 하는 케이스들이 쌓였음. 무엇을
읽기 →