■ 1. 문제점

• 1.1 수기 관리의 비효율성
운송 관리가 전화, 문서, 엑셀 기반으로 이루어져 실시간 정보 공유가 어렵고, 수작업으로 인한 데이터 입력 오류와 시간 낭비가 빈번하게 발생합니다.

• 1.2 실시간 가시성 부족
운송 중인 차량의 현재 위치와 상태를 파악하기 어려워, 화주 문의 시 즉각적인 응답이 불가능하고 예상치 못한 지연 발생 시 대응이 늦어집니다.

• 1.3 운송 이력 관리 어려움
과거 운송 데이터가 체계적으로 보관되지 않아 통계 분석이 어렵고, 감사 및 분쟁 발생 시 증빙 자료 확보가 어렵습니다.

• 1.4 권한 관리 부재
운송사 내 역할별 접근 제어가 없어 보안 문제와 업무 효율성 저하가 발생하며, 데이터 변경 이력 추적이 불가능합니다.

---

■ 2. 프로젝트 목표

• 2.1 비즈니스 목표
- 업무 효율성 향상: 운송 등록 및 관리 시간 50% 단축
- 실시간 가시성 확보: 언제든 드라이버 위치 및 운송 상태 파악 가능
- 데이터 기반 의사결정: 운송 이력 데이터 축적 및 통계 분석 기반 마련
- 서비스 신뢰도 향상: 화주에게 실시간 운송 현황 제공으로 신뢰도 제고

• 2.2 기술적 목표
- 직관적 UI/UX: React 기반 반응형 인터페이스 구현
- 안정적 백엔드: Spring/Java 기반 확장 가능한 시스템 구축
- 원활한 외부 연동: 드라이버 위치 API 및 지도 API 통합
- 고성능 처리: 100대 이상 차량 실시간 위치 데이터 처리
- 장기 데이터 관리: 5년간 데이터 보관 및 빠른 조회 지원

• 2.3 사용자 경험 목표
- 접근성: 3클릭 이내 모든 주요 기능 접근
- 부드러운 UX: 지도 UI 실시간 업데이트 시 끊김 없는 경험
- 빠른 학습 곡선: 2시간 이내 시스템 사용법 습득

---

■ 3. 주안점

• 3.1 실시간 성능 보장
다수의 드라이버 위치 정보가 동시에 업데이트되더라도 지도 UI의 지연이나 끊김이 발생하지 않도록 성능 최적화에 주력합니다.

• 3.2 외부 서비스 안정적 연동
클라이언트 제공 드라이버 위치 API와의 안정적인 연동을 보장하고, API 장애 시에도 다른 기능은 정상 동작하도록 설계합니다.

• 3.3 보안 및 규정 준수
역할 기반 접근 제어, 데이터 암호화, 감사 로그 5년 보관 등 엔터프라이즈급 보안 요구사항을 충족합니다.

• 3.4 확장 가능한 설계
향후 멀티 테넌시, API 외부 제공, 추가 기능 개발 등을 고려한 모듈화된 아키텍처를 구축합니다.

■ 1. 포트폴리오 소개

실시간 화물 운송 관제 웹 플랫폼 - 물류/운송 산업을 위한 통합 관리 시스템으로, 운송사 직원 및 관리자를 주요 타깃으로 하는 엔터프라이즈 솔루션 개발
본 플랫폼은 운송사가 화물 운송 요청을 효율적으로 관리하고, 자사 소속 드라이버의 위치를 실시간으로 추적하며, 전체 운송 과정을 디지털화하여 업무 효율성을 극대화하는 것을 목표로 합니다.

---

■ 2. 작업 범위

• 개발 참여 범위

- 상세 기획 (요구사항 정의, 기능 명세, 화면 설계)
- UI/UX 디자인 (기능 중심의 직관적 인터페이스)
- 프론트엔드 개발 (React + TypeScript)
- 백엔드 개발 (Spring Boot + Java)
- 서버/DB/인프라 구축 (PostgreSQL/MySQL, Redis)
- 외부 API 연동 (드라이버 위치 API, 지도 API)
- 관리자 페이지 개발 (시스템 관리자, 운송사 관리자)

