🛵 배달길 통합 메뉴얼 v1.1.4

최종 업데이트: 2026년 6월 6일
앱 버전: 1.1.4+16
지원 플랫폼: Android (iOS 준비 중)

목차

1. 앱 소개
2. 시작하기 — 계정 & 온보딩
   • 2-1. 온보딩 화면
   • 2-2. 회원가입
   • 2-3. 로그인
   • 2-4. 비밀번호 재설정
   • 2-5. 소셜 로그인 (구글 / 카카오)
3. 메인 화면 구조
4. 홈탭 — 지도 & 위치메모
   • 4-1. 지도 기본 조작
   • 4-2. 위성 / 일반 지도 전환
   • 4-3. 핀 메모 (위치 메모)
   • 4-4. 위치메모 불러오기
   • 4-5. 공지 마퀴 (스크롤 배너)
   • 4-6. AI 챗봇 (배달길 도우미)
5. 레이더탭 — 실시간 위치 공유
   • 5-1. 주변레이더
   • 5-2. 친구레이더
   • 5-3. 그룹 채팅
   • 5-4. 위치 공유 동의서
   • 5-5. 지도 유형 버튼 (위성 + 도로감추기)
6. 커뮤니티탭
   • 6-1. 카테고리
   • 6-2. 게시글 작성 / 수정 / 삭제
   • 6-3. 갤러리 게시판
   • 6-4. 검색
   • 6-5. 신고 / 차단
   • 6-6. 광고 정책
7. 결산탭 — 수입 & 지출 관리
   • 7-1. 월별 결산 개요
   • 7-2. 수입 입력
   • 7-3. 지출 입력
   • 7-4. 달력 뷰
   • 7-5. 통계 차트
   • 7-6. 목표 설정
   • 7-7. CSV 내보내기
8. 정비탭 — 차량 관리
   • 8-1. 차량 등록
   • 8-2. 소모품 교체 주기
   • 8-3. 정비 이력
   • 8-4. 주행거리 연동
9. 정보탭 — 내 정보
   • 9-1. 프로필 카드
   • 9-2. 위치 기록 통계
   • 9-3. 위치메모 통계
   • 9-4. 개인정보 처리방침 & 오픈소스 라이선스
10. 드로어 메뉴
    • 10-1. 프로필 사진 변경
    • 10-2. 친구 & 그룹 목록
    • 10-3. 설정
    • 10-4. 관리자 페이지
    • 10-5. 로그아웃
11. 설정 페이지
    • 11-1. 알림 소리
    • 11-2. 회원 탈퇴
12. 푸시 알림 (FCM)
13. 친구 시스템
    • 13-1. 친구 추가
    • 13-2. 친구 요청 수락 / 거절
    • 13-3. 즐겨찾기
    • 13-4. 친구 삭제
14. 그룹 채팅 상세
    • 14-1. 그룹 방 만들기
    • 14-2. 입장 방법 (일반 / 비밀번호 / 요청)
    • 14-3. 방장 기능
    • 14-4. 초대 & 강제퇴장
15. 관리자 페이지
    • 15-1. 앱 설정 탭
    • 15-2. 신고 탭
    • 15-3. 관리자 탭
    • 15-4. 유저 탭
    • 15-5. 푸시알림 탭
16. 자주 묻는 질문 (FAQ)
    • 16-1. 계정 관련
    • 16-2. 지도 & 위치 관련
    • 16-3. 레이더 관련
    • 16-4. 친구 & 그룹 관련
    • 16-5. 결산 & 정비 관련
    • 16-6. 커뮤니티 관련
    • 16-7. 알림 관련
    • 16-8. 오류 & 기술 문의
17. 개인정보 및 데이터 정책
18. 버전 히스토리

1. 앱 소개

배달길은 배달 라이더를 위한 올인원 실시간 위치 공유 & 커뮤니티 앱입니다.

핵심 기능 한눈에 보기

기술 스택

• 프레임워크: Flutter 3 (Dart)
• 백엔드: Supabase (PostgreSQL + Realtime + Storage)
• 인증: Supabase Auth (이메일 / 구글 / 카카오)
• 지도: 네이버 지도 SDK (flutter_naver_map)
• 위치: GeoFlutterfireplus + Geolocator (GeoHash 서버사이드 필터)
• 푸시: Firebase Cloud Messaging (FCM)
• 광고: Google AdMob
• AI: DIFY 챗봇 스트리밍 API

2. 시작하기 — 계정 & 온보딩

2-1. 온보딩 화면

앱을 처음 설치하면 5장의 온보딩 슬라이드가 나타납니다.

• 우측 상단 “건너뛰기” 버튼으로 즉시 로그인 화면으로 이동 가능합니다.
• 온보딩은 최초 1회만 표시됩니다. (SharedPreferences에 완료 여부 저장)

2-2. 회원가입

1. 로그인 화면 → “회원가입” 탭 선택
2. 이메일 주소 입력
3. 비밀번호 (8자 이상) 입력 및 확인
4. 닉네임 설정 (최대 20자, 중복 불가)
5. 가입하기 버튼 클릭
6. 가입한 이메일로 인증 메일 발송 → 링크 클릭 후 인증 완료
7. 인증 완료 후 로그인 가능

주의: 이메일 인증 전에는 일부 기능이 제한될 수 있습니다.

