🚑 findER - Refactoring 🚑

2023년 제17회 공개 SW 개발자대회

실시간 응급실 병상 확인 모바일 앱, findER(Emergency Room)

written by wingunkh & gretea5

🖼️ Frontend

📑 목차

• ✍🏻 프로젝트 개요
• ⭐ 주요 기능
• 📚 기술 스택
• 🔗 API 문서
• 🗺️ 시스템 구조도
• 👩‍👩‍👧‍👦 팀원 및 담당 파트
• 🛠️ 리팩터링 히스토리

✍🏻 프로젝트 개요

• 응급실 병상이 없어서 환자가 떠돌다가 숨지는 ‘응급실 뺑뺑이’ 현상에 대한 뉴스를 접하며, 평소 병상 현황을 쉽게 확인할 수 없는 점이 불편하다고 느꼈습니다.
• 이를 해결하기 위해 사용자가 실시간 잔여 병상 수와 다양한 응급실 정보를 확인할 수 있는 모바일 앱을 개발하였습니다.

📰 '응급실 뺑뺑이' 잇단 사망‥왜 반복되나 (MBC 뉴스)

⭐ 주요 기능

응급실 위치 확인 기능

Kakao Map API 지도에서 응급실 위치를 확인할 수 있습니다.
또한, Kakao Local API를 활용한 검색 기능을 제공합니다.

응급실 프리뷰 기능

국립중앙의료원 API를 활용해 실시간 응급실 잔여 병상 수를 제공합니다. (1분 간격 갱신)
또한, Kakao Mobility API를 활용해 이동 거리와 예상 이동 소요 시간을 제공합니다.

응급실 상세보기 기능

구급차, CT, MRI 가용 여부와 진료 과목 등 프리뷰에서 제공하지 않는 응급실 정보를 추가적으로 제공합니다.

길찾기 기능

응급실 상세보기에서 버튼을 클릭해 Kakao Map 길찾기 기능을 사용할 수 있습니다.

문진표 CRUD 기능

응급 상황에 유용하게 사용될 수 있도록 문진표 관련 기능을 제공합니다.

사용자 간 문진표 공유 기능

다른 사용자의 시리얼 번호를 통해 공유 관계를 설정하고, 문진표를 공유할 수 있습니다.

📚 기술 스택

Language
Framework
API
Server
Database
Tool
etc.

🔗 API 문서

🔗Notion

🗺️ 시스템 구조도

👩‍👩‍👧‍👦 팀원 및 담당 파트

Front-End	Back-End
박장훈	김현근
Android Mobile Application 개발 (Kotlin)	Spring API Server 개발 (Java)

🛠️ 리팩터링 히스토리

리팩터링은 2023년 9월 기준
제가 담당한 기능 (문진표 CRUD, 문진표 공유, 응급실 실시간 잔여 병상 수 갱신, AWS EC2 및 데이터베이스 구축 등)을 포함하여
다른 팀원이 담당한 기능 (로그인, 응급실 정보 저장, Kakao Mobility API 활용 등)을 모두 포함합니다.

1. 로그인 방식 변경 (2024-02-22)

자세히 보기

- 전 : Spring Security
- 후 : SHA-256 + Salt
- 이유 : 실제 서비스 여부가 결정되지 않았으로, 우선 로그인 방식을 간단한 방법으로 유지하기 위함

2. 비즈니스 로직 위치 변경 (2024-03-15)

자세히 보기

- 전 : 비즈니스 로직이 Repository 계층에 네이티브 쿼리로서 존재
- 후 : Spring Data JPA Query Method를 활용하여 네이티브 쿼리 제거, 비즈니스 로직을 Service 계층으로 이동
- 개선 : Spring Web Application 계층 책임을 더욱 명확하게 분리

3. 문진표 공유 로직 변경 (2024-03-15)

자세히 보기

