인천공항 이용객 동선 분석 프로젝트

1. 제작기간 & 참여 인원

2024.09.08 ~ 2024.12.01

백엔드 2인, 프론트 1인, AI 1인으로 구성된 팀 프로젝트입니다.

저는 JWT 활용한 로그인 기능, 댓글 CRUD, 경로 추천/비추천, 도로 혼잡도 반환 API 개발 및 인프라 구성을 담당하였습니다.

2. 사용 기술

• JAVA 21
• Spring Boot
• Spring Data JPA
• PostgreSQL
• JWT
• Spring Security

3. API 명세서

프론트엔드와 원활한 소통을 위해 사용자 관련 api 명세서를 작성하였습니다.

• 노션 링크 : https://carnation-pedestrian-278.notion.site/13ff4dcd5263804a84f6cb8aafc4a22a?v=140f4dcd52638055935a000cb2d131d6&pvs=74

4. ERD

5. 시스템 구성도

6. 트러블 슈팅

6-1. 도로혼잡도 API 성능 최적화

• 도로 혼잡도 API를 개발하면서, 초기 설계에서는 수도권 전체 도로 데이터를 클라이언트에 반환하도록 구현했습니다.

  • 문제상황:

    • 데이터량 과다로 인해 클라이언트에서 지도에 혼잡도를 시각화하는 속도가 매우 느려졌습니다.

    • 또한 서버 응답 시간이 지연되는 현상이 발생하였습니다.

  • 해결 방안:

    • API를 각 도시별, 도로등급별로 세분화하여 클라이언트가 줌 레벨에 따라 필요한 도시별, 도로 등급만 요청하도록 설계하였습니다.

    • 줌 레벨이 낮을 때는 고속국도와 고속도로 등 주요 도로만 반환.

    • 줌 레벨이 높을 때는 해당 도시 내의 도로 데이터를 반환.

개선된 코드

• 기존 컨트롤러

    // 혼잡도 전부 조회
    @GetMapping("/traffic/all")
    public ResponseEntity<List<Map<String, Object>>> getAllTraffic(
            @RequestParam String date,
            @RequestParam String hour) {
        return ResponseEntity.ok(gcsService.getAllTraffic(date, hour));
    }

- 수정된 컨트롤러

    //도시별 혼잡도 조회
    @GetMapping("/traffic/{num}/all/{rank}")
    public ResponseEntity<List<Map<String, Object>>> getCityTraffic(
            @RequestParam String date,
            @RequestParam String hour,
            @PathVariable Integer num,
            @PathVariable Integer rank) {
        List<Map<String, Object>> cityTraffic = gcsService.getCityTraffic(date, hour, num, rank);
        return (ResponseEntity.ok(cityTraffic));
    }

• 해당 api를 수정한 결과 응답속도가 50% 이상 개선되는 효과가 있었습니다.

7. 시연 영상