Haid
Haid logo
상용화주식회사 힐빙케어

Haid

2025-03-01 - 2025-05-31

프로젝트 소개

이동에 어려움을 겪는 교통약자들을 위해 설계된 맞춤형 이동 지원 서비스입니다. 휠체어 사용자, 노약자, 장애인 등 혼자 이동이 불편한 분들이 병원, 마트, 공항 등 다양한 목적지로 편리하고 안전하게 이동할 수 있도록 돕습니다.

"장애인분들 대상으로 휠체어 그대로 탑승이 가능한 택시 호출 서비스를 제공하는 어플리케이션입니다."

갤러리

Haid screenshot 1
Haid screenshot 2
Haid screenshot 3
Haid screenshot 4
Haid screenshot 5
Haid screenshot 6
Haid screenshot 7
Haid screenshot 8

구현 목록

인증 및 사용자 관리

  • JWT 및 OAuth 기반 인증 체계 구축 및 보안 토큰 관리 로직 구현
  • PortOne 연동을 활용한 휴대폰 본인인증 프로세스 도입
  • 사용자 프로필 관리 및 실사용자(탑승객), 보호자 관계 매핑 기능 개발
  • 결제용 신용카드 등록 관리 및 사용자 포인트 적립/차감 내역 시스템 구축

기사 및 휴가/근무 이력 관리

  • 기사 프로필 관리 및 누적 근무 이력, 앱 내 차단 이력(블랙리스트) 관리 시스템 구축
  • 기사 휴가(연차, 반차 등) 상세 신청, 승인 프로세스 및 휴가 기록 데이터베이스화 로직 구현

차량 정보 및 운행 일지 시스템

  • 차량 기본 정보 및 부가 옵션 매핑, 차량 통계 누적 관리 체계 구축
  • 차량 운행 일지 생성, 관리 및 S3 연동을 통한 운행 관련 증빙 이미지 업로드 기능 개발

택시 예약 및 배차 시스템

  • 택시 호출, 예약 정보 처리 및 이동 경로 데이터 보관 메커니즘 구현
  • 결제 대기 등 임시 예약 상태 관리 로직 구축
  • 배차 및 운행 상황별 기사 대상 알림톡(메시지) 발송 트리거링 기능 개발

결제 모듈 및 정산(영수증) 연동

  • 서비스 상품 정보 관리 및 PortOne API 기반 결제(빌링키) 프로세스 통합
  • 상세 결제 누적 이력 조회 및 처리 상태 관리 기능 구현
  • 결제 내역에 대한 현금영수증 및 세금계산서 발급 처리 로직 개발

메시징 및 푸시 알림 인프라

  • Firebase Cloud Messaging(FCM) 연동을 통한 푸시 알림 통합 구축
  • 비즈니스 및 상황별 메시지 템플릿 관리 자동화 기능 개발
  • 관리자, 탑승자(사용자), 기사 간의 인앱 메시지 송수신 시스템 구축

고객 지원 및 피드백(게시판) 관리

  • 앱 내 공지사항 및 커뮤니티 조성을 위한 게시판, 댓글 관리 시스템 구현
  • 운행 종료 후 승객 평점 및 기사 상호 피드백 수집 로직 개발
  • 기업(B2B) 비즈니스 문의 및 고객센터 고객 상담 히스토리 누적 관리 시스템 구축

B2B 기업 연동 및 앱 코어 설정 관리

  • 제휴 고객사(B2B) 및 소속 고객(임직원) 계정 관리 기능 개발
  • 외부 파트너사 API 연동 처리
  • 모바일 앱 버전 관리(강제/권고 업데이트), 약관 동의 내역 및 디스플레이 배너 설정 기능 구현

트러블 슈팅

공공데이터 API 응답 불일치 해결을 통한 예약 시스템 결제 로직 안정화

예약 시 주말과 공휴일의 경우 추가요금이 부과된 상태로 결제가 진행되어야합니다.

그렇기에 주말 여부와 공휴일 여부를 체크하는 과정이 필요합니다.

주말의 경우 예약일자의 요일을 서버 내에서 확인하여 주말 여부를 체크할 수 있었는데 공휴일 여부는 예약일자의 년월을 추출하여 공공데이터포털의 한국천문연구원 특일 정보 API를 사용하여 예약일자 년월을 기준으로 어떤 공휴일들이 있는지 리스트를 반환받을 수 있었습니다.

여기서 발생된 문제는 '리스트'를 반환하는 API이기 떄문에 반환모델이 반환 값이 항상 배열일 것으로 생각했는데 일관되지 않은 반환 모델로 인한 이슈가 발생했습니다.

조회 시 공휴일이 없는 경우에는 빈배열을 예상했으나 '' 빈 문자열이 반환되었고 간헐적으로 null이 반환되는 경우가 발생했습니다.

항상 배열이 반환될 것으로 생각한 저의 입장에서는 자료형태의 검증이 불필요하다고 생각했기때문에 검증과정을 생략 후 반환 속성에 배열메소드를 작성했는데 이때 배열이 아니기 떄문에 오류가 발생했습니다.

이 문제를 해결하기 위해 자료형태에 대한 검증을 포함시켰고 너무 일관적인 반환값임을 예측하기보다도 이 후에는 조금 더 경우의 수를 고려하여 최소한의 반환된 자료에 대한 형태 검증은 생략하지 않도록 설계할 것 같습니다.

개발 지표

기여도
0%
완성도
0%

담당 역할

Backend Development

DB 설계모듈 구현API 설계API 문서화인증/인가서버 로깅

Infra Engineering

도메인 DNS 관리배포 자동화로그 수집CDN서버 프로비저닝컨테어너화

함께한 팀원

Haid | iamlog