ahngbeom

ahngbeom

My Journey as a Developer

GitHub
Back to list

2025년 4월 월간 회고록

2025-04-30 · Retrospective > 2025 > monthly

회고모비닥월간회고

2025년 4월 월간 회고록

기간: 2025-04-01 ~ 2025-04-30 담당자: bahn


개요

4월 한 달간 모비닥 프로젝트에서 수행한 작업을 정리한 종합 회고록입니다.

항목수량
Jira 이슈27개 (완료 25개, 92.6%)
Git 커밋68개 (Backend 40, Frontend 17, mobidoc-pdf 1, DB Migration 8, DB 스키마 2)
코드 변경+8,825 / -3,195 라인
작업 일수20일

Jira 이슈 현황

이슈 유형별 분류

유형수량비율
버그15개55.6%
개선9개33.3%
새 기능1개3.7%
작업2개7.4%

우선순위별 분류

우선순위수량비율
최상1개3.7%
높음1개3.7%
중간24개88.9%
최하1개3.7%

완료된 주요 작업

이슈유형우선순위설명
이슈 #1버그중간[환자] 진료신청서 - 주민등록번호 입력이 필요한 초진 환자 처리 개선
이슈 #2새 기능최상[환자] 건강 시트 환경 요인 기능 서버 API 작업
이슈 #4개선중간[통합][환자] 재진 판단 기준 개선
이슈 #5버그중간[통합] 가예약 도착 확인 모달에서 버튼 연타 방지
이슈 #6버그중간[환자] 초진문진표 스크롤 버그 수정
이슈 #7개선중간[환자] 비회원 웹 접수 - 신규환자 등록 뒤로가기 버튼 개선
이슈 #8개선높음[통합] 처방전 합성 성능 개선
이슈 #9버그중간[환자] 통합 클라이언트의 진료 접수 변동 QR 정상 작동 수정
이슈 #10작업중간[DB작업] Room 테이블 인덱스 추가, 진료 구분 테이블 추가
이슈 #11개선중간[통합] 처방전 합성 모듈 - 메모리 힙 최적화

미완료 이슈 (2개)

이슈유형우선순위설명
이슈 #3개선중간[환자] 재 본인인증 시, 기존 로그인 정보와 불일치 예외 케이스 검토
이슈 #25버그중간[통합] 가예약 모달 접수버튼 로딩 후 추가 클릭 가능 이슈

Git 커밋 현황

커밋 유형별 분류

유형수량비율
feat (새 기능)1221.1%
fix (버그 수정)814.0%
refactor (리팩토링)915.8%
test (테스트)35.3%
chore (기타)2543.9%

Backend (mobidoc-server) - 40개 커밋

기상 정보 API 연동 및 개선 (10개 커밋)

  • 공공데이터포탈 기상청 API 연동으로 실시간 기상/대기오염 정보 조회 구현
  • weather-module 예외처리 개선 (재시도 로직, 타임아웃 처리)
  • 미세먼지 농도 필드 추가 및 데이터 정합성 개선
  • PROD 환경 대기오염 API 단계별 활성화

결제 모듈 개선 (5개 커밋)

  • payment-module에 API 로깅 로직 데코레이터 패턴 적용
  • api_histories 테이블에 updated_at, version 컬럼 추가
  • 결제 카드 삭제 시 credit_card_histories 이력 추가
  • PaymentAdapter @Transactional 적용으로 데이터 일관성 확보

환자 관리 기능 (9개 커밋)

  • WEB 진료 신청서 도착 확인 API 수정
  • 진료 받을 환자 리스트 AutoCheck 조건 추가
  • 의사 시간표 조회 API 구현
  • 초진/재진 구분 컬럼 분리 및 관리
  • 기존 환자로 대체하여 가예약 생성 로직 구현

통합 기능 (6개 커밋)

  • 환자 차트번호 검색 우선 정렬 및 Limit 50 설정
  • 병원 운영시간 조회 API 문서화
  • 신규 가입 API APM Context 추가

Frontend (mobidoc-front) - 17개 커밋

환자 앱 개선 (9개 커밋)

  • WEB 진료 신청서 가예약 도착 확인 프로세스 수정
  • 비회원 진료 신청서 도착 확인 완료 페이지 개편
  • 기상 정보 미세먼지 데이터 예외처리
  • 홈 화면 현재 기온 스켈레톤 UI 적용
  • 진료신청서 초진문진표 스크롤 버그 수정
  • WEB QR 접수 신규 환자 등록 뒤로가기 버튼 오류 수정

통합 기능 (4개 커밋)

  • 기존 환자 대체 가예약 생성 로직 구현
  • 가예약 도착 확인 모달 loading 애니메이션 적용
  • 진료 받을 환자 카드 인터렉션 메소드 리팩토링

관리자 기능 (2개 커밋)

  • 병원 검색 필터 지역 표기 개선
  • 진료 예약 조회 예약 취소 버그 수정

mobidoc-pdf (mobidoc-file) - 1개 커밋

성능 프로파일링 도구 추가:

  • [mobidoc-pdf] /debug/pprof - Go pprof 디버그 엔드포인트 추가
    • 3월에 구축한 PDF 합성 서비스의 런타임 성능 프로파일링 기능 추가
    • 메모리 사용량, CPU 프로파일, goroutine 분석 가능

mobidoc-migration(DB 마이그레이션) (8개 커밋)

레포지토리:

  • mobidoc-migration: 8개

