아카이브로 살펴볼 수 있는 질문을 고르세요
이 설계는 가정한 상황을 바탕으로 합니다. 사용자는 경로를 정했고, 통신이 안정적이지 않은 곳에서 쓸 휴대전화를 준비하고 있습니다. 미리 무엇을 내려받을지, 기기와 관련해 어떤 전제를 확인할지, 선택한 소프트웨어에 관해 무엇을 물어볼지 알아보려고 오프라인 지도에 관한 토론을 읽고 싶어 합니다. 아카이브는 과거 토론의 출처이지 지도 제공자가 아닙니다.
읽기 기능을 방향 전환 안내 안이 아니라 준비 메모 옆에 배치하세요. 결과가 경로 옆에 보인다는 이유로 확인된 등산로 상황이 되어서는 안 됩니다. 지도 다운로드, 위치 권한, 현재 통제 구간, 안전 정보는 앱의 적절한 부분에서 각각 다루세요. 이렇게 나누면 과거 경험담에 없는 권위를 부여하지 않으면서도 유용한 역할을 줄 수 있습니다.
의도한 작은 요청을 한 번 보내세요
제안한 쿼리 offline maps와 subreddit hiking으로 시작하세요. 클라이언트가 선택을 백엔드로 보내고, 백엔드는 저장한 서비스 키로 /v1/search?q=offline%20maps&subreddit=hiking&limit=3&page=1을 호출할 수 있습니다. 이는 요청 설계이며 일치하는 레코드 세 개가 존재한다는 증거가 아닙니다. 키는 백엔드에 있고 사용자가 입력할 값이 아닙니다.
짧은 첫 페이지를 이용하면 큰 피드를 설계하기 전에 읽기 작업부터 생각할 수 있습니다. q는 title과 text를 대상으로 AND 검색을 수행하므로, 이 문구는 정확한 구문 일치나 의미 검색 명령이 아닙니다. 사용자가 문구를 바꾸면 앱에서 새로운 검색임을 설명하고 페이지 순서를 다시 시작하세요. 쿼리를 몰래 넓힌 뒤 새 결과를 원래 질문에서 나온 것처럼 표시하지 마세요.
레코드를 추천이 아닌 참고 자료로 바꾸세요
아카이브는 평면 레코드를 반환합니다. 카드에는 제공된 본문, 출처 커뮤니티, 유효한 작성 날짜, 사용할 수 있는 출처 링크를 표시할 수 있습니다. 댓글에는 제목이나 도움이 될 문맥이 없을 수 있습니다. 제목이나 날짜를 지어내지 말고 제공되지 않는다고 알리세요. 있는 상위 식별자를 활용해 일부 레코드를 로컬에서 연결할 수 있지만, 완전한 토론이 확보되었다는 뜻은 아닙니다.
아카이브는 레코드를 문서 순서로 반환하며, 시간순·관련도순·점수순이 아닙니다. 인터페이스도 그 한계와 맞게 구성해 영역을 「최선의 답변」이 아니라 「과거 참고 자료」로 부르세요. 독자는 서로 다른 경험을 비교하고 가능한 경우 출처를 따라갈 수 있습니다. 다른 사람의 환경에 관한 짧은 글을 이 기기나 여행에 대해 확인된 지침으로 바꾸지 마세요.
도움이 되는 결과보다 도움이 안 되는 결과를 먼저 설계하세요
정상 요청에서도 레코드가 없을 수 있습니다. 입력을 계속 보이게 하고 다른 단어를 시도하는 등 의도적인 변경을 제안하세요. 빈 상태는 그 응답을 설명할 뿐, 아무도 주제를 논의하지 않았다는 증거가 아닙니다. 정상적인 조회 요청은 결과가 없어도 1크레딧을 사용합니다. 앱 운영자는 자동 검색을 켜기 전에 이 비용을 이해해야 합니다.
실패는 다릅니다. 질문을 보존하고 적절한 경우 재시도 선택을 제공하세요. 서비스 키와 크레딧 문제는 운영자가 맡고, 이용자에게는 토론 검색을 사용할 수 없다는 간결한 설명이 필요합니다. 이 읽기 흐름에 계정 결제 도구를 넣거나 지연된 요청만으로 아카이브가 중단되었다고 판단하지 마세요.
마무리에서도 범위를 분명히 하세요
pagination.has_more가 허용하면 「더 보기」로 같은 필터와 limit을 유지한 다음 페이지를 조회할 수 있습니다. 대신 사용자가 앱 자체의 기기 내 목록에 출처 참조를 저장할 수도 있습니다. 어느 쪽도 완전한 수록 범위, 출처의 영구 제공, 전체 대화의 오프라인 사본을 보장하지 않습니다. 참조를 저장해도 사용할 수 있는 지도가 다운로드되지는 않습니다.
유용한 마무리는 사용자가 실제 지도 소프트웨어와 최신 안내에서 확인할 짧은 질문 목록입니다. 이는 설계 의도이지 측정된 효과가 아닙니다. 참조를 다시 보여 주는 곳에서도 과거 자료라는 표시를 유지하세요. 카드 변환, 출처 시점 표시, 기기 내 읽기 목록 선택은 /ko/#field-notes에서 확인하세요.
