개요
2025년 6월 월간 회고록입니다. 이번 달은 총 11개의 커밋을 통해 테스트 코드 개선, 소규모 버그 수정, api-doctor OOM 장애 대응 및 다양한 유지보수 작업을 진행했습니다.
완료한 작업
테스트 개선
| 날짜 | 제목 | 레포지토리 | 설명 |
|---|---|---|---|
| 2025-06-27 | integration tag 추가 & build.gradle 설정 | 백엔드 (2개 커밋) | 통합 테스트 분리 및 빌드 최적화 |
상세 내용
통합 테스트 분리 (2025-06-27)
- 통합 테스트에
@Tag("integration")추가 - build.gradle에
excludeTags 'integration'설정 - 단위 테스트와 통합 테스트 분리로 빌드 시간 단축
- CI/CD 파이프라인 효율성 향상
효과:
- 일반 빌드 시 통합 테스트 제외로 빌드 속도 개선
- 필요 시에만 통합 테스트 실행 가능
- 개발 생산성 향상
버그 수정 및 개선
| 날짜 | 이슈 | 제목 | 레포지토리 | 설명 |
|---|---|---|---|---|
| 2025-06-04 | 이슈 #1 | 유튜브 채널 및 비디오 조회 쿼리 수정 | 백엔드, 프론트엔드 | 관리자 유튜브 조회 기능 개선 |
| 2025-06-24 | 이슈 #2 | 주소 등록 데이터 수정 | 프론트엔드 | 환자 앱 주소 등록 버그 수정 |
| 2025-06-25 | - | 결제선생 예외 레벨 조정 | 백엔드 | Slack 알림 제거 (노이즈 감소) |
| 2025-06-26 | - | eslint 세미콜론 규칙 추가 | 프론트엔드 | 코드 스타일 일관성 개선 |
상세 내용
유튜브 채널 및 비디오 조회 쿼리 수정 (이슈 #1)
- 관리자 화면에서 유튜브 콘텐츠 조회 시 쿼리 오류 수정
- 백엔드 및 프론트엔드 양쪽 수정으로 완전한 버그 해결
주소 등록 데이터 수정 (이슈 #2)
- 환자 앱에서 주소 등록 시 데이터 처리 오류 수정
- 사용자 경험 개선
결제선생 예외 레벨 조정
- 결제 시스템 예외 로그 레벨 조정
- 불필요한 Slack 알림 제거로 알림 노이즈 감소
- 운영팀 알림 피로도 개선
eslint 세미콜론 규칙 추가
semi: ['warn', 'always']옵션 추가- 코드 스타일 일관성 확보
- 코드 리뷰 시 불필요한 논의 감소
주요 성과 및 인사이트
1. 테스트 전략 개선
배경: 통합 테스트가 일반 빌드에 포함되어 빌드 시간이 길어지는 문제 발생
해결:
- JUnit 5의
@Tag기능을 활용한 테스트 분류 - Gradle 빌드 설정에서 통합 테스트 제외
- 빌드 시간 단축 및 개발 생산성 향상
학습 포인트:
- 테스트 전략의 중요성
- 단위 테스트와 통합 테스트의 명확한 분리 필요
- CI/CD 파이프라인 최적화를 통한 개발자 경험 개선
2. 알림 노이즈 관리
개선 사항:
- 결제 시스템 예외의 Slack 알림 레벨 조정
- 불필요한 알림 제거로 중요한 알림에 집중 가능
- 운영팀 알림 피로도 개선
중요성:
- 알림이 많으면 중요한 알림을 놓칠 수 있음
- 예외 레벨 설정의 중요성
- 모니터링 시스템의 신뢰도 향상
3. 코드 품질 유지
코딩 컨벤션 개선:
- eslint 규칙 강화로 코드 스타일 일관성 확보
- 세미콜론 규칙 추가로 JavaScript/TypeScript 코드 품질 향상
- 코드 리뷰 시 스타일 관련 논의 시간 절약
Git 커밋 통계
전체 요약
| 항목 | 수량 |
|---|---|
| 총 커밋 수 | 11개 (백엔드 4개 + 프론트엔드 3개 + helm 2개 + DB Migration 1개 + DB 스키마 1개) |
| 작업 레포지토리 | 2개 |
| 변경된 파일 | 31개 (백엔드 26개 + 프론트엔드 5개) |
| 추가된 라인 | +299 |
| 삭제된 라인 | -128 |
| 순증 | +171 라인 |
레포지토리별 커밋 통계
백엔드 (mobidoc-server) - 4개 커밋
| 지표 | 값 |
|---|---|
| 커밋 수 | 4개 |
| 변경 파일 | 26개 |
| 추가 라인 | +282 |
| 삭제 라인 | -116 |
| 순증 | +166 라인 |
주요 커밋 내역:
[TEST CODE]통합 테스트 분리 (6월 27일) - 2개 커밋- api-patient, api-doctor 모듈의 통합 테스트 태그 추가
- build.gradle 설정으로 일반 빌드 시 통합 테스트 제외
[통합, 환자]결제선생 예외 레벨 조정 (6월 25일)- Slack 알림 제거로 운영 노이즈 감소
[이슈 #1]유튜브 채널 및 비디오 조회 쿼리 수정 (6월 4일)
프론트엔드 (mobidoc-front) - 3개 커밋
| 지표 | 값 |
|---|---|
| 커밋 수 | 3개 |
| 변경 파일 | 5개 |
| 추가 라인 | +17 |
| 삭제 라인 | -12 |
| 순증 | +5 라인 |
주요 커밋 내역:
[전체]eslint 세미콜론 규칙 추가 (6월 26일)- 코드 스타일 일관성 개선
[이슈 #2]주소 등록 데이터 수정 (6월 24일)- 환자 앱 주소 입력 버그 수정
[이슈 #1]유튜브 조회 쿼리 수정 (6월 4일)
mobidoc-helm(인프라) - 2개 커밋
api-doctor OOM(Out Of Memory) 장애 대응으로 Kubernetes 리소스를 조정했습니다.
- [deploy/v2-api-doctor-oom] api.resources.requests.cpu: 300m 증가 (6월 23일)
- [deploy/v2-api-doctor-oom] api.resources.limits.memory: 800m 증가 (6월 23일)
mobidoc-migration(DB 마이그레이션) - 1개 커밋
- release-20250529 (06-10)
mobidoc-database(DB 스키마) - 1개 커밋
| 날짜 | 커밋 메시지 |
|---|---|
| 06-19 | [release-20250619] MOBIDOC DATABASE SCHEMA UPDATE |
커밋 유형별 분류
| 유형 | 수량 | 비율 | 주요 내용 |
|---|---|---|---|
| test | 2개 | 22.2% | 통합 테스트 분리 및 빌드 최적화 |
| fix | 3개 | 33.3% | 유튜브 조회, 주소 등록, 예외 레벨 조정 |
| infra | 2개 | 22.2% | api-doctor OOM 대응 CPU/Memory 리소스 조정 |
| style | 1개 | 11.1% | eslint 규칙 추가 |
| chore | 1개 | 11.1% | 설정 변경 |
일별 커밋 활동 분포
2025-06-04 (화): ████████ 2개 (백엔드 1개 + 프론트 1개)
2025-06-24 (월): ████ 1개 (프론트 1개)
2025-06-25 (화): ████ 1개 (백엔드 1개)
2025-06-26 (수): ████ 1개 (프론트 1개)
2025-06-27 (목): ████████ 2개 (백엔드 2개)
활동 패턴 분석:
- 월 초 1회 (6월 4일)
- 월 말 집중 (6월 24-27일) - 5개 커밋
- 주중 고르게 분산된 활동
- 대규모 기능 개발보다는 유지보수 중심의 달
주요 변경 파일
백엔드
- 통합 테스트 파일들 (다수) -
@Tag("integration")추가 build.gradle(api-patient, api-doctor) - 테스트 제외 설정- 유튜브 조회 관련 쿼리 파일
- 결제 예외 처리 파일
프론트엔드
.eslintrc.js- 세미콜론 규칙 추가- 주소 등록 컴포넌트
- 유튜브 조회 관련 파일
회고
6월의 특징
6월은 총 11개 커밋(코드 7개 + helm 2개 + DB Migration 1개 + DB 스키마 1개)으로 개발 활동이 적었던 달입니다. 이는 다음과 같은 이유로 추정됩니다:
- 휴가 또는 다른 업무 집중: 개발 외 업무나 개인 일정
- 대규모 기획/설계 기간: 다음 분기 준비 및 기획
- 코드 리뷰 및 지원 업무: 다른 팀원 코드 리뷰나 협업
좋았던 점
- 테스트 전략 개선: 통합 테스트 분리로 빌드 효율성 향상
- 코드 품질 유지: 적은 커밋 수에도 불구하고 코드 품질 개선 작업 진행
- 알림 관리: 운영 효율성을 고려한 알림 레벨 조정
- 작고 명확한 커밋: 각 커밋이 명확한 목적을 가지고 있음
개선할 점
- 활동 기록 부족: 실제 업무 대비 커밋 활동 기록이 적음
- 문서화 부재: 6월에는 문서화 커밋이 없음
- 기능 개발 부족: 신규 기능 개발이나 대규모 개선 작업 없음
학습
- 테스트 분류의 중요성: 단위 테스트와 통합 테스트를 명확히 분리하여 빌드 시간 최적화
- 알림 피로도 관리: 과도한 알림은 오히려 중요한 알림을 놓치게 만듦
- 코딩 컨벤션의 가치: 자동화된 스타일 체크로 코드 리뷰 품질 향상
- 소규모 개선의 누적 효과: 작은 개선들이 모여 전체 개발 경험을 향상시킴
7월 계획
- 개발 활동 증가 및 신규 기능 개발 진행
- 문서화 작업 재개
- 기술 부채 정리 및 리팩토링
- 테스트 커버리지 개선
통계 요약
- 생산성 지표: 일평균 0.33개 커밋 (helm, DB Migration 포함)
- 코드 기여도: +299/-128 라인 (순증 171 라인, 코드 레포 기준)
- 주요 기여 영역: 테스트 개선 (22.2%), 버그 수정 (33.3%), 인프라 (22.2%)
- 활동 집중도: 월말 집중 (23-27일에 77.8% 커밋)
6월은 휴식과 재정비의 시간으로, 작지만 의미있는 개선 작업들을 통해 코드 품질과 개발 환경을 개선하고, api-doctor OOM 장애에 신속히 대응한 달이었습니다.