주요 작업:

  • [MPT-7657] Korea Cast 기상 정보 테이블 (04-03)
  • Slack notification 설정 (04-03)
  • MR Template 수정 (04-04)
  • [MPT-7471] hospital_patient visit 컬럼 추가 (04-10)
  • payment.api_histories 컬럼, 환자 커플링, 진료 뷰 업데이트 (04-29 x4)

mobidoc-database(DB 스키마) (2개 커밋)

날짜커밋 메시지
04-17[release-20250417] MOBIDOC DATABASE SCHEMA UPDATE
04-29[release-20250429] MOBIDOC DATABASE SCHEMA UPDATE

주요 성과

1. 기상 정보 서비스 안정화

공공데이터포탈 API 연동으로 실시간 기상/미세먼지 정보를 제공하는 weather-module을 구현했습니다. 초기 통합 과정에서 발생한 네트워크 타임아웃, null 응답 등 예외 상황을 단계적으로 개선하여 안정적인 서비스를 구축했습니다.

2. 결제 모듈 추적성 강화

API 호출 이력을 데코레이터 패턴으로 로깅하고, 카드 삭제 이력을 별도 테이블에 기록하여 결제 관련 모든 작업의 추적성을 확보했습니다. 트랜잭션 관리를 통해 데이터 일관성도 강화했습니다.

3. 초진/재진 데이터 정합성 개선

기존 단일 컬럼으로 관리되던 초진/재진 정보를 분리하여 데이터 정합성을 높였습니다. 35개 파일에 걸친 대규모 리팩토링을 진행하며 관련 테스트 코드도 함께 수정했습니다.

4. 처방전 합성 성능 최적화

처방전 합성 모듈의 성능 개선과 메모리 힙 최적화 작업을 완료하여 시스템 안정성을 향상시켰습니다. 또한 mobidoc-pdf 서비스에 pprof 디버그 엔드포인트를 추가하여 런타임 성능 프로파일링을 가능하게 했습니다.

5. 환자 경험 개선

진료 신청서 도착 확인 프로세스를 개편하고, 다양한 UI 버그를 수정하여 환자 앱의 사용성을 향상시켰습니다. 스켈레톤 UI와 로딩 애니메이션을 추가하여 체감 성능도 개선했습니다.


활동 패턴

요일별 커밋 통계

  • 월요일: 9개 (15.8%)
  • 화요일: 7개 (12.3%)
  • 수요일: 14개 (24.6%)
  • 목요일: 16개 (28.1%) - 최다 커밋
  • 금요일: 4개 (7.0%)
  • 토요일: 0개 (0%)
  • 일요일: 1개 (1.8%)

작업 패턴 분석

  • 주중(월~금) 중심 개발: 50개 (87.7%)
  • 중순(9~11일) 집중 개발: 10개 커밋
  • 하순(21~24일) 안정화: 11개 커밋

기술 부채 및 개선 영역

해결한 기술 부채

  1. 결제 이력 미흡: credit_card_histories 테이블 추가로 완전한 감사 로그 확보
  2. 초진/재진 혼재: 컬럼 분리로 데이터 정합성 개선
  3. 기상 API 불안정: 예외처리 및 재시도 로직으로 안정성 확보
  4. 환자 검색 성능: Limit 및 우선 정렬로 응답 속도 개선

남은 개선 사항

  1. 테스트 커버리지: 전체 57개 커밋 중 테스트 코드는 3개 (5.3%)로 추가 작성 필요
  2. API 문서화: 일부 API만 문서화되어 전체 API 문서 정비 필요
  3. 국제화: validation message 번역 완료했으나 UI 메시지 번역은 추가 작업 필요

다음 달 계획

진행 예정

  • 미완료 이슈 2개 처리 (이슈 #3, 이슈 #25)
  • 기상 정보 서비스 모니터링 및 추가 안정화
  • 결제 모듈 테스트 커버리지 확대
  • API 문서화 완성도 향상

모니터링 필요

  • 버그 수정 내용 통합 테스트 진행
  • 처방전 합성 성능 개선 후 운영 환경 안정성 확인

통계 요약

생산성 지표

  • Jira 완료율: 92.6% (25/27개)
  • 일평균 커밋: 3.3개 (20일 작업일 기준)
  • 코드 기여도: +8,825/-3,195 라인 (순증 5,630 라인)
  • 평균 파일 변경: 6.9개/커밋

작업 영역 분포

  • Backend: 60.6% (40개 커밋)
  • Frontend: 25.8% (17개 커밋)
  • mobidoc-pdf: 1.5% (1개 커밋)
  • mobidoc-migration(DB): 12.1% (8개 커밋)

주요 기여 모듈

  • weather-module: 기상 정보 연동 (10개 커밋)
  • patient-api: 환자 관리 (9개 커밋)
  • payment-module: 결제 관리 (5개 커밋)
  • integrated: 통합 기능 (6개 커밋)

회고

잘한 점

  1. 높은 완료율: Jira 이슈 92.6% 완료로 효율적인 업무 진행
  2. 안정성 강화: 15개 버그 수정으로 제품 품질 향상
  3. 성능 최적화: 처방전 합성 및 메모리 최적화로 시스템 안정성 확보
  4. 새 기능 개발: 건강 시트 환경 요인 기능 성공적 배포

배운 점

  1. 데코레이터 패턴: API 로깅에 효과적으로 적용하여 추적성 확보
  2. 점진적 리팩토링: 대규모 리팩토링도 작은 단위로 나누어 안전하게 진행 가능

개선할 점

  1. 테스트 코드 작성 비율 향상 필요 (현재 5.3%)
  2. API 문서화 습관화
  3. 우선순위 체계의 더욱 효과적인 활용