# 업데이트 내역

## 2026-10-27 · 접속 시 자료 서버 준비

- 앱을 열면 자료 서버 연결을 바로 시작합니다. 지역을 고르는 동안 서버가 켜지므로 첫 검색의 대기 시간이 줄어들 수 있습니다.

## 2026-10-26 · 첫 화면 빠르게 열기

- 웹 화면을 무료 정적 사이트로 따로 배포할 수 있게 준비했습니다. 화면은 서버가 잠들어도 바로 열리고, 지역·코스 자료는 기존 Render API가 시작되면 불러옵니다.
- 자료 서버가 깨어나는 동안 연결 상태를 화면에 안내합니다. 무료 API의 첫 조회 대기 시간은 남아 있습니다.

## 2026-10-25 · 후원 버튼 위치

- 상단 후원 버튼을 본문과 서비스 안내가 끝난 뒤 페이지 최하단으로 옮겼습니다. 후원 방법 선택과 계좌 복사는 유지합니다.

## 2026-10-24 · 전자책 바로가기

- 상단 공통 메뉴에 로키스튜디오 전자책 페이지를 새 탭으로 여는 버튼을 추가했습니다.

## 2026-10-24 · 공통 이체 안내

- 카카오뱅크 이체 버튼에서 Roky Studio의 계좌 안내를 새 탭으로 엽니다. 계좌번호는 홈페이지에서 복사합니다.

## 2026-10-23 · 서울 코스 위치 검색 개선

- 서울 주소의 `서울특별시`와 `종로구` 등 자치구를 구분해 확인한다. 도로명·건물번호가 일치하는 검색 결과가 지역명 차이로 버려지지 않도록 수정했다.
- `통인동 118-1` 같은 지번 주소도 카카오 주소 검색으로 보내고 동·지번·산 여부가 정확히 맞을 때만 경로의 출발·도착점으로 사용한다.
- `세종대로 172`처럼 같은 건물번호의 지하 주소가 먼저 검색될 때 지상 코스 주소로 잘못 선택하지 않도록 구분한다.

## 2026-10-23 · 모바일 화면 글자 줄이기

- 모바일 코스 카드는 출발·도착, 거리, 지도 버튼을 먼저 보여준다. 긴 설명·경유지·원본 주소·자료 기준은 `코스 상세 정보`에서 펼쳐 볼 수 있다.
- 지도 아래 경로 만들기와 자료·경로 안내를 접어 두고, 코스 목록의 반복 안내를 짧게 바꿨다.

## 2026-10-23 · 코스 위치 실패 안내 간소화

- 출발·도착 위치 확인에 실패하면 카드에 짧은 사유와 카카오맵 직접 찾기 링크 하나만 표시한다. 지도 위와 카드에서 같은 오류 설명을 반복하지 않는다.
- 경로선 표시 후 카드에는 간단한 완료 문구만 남기고, 거리와 시간은 지도 안내에서 확인하도록 정리했다.

## 2026-10-23 · 카카오 도보 경로선

- 공공 코스의 출발·도착 지점이 확인되면 카카오 도보 경로를 가져와 지도에 보라색 선으로 표시한다. 카카오가 계산한 거리·시간을 공공 코스의 길이와 구분한다. 기존 경기둘레길 공식 코스선은 빨간색이다.
- 주소가 빠진 코스도 장소명과 지역명이 맞으면 위치를 찾는다. 찾지 못하면 카카오맵의 도보 길찾기 화면에서 카드에 표시된 출발·도착 장소명을 직접 검색하도록 링크 하나로 안내한다. 원본 순환 코스는 한 점에서 전체 경로를 자동 생성하지 않는다.

## 2026-10-23 · 상세 주소 자동 검색 준비와 실패 화면 정리

- 공공 코스 출발·도착 위치 확인에 카카오 로컬 API를 연결할 수 있게 했다. 서버 비밀 환경변수 `KAKAO_REST_API_KEY`가 있으면 도로명·건물번호 또는 장소명·시군구를 확인한 결과만 지도에 표시한다. 키가 없으면 기존 검색 공급원을 사용한다.
- 위치 확인 실패 시 주소 검색 링크 세 개를 나열하던 화면을 간결한 안내로 바꿨다. 실제 코스 경로선이 없는 경우에는 여전히 코스 전체를 그린 것으로 표시하지 않는다.