2-3. 로그인

1. 앱 실행 → 스플래시 화면 로딩 후 로그인 화면
2. 이메일 / 비밀번호 입력 후 로그인 버튼 클릭
3. 자동 로그인: 이전 로그인 세션이 유효하면 자동으로 메인 화면으로 진입

2-4. 비밀번호 재설정

1. 로그인 화면 → “비밀번호를 잊으셨나요?” 클릭
2. 가입 이메일 주소 입력
3. 재설정 메일 발송 클릭
4. 수신한 이메일의 링크를 클릭하여 새 비밀번호 설정

재설정 링크는 1시간 동안 유효합니다.

2-5. 소셜 로그인 (구글 / 카카오)

구글 로그인

1. 로그인 화면 → “구글로 계속하기” 버튼 클릭
2. 구글 계정 선택 또는 입력
3. 권한 허용 후 자동 닉네임 설정 팝업 확인

카카오 로그인

1. 로그인 화면 → “카카오로 계속하기” 버튼 클릭
2. 카카오 계정으로 로그인
3. 최초 1회 닉네임 설정 다이얼로그가 표시됩니다

소셜 로그인 최초 가입 시: 닉네임 설정 팝업이 나타납니다. 반드시 닉네임을 입력해야 앱을 사용할 수 있습니다.

3. 메인 화면 구조

로그인 후 메인 화면은 하단 탭바로 구성됩니다.

┌─────────────────────────────────────┐
│           상단 앱바 / 지도           │
│                                     │
│            [메인 콘텐츠]            │
│                                     │
├──────┬──────┬──────┬──────┬──────────┤
│ 🏠홈 │ 🗺레이더│ 👥커뮤 │ 💰결산 │ ℹ️정보 │
└──────┴──────┴──────┴──────┴──────────┘

좌측 상단 햄버거 버튼(≡): 드로어 메뉴 열기
상단 알림 벨 아이콘: 알림 목록 확인

4. 홈탭 — 지도 & 위치메모

4-1. 지도 기본 조작

홈탭은 네이버 지도를 기반으로 합니다.

지도 위 버튼 설명

4-2. 위성 / 일반 지도 전환

홈탭 상단에 지도 유형 버튼이 있습니다.

• 일반 지도: 기본 도로 지도
• 위성 지도: 위성 영상 + 도로 정보
• 위성 전용 (도로 감추기): 위성 영상만 표시 (도로 레이어 OFF)

사용 팁: 픽업 장소나 골목 진입로 확인 시 위성 지도가 유용합니다.
도로 감추기 모드는 지형지물을 보다 선명하게 확인하고 싶을 때 사용하세요.

4-3. 핀 메모 (위치 메모)

지도 특정 위치에 메모를 남기는 기능입니다. 단골 픽업존, 주차 금지 구역, 고객 건물 정보 등을 기록할 수 있습니다.

핀 메모 저장 방법

1. 홈탭 우측 하단 📌 핀메모 버튼 클릭
2. 화면 상단에 “지도를 클릭하여 위치를 선택하세요” 안내 배너 표시
3. 저장하고 싶은 지도 위 위치를 탭
4. 카카오 역지오코딩으로 자동 주소 변환 (카카오 API 활용)
5. 메모 내용 입력 다이얼로그 표시
6. 제목·내용 작성 후 저장 클릭

핀 메모 조회 / 수정 / 삭제

• 지도에 표시된 📌 핀 아이콘 클릭 → 상세 팝업
• 팝업 내 수정 / 삭제 버튼 제공

주의사항

• 위치메모는 주소 변환 시 사용량이 차감됩니다.
• 월별 사용량 한도는 정보탭 → 위치메모 통계에서 확인 가능합니다.
• 오프라인 상태에서는 메모 저장이 불가합니다.

4-4. 위치메모 불러오기

이전에 저장한 위치메모를 지도에 한 번에 표시합니다.

1. 홈탭 상단 “위치메모 불러오기” 버튼 클릭
2. 저장된 모든 위치메모가 지도에 핀으로 표시됨
3. 다시 클릭하면 핀 숨김

자주 묻는 질문: “불러오기 버튼이 안 보여요”
→ 홈탭 상단 작은 버튼들 중 아이콘 형태로 표시됩니다. 화면을 스크롤하거나 버튼 영역을 확인해 주세요.

4-5. 공지 마퀴 (스크롤 배너)

홈탭 하단에 공지사항이 흘러가는 배너(마퀴)가 표시됩니다.

• 관리자가 등록한 공지를 실시간으로 표시
• 스크롤 속도는 자동 조절
• 공지 배너를 탭하면 상세 내용 확인 가능 (향후 업데이트 예정)

4-6. AI 챗봇 (배달길 도우미)

홈탭 우측 하단의 🤖 챗봇 아이콘을 탭하면 AI 도우미가 실행됩니다.

특징

• DIFY 기반 스트리밍 AI (실시간 타이핑 효과)
• 에르메스 컬러 팔레트 적용 (브라운·오렌지 테마)
• 무료 200건/월 제공 (초과 시 제한될 수 있음)
• 대화 내역은 세션 단위로 유지

빠른 질문 버튼 (퀵 액션)

채팅창 하단에 아래 질문들을 원클릭으로 입력 가능합니다.

