일기
회고 / 메모
-
JSP 관리자 테이블 모바일 레이아웃과 colspan 자동화 개선
feat: JSP 테이블 colspan 값 동적 처리 및 레이아웃 정리 JSP UI 작업은 레거시 환경에서 어떻게 사용성을 올릴 수 있는지 계속 고민하게 만듦. 테이블 레이아웃 개선 모바일에서 가로 스크롤 없이 보이게 하는 게 과제였음. 카드형 뷰로 폴백 처리함. jsp <%-- PC: 테이블 형태 --%> <div class="admin-tab
읽기 → -
아키텍처·API 레퍼런스 문서 체계 정비
docs: 문서 업데이트 및 개선 (Redis, 아키텍처, 스킬 정의) 문서화 작업은 귀찮지만 나중을 위해 꼭 필요함. 특히 외부 API 연동 부분은 레퍼런스 없으면 매번 명세서 다시 뒤져야 함. 문서 구조 .claude/docs/ ├── api-reference.md 외부 API 엔드포인트 정리 ├── architecture.md
읽기 → -
이커머스 PG 플랫폼 디자인 토큰 통일
feat: 이커머스 PG 플랫폼 사용자 페이지 전반 UI 개선 및 CSS/SCSS 정리 CSS/SCSS 작업은 눈에 잘 안 보이지만 쌓이면 시스템 전체 일관성에 영향 줌. 이번엔 디자인 토큰 통일과 반응형 최적화가 메인이었음. CSS 변수 통일 작업 컴포넌트마다 4px, 6px, 8px, 12px이 혼재해있었음. 디자인 시스템 기준을 잡고 CSS
읽기 → -
OMC 심볼릭 링크 스킬을 깃이그노어로 관리하도록 정리
chore: OMC 심볼릭 링크 스킬 gitignore 처리 이번 작업의 핵심은 기존 기능 안정화와 코드 일관성 확보였음. 변경 범위가 여러 레이어에 걸쳐있어서 영향 범위를 꼼꼼히 체크했음. 변경 영역 | 레이어 | 파일 수 | 주요 변경 | |--------|--------|---------| | 백엔드 로직 | 0개 | 핵심 처리 로직 개선 |
읽기 → -
모바일 대응 관리자 테이블을 카드형으로 개선
메뉴 정리 및 툴팁 기능 등 수정 JSP UI 작업은 레거시 환경에서 어떻게 사용성을 올릴 수 있는지 계속 고민하게 만듦. 테이블 레이아웃 개선 모바일에서 가로 스크롤 없이 보이게 하는 게 과제였음. 카드형 뷰로 폴백 처리함. jsp <%-- PC: 테이블 형태 --%> <div class="admin-table-wrapper d-none d-m
읽기 → -
레거시 JSP 관리자 화면 모바일 대응
feat: 불필요 메세지 정리 JSP UI 작업은 레거시 환경에서 어떻게 사용성을 올릴 수 있는지 계속 고민하게 만듦. 테이블 레이아웃 개선 모바일에서 가로 스크롤 없이 보이게 하는 게 과제였음. 카드형 뷰로 폴백 처리함. jsp <%-- PC: 테이블 형태 --%> <div class="admin-table-wrapper d-none d-md-
읽기 → -
SQL 쿼리 정리로 코드 일관성과 가독성 개선
feat: 불필요 메세지 정리 이번 작업의 핵심은 기존 기능 안정화와 코드 일관성 확보였음. 변경 범위가 여러 레이어에 걸쳐있어서 영향 범위를 꼼꼼히 체크했음. 변경 영역 | 레이어 | 파일 수 | 주요 변경 | |--------|--------|---------| | 백엔드 로직 | 0개 | 핵심 처리 로직 개선 | | 화면 (JSP) | 0개
읽기 → -
Apple OAuth 콜백 오류와 세션 유실 문제 해결
refactor: OAuth 연동 회원 조회 로직 변경 및 UI 개선 Apple OAuth가 구글/카카오랑 달리 까다로운 이유가 있음. form_post 방식을 강제하기 때문에 콜백이 POST로 들어오고, 이 과정에서 세션이 끊기거나 CORS 문제가 발생함. Apple OAuth 특이사항 - 콜백이 GET이 아닌 POST (form_post) -
읽기 → -
하위 파트너 수수료 정산 코드
refactor: 하위 파트너 수수료 관리 코드 및 UI 제거 정산 및 수수료 로직은 버그 하나가 금전 오류로 직결되는 영역이라 신중하게 접근해야 함. 수수료 계산 구조 유통 단계별로 수수료가 누적되는 구조임. 최하위 파트너가 가장 높은 요율을 부담하고, 상위로 갈수록 낮아지며 그 차액이 각 단계의 수익임. | 단계 | 요율 | 수익 | |---
읽기 → -
수수료 단계별 정산 로직과 멱등성 처리 구현
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. 내부 구조 정리 작업. 기능은 안 바뀌지만 앞으로의 유지보수를 위한 투자임. 정리 대상 코드 리뷰나 기능 추가 작업을 하다 보면 '이 부분 나중에 꼭 정리해야지'라고 생각하는 곳들이 쌓임. 이번에 그 기술 부채를 정리했음. - 컨트롤러: 역할이 불명확한 부분 분리
읽기 →