- 수원팔색길 모수길처럼 출발·도착이 같은 순환 코스는 한 기준점과 지나는 곳을 표시하고, 카카오맵의 빈 도보 길찾기 입력 화면과 수원시 공식 코스 지도를 연결한다. 공공데이터 22km·7시간 40분과 수원시 공식 안내 22.3km·7시간 20분을 구분한다. 장소명은 다른데 출발·도착 주소가 같은 자료는 자동 경로로 만들지 않는다.
- 공공 코스의 출발·도착 검색점이 모두 확인되면 카카오맵 도보 길찾기에 두 점을 함께 전달한다. 이전 버튼은 출발지 한 점만 전달했다. 한쪽을 확인하지 못한 코스에는 자동 길찾기 대신 원본 주소 검색과 직접 지정 방법을 안내한다.

## 공개 미리보기 · 2026-10-23

- 공공 코스의 출발·도착 주소를 검색할 때 도로의 중간 지점을 특정 건물 주소로 잘못 표시하지 않도록 검증한다. 한쪽 지점을 확인하지 못하면 지도에 코스를 표시하거나 화면을 이동하지 않고, 해당 카드에 원본 주소를 카카오맵에서 검색하는 링크를 보여준다. 평택시청 주소는 시청 장소 검색 결과를 인근 위치로 구분해 사용한다.
- 다른 코스를 고르면 이전 코스선과 출발·도착 표시를 지우고 마지막 선택만 지도에 남긴다. 코스를 보는 동안 주변 보행로·쉼터·내 위치 점은 숨기며, `선택 해제 · 주변 지도 보기`로 다시 표시한다.
- 공공 코스 카드의 `출발지·도착지 지도에서 찾기`를 누르면 확인 가능한 두 검색 지점을 지도에 표시하고 한 화면에 맞춘다. 도착지 이름 검색을 우선하며 주소 검색이 부정확하면 도착점 표시를 생략한다. 두 지점을 잇는 코스선은 임의로 그리지 않는다.
- 앱 이름을 `우리 동네 런닝 코스`로 바꿨다. 화면 제목·브라우저 제목·공유 제목·푸터에 반영하고 공개 주소는 유지한다.
- 지도에서 출발점·도착점을 고르면 무료 도보 경로 서버를 통해 보행 경로선과 거리를 자동으로 표시한다. 걷기·러닝 선택에 따라 속도를 가정해 예상 시간을 보여주고, 최근 확인한 내 위치를 출발점으로 사용할 수 있다. 이는 공공 코스의 원본 선형이나 실시간 내비게이션이 아니다.
- 지역을 바꾸면 거리 필터를 ‘전체’로 돌려 새 지역의 코스 목록을 바로 표시한다. ‘지도 중심에서 찾기’도 중심점의 시·군·구를 확인해 공공 코스를 불러온다.
- 경기둘레길 공공 코스를 선택하면 경기관광공사 공식 상세 페이지의 경로 좌표를 지도에 빨간 선으로 표시한다. 공식 코스명과 번호가 일치할 때만 보여주며, 시작·끝점과 원본 링크를 함께 표시한다. 모바일 화면 크기로 전환해도 선택한 코스선이 지도 안에 들어오도록 맞춘다. 경로선 자료가 없는 다른 코스에는 임의의 선을 그리지 않는다.
- 상단에 운영자의 X·Threads 계정을 새 탭으로 여는 버튼을 추가했다.