• 지원 환경

- PC Web: 반응형 웹 (1920x1080, 1366x768 등 다양한 해상도 대응)
- 브라우저: Chrome, Firefox, Safari, Edge 최신 버전 지원
- 지도 UI: Google Maps, Naver Maps, 또는 Kakao Maps API 연동

---

■ 3. 주요 업무

• 3.1 핵심 기능

- 운송 신청 및 등록: 출발지, 도착지, 운송 일정, 화물 정보, 차량 정보 등록
- 운송 현황 관리: 운송 상태(운송 예약, 운송 중, 운송 완료) 실시간 모니터링 및 업데이트
- 실시간 위치 관제: 외부 API 연동을 통한 드라이버 실시간 위치 추적 및 지도 시각화
- 드라이버 배정 시스템: 운송 건별 드라이버 수동 배정 및 관리
- 역할 기반 접근 제어: 시스템 관리자, 운송사 관리자, 운송사 일반 직원 권한 분리
- 감사 로그 시스템: 모든 사용자 작업 이력 추적 및 5년간 보관

• 3.2 주요 페이지

- 로그인/인증 페이지: 이메일 기반 인증, 비밀번호 재설정
- 대시보드: 운송 현황 통계, 차트 시각화 (Recharts)
- 운송 관리 페이지: 목록 조회, 필터링, 정렬, 검색, 엑셀 다운로드
- 운송 등록/수정 페이지: 주소 검색 기능 포함 폼
- 실시간 위치 관제 페이지: 지도 UI, 차량 위치 핀, 이동 경로 표시, 알림 시스템
- 시스템 관리자 페이지: 운송사 계정 관리, 통합 모니터링 대시보드
- 운송사 관리자 페이지: 직원 계정 관리, 감사 로그 조회, 운송 통계

• 3.3 기술적 구현

- 프론트엔드: React 18+, React Router, Context API, Tailwind CSS, React Leaflet
- 백엔드: Spring Boot 2.7+, Java 11+, Spring Security, JWT 인증
- 데이터베이스: PostgreSQL/MySQL (주), Redis (캐싱 및 세션)
- 외부 연동: 드라이버 위치 API, 지도 API, Geocoding API
- 성능 최적화: 코드 스플리팅, 지도 렌더링 최적화, API 응답 압축

---

■ 4. 주안점

• 4.1 실시간 성능 및 안정성

- 고성능 위치 추적: 100대 이상의 차량 위치를 동시에 실시간 처리하고 지도에 표시하며, UI 지연이나 끊김 없이 부드러운 사용자 경험 제공
- 시스템 안정성: 99.9% 가용성 목표 (연간 8.7시간 이하 다운타임)
- 외부 API 장애 대응: 드라이버 위치 API 장애 시에도 운송 관리 기능은 정상 동작하도록 격리

• 4.2 보안 및 데이터 관리

- 역할 기반 접근 제어 (RBAC): 3단계 역할(시스템 관리자, 운송사 관리자, 일반 직원)에 따른 세밀한 권한 관리
- 데이터 암호화: 비밀번호 BCrypt 해싱, 중요 정보 AES 암호화
- 감사 로그: 모든 사용자 작업 추적 및 5년간 보관으로 규정 준수
- Soft Delete: 중요 데이터 삭제 시 논리적 삭제 처리 및 복구 기능

• 4.3 직관적이고 효율적인 UX

- 3클릭 규칙: 모든 주요 기능에 3번 이내 클릭으로 접근 가능
- 기능 중심 디자인: 화려함보다 정보 전달과 업무 효율성 우선
- 데이터 시각화: 통계 및 현황 데이터를 차트(막대, 원형, 선형)로 시각화
- 반응형 디자인: 다양한 해상도에서 최적화된 레이아웃

• 4.4 확장 가능한 아키텍처

- 모듈화 설계: 향후 마이크로서비스 전환 가능한 레이어드 아키텍처
- 데이터베이스 최적화: 인덱스 전략, 파티셔닝 (5년치 데이터 보관)
- 캐싱 전략: Redis를 활용한 자주 조회되는 데이터 캐싱