• 레이더 사용법이 궁금해요
• 그룹 채팅 만드는 방법은?
• 수입 입력하는 방법은?
• 위치 메모 사용법은?
• 정비 탭 사용법 알려주세요
• 회원 탈퇴 방법은?

음성 입력

• 마이크 아이콘 클릭 → 음성으로 질문 가능 (한국어)
• STT(Speech-to-Text) 엔진 활용

자주 묻는 질문: “챗봇이 응답하지 않아요”
→ 네트워크 연결을 확인하거나, 월 무료 한도(200건)를 초과했을 수 있습니다.

5. 레이더탭 — 실시간 위치 공유

레이더탭은 주변레이더와 친구레이더 두 가지 모드로 구성됩니다.

5-1. 주변레이더

반경 내 위치를 공유 중인 모든 사용자(익명 포함)를 지도에서 확인합니다.

시작하기

1. 레이더탭 → “🗺 주변레이더” 탭 선택
2. 위치 공유 토글 ON → 위치 동의서 확인 후 공유 시작
3. 지도에 파란 원(반경)과 주변 파트너 마커 표시

주요 UI

| 요소 | 설명 | |——|——| | 반경 슬라이더 | 레이더 탐지 반경 조절 (500m ~ 5km) | | 위치 공유 토글 | ON/OFF로 내 위치 공유 여부 결정 | | 파트너 마커 | 주변 라이더 아이콘 (이동수단 유형별 표시) | | 상태 메시지 | 각 파트너 상태 메시지 표시 | | 현재위치 버튼 | 내 위치로 지도 이동 |

주변레이더 채팅

• 주변레이더 하단 채팅 입력창으로 주변 파트너와 실시간 소통
• 반경 내 사용자 모두에게 메시지 전달

이동수단 설정

• 드로어 또는 레이더 설정에서 이동수단(오토바이/자전거/킥보드/도보) 선택 가능
• 선택한 이동수단 아이콘이 내 마커에 표시됨

5-2. 친구레이더

친구 목록에 등록된 사용자의 위치만 별도 지도에 표시합니다.

시작하기

1. 레이더탭 → “⭐ 친구레이더” 탭 선택
2. 위치 공유 토글 ON (친구 전용 공유, 주변레이더와 독립)
3. 친구 목록의 위치가 지도에 표시됨

주요 UI

| 요소 | 설명 | |——|——| | 친구 위치 마커 | 친구 닉네임 + 마커 색상 | | 위치 공유 토글 | 친구레이더 전용 공유 여부 | | 온라인 상태 | 친구 마커 색상으로 온라인/오프라인 구분 | | 그룹 버튼 | 그룹 목록 바로가기 | | 친구 버튼 | 친구 목록 / 초대 바로가기 |

주변레이더 vs 친구레이더 위치 공유 독립

두 레이더의 위치 공유는 완전히 독립적입니다.

• 주변레이더 ON + 친구레이더 OFF → 주변에는 표시되지만 친구에게는 안 보임
• 주변레이더 OFF + 친구레이더 ON → 친구에게만 표시됨
• 둘 다 ON → 양쪽 모두 표시

5-3. 그룹 채팅

친구레이더 하단의 그룹 채팅 버튼으로 접근합니다. (→ 14장 상세 참조)

5-4. 위치 공유 동의서

처음 위치 공유를 시도하면 위치 공유 동의서 팝업이 표시됩니다.

• 동의 내용을 확인하고 “동의” 클릭 후 공유 시작
• 동의 여부는 Supabase users 테이블의 location_consent_at 컬럼에 저장
• 한번 동의하면 이후에는 팝업이 다시 표시되지 않음

위치 공유 동의를 철회하고 싶다면: 설정 페이지 → 회원 탈퇴 또는 개발자에게 문의

5-5. 지도 유형 버튼 (위성 + 도로감추기)

레이더탭 상단 탭바 아래에 두 개의 토글 버튼이 있습니다.

도로 감추기 버튼은 위성 모드에서만 활성화됩니다.

6. 커뮤니티탭

동네 라이더끼리 정보와 이야기를 나누는 게시판입니다.

6-1. 카테고리

지역 필터: 상단 “전국” 버튼으로 지역 범위 선택 가능

6-2. 게시글 작성 / 수정 / 삭제

게시글 작성

1. 커뮤니티탭 → ✏️ 작성 버튼 (우측 하단 FAB)
2. 카테고리 선택
3. 제목 입력 (최대 50자)
4. 본문 입력
5. 이미지 첨부 (선택, 최대 5장)
6. 게시 버튼 클릭

게시글 수정

• 내 게시글 → 상세 화면 → “수정” 버튼 클릭
• 제목·본문·이미지 수정 후 저장

게시글 삭제

• 내 게시글 → 상세 화면 → “삭제” 버튼 클릭
• 확인 다이얼로그 후 삭제

관리자 권한: 관리자는 타인의 게시글도 삭제 가능

6-3. 갤러리 게시판

사진 중심의 그리드 뷰 게시판입니다.

• 2열 그리드 형태로 썸네일 표시
• 이미지 업로드 필수 (텍스트만 작성 불가)
• 갤러리 아이템 탭 → 상세 화면에서 전체 이미지 & 댓글 확인

6-4. 검색

커뮤니티 상단 🔍 검색 아이콘 클릭 후 키워드 입력.