- 화면 제목과 브라우저 제목의 표기를 `우리 동네 산책길`로 바로잡았다.
- 휴대폰에서 검색·지도를 먼저 보고 코스 목록으로 바로 이동할 수 있게 배치를 다듬었다. 긴 안내와 지도 자료·길찾기 조작은 펼쳐서 볼 수 있고, 공공 코스 카드는 이름·거리부터 볼 수 있다.
- 내 위치 주변 찾기에서 주변 OSM 자료만 보이던 문제를 고쳤다. 위치의 시·군·구를 확인해 해당 지역 전체의 공공 코스 목록도 함께 불러온다.
- ‘내 위치 주변 찾기’ 버튼을 추가했다. 누르면 위치 권한을 요청하고 주변 OSM 보행로·쉼터와 거리별 걷기 초안을 조회한다. 공공 코스 목록은 시·군·구 이름으로 검색한다.
- 지도 위에서 마우스 휠로 확대·축소할 수 있게 했다.
- 모바일 화면에서 지도를 검색·위치 선택 바로 아래로 옮겨 긴 코스 목록보다 먼저 볼 수 있게 했다.
- 시작 화면을 전국 지도로 바꾸고 지역을 선택하기 전에는 특정 지역 자료를 불러오지 않도록 했다. 소사벌 우선 문구와 바로가기를 제거하고 평택시도 일반 지역 검색으로 열리게 했다.
- Render에 공공데이터 서비스 키를 등록한 뒤 안성시 공공 코스 8개가 공개 웹앱에 표시되는 것을 확인했다. 코스선 좌표는 제공되지 않아 지도에 그리지 않는다.
- Render에서 웹앱을 공개하고 평택 소사벌과 안성시의 지역 검색, 지도, OSM 보행로·쉼터, 1·5·10km 걷기 초안을 확인했다.
- Roky Studio 홈페이지에 우리동네산책길 프로젝트·업데이트 카드와 의견 선택지를 추가했다.
- 공공 코스 API 키가 없는 동안에는 연결 준비 상태를 표시했다. 운영 키는 서버 환경변수에만 보관한다.

## 개발 중 · 2026-10-23

- 첫 공개 버전에서 앱 안의 걷기 내비게이션을 제외하고 지도 탐색·쉼터·외부 카카오맵 도보 길찾기로 범위를 확정했다. 원래 설계는 이력으로 보존했다.
- Render 무료 미리보기용 `render.yaml`과 비밀값이 없는 환경변수 예시를 추가했다.
- 공개 운영에 대비해 자료 새로고침 최소 간격(OSM 1분·공공 코스 10분)과 지역별 OSM 서버 캐시 최대 200곳을 적용했다. 최근 자료를 재사용하면 원래 조회 시각과 재사용 상태를 보여준다.
- 안성시 검색에서 다른 지역의 OSM 왕복 초안과 쉼터 목록이 독립적으로 바뀌는지 확인했다. 검색 지역을 URL로 다시 열고 브라우저 뒤로 가기로 이전 지역에 돌아갈 수 있게 했다.
- 선택한 OSM 왕복 초안에서 직선거리 60m 이내의 쉼터를 가까운 순으로 보여주고, 초안 시작점과 쉼터를 카카오맵 길찾기 목적지로 고를 수 있게 했다.
- 연결된 OSM 보행로를 이용해 선택 지역의 왕복 탐색 초안을 계산하고, 거리 탭과 지도에서 볼 수 있게 했다. 소사벌에서는 약 1km·5km 초안과 5km 왕복길 2회로 이루어진 10km 초안을 볼 수 있다. 공식 코스나 내비게이션으로 제공하지 않는다.
- 소사벌 A·B 공식 코스의 원본 안내도·GPX를 확보하기 위한 문의 문안과 현장 기록 항목을 검증 계획에 정리했다. 공식 코스선은 자료 확인 전까지 표시하지 않는다.

## 개발 중 · 2026-10-22

