📘 짝궁여행 사용 설명서 & 가이드

처음 시작하는 방법부터 오프라인 지도, 여행 중 기능, 개인 호스트 서버 운영 요약까지 한눈에 확인하세요.

1. 어떤 기기에서 쓸 수 있나요?

기기 사용 방법 할 수 있는 것
🤖 안드로이드 폰 짝궁여행 앱(APK) 설치 함께 쓰기(서버 연결) & 혼자 쓰기(로컬 저장) 모두 가능. 도착 알림, 변경 알림, 오프라인 지도 지원
💻 PC (웹 브라우저) 크롬·엣지 등으로 서버 주소 열기 큰 화면으로 일정 짜기, 함께 쓰기 실시간 동기화, 호스트라면 서버 관리 및 업데이트
🍎 아이폰 테스트 앱(1.0.20) 운영 중 (앱스토어 준비) 현재 폰 브라우저·PWA는 차단되어 있으며, 정식 출시 전까지는 PC 브라우저와 병행 사용
함께 쓰기는 같은 서버에 연결해 PC와 폰이 실시간으로 동기화되며, 혼자 쓰기는 서버 없이 폰 내부에만 기록을 저장합니다.

2. 설치 및 시작하기

안드로이드 앱 설치

  1. 짝궁여행 공식 네이버 카페에서 최신 APK를 내려받아 설치합니다.
  2. 설치 시 "출처를 알 수 없는 앱" 허용을 켜고, Play 프로텍트 안내가 나오면 세부정보 더보기 → 그래도 설치를 선택합니다.
  3. 첫 화면에서 🧳 혼자 쓰기(이름만 입력해 바로 시작) 또는 👫 함께 쓰기(호스트에게 받은 주소나 초대 링크 붙여넣기)를 고릅니다.

PC 브라우저

  • 별도 프로그램 설치 없이 호스트 서버 주소(`https://...`)를 열고 스마트폰과 같은 계정으로 로그인하면 바로 이어집니다.

3. 여행 만들기 & 홈 화면

  • + 새 여행 일정 만들기: 대표 여행지를 고르면 국내/해외·통화가 자동 설정되며, 달력에서 가는 날과 오는 날을 선택합니다.
  • ☰ 사이드 메뉴: 새 여행 만들기, 여행기록방 바꾸기(연인방·친구방 분리), 함께할 사람 초대, 설정, 알림창 D-Day 표시, 혼자 쓰기 ↔ 함께 쓰기 전환이 모두 모여 있습니다.
  • 🗺️ 우리가 다녀온 곳: 다녀온 여행이 대표 사진 핀으로 지도에 표시되며, 🇰🇷 국내 / 🌏 해외 전환이 가능합니다.
  • 🔎 여행 검색 & 태그: 제목·여행지·태그·장소명·날짜로 빠르게 찾고, 지난 여행은 출발한 달별로 깔끔하게 접어 보관합니다.

4. 일정 짜기 & 실시간 동시 편집

  • 다양한 장소 추가: 이름 검색, 구글 지도 공유 링크 붙여넣기, 🗺️ 지도에서 직접 핀 찍기, ✏️ 주소 직접 입력까지 지원합니다.
  • 순서 변경 & 연박: 손잡이(⋮⋮)를 끌어 순서를 바꾸고 다른 Day로 옮길 수 있으며, 숙소는 몇 박인지 고르면 자동으로 여러 날에 배치됩니다.
  • 이동 경로: 직선·차량·도보 중 선택하면 실제 도로 경로와 예상 소요 시간을 표시합니다.
  • 📩 예약 확인서 자동 등록: 항공권·숙소·기차 확인서 메일이나 PDF·캡처를 올리면 일정에 추가하고 📁 예약 확인서 보관함에 모아둡니다.
  • 🔒 나만 보는 메모: 예약 번호나 개인 메모를 다른 멤버에게 보이지 않게 숨겨 적을 수 있습니다.
  • 실시간 충돌 방지: 바꾼 칸만 안전하게 저장되어 덮어쓰지 않으며, 다른 멤버가 수정 중이면 표시되고 변경 시 되돌리기도 가능합니다.

5. 지도 & 오프라인 지도

  • 지도 종류 선택: 무료 벡터 지도(OpenStreetMap 기반, 상업적 라이선스 준수), 카카오맵, 구글 지도를 지원합니다. (일본어·영어 화면에서는 구글 지도 설정만 표시)
  • 🗺️ 오프라인 지도: 설정 → 오프라인 지도에서 원하는 지역을 미리 내려받으면 데이터 연결 없이도 지도가 자세히 보입니다.
    • 한국: 제주도, 서울·수도권, 부산·울산·동부경남, 강원 영동, 대한민국 전체
    • 일본: 도쿄·간토, 오사카·교토·고베, 후쿠오카·유후인·규슈 북부, 마쓰야마·다카마쓰·시코쿠, 삿포로·홋카이도, 오키나와 본섬, 일본 전체
  • 🔎 도로명주소 검색 DB (한국어): 한국 도로명주소 DB(압축 약 196MB)를 받아 두면 인터넷 없이도 도로명 주소·건물명을 즉시 검색할 수 있습니다. (호스트 서버에도 받아 모든 멤버 검색 속도 향상 가능)
  • 🧭 길찾기 연동: 카카오내비, 네이버 지도, 구글 지도, 애플 지도(아이폰)로 바로 길안내를 연결합니다.