• 게시글 제목·본문에서 실시간 검색
• 검색어 초기화: X 버튼 또는 뒤로 가기

6-5. 신고 / 차단

게시글 신고

1. 게시글 상세 → 우측 상단 “⋯” 버튼
2. 신고 선택 → 신고 사유 입력
3. 관리자에게 신고 접수 → 관리자 페이지에서 처리

댓글 신고

• 댓글 길게 누르기 → 신고 선택

신고된 게시글·댓글은 관리자 검토 후 삭제될 수 있습니다.

6-6. 광고 정책

커뮤니티에는 Google AdMob 광고가 삽입됩니다.

광고는 앱 운영 비용을 충당하기 위한 것으로, 사용자 경험을 최대한 해치지 않도록 최소화하였습니다.

7. 결산탭 — 수입 & 지출 관리

배달 수입과 지출을 플랫폼별·항목별로 기록·분석하는 가계부 기능입니다.

7-1. 월별 결산 개요

결산탭 상단에 선택된 연·월과 요약 카드가 표시됩니다.

• 당월 총 수입 / 총 지출 / 순이익 한눈에 확인
• 상단 화살표(< >)로 월 이동

탭 구성: | 탭 | 내용 | |—-|——| | 달력 | 날짜별 수입/지출 표시 | | 수입 | 수입 내역 리스트 | | 지출 | 지출 내역 리스트 | | 통계 | 차트 분석 |

7-2. 수입 입력

1. 결산탭 → 우측 하단 ”+ 수입” 버튼
2. 수입 입력 페이지에서 아래 정보 입력:

입력 방법

• 수동 입력: 직접 숫자 키패드 입력
• 음성 입력: 마이크 아이콘 클릭 후 음성으로 입력 (“기본급 삼만오천원”)
• OCR 인식: 카메라로 영수증·캡처 이미지 스캔 후 자동 인식

7-3. 지출 입력

1. 결산탭 → 우측 하단 ”- 지출” 버튼
2. 지출 입력 페이지에서 아래 정보 입력:

• 금액 입력 (계산기 기능 내장)
• 날짜 선택
• 메모 선택 입력
• 음성 입력 지원 (“유류비 오만원”)

7-4. 달력 뷰

• 달력 날짜를 탭하면 해당일 수입·지출 리스트 하단에 표시
• 수입이 있는 날: 초록 점 표시
• 지출이 있는 날: 빨간 점 표시
• 달력 월 이동 ↔ 상단 연·월 표시 양방향 동기화

7-5. 통계 차트

통계 탭에서 아래 차트를 확인할 수 있습니다:

통계 기간 선택: 주간 / 월간 탭 전환 가능

7-6. 목표 설정

• 결산탭 → “목표 설정” 버튼 (또는 요약 카드 내 목표 아이콘)
• 월 목표 수입 금액 입력
• 달성률 프로그레스 바 표시

7-7. CSV 내보내기

• 결산탭 → 우측 상단 공유 아이콘
• 해당 월의 수입·지출 내역을 CSV 파일로 내보냄
• 카카오톡·이메일·Google Drive 등으로 공유 가능

8. 정비탭 — 차량 관리

결산탭 내 “정비” 탭(4번째 탭)에서 이륜차 유지보수를 관리합니다.

8-1. 차량 등록

처음 정비탭 진입 시 차량 등록 화면이 표시됩니다.

1. ”+ 차량 추가” 버튼 클릭
2. 차량 정보 입력:
   • 차량명 (예: 혼다 PCX125)
   • 차종 유형 (오토바이 / 자전거 / 킥보드)
   • 현재 주행거리 (km)
   • 구입일 (선택)
3. 저장 클릭

여러 대의 차량을 등록하고 상단 셀렉터로 전환 가능합니다.

8-2. 소모품 교체 주기

오토바이 기본 소모품과 권장 교체 주기:

• 각 소모품 교체 후 “교체 완료” 버튼 클릭 → 주행거리 초기화 및 이력 기록
• 교체 주기가 가까워지면 경고 표시(노란색) 또는 위험 표시(빨간색) 로 강조

8-3. 정비 이력

• 정비탭 → “이력” 탭
• 과거 교체·수리 기록 날짜순으로 표시
• 이력 항목: 날짜, 소모품명, 주행거리, 비용, 메모
• 수기 입력 “기타 정비” 추가 가능 (타이어 패치, 기타 수리 등)

8-4. 주행거리 연동

• 결산탭 수입 입력 시 주행거리 입력 → 정비 소모품 남은 거리 자동 차감
• 정비 대시보드에서 현재 주행거리와 다음 교체까지 남은 거리 한눈에 확인

9. 정보탭 — 내 정보

9-1. 프로필 카드

정보탭 상단 프로필 카드에서 내 계정 정보를 확인합니다.

9-2. 위치 기록 통계

9-3. 위치메모 통계

9-4. 개인정보 처리방침 & 오픈소스 라이선스

정보탭 하단에 아래 링크가 있습니다.

10. 드로어 메뉴

좌측 상단 햄버거(≡) 버튼 또는 화면 좌측 끝에서 스와이프로 드로어를 엽니다.

10-1. 프로필 사진 변경

드로어 상단 프로필 아이콘을 탭하면 사진 변경 바텀시트가 표시됩니다.