- 지도에서 출발점을 직접 고르고 쉼터·지도 도착점까지 카카오맵 도보 길찾기를 열 수 있게 했다. 출발점은 지우거나 지역을 바꾸면 해제된다.
- 사용자가 직접 위치를 확인한 경우, 조회 지역의 쉼터를 마지막 확인 위치에서의 직선거리순으로 볼 수 있게 했다. 위치가 없거나 5분이 지나면 탐색 중심 기준으로 돌아간다.
- 선택한 지역 중심에서 가까운 OSM 쉼터 최대 5곳을 직선거리순으로 표시하고, 목록에서 지도와 길찾기로 이어지게 했다. 다른 지역을 검색하면 목록도 해당 지역 자료로 바뀐다.
- 쉼터 점을 선택해 카카오맵 길찾기의 목적지로 보낼 수 있게 했다. 보행로 선보다 쉼터 점을 위에 표시해 선택할 수 있도록 고쳤다.
- Postpass를 OSM 지도 자료의 우선 공급원으로 연결했다. 소사벌 조회에서 쉼터 54곳과 보행로 조각 642개를 확인했고, 실패 시 Overpass를 시도한다.
- 웹 서버가 브라우저에 제공하는 파일을 화면·스타일·스크립트·공개 문서로 제한해 서버 코드와 설정 파일을 요청할 수 없게 했다.
- 공개 Overpass 전역 서버의 과부하를 확인했다. 한국 자료가 없는 지역 전용 서버로 전환하지 않고 자료 조회 실패를 화면에 표시한다.
- 지도에서 사용자가 도착점을 직접 고르고 카카오맵 길찾기를 열 수 있게 했다. 최근 5분 내 위치 확인 시 도보 모드 링크를 사용한다.
- 소사벌 조사 후보마다 근거 자료 링크를 표시하고, A·B의 1.8km를 기사에 적힌 미검증 거리로 명확히 구분했다.
- 출발지 주소 검색 결과에서 카카오맵 길찾기를 열 수 있게 했다. 주소 지점까지의 외부 길찾기이며, 실제 코스 입구는 확인 전이다.
- 소사벌 이름이 포함된 도시공원 25곳의 시설 설명을 점검했다. 개별 쉼터 좌표는 확인되지 않았으며 `벤치플륨관`을 벤치로 취급하지 않는다.
- OSM에서 버스정류장 쉼터와 비공개 시설을 산책 휴식 지점 목록에서 제외하도록 했다.
- 지역명·코스 출발지 검색을 앱 서버로 옮겨 전체 요청 간격을 관리하고 같은 검색 결과를 재사용하도록 했다.
- 공공 코스의 원본 출발지 주소를 표시하고, 버튼으로 주소 검색 결과를 지도에 표시할 수 있게 했다. 실제 코스 입구와 다른 경우가 있을 수 있음을 명시했다.
- 도시공원 공공데이터의 시설 설명과 공원 중심 좌표를 조사했다. 현재 키로는 API 접근이 거부되어 쉼터 마커로 사용하지 않았다.
- Node 20 이상에서 `npm start`로 실행할 수 있게 하고 서버 상태 확인 경로 `/api/health`를 추가했다.
- 공개 Overpass 서버 장애 시 보행로·쉼터·벤치 레이어를 지우고, 지연·과부하·연결 실패 상태를 구분해 안내하도록 수정했다.
- 실제 공공데이터 API에서 평택·안성 코스 목록을 확인하고 웹앱 표시와 5km 필터를 검증했다. 공공 코스가 시·군·구 전체 목록임을 화면에 명시했다.
- 웹앱 배포 구조와 서버 비밀 환경변수 설정을 문서화하고 `.env` 계열 파일의 Git 추적을 막았다.
- 개발 결정·검증 결과·남은 제약을 남기는 개발 기록을 추가했다.
- 전국길관광정보표준데이터 API 연결과 시·군·구별 공공 코스 목록, 원본 기준일 표시를 추가했다. 서비스 키가 없는 환경에서는 연결 준비 상태를 표시한다.
- 공공 코스와 소사벌 조사 후보를 구분하고, 1·5·10km 필터를 양쪽에 적용했다. 공공 코스에는 경로선 좌표가 없어 지도에 코스선을 그리지 않는다.
- 선택 지역의 OSM 보행로·쉼터·벤치를 조회하는 시범 데이터 레이어와 새로고침, 조회 상태를 추가했다.
- 외부 조회는 앱 서버가 담당하도록 바꾸고 10분 캐시, 중복 요청 합치기, 15초 시간 제한을 적용했다. 현재 실행 환경에서는 외부 Overpass 연결이 실패해 실제 지도 자료 표시는 검증하지 못했다.
- 공공데이터·OSM·카카오 도보 API를 함께 쓰는 실시간 데이터 연결 방안을 정리하고, 운영형 Overpass 주소·키를 서버 환경변수로 바꿀 수 있게 했다.
- 전국 지역명 검색과 지도 중심 선택을 추가해 현재 위치와 탐색 지역을 분리했다.
- 자료가 없는 지역에서는 소사벌 코스를 주변 코스처럼 보여주지 않고 준비 중임을 표시한다.
- 평택 소사벌 배다리생태공원 중심의 첫 지도 화면을 만들었다.
- 1·5·10km 거리 선택과 코스 후보의 자료 확인 상태를 표시했다.
- 사용자가 요청한 경우에만 현재 위치를 지도에 표시한다. 위치는 저장하거나 서버로 전송하지 않는다. 지도 타일을 불러올 때 지도 제공자와 통신한다.
- 확인되지 않은 경로선과 쉼터 위치는 표시하지 않는다.

현재 버전은 공개 미리보기다. OSM 자료와 거리별 초안은 현장 검증된 코스가 아니다. 공공 코스 API의 목록에는 코스선 좌표가 없다.