6. 여행 중에 쓰는 기능

  • 📍 도착 알림: 여행 당일 일정 장소 200m 이내에 들어가면 도착 알림이 뜹니다. (위치 정보는 폰 내부에서만 판단하며 서버로 전송하지 않습니다.)
  • 🔔 팀원 변경 알림: 동행이 일정을 고치면 푸시 알림으로 알려주며, 최근 30일 변경 내역을 한눈에 볼 수 있습니다.
  • 📷 여행 앨범: 멤버들이 찍은 사진을 올리면 촬영 날짜와 위치 기준으로 Day·장소별 자동 정리됩니다.
  • ✓ 준비물 체크리스트: 👥 함께 챙길 것과 🙋 각자 챙길 것으로 구분해 빠짐없이 챙깁니다.
  • 💰 가계부 & 영수증 인식: Day별 지출과 정산 내역을 기록하고, 🧾 영수증 사진을 찍어 금액·가게·날짜를 자동으로 채웁니다.

7. 인터넷이 없을 때 (오프라인)

  • 함께 쓰기(안드로이드): 한 번 열어본 여행은 인터넷 없이도 열람·수정이 가능하며, 수정 내역은 폰에 임시 보관되었다가 인터넷 연결 시 자동 업로드됩니다.
  • 혼자 쓰기: 모든 데이터가 폰에 있으므로 비행기 모드에서도 그대로 동작합니다.
  • 오프라인 지도: 미리 받은 지역은 상세 지도까지 그대로 보이고, 받지 않은 지역도 기본 세계 지도로 핀과 경로를 확인할 수 있습니다.

8. 설정 · 다국어 · 백업

  • 🌐 언어 전환: 자동(기기 설정), 한국어, 日本語, English를 지원합니다.
  • 내 정보 & 프로필: 프로필 사진(원형 크롭·확대/이동) 및 이름을 관리합니다.
  • 💾 백업 & 복원 (혼자 쓰기): 폰 저장소나 구글 드라이브·네이버 MYBOX 등으로 백업 파일을 내보내고, 새 폰에서 그대로 불러올 수 있습니다.
  • 📌 알림창 D-Day: 다가오는 여행 디데이를 안드로이드 상단 알림창에 계속 띄워둘 수 있습니다.

9. 개인 호스트 서버 구축 요약 (프라이버시 운영)

외부 서비스에 내 여행 기록과 사진을 맡기지 않고, 내 PC·NAS(시놀로지 등) 또는 개인 클라우드 VPS에 나만의 서버를 직접 띄워 쓸 수 있습니다.

  1. 호스트 키트 준비: 네이버 카페에서 최신 jjakgung-host-kit.zip을 내려받습니다.
  2. Docker 실행: Docker Desktop(PC) 또는 NAS Container Manager에서 한 번의 설정으로 서버를 실행합니다.
  3. 외부 접속 연결:
    • 무료 방식: DuckDNS 무료 도메인 + 공유기 포트포워딩(80/443)
    • 보안 강화 추천: 개인 도메인 + Cloudflare Tunnel(포트 열기 없이 집 IP 보호) 또는 Tailscale(지정 기기만 비공개 접속)
  4. 간편 업데이트: 호스트 PC 브라우저의 설정 → 서버 업데이트에서 새 릴리스 zip 파일만 올리면 재빌드 없이 바로 반영됩니다.
앱 내 설정 → 앱 정보 → 호스트 서버 만드는 방법에서도 상세한 단계별 그림 안내서를 바로 열어볼 수 있습니다.

10. 비밀번호 재설정 & 업데이트 FAQ

  • 비밀번호를 잊었을 때: 호스트가 설정 → 👥 회원 관리에서 6자리 재설정 코드(30분 유효)를 발급하면, 로그인 화면의 '비밀번호를 잊었어요'에서 바로 새 비밀번호를 설정할 수 있습니다.
  • 웹 화면 업데이트: 호스트 서버가 업데이트되면 앱 실행 시 새 버전 알림이 뜨고, PC 브라우저는 새로고침만 하면 반영됩니다.
  • 안드로이드 APK 업데이트: 새 앱 버전이 나오면 앱 안에서 알림을 띄워 바로 내려받아 설치할 수 있습니다.