• 사진은 Supabase Storage에 저장되며, 앱 전반에서 즉시 반영됩니다.

10-2. 친구 & 그룹 목록

드로어 → “친구 & 그룹” 클릭 → GroupListPage 이동

• 친구 목록, 그룹 목록, 친구 초대 3개 탭으로 구성
• (→ 13장, 14장 상세 참조)

10-3. 설정

드로어 → “설정” 클릭 → SettingsPage 이동 (→ 11장 상세 참조)

10-4. 관리자 페이지

• 관리자 계정으로 로그인 시 드로어에 “관리자 페이지” 메뉴 표시
• (→ 15장 상세 참조)

10-5. 로그아웃

드로어 하단 “로그아웃” 버튼 클릭 → 확인 다이얼로그 → 로그인 화면으로 이동

로그아웃 시 위치 공유 자동 종료

11. 설정 페이지

드로어 → 설정 (또는 드로어 상단 설정 아이콘)

11-1. 알림 소리

• 각 토글을 탭하면 미리듣기 재생
• 설정은 기기에 저장 (SharedPreferences)

11-2. 회원 탈퇴

설정 페이지 하단 카드 섹션에 위치합니다.

1. “회원 탈퇴” 버튼 클릭
2. 탈퇴 사유 확인 안내 다이얼로그
3. “탈퇴 확인” 버튼 클릭 → 계정 완전 삭제

주의: 탈퇴 시 아래 데이터가 영구 삭제됩니다.

• 작성한 게시글·댓글
• 수입·지출 기록
• 위치메모
• 친구 관계
• 정비 기록

탈퇴 후 동일 이메일로 재가입이 가능하나, 삭제된 데이터는 복구되지 않습니다.

12. 푸시 알림 (FCM)

Firebase Cloud Messaging(FCM)을 통해 관리자가 실시간 공지를 발송합니다.

알림 수신 설정

• 앱 최초 실행 시 알림 권한 요청 팝업이 표시됩니다.
• “허용” 클릭 후 FCM 토큰이 Supabase에 저장되어 알림 수신 가능

알림 유형

포그라운드 알림

앱 사용 중 알림 수신 시 → 화면 상단에 에르메스 스타일 알림 배너 표시

• 브라운·오렌지 컬러 테마
• 3초 후 자동 사라짐

백그라운드 알림

앱이 백그라운드에 있을 때 → 기기 상단 알림 바에 일반 알림으로 표시

알림 소리 ON/OFF

설정 페이지에서 푸시 알림 소리 토글로 제어 (→ 11장 참조)

13. 친구 시스템

13-1. 친구 추가

1. 드로어 → “친구 & 그룹” → “친구 초대” 탭
2. 상대방 닉네임으로 검색
3. “친구 요청 보내기” 버튼 클릭

또는

• 레이더 지도에서 파트너 마커 탭 → “친구 요청” 버튼

최대 친구 수: 25명

13-2. 친구 요청 수락 / 거절

• 상대방이 친구 요청을 보내면 알림 수신
• 드로어 → “친구 & 그룹” → “요청” 탭에서 확인
• 수락 / 거절 버튼으로 처리

13-3. 즐겨찾기

• 친구 목록에서 친구 이름 우측 ⭐ 별 아이콘 탭 → 즐겨찾기 등록
• 즐겨찾기한 친구는 목록 상단에 표시
• 다시 탭하면 즐겨찾기 해제

13-4. 친구 삭제

• 친구 목록에서 친구 이름 길게 누르기 → “친구 삭제” 옵션 선택
• 확인 다이얼로그 후 삭제

친구 삭제 후 상대방의 친구 목록에서도 자동으로 제거됩니다.

14. 그룹 채팅 상세

14-1. 그룹 방 만들기

1. 드로어 → “친구 & 그룹” → “그룹” 탭
2. 우측 하단 ”+ 방 만들기” 버튼 클릭
3. 방 이름 입력 (최대 20자)
4. 비밀번호 설정 선택 (선택 사항)
   • 비밀번호 입력 시 → 비밀번호를 아는 사람은 바로 입장 가능
5. “만들기” 버튼 클릭

최대 그룹 멤버: 25명

14-2. 입장 방법 (일반 / 비밀번호 / 요청)

14-3. 방장 기능

그룹을 만든 사람이 방장이 됩니다. 방장은 아래 기능을 사용할 수 있습니다:

14-4. 초대 & 강제퇴장

친구 초대

• 채팅방 상단 “멤버 초대” 아이콘 클릭
• 친구 목록에서 초대할 친구 선택 → 초대 알림 발송

강제퇴장 (방장 전용)

• 채팅방 상단 “멤버 목록” 클릭
• 퇴장시킬 멤버 탭 → “강제퇴장” 선택
• 해당 멤버는 즉시 채팅방에서 나가게 됩니다.

강제퇴장된 멤버는 3초 이내에 자동으로 채팅방에서 퇴장됩니다. (멤버십 주기적 확인 로직)

채팅 메시지 유지 정책

• 백그라운드 2~3분 후 채팅 메시지가 갱신됩니다.
• 앱 재진입 시 최근 50개 메시지를 불러옵니다.

15. 관리자 페이지

관리자 계정에게만 표시됩니다. 드로어 → “관리자 페이지”

