길벗

프로젝트 소개

문제 정의 -> 기존 한계 -> 길벗 목표

주요 기능

🚧 장애물 탐지 및 회피 방향 안내

스마트폰 카메라 영상 기반 보행 위험 장애물 실시간 탐지
YOLOv11s로 사람, 차량, 자전거, 킥보드 등 객체 인식
YOLOv8-SEG로 보행 가능 영역 분석
장애물 위치·거리·위험도 기반 회피 방향 안내

🗺️ 길찾기

현재 위치와 목적지 기반 보행 경로 안내
TMAP 보행자 경로 API 활용
이동 거리, 소요 시간, 회전 지점 정보 제공
횡단보도 및 음향신호기 존재 여부 안내

🔊 음성 및 햅틱 안내

음성(TTS)과 진동(햅틱) 기반 안내
위험 상황, 방향 안내, 길찾기 정보 전달
화면 확인 없이 정보 인지 가능
음성 속도·안내 문구 길이 등 사용자 맞춤 설정

♿ 접근성 중심 UI

시각장애인 사용성을 고려한 모바일 UI
큰 버튼 중심의 직관적인 구조
최소 조작으로 주요 기능 접근
누구나 쉽게 사용할 수 있는 인터페이스 설계

소개 영상

시스템 아키텍처

Frontend

Backend

AI / ML

External API

Data

Collaboration

사용법

시작 화면 / 홈 화면

카카오 로그인 후 장애물 탐지, 길찾기, 설정 기능에 접근합니다.

장애물 탐지 화면

탐지 시작 버튼을 누르면 카메라가 실시간으로 장애물을 감지하고 진동으로 알려줍니다.

길찾기 화면

목적지를 키보드 또는 음성으로 입력하고 안내를 시작합니다.

저장된 장소 관리

자주 가는 장소를 저장하고, 카테고리 아이콘으로 구분하여 빠르게 선택합니다.

길찾기 중 / 설정 화면

남은 거리·소요 시간·위험 요소를 안내하고, 안내 문구 길이와 진동 강도를 조절합니다.

설정 / 계정 화면

알림·소리 설정, 앱 정보 확인, 로그아웃 및 회원 탈퇴를 할 수 있습니다.

폴더 구조

capstone-2026-16/
    ├── .github/                      # GitHub 관련 설정
    │   └── workflows/                # GitHub Actions CI/CD 워크플로우 파일
    │
    ├── frontend/                     # Flutter 기반 모바일 애플리케이션
    │   ├── android/                  # Android 플랫폼 설정 및 빌드 파일
    │   ├── ios/                      # iOS 플랫폼 설정 및 빌드 파일
    │   ├── assets/                   # 앱에서 사용하는 이미지, 아이콘, 리소스
    │   ├── lib/                      # Flutter 주요 소스 코드
    │   │   ├── screens/              # 화면 단위 UI
    │   │   ├── widgets/              # 재사용 가능한 UI 컴포넌트
    │   │   ├── services/             # API, 위치, 카메라, TTS 등 서비스 로직
    │   │   └── models/               # 요청/응답 및 상태 데이터 모델
    │   ├── pubspec.yaml              # Flutter 의존성 및 에셋 설정
    │   └── pubspec.lock              # Flutter 패키지 잠금 파일
    │
    ├── server/                       # Spring Boot 기반 백엔드 서버
    │   ├── src/                      # 백엔드 애플리케이션 소스 코드
    │   │   ├── main/java/            # Java 21 기반 서버 코드
    │   │   │   ├── domain/           # auth, user, place, navigation, crosswalk 등 도메인 로직
    │   │   │   └── global/           # 공통 설정, 예외 처리, 보안, 응답 구조
    │   │   └── main/resources/       # application.yml 등 설정 파일
    │   ├── gradle/                   # Gradle Wrapper 관련 파일
    │   ├── build.gradle              # 서버 의존성 및 빌드 설정
    │   ├── settings.gradle           # Gradle 프로젝트 설정
    │   ├── gradlew                   # Linux/macOS용 Gradle 실행 스크립트
    │   ├── gradlew.bat               # Windows용 Gradle 실행 스크립트
    │   └── Dockerfile                # 백엔드 서버 Docker 이미지 빌드 파일
    │
    ├── ai/                           # FastAPI 기반 AI 분석 서버
    │   ├── app/                      # AI 서버 애플리케이션 소스 코드
    │   │   ├── api/                  # 이미지 분석 및 안내 이벤트 API
    │   │   ├── services/             # 객체 탐지, 추적, 거리 추정, 안내 생성 로직
    │   │   └── utils/                # 전처리, 후처리, 공통 유틸리티
    │   ├── models/                   # YOLO, YOLO-SEG, Depth 모델 파일
    │   └── requirements.txt          # Python 패키지 의존성 목록
    │
    ├── docs/                         # GitHub Pages 프로젝트 소개 사이트
    │   ├── _pages/                   # 시스템 구조, AI, API, Demo, Team 등 상세 페이지
    │   ├── _layouts/                 # Minimal Mistakes 레이아웃 파일
    │   ├── _includes/                # 재사용 가능한 섹션 컴포넌트
    │   ├── _sass/                    # 커스텀 및 테마 SCSS 스타일
    │   ├── _data/                    # 내비게이션 등 Jekyll 데이터 파일
    │   ├── assets/                   # 문서 사이트 이미지, CSS, JS 리소스
    │   ├── _config.yml               # Jekyll 사이트 설정 파일
    │   └── index.md                  # GitHub Pages 메인 페이지
    │
    ├── .gitignore                    # Git에서 제외할 파일 및 폴더 패턴
    └── README.md                     # 프로젝트 최상위 README 파일