- 전 : 제한 시간 내 두 사용자가 서로에게 공유 요청 전송
- 후 : 사용자에게 고유한 시리얼 번호 부여, 이를 바탕으로 공유 요청 전송
- 개선 : 클라이언트 요청 횟수 감소

4. 응급실 정보 저장 로직 변경 (2024-03-29)

자세히 보기

- 전 : 응급의료기관 정보 조회 API를 호출 후 응급실 정보만 별도 추출
- 후 : 응급실 실시간 잔여 병상 수 조회 API를 통해 응급실 식별자 추출, 이를 바탕으로 응급실에 대해서만 응급의료기관 정보 조회 API 호출
- 개선 : 속도 향상 (전 약 200,000ms → 후 약 65,000ms)

5. 응급실 병상 수 변동 추이 그래프 제거 (2024-04-17)

자세히 보기

- 전 : 실시간 잔여 병상 수 DB에 400 (응급실 = 약 400개) * 1440 (하루 = 1440분) = 약 600,000개의 엔티티 유지
- 후 : 실시간 잔여 병상 수 DB에 400개의 엔티티 유지 (더 이상 1분 간격으로 엔티티가 누적되지 않고 갱신됨)
- 이유 : 사용자 관점에서 유의미한 정보가 아니라고 판단
- 개선 : 유지해야 하는 엔티티의 수 대폭 감소

6. 외부 API 활용 클래스 추상화 (2024-05-05)

자세히 보기

- 전 : 국립중앙의료원 API 활용 클래스와 Kakao Mobility API 활용 클래스가 독립적
- 후 : 추상 클래스로 일반화, 각 클래스가 추상 클래스의 메서드를 오버라이드
- 개선 : 코드 중복 제거, 유지보수성 향상

7. 응급실 도메인에 진료과목 추가 (2024-05-06)

자세히 보기

- 예 : 가정의학과, 구강내과, 내과 ...
- 개선 : 사용자 관점에서 유의미한 정보라고 판단

8. 응급실 위치 정보 응답 로직 변경 (2024-05-20)

자세히 보기

- 전 : 사용자가 Kakao Map을 드래그할 때마다 범위 내 모든 응급실에 대한 위치 정보 응답
- 후 : Kakao Map 화면 이동 시 (or 사용자 로그인 시) 모든 응급실에 대한 위치 정보 응답, 프론트엔드 측에서 ShraedPreference를 통해 유지
- 개선 : 클라이언트 요청 횟수 감소

9. Spring Boot 버전 업데이트 (2024-05-24)

자세히 보기

- 전 : SpringBootVersion = 2.7.1
- 후 : SpringBootVersion = 3.0.0

10. ResponseEntity 결정 계층 변경 (2024-05-29)

자세히 보기

- 전 : Service 계층
- 후 : Controller 계층
- 이유 : Service 계층은 비즈니스 로직을 처리하고, Controller 계층이 웹 관련 요청에 대한 응답을 처리하도록 하기 위해
- 개선 : Spring Web Application 계층 책임을 더욱 명확하게 분리

11. HTTP Status Code 개선 (2024-05-29)

자세히 보기

- 전 : 200 (OK), 404 (Not Found)만 사용
- 후 : 201 (Created), 204 (No Content), 409 (Conflict) 등 추가

12. 예외 처리 로직 수정 (2024-06-09)

자세히 보기

- 전 : Checked Exception
- 후 : Unchecked Exception
- 개선 : 가독성 향상, 유지보수성 향상

13. @RestControllerAdvice 사용 전역 예외 처리 구현 (2024-06-19)

자세히 보기

- 전 : 각 클래스에서 예외 처리
- 후 : @RestControllerAdvice 클래스에서 전역적으로 예외 처리
- 개선 : 가독성 향상, 유지보수성 향상

14. @Aspect 사용 로깅에 AOP 적용 (2024-07-10)

자세히 보기

- 전 : 각 클래스에서 로깅
- 후 : @Aspect 클래스를 통해 공통 관심 사항 (로깅) 분리
- 개선 : 가독성 향상, 유지보수성 향상