15-1. 앱설정 탭

15-2. 신고 탭

• 신고된 게시글·댓글 목록 표시
• 각 신고 건 탭 → 상세 내용 확인
• 삭제 또는 신고 무시 처리
• 탈퇴 유저 FK 오류 없이 안전 삭제 처리

15-3. 관리자 탭

• 현재 관리자 목록 조회
• 관리자 추가/제거 (최고관리자만 가능)

15-4. 유저 탭

15-5. 푸시알림 탭

알림 발송

1. 제목 입력 (기본값: “[배달길]”)
2. 본문 내용 입력
3. 대상 선택:
   • 전체 발송: 모든 사용자
   • 지역 선택: 시(광역) → 구(기초) 단계별 선택
4. 발송 버튼 클릭 → Supabase Edge Function 호출 → FCM 발송

전송 내역

• 발송 탭에서 발송 이력 목록 확인
• 날짜, 제목, 대상, 수신자 수 표시

16. 자주 묻는 질문 (FAQ)

16-1. 계정 관련

Q. 이메일 인증 메일이 오지 않아요.

A. 다음을 확인해 주세요:

1. 스팸/정크 메일함 확인
2. 이메일 주소 오타 여부 확인
3. 로그인 화면에서 “재발송” 버튼 클릭 (있는 경우)
4. 5분 이상 기다린 후에도 오지 않으면 다른 이메일로 재가입 시도

Q. 닉네임을 변경하고 싶어요.

A. 현재 버전에서는 앱 내 닉네임 변경 기능이 제공되지 않습니다. 변경이 필요하시면 개발자에게 문의해 주세요. (정보탭 → 개발자 정보)

Q. 구글/카카오로 로그인했는데 닉네임 설정 팝업이 안 나와요.

A. 이미 닉네임이 설정된 경우 팝업이 나타나지 않습니다. 닉네임이 이상하게 설정되어 있다면 개발자에게 문의해 주세요.

Q. 탈퇴했다가 같은 이메일로 재가입할 수 있나요?

A. 가능합니다. 단, 이전 데이터(수입/지출 기록, 위치메모, 게시글, 친구 관계 등)는 복구되지 않습니다.

Q. 비밀번호를 여러 번 틀렸는데 계정이 잠겼어요.

A. 일정 횟수 이상 오류 시 일시적으로 잠길 수 있습니다. 비밀번호 재설정 이메일을 통해 새 비밀번호를 설정하면 잠금이 해제됩니다.

Q. 소셜 로그인 이후 이메일/비밀번호 로그인으로 전환할 수 있나요?

A. 현재 소셜 계정과 이메일 계정의 통합은 지원되지 않습니다. 기존 소셜 로그인 방식을 계속 사용해 주세요.

16-2. 지도 & 위치 관련

Q. 지도가 로딩되지 않아요.

A. 다음을 확인해 주세요:

1. 인터넷 연결 상태 확인
2. 앱 강제 종료 후 재실행
3. 기기 재부팅

Q. 내 위치가 지도에 정확하게 표시되지 않아요.

A. 다음을 확인해 주세요:

1. 기기 설정 → 위치 권한이 “항상 허용” 또는 “앱 사용 중 허용”으로 설정되어 있는지 확인
2. GPS가 활성화되어 있는지 확인
3. 실내에 있을 경우 GPS 신호가 약할 수 있습니다. 야외에서 확인해 주세요.

Q. 위치메모 저장이 안 돼요.

A. 다음을 확인해 주세요:

1. 인터넷 연결 확인 (주소 변환에 인터넷 필요)
2. 이번 달 위치메모 사용 한도 초과 여부 확인 (정보탭 → 위치메모 통계)
3. 로그인 세션이 만료되었을 수 있습니다. 로그아웃 후 재로그인

Q. 위성 지도로 전환했는데 화질이 나빠요.

A. 위성 이미지 품질은 지역·확대 수준에 따라 달라집니다. 네이버 지도 데이터 기반으로 제공되며, 배달길 앱에서 별도로 개선할 수 없습니다.

Q. 핀 메모 모드에서 지도를 탭해도 아무 반응이 없어요.

A. 핀 메모 모드 진입 후 화면 상단에 파란 안내 배너가 표시되어야 합니다. 배너가 보이지 않으면 핀 모드가 정상 진입되지 않은 것입니다. 📌 버튼을 다시 탭해 보세요.

16-3. 레이더 관련

Q. 레이더에 아무도 표시되지 않아요.

A. 다음을 확인해 주세요:

1. 내 위치 공유 토글이 ON 상태인지 확인
2. 반경 범위가 너무 좁게 설정되어 있지 않은지 확인 (최소 500m)
3. 해당 시간대·지역에 위치를 공유 중인 사용자가 없을 수 있습니다.
4. 위치 공유 동의서에 동의했는지 확인

Q. 내 마커가 지도에 표시되지 않아요.

A. 위치 공유 토글 ON + GPS 권한 허용 상태에서도 마커가 보이지 않는다면:

• 앱을 강제 종료 후 재실행
• 기기 GPS를 끄고 다시 켜기
• 인터넷 연결 확인

Q. 주변레이더를 ON 했는데 위치 동의서 팝업이 매번 나와요.

