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 (새 기능) | 12 | 21.1% |
| fix (버그 수정) | 8 | 14.0% |
| refactor (리팩토링) | 9 | 15.8% |
| test (테스트) | 3 | 5.3% |
| chore (기타) | 25 | 43.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개 커밋
기술 부채 및 개선 영역
해결한 기술 부채
- 결제 이력 미흡: credit_card_histories 테이블 추가로 완전한 감사 로그 확보
- 초진/재진 혼재: 컬럼 분리로 데이터 정합성 개선
- 기상 API 불안정: 예외처리 및 재시도 로직으로 안정성 확보
- 환자 검색 성능: Limit 및 우선 정렬로 응답 속도 개선
남은 개선 사항
- 테스트 커버리지: 전체 57개 커밋 중 테스트 코드는 3개 (5.3%)로 추가 작성 필요
- API 문서화: 일부 API만 문서화되어 전체 API 문서 정비 필요
- 국제화: 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개 커밋)
회고
잘한 점
- 높은 완료율: Jira 이슈 92.6% 완료로 효율적인 업무 진행
- 안정성 강화: 15개 버그 수정으로 제품 품질 향상
- 성능 최적화: 처방전 합성 및 메모리 최적화로 시스템 안정성 확보
- 새 기능 개발: 건강 시트 환경 요인 기능 성공적 배포
배운 점
- 데코레이터 패턴: API 로깅에 효과적으로 적용하여 추적성 확보
- 점진적 리팩토링: 대규모 리팩토링도 작은 단위로 나누어 안전하게 진행 가능
개선할 점
- 테스트 코드 작성 비율 향상 필요 (현재 5.3%)
- API 문서화 습관화
- 우선순위 체계의 더욱 효과적인 활용