♿ FlatWay (플랫웨이) - 보행 약자 맞춤형 도로 단차 안내 및 대시보드 시스템
휠체어 및 이동 약자를 위해 길 위의 단차와 노면 파손 정보를 센서로 자동 수집하고, 맞춤형 안전 우회 경로를 실시간으로 제공하는 스마트 내비게이션 솔루션입니다.
🗺️ 프로젝트 개요 (Overview)
기존의 상용 네비게이션 서비스는 차량 또는 일반 보행자 위주로 설계되어 있어, 2cm 이상의 미세한 보도 턱(단차), 보도블록 파손, 급경사 구간 등 휠체어 사용자에게 치명적인 보행 장애물 정보를 제공하지 못합니다.
FlatWay는 모바일 앱(Flutter)의 고주파 센서 수집 기술과 웹 대시보드(Next.js)의 시각화 및 경로 우회 알고리즘을 Supabase 실시간 DB로 연결하여, 이동 약자가 목적지까지 끊김 없이 안전하게 이동할 수 있는 '도어 투 도어(Door-to-Door)' 무장애 길 안내 환경을 구축합니다.
🚀 주요 기능 (Key Features)
📱 1. FlatWay 모바일 앱 (Flutter)
- 센서 기반 자동 노면 스캔: 스마트폰 내장 가속도계 센서를 활용해 100Hz 주파수로 주행 진동을 감지하고, 단차 발생 구간의 충격 피크(Peak)를 검출하여 위경도 좌표와 함께 서버로 자동 업로드합니다.
- 실시간 도로 장애 제보: 보도 턱, 노면 파손, 불법 적치물 등 위험 요소를 발견했을 때 터치 몇 번으로 손쉽게 현장 정보를 입력해 제보할 수 있습니다.
- 이동 수단 모드별 맞춤 경로: 일반 보행, 전동 휠체어, 수동 휠체어 등 사용 기기 특징에 최적화된 경로선 및 음성 안내를 매핑하여 제공합니다.
💻 2. FlatWay 대시보드 웹 (Next.js)
- 실시간 위험 요소 시각화: Supabase DB와 연동하여 수집된 도로 단차 및 건물 편의 시설 데이터를 지도 상에 다양한 마커(핀)로 실시간 렌더링합니다.
- 개인별 맞춤 이동 한계 설정 (Custom Thresholds): 사용자가 직접 허용 가능한 단차(cm)와 최대 경사도(°)를 설정하면, 경로 상의 위험 정보를 탐색하여 기준 초과 시 안전한 우회 경로로 자동 재탐색을 실행합니다.
- 도어 투 도어 실내외 통합 안내: 건물 입구의 경사로 유무뿐만 아니라, 건물 내부의 승강기(엘리베이터) 위치까지 이어지는 실내 경로(점선)를 한 화면에서 확인할 수 있습니다.
🛡️ 3. 데이터 신뢰성 & 어뷰징 검증 (Trust & Verification)
- 센서-제보 교차 검증: 특정 사용자가 수동 제보한 위치의 반경 20m 이내를 지나간 다른 사용자의 자동 센서 충격 데이터를 매칭하여 허위 제보를 판별합니다.
- 신뢰 점수(Trust Score) 제어: 신뢰 점수가 50% 미만인 제보는 지도 상에 반투명한 노란색 핀(검증 대기)으로 표기되며 경로 안내 연산에서 제외되고, 기준 충족 시 정식 핀으로 활성화됩니다.
🏗️ 시스템 아키텍처 (Architecture)
┌────────────────────────┐ ┌────────────────────────┐
│ FlatWay Mobile │ │ FlatWay Dashboard │
│ (Flutter App) │ │ (Next.js Web App) │
└───────────┬────────────┘ └───────────┬────────────┘
│ │
│ (Realtime Read/Write) │ (Realtime Read/Write)
▼ ▼
┌──────────────────────────────────────────────┐
│ Supabase Database │
│ - hazards table (단차/파손/경사 정보) │
│ - buildings table (건물 편의시설 정보) │
└──────────────────────────────────────────────┘
📂 프로젝트 구조 (Directory Structure)
flatway/
├── agent.md # AI 에이전트 공통 행동 규칙 가이드
├── README.md # 프로젝트 통합 소개 및 시작 문서
├── docs/ # 프로젝트 기획 및 화면 설계 워크시트 (PDF)
│
├── dashboard/ # Next.js 대시보드 웹 애플리케이션
│ ├── docs/ # 대시보드 스키마, 완료 가이드, 인수인계 문서
│ │ ├── supabase_schema.sql # Supabase 테이블 및 초기 데이터 시드 SQL
│ │ └── 단차수집_인수인계_가이드.md # 센서 계산 공식 및 수집 매핑 상세 문서
│ ├── src/
│ │ ├── app/ # Next.js App Router (Layout, Style, Page)
│ │ ├── components/ # Leaflet 지도, 제보 모달 등 컴포넌트
│ │ └── data/ # 로컬 모크 데이터 (mockData.js)
│ └── package.json
│
└── flatway_app/ # Flutter 모바일 수집 및 안내 애플리케이션
├── lib/
│ ├── screens/ # 지도 화면 및 안내 뷰
│ ├── services/ # GPS 위치 및 Supabase 연동 서비스
│ └── widgets/ # 단차 수동 제보 등록 모달
└── pubspec.yaml
🛠️ 시작 가이드 (Getting Started)
1. 전제 조건 (Prerequisites)
2. 웹 대시보드 실행 방법
# dashboard 폴더로 이동
cd dashboard
# 의존성 패키지 설치
npm install
# 로컬 개발 서버 실행
npm run dev
# -> http://localhost:3000 에서 접속 및 테스트 가능
3. 모바일 수집 앱 실행 방법
# flatway_app 폴더로 이동
cd flatway_app
# 의존성 패키지 설치
flutter pub get
# 시뮬레이터 또는 실기기에서 실행
flutter run
👥 팀원 소개 (Team '사고뭉치')
우리는 작전여자고등학교 2학년 인공지능탐구부 동아리 소속의 '사고뭉치' 팀입니다. 프로젝트의 코딩 작업은 팀원 전원이 협동하여 함께 진행하고 있습니다.
📝 라이선스 및 협업 지침
- 본 프로젝트는 사고뭉치 팀에 의해 무장애 보행 환경 개선을 목표로 개발되고 있습니다.
- 개발 과정에서의 AI 에이전트 연동 및 코딩 가이드는 루트 폴더의 agent.md 파일 규칙을 엄격히 준수합니다.