A. 동의 후 “동의” 버튼을 클릭해야 정상적으로 동의가 저장됩니다. 만약 매번 나온다면 SharedPreferences 캐시 문제일 수 있습니다. 앱 데이터 초기화 후 재시도해 주세요.

Q. 친구가 위치 공유를 켰는데 친구레이더에 안 보여요.

A. 다음을 확인해 주세요:

1. 상대방이 “친구레이더 전용 위치 공유”를 ON 했는지 확인 (주변레이더 공유와 별개)
2. 양측이 서로 친구 등록이 되어 있는지 확인
3. 지도 새로고침 (친구 위치 버튼 탭)

Q. 레이더에서 상대방의 이동 수단이 이상하게 표시돼요.

A. 상대방이 앱에서 이동수단을 설정하지 않았을 수 있습니다. 이동수단 기본값은 오토바이입니다.

Q. 레이더 채팅 메시지가 사라졌어요.

A. 앱이 백그라운드로 이동한 뒤 2~3분 이상 경과하면 채팅 구독이 초기화될 수 있습니다. 앱을 다시 전면으로 가져오거나 재실행하면 이전 메시지가 복원됩니다. 앱 재실행 시 최근 50개 메시지를 불러옵니다.

16-4. 친구 & 그룹 관련

Q. 친구를 최대 몇 명까지 추가할 수 있나요?

A. 최대 25명까지 추가 가능합니다.

Q. 친구 요청을 보냈는데 상대방이 못 받는다고 해요.

A. 다음을 확인해 주세요:

1. 닉네임을 정확하게 입력했는지 확인
2. 상대방이 앱을 설치하고 로그인 상태인지 확인
3. 상대방의 알림 설정 확인

Q. 그룹 방에 비밀번호를 설정했는데 변경하고 싶어요.

A. 현재 버전에서는 방 생성 후 비밀번호 변경 기능이 없습니다. 방을 삭제하고 새로 만들어 주세요.

Q. 그룹 채팅방에서 강제로 퇴장당했어요.

A. 방장이 강제퇴장 처리한 경우입니다. 재입장은 방장의 허가가 필요합니다.

Q. 그룹 방을 삭제하면 채팅 내역이 사라지나요?

A. 그룹 방을 삭제하면 해당 방의 모든 채팅 메시지와 멤버 정보가 영구 삭제됩니다.

Q. 그룹에 친구가 아닌 사람도 초대할 수 있나요?

A. 현재 초대 기능은 친구 목록에 있는 사람만 초대 가능합니다. 또는 비밀번호가 없는 공개 방의 경우 누구나 자유 입장 가능합니다.

16-5. 결산 & 정비 관련

Q. 수입을 입력했는데 통계에 반영이 안 돼요.

A. 다음을 확인해 주세요:

1. 선택한 연·월이 입력한 날짜와 일치하는지 확인 (상단 월 이동 확인)
2. 앱을 완전히 종료 후 재실행
3. 인터넷 연결 확인 (데이터는 Supabase 서버에 저장됨)

Q. 지출 카테고리에 원하는 항목이 없어요.

A. “기타” 카테고리에 메모를 상세히 적어 사용할 수 있습니다. 카테고리 추가는 건의사항 게시판에 남겨주시면 검토하겠습니다.

Q. 음성 입력이 작동하지 않아요.

A. 다음을 확인해 주세요:

1. 기기 설정 → 배달길 앱 → 마이크 권한 허용
2. 조용한 환경에서 또렷하게 말해 주세요.
3. 예) “기본급 삼만오천원 배달 십오건”

Q. 수입/지출 내역을 수정하고 싶어요.

A. 해당 내역 탭 → “수정” 버튼 클릭 후 수정 가능합니다.

Q. 정비 탭에서 차량을 여러 대 등록할 수 있나요?

A. 가능합니다. 정비탭 상단 차량 셀렉터에서 ”+ 차량 추가”를 선택하면 됩니다. 등록된 차량은 상단 셀렉터로 전환하여 관리합니다.

Q. 엔진오일 교체 후 ‘교체 완료’ 처리를 했는데 주행거리가 초기화가 안 돼요.

A. 결산탭 수입 입력에서 주행거리 항목을 입력해야 정비탭의 주행거리 카운터가 정상 작동합니다. 주행거리 입력 없이 교체 완료 처리 시 시간 기준으로만 초기화됩니다.

Q. CSV 내보내기 파일이 깨져서 열려요.

A. CSV 파일을 Excel로 열 때 인코딩 설정이 필요할 수 있습니다.

• Excel → 데이터 → 외부 데이터 가져오기 → CSV 파일 선택 → 인코딩 “UTF-8” 선택

16-6. 커뮤니티 관련

Q. 게시글 이미지가 업로드되지 않아요.

A. 다음을 확인해 주세요:

1. 기기 설정 → 배달길 앱 → 저장소/파일 접근 권한 허용
2. 이미지 파일 크기가 너무 크지 않은지 확인 (권장: 5MB 이하)
3. 인터넷 연결 확인

Q. 내 게시글이 삭제되었어요.

A. 신고 누적 또는 관리자 판단으로 삭제되었을 수 있습니다. 부당 삭제라고 판단되면 정보탭 → 개발자 정보로 문의해 주세요.

Q. 건의사항 카테고리에 비밀번호가 필요해요.

A. 건의사항 카테고리는 비밀번호 보호 게시판으로 운영됩니다. 비밀번호는 커뮤니티 공지 또는 관리자에게 문의해 주세요.

Q. 지역 필터로 우리 동네만 볼 수 있나요?

A. 상단 “전국” 버튼을 탭하면 지역 필터 옵션이 나타납니다. 내 위치 기준으로 동네를 필터링할 수 있습니다. (GPS 권한 필요)

Q. 댓글에 이미지를 첨부할 수 있나요?

A. 현재 버전에서는 댓글에 텍스트만 입력 가능합니다. 이미지 첨부는 향후 업데이트에서 지원 예정입니다.

16-7. 알림 관련

Q. 푸시 알림을 받지 못하고 있어요.

A. 다음을 확인해 주세요:

1. 기기 설정 → 배달길 앱 → 알림 허용 여부 확인
2. 배달길 설정 → 푸시 알림 소리 ON 확인
3. 기기 배터리 최적화 설정에서 배달길 앱을 “최적화 제외”로 설정

Q. 친구 로그인 알림 소리가 너무 자주 울려요.

A. 설정 → “친구 로그인 소리” 토글을 OFF로 변경하면 소리가 울리지 않습니다.

Q. 공지사항 알림이 오지 않아요.

A. 설정 → “공지사항 소리” ON 상태를 확인하고, FCM 권한이 허용되어 있는지 확인해 주세요.

Q. 앱을 닫은 상태에서도 알림을 받을 수 있나요?

A. 앱이 완전히 종료(강제 종료)된 상태에서도 FCM 백그라운드 알림은 수신됩니다. 단, 일부 기기(배터리 최적화가 강한 기기)에서는 수신이 지연되거나 차단될 수 있습니다.

16-8. 오류 & 기술 문의

Q. 앱이 갑자기 종료돼요 (크래시).

A. 다음을 시도해 주세요:

1. 앱 강제 종료 후 재실행
2. 기기 재부팅
3. 앱 업데이트 확인 (Play 스토어)
4. 앱 캐시 삭제: 기기 설정 → 앱 → 배달길 → 저장소 → 캐시 삭제
5. 지속 시 정보탭 → 개발자 정보로 기기 정보와 함께 문의

Q. 로그인 후 흰 화면만 보여요.

A. 네트워크 연결이 불안정하거나 Supabase 서버 연결 시간이 초과된 경우입니다. 인터넷 연결 확인 후 앱을 재실행해 주세요.

Q. “세션이 만료되었습니다” 메시지가 자주 나와요.

A. Supabase 인증 토큰 갱신 주기에 따라 발생합니다. 로그아웃 후 재로그인하면 해결됩니다. 자동 로그인 기능이 적용되어 있어 이후에는 자동 갱신됩니다.

Q. 수입 입력 페이지에서 OCR 인식이 잘 안돼요.

A. Google ML Kit Text Recognition을 사용합니다. 다음을 시도해 주세요:

1. 촬영 시 밝은 환경에서 화면을 수평으로 고정
2. 이미지가 선명하게 찍히도록 카메라 거리 조절
3. 텍스트가 명확하게 구분되는 영수증/캡처 이미지 사용

Q. 앱 버전은 어디서 확인하나요?

A. 정보탭 하단 “오픈소스 라이선스 보기” 근처에 현재 앱 버전이 자동으로 표시됩니다. (package_info_plus 동적 표시)

Q. 기기를 바꿨는데 데이터가 없어요.

A. 배달길은 클라우드 기반(Supabase) 으로 데이터를 저장합니다. 동일 계정으로 로그인하면 모든 데이터가 자동 복원됩니다. 단, SharedPreferences에 저장된 앱 설정(알림 소리 등)은 기기 교체 시 초기화됩니다.

17. 개인정보 및 데이터 정책

수집하는 정보

데이터 저장 위치

• Supabase (PostgreSQL): 사용자 정보, 위치 기록, 수입/지출, 게시글 등
• Firebase: FCM 토큰, 인증 (Firebase Auth)
• 기기 내부: 앱 설정 (SharedPreferences)
• Supabase Storage: 이미지 파일

데이터 보존 기간

• 계정 활성 기간 동안 모든 데이터 보존
• 회원 탈퇴 시 즉시 영구 삭제
• 탈퇴 후 30일 내 백업 데이터도 삭제

위치 정보 특별 안내

• 위치 정보는 동의서 확인 후에만 수집
• 위치 공유 OFF 시 즉시 업로드 중단
• 위치 데이터는 실시간으로만 사용되며 장기 보관하지 않음
• GeoHash 기반으로 서버사이드 필터링 처리 (불필요한 데이터 전송 최소화)

18. 버전 히스토리

개발자 정보

• 앱 이름: 배달길 (Baedalgil)
• 개발: 개인 개발 프로젝트
• 문의: 정보탭 → 개발자 정보
• 버그 리포트: 정보탭 → 개발자 정보 또는 커뮤니티 건의사항 게시판
• 라이선스: 오픈소스 라이선스는 정보탭에서 확인

개발자 정보

• 개발자 : 허경수
• 연락처 : herks@naver.com
• 연락처 : herks82@gmail.com

이 메뉴얼은 배달길 v1.1.4 기준으로 작성되었습니다. 앱 업데이트에 따라 내용이 변경될 수 있습니다.