하나원큐 놀이터 · 공공데이터 신규 서비스 기획 · 2026-11

축제×장날 겹치는 날 찾기

지역 축제와 전통시장 장날이 같은 날 겹치는 「최고의 날」을 찾아 알려 주는 서비스의 기획서입니다. 브리프부터 유저플로우까지 다섯 단계를 차례로 승인받았습니다.

1234567891011 장날(1일+6일 시장)축제 기간겹치는 날
5요구사항11기능5흐름 구간74결정 질문 (결정됨 67)

단계 1 · 승인됨

브리프

docs/00-brief.md

단계: brief · 작성일: 2026-11-14(재검토: 2026-11-14, 축제 데이터 출처 변경 D-3 반영) · 출처: 사용자 인터뷰(6개 질문, 사용자가 예시 답을 그대로 채택), 사용자 아이디어 메모, 전통시장·관광공사 API 연동 확인 결과

1. 한 줄 정의

주말 나들이를 계획하는 하나원큐 사용자에게 지역 축제와 전통시장 장날이 같은 날 겹치는 「최고의 날」과 그 장소를 알려 주는 서비스이다.

2. 핵심 문제

  • 축제 일정과 장날 정보가 서로 다른 곳에 흩어져 있어, 축제도 보고 장도 볼 수 있는 날을 사용자가 직접 맞춰 보기 어렵다.
  • 지금은 축제 일정과 시장 개설주기를 각각 찾아본 뒤 날짜를 손으로 비교해야 하며, 이 과정이 번거로워 겹치는 날을 놓친다.

3. 타깃 고객

  • 주 사용자: 주말 국내 나들이를 계획하는 30~50대 가족 단위 여행객이다. 하나원큐 앱 사용자이다.
  • 보조 사용자: 매달 「이번 달 겹치는 날 TOP 5」 콘텐츠를 올리는 운영자이다.

4. 전달 가치

  • 「이날 가면 축제도 보고 장도 본다」는 날을 한 번에 골라 준다. 겹치는 날은 드물기 때문에 희소성이 있다.
  • 대안: 지자체·관광 사이트의 축제 일정과 시장 정보를 각각 검색해 직접 비교한다.

5. MVP 범위

구분기능
포함이번 달 겹치는 날 TOP 5
포함날짜·지역으로 겹치는 날 찾기
포함상세: 축제 + 시장 + 주변 관광정보
범위 밖알림
범위 밖결제·쿠폰
범위 밖저장(D-9)

6. 성공 기준과 제약

  • 성공 기준: TOP 5 콘텐츠의 월 조회수로 판단한다. 인터뷰에서는 저장 수도 기준이었으나, 저장 기능을 MVP에 두지 않기로 해 뺐다(D-9). 목표 수치는 두지 않는다(D-1 보류).
  • 플랫폼: 하나원큐 앱 안의 「놀이터」 메뉴로 진입한다.
  • 제약: 일정·예산 제약은 두지 않는다(D-2 보류). 축제·관광정보는 한국관광공사 국문 관광정보 서비스_GW만 쓰고, 엑셀 파일은 쓰지 않는다(D-3).

참고: 확인한 데이터 (사실 정리)

  • 축제 한국관광공사 국문 관광정보 서비스_GW(KorService2)의 행사정보 조회(searchFestival2)를 쓴다(D-3). 2026-11-14 조회 기준으로 2026-01-01 이후 진행되는 축제는 863건이다(이 중 2026-11-14 이후에도 진행되는 축제는 83건).
  • 모든 건에 시작일·종료일(일 단위)과 좌표(경도 mapx·위도 mapy)가 있다. 축제명, 주소, 이미지(6건 제외), 개최 장소·프로그램(상세 조회 detailIntro2)이 있다.
  • 방문객 수는 없다.
  • 처음에 검토한 엑셀 파일(2026_festival.xlsx)은 쓰지 않는다(D-3 변경).
  • 시장 전국전통시장표준데이터 1,403곳에 개설주기와 위도·경도가 있다. 개설주기가 「매일」인 곳이 1,024곳이고, 「1일+6일」처럼 특정 날짜에 서는 곳이 약 380곳이다. 21곳은 좌표가 없다.
  • 주변 관광정보 같은 관광공사 서비스의 위치기반 조회(locationBasedList2)로 시장 반경 내 관광지·음식점 등을 조회할 수 있다.

결정 필요

  • D-1, D-2, D-3, D-4, D-5

단계 2 · 승인됨

PRD

docs/01-prd.md

단계: prd · 근거: docs/00-brief.md(2026-11-14 재검토 승인), docs/decisions.md(결정됨 행), docs/ref-hanaoneq-ia.md(피그마 하나원큐 IA 참고, 가정·더미 데이터) · 작성일: 2026-11-14(축제 데이터 출처 변경 D-3에 따라 전면 재작성)

1. 개요

한 줄 정의

주말 나들이를 계획하는 하나원큐 사용자에게 지역 축제와 전통시장 장날이 같은 날 겹치는 「최고의 날」과 그 장소를 알려 주는 서비스이다.

제품 목표

  • 사용자가 축제 일정과 시장 개설주기를 따로 찾아 비교하지 않고도, 「이날 가면 축제도 보고 장도 본다」는 날을 한 번에 고를 수 있게 한다.
  • 매달 「이번 달 겹치는 날 TOP 5」를 정해진 규칙(D-7, D-25)으로 자동 산출하고, 운영자가 검수해 게시할 수 있게 한다(D-11).
  • 겹치는 날의 상세에서 축제·시장·주변 관광정보를 함께 보여 주어 나들이 계획을 한 화면에서 끝낼 수 있게 한다.

배경

  • 축제 일정과 장날 정보는 서로 다른 곳에 흩어져 있다. 축제는 지자체·관광 사이트에, 시장 개설주기는 시장 정보에 따로 있어 사용자가 직접 날짜를 맞춰 봐야 한다.
  • 공공데이터로 두 정보를 이을 수 있다. 축제와 주변 관광정보는 한국관광공사 국문 관광정보 서비스_GW(KorService2)를, 시장은 전국전통시장표준데이터(전통시장 API)를 쓴다(D-3).
  • 관광공사 행사정보 조회(searchFestival2)로 2026-11-14에 조회한 결과, 2026-01-01 이후 진행되는 축제는 863건이고 모두 일 단위 시작일·종료일과 좌표가 있다.
  • 전통시장 데이터는 1,403곳이며 개설주기와 위도·경도가 있다.
  • 하나원큐 IA 참고 보드(가정·더미 데이터 기준)는 라이프스타일 서비스로 방문 빈도가 늘었지만 앱이 무거워졌다는 이슈를 제시한다. 브리프는 진입 위치를 기존 비금융 영역인 「놀이터」로 정했다. 놀이터 안의 정확한 위치와 추가 진입점 여부는 D-12에서 정한다.

2. 문제와 해결

사용자 문제

  • 축제도 보고 장도 볼 수 있는 날을 찾으려면 축제 일정과 시장 개설주기를 각각 검색한 뒤 날짜를 손으로 비교해야 한다.
  • 이 비교가 번거로워 사용자는 겹치는 날을 놓친다. 정기장(「1일+6일」처럼 특정 날짜에 서는 장)과 축제가 겹치는 날은 드물어서 더 놓치기 쉽다.
  • 축제 장소와 시장이 얼마나 가까운지, 근처에 함께 들를 관광지·음식점이 있는지도 따로 찾아야 한다.

해결 방안

  • 겹치는 날 계산: 축제 기간(시작일~종료일) 중 하루가, 축제 좌표에서 5km 이내(D-5)에 있는 시장의 장날과 같은 날이면 「겹치는 날」로 본다. 「겹치는 날」 한 건은 축제 × 시장 × 날짜 조합이다(D-10). 같은 축제·같은 날이라도 5km 안 시장이 다르면 다른 건이다.
  • 축제 좌표는 관광공사 행사정보의 좌표(경도 mapx·위도 mapy)를 쓰고, 시장 좌표는 전통시장 데이터의 위도·경도를 쓴다.
  • 장날은 시장의 개설주기로 정한다. 개설주기가 「매일」인 상설장도 장날에 포함한다(D-4). 정기장 표기는 끝자리 방식으로 바꾼다(D-29). 예를 들어 「1일+6일」은 끝자리가 1·6인 날(1·6·11·16·21·26일)이고, 「5일+10일」은 끝자리가 5·0인 날(5·10·15·20·25·30일)이다.
  • 좌표가 없는 시장 21곳의 처리는 D-16에서 정한다.
  • 이번 달 겹치는 날 TOP 5: 달력 월을 기준으로 매달 1일 후보를 자동 산출하고, 운영자가 검수해 게시한다(D-11).
  • 순위는 정기장 장날과 겹치는 날을 먼저 올리고(D-7), 같은 조건이면 축제 기간이 짧은 순으로 정한다(D-25). 그래도 같으면 D-30에서 정한다. 관광공사 데이터에는 방문객 수가 없어 기간이 짧은 축제, 곧 드문 기회를 앞에 둔다.
  • 상설장을 포함하면(D-4) 상설장 근처 축제는 축제 기간 내내 겹치는 날이 된다. 이 순위 규칙은 드물게 오는 정기장 장날과 짧은 축제를 앞에 두어 「겹치는 날은 드물다」는 희소성을 지키는 장치이다.
  • 한 축제가 같은 날 시장만 달리해 여러 칸을 차지할 수 있다. TOP 5 안의 같은 축제 중복 허용 여부는 D-20에서 정한다.
  • 그 달의 겹치는 날 후보가 5건 미만일 때의 표시 방식은 D-26에서 정한다.
  • 날짜·지역으로 겹치는 날 찾기: 사용자가 시도→시군구를 고르고 오늘부터 2026-12-31 사이의 날짜를 골라 그 조건의 겹치는 날을 찾는다(D-14). 종료일 2026-12-31을 유지할지는 D-28에서 정한다. 결과의 정렬과 같은 축제 묶음 방식은 D-23에서 정한다.
  • 상세: 겹치는 날 한 건에 대해 축제 정보, 시장 정보, 주변 관광정보를 함께 보여 준다.
  • 축제 정보: 관광공사 행사정보 조회(searchFestival2)의 축제명, 주소, 시작일·종료일, 대표 이미지와 상세 조회(detailIntro2, 콘텐츠 타입 15)의 개최 장소, 행사 시간, 이용 요금, 프로그램, 주최를 보여 준다. 상세 조회 항목은 API가 제공하는 필드이며 축제에 따라 비어 있을 수 있다(빈 값 표시는 기능 상세에서 정한다).
  • 시장 정보: 전통시장 데이터의 시장명·개설주기·위치를 보여 준다. 그 건의 시장만 보여 줄지, 같은 날 5km 안 다른 시장도 함께 보여 줄지는 D-22에서 정한다.
  • 주변 관광정보: 같은 관광공사 서비스의 위치기반 조회(locationBasedList2)로 시장 주변 정보를 조회한다. 보여 줄 종류와 반경은 D-15, 축제공연행사(15)를 주변 관광정보에 넣을지는 D-31에서 정한다.
  • 데이터 갱신: 관광공사 축제 데이터는 등록·수정이 계속된다. 일정 변경·취소를 언제 반영할지(조회 주기)와 주변 관광정보를 언제 불러올지는 D-27에서 정한다.

차별점

  • 기존 대안은 지자체·관광 사이트의 축제 일정과 시장 정보를 각각 검색해 직접 비교하는 것이다. 이 서비스는 그 비교를 대신해 겹치는 날만 골라 준다.
  • 정기장 장날 우선과 짧은 축제 우선의 순위(D-7, D-25)로, 매일 서는 상설장 때문에 TOP 5가 흔해지는 것을 막고 「드문 날」을 먼저 보여 준다. 찾기 결과의 정렬은 D-23에서 정한다.
  • 하나원큐 앱 안 「놀이터」에서 바로 쓸 수 있어 별도 앱이나 사이트를 찾을 필요가 없다. 로그인하지 않아도 조회할 수 있다(D-13).

3. 타깃과 시나리오

타깃 사용자

  • 주 사용자(사용자): 주말 국내 나들이를 계획하는 30~50대 가족 단위 여행객이다. 하나원큐 앱 사용자이며, 축제와 장을 함께 즐길 수 있는 날과 장소를 찾는 것이 목표이다. 로그인하지 않은 상태에서도 조회할 수 있다(D-13).
  • 보조 사용자(운영자): 매달 자동 산출된 「이번 달 겹치는 날 TOP 5」 후보를 검수해 게시하는 담당자이다(D-11). 검수·게시를 어느 도구에서 할지는 D-21에서 정한다.

사용자 시나리오

  1. 첫 진입: 사용자가 하나원큐 홈의 바로가기에서 「놀이터」로 들어가 이 서비스의 진입점을 누른다. 놀이터 안의 정확한 위치와 추가 진입점은 D-12에서 정한다.
  2. TOP 5 확인: 첫 화면에서 운영자가 검수해 게시한 「이번 달 겹치는 날 TOP 5」를 본다. 정기장 장날과 겹치는 날이 위에 있고, 같은 조건이면 기간이 짧은 축제가 위에 있다.
  3. 상세 확인: TOP 5 중 하나를 눌러 축제 정보(개최 장소·행사 시간·이용 요금·프로그램 등), 5km 이내 시장과 장날, 주변 관광정보를 한 화면에서 본다.
  4. 직접 찾기: 시도→시군구와 날짜(오늘~2026-12-31)를 골라 그 조건의 겹치는 날 목록을 보고, 그중 하나의 상세로 들어간다.
  5. 재방문: 다음 달에 놀이터로 다시 들어와 새로 게시된 TOP 5를 본다. 저장 기능은 MVP에 두지 않으므로 다시 찾을 때는 TOP 5나 찾기로 들어간다(D-9).

4. 성공과 리스크

핵심 지표

  • TOP 5 콘텐츠 월 조회수 — 한 달 동안 TOP 5 콘텐츠가 조회된 횟수이다. 무엇을 한 번의 조회로 셀지(상세 진입, 목록 노출, 순 사용자)는 D-18에서 정한다. 비로그인 조회(D-13)가 있으므로 순 사용자를 고르면 비로그인 사용자를 세는 방법도 함께 정해야 한다 — 목표 수치를 두지 않는다(D-1 보류).
  • 브리프 인터뷰의 「저장 수」는 저장 기능을 MVP에 두지 않기로 해(D-9) 지표에서 뺀다.

리스크

  • 상설장 포함으로 희소성 약화: 시장 1,403곳 중 1,024곳이 「매일」 서는 상설장이라(D-4), 상설장 근처 축제는 기간 내내 겹치는 날이 된다 → TOP 5는 정기장 장날과 겹치는 날을 먼저 올리고(D-7), 같은 조건이면 축제 기간이 짧은 순으로 정해(D-25) 드문 날을 앞에 둔다. 이 완화는 TOP 5에만 적용되며, 찾기 결과의 정렬은 D-23에서 정한다.
  • 연말 데이터 부족: 2026-11-14 조회 기준으로 이날 이후에도 진행되는 축제는 83건뿐이다. 달에 따라 겹치는 날이 5건 미만이 되어 TOP 5를 채우지 못할 수 있다 → 5건 미만일 때 표시 방식을 정한다(D-26). (제안) 있는 건수만 보여 주고 「이번 달은 N건」이라고 알리며, 운영자는 검수 단계(D-11)에서 후보 수를 먼저 확인한다.
  • 일정 변경·취소 반영 지연: 관광공사 데이터는 등록·수정이 계속되므로, 조회 주기에 따라 이미 게시한 TOP 5나 찾기 결과에 바뀐 일정·취소된 축제가 남을 수 있다 → 반영 시점(조회 주기)을 정한다(D-27). (제안) 상세에 데이터 기준 시점을 표시한다.
  • 좌표 품질에 따른 5km 판정 오차: 축제 좌표는 관광공사 좌표(mapx·mapy)를 그대로 쓰므로 5km 판정(D-5)의 정확도는 그 좌표의 품질에 달려 있다. 좌표가 실제 개최 장소와 다르면 경계에서 판정이 틀릴 수 있다 → (제안) 상세에 개최 장소(eventplace)와 주소를 함께 보여 사용자가 실제 위치를 확인하게 한다.
  • 외부 API 의존: 축제·주변 관광정보(관광공사)와 시장(전통시장 API)을 모두 외부 API로 가져오므로 호출 한도나 장애가 서비스에 그대로 영향을 준다 → (제안) 조회 실패 시 마지막으로 받은 데이터와 기준 시점을 보여 준다. 축제·시장 데이터를 미리 받아 둘지, 요청마다 부를지와 그 주기는 D-27에서 정한다.
  • 앱 무게와 5060 인지 부하: IA 참고 보드는 비금융 콘텐츠 업데이트 후 앱 실행 1.5초 지연, 5060 고객 체류 시간 20% 감소를 제시하고, 진입점 선택 때 앱 무게와 5060 인지 부하를 고려하라고 한다. 이 수치는 보드의 가정·더미 데이터이며 실측이 아니다 → 브리프에 따라 새 탭을 늘리지 않고 기존 놀이터 안에 들어간다(정확한 위치는 D-12). (제안) 첫 화면은 TOP 5 중심으로 단순하게 둔다.
  • 좌표 없는 시장: 시장 21곳은 좌표가 없어 5km 판정을 할 수 없다 → 처리 방법을 정한다(D-16). (제안) 5km 판정에서 빼고 노출하지 않는다.
  • 찾기 기간과 TOP 5 주기의 어긋남: 찾기 종료일이 2026-12-31(D-14)이라 오늘(2026-11-14) 기준 찾기 기간은 약 7주뿐이고, TOP 5는 달력 월로 계속 돈다 → 종료일 유지 여부를 정한다(D-28).
  • 이미지 없는 축제: 2026-01-01 이후 진행 축제 863건 중 6건은 대표 이미지가 없다 → (제안) 기본 이미지로 대신한다.

5. 기본 정보

  • 카테고리: lifestyle
  • 디바이스: 하나원큐 앱(모바일). 운영자의 검수·게시 도구는 D-21에서 정한다.
  • 역할: 사용자(로그인·비로그인 모두 조회 가능, D-13), 운영자
  • 진입 위치: 하나원큐 홈 바로가기 → 「놀이터」. 놀이터에는 이미 여행 탭(화면 24)이 있다(IA 참고 보드). 놀이터 안 위치와 추가 진입점은 D-12에서 정한다.
  • 데이터 출처(D-3, 엑셀 파일은 쓰지 않는다)
  • 축제: 한국관광공사 국문 관광정보 서비스_GW(KorService2)
  • 행사정보 조회 searchFestival2: 콘텐츠 ID, 축제명(title), 주소(addr1), 시작일·종료일(eventstartdate·eventenddate, 일 단위), 좌표(mapx 경도·mapy 위도), 대표 이미지(firstimage)
  • 상세 조회 detailIntro2(콘텐츠 타입 15): 개최 장소(eventplace), 행사 시간(playtime), 이용 요금(usetimefestival), 프로그램(program), 주최(sponsor1) 등. 값이 비어 있을 수 있다.
  • 방문객 수는 없다(그래서 TOP 5 동률 기준은 축제 기간이 짧은 순이다, D-25).
  • 시장: 전국전통시장표준데이터(전통시장 API)의 시장명·개설주기·위도·경도를 쓴다.
  • 주변 관광정보: 같은 관광공사 서비스의 위치기반 조회 locationBasedList2. 종류·반경은 D-15, 축제공연행사(15) 포함 여부는 D-31에서 정한다.
  • 조회 범위: 찾기는 오늘부터 2026-12-31까지이다(D-14, 종료일 유지 여부는 D-28). TOP 5는 달력 월 기준이다(D-11).
  • 범위 밖: 알림, 결제·쿠폰, 저장(D-9)
  • 제약: 목표 수치·일정·예산 제약은 두지 않는다(D-1·D-2 보류).

결정 필요

  • 결정됨(반영): D-3(변경), D-4, D-5, D-7, D-9, D-10, D-11, D-13, D-14, D-25, D-29
  • 보류(반영하지 않음): D-1, D-2 / D-3 변경으로 무효: D-6, D-8, D-17, D-19, D-24
  • 열린 질문(이 PRD에서 짚음): D-12(진입 위치), D-15(주변 관광정보 종류·반경), D-16(좌표 없는 시장), D-18(조회수 정의), D-20(TOP 5 같은 축제 중복), D-21(운영 도구), D-22(상세 시장 표시 범위), D-23(찾기 결과 정렬)
  • 새 질문: D-26(TOP 5 후보 5건 미만 표시), D-27(데이터 조회 주기·변경 반영), D-28(찾기 기간 종료일 유지 여부), D-30(D-25 다음 동률 기준), D-31(주변 관광정보에 축제공연행사 포함 여부)

단계 3 · 승인됨

기능 맵

docs/02-feature-map.md

단계: featureMap · 근거: docs/01-prd.md(2026-11-14 재작성·승인), docs/00-brief.md(2026-11-14 재검토 승인), docs/decisions.md(결정됨 행), docs/ref-hanaoneq-ia.md(IA 참고) · 작성일: 2026-11-14(축제 데이터 출처 변경 D-3에 따라 전면 재작성)

요약

ID요구사항중요도기능 수
R-ENT놀이터에서 서비스 진입high1
R-TOP이번 달 겹치는 날 TOP 5high3
R-SRC날짜·지역으로 겹치는 날 찾기high2
R-DTL겹치는 날 상세high3
R-DAT축제·시장 데이터 준비와 겹치는 날 산출high2

용어: 「겹치는 날」 한 건은 축제 × 시장 × 날짜 조합이다(D-10). 같은 축제·같은 날이라도 축제 좌표 5km 안(D-5) 시장이 다르면 다른 건이다.
데이터 출처(D-3): 축제와 주변 관광정보는 한국관광공사 국문 관광정보 서비스_GW(KorService2), 시장은 전국전통시장표준데이터(전통시장 API)이다. 엑셀 파일은 쓰지 않는다.


R-ENT 놀이터에서 서비스 진입

  • 중요도: high
  • 설명: 사용자가 하나원큐 홈 바로가기 → 「놀이터」에서 이 서비스의 진입점을 눌러 서비스 첫 화면(이번 달 겹치는 날 TOP 5)으로 들어간다. 놀이터 안의 정확한 위치와 추가 진입점 여부는 D-12에서 정한다. 로그인하지 않은 사용자도 들어가 조회할 수 있다(D-13).

수락 기준

  • ☐ 하나원큐 홈 바로가기 → 놀이터에서 이 서비스의 진입점이 보인다(위치는 D-12).
  • ☐ 진입점을 누르면 서비스 첫 화면인 「이번 달 겹치는 날 TOP 5」가 열린다.
  • ☐ 로그인하지 않은 상태에서도 진입점을 눌러 첫 화면을 볼 수 있다(D-13).

기능

ID기능중요도설명역할디바이스
F-ENT01놀이터 진입점high사용자가 놀이터 안의 진입점을 눌러 서비스 첫 화면으로 들어간다. 진입점 위치와 추가 진입점 여부는 D-12를 따른다. 비로그인도 들어갈 수 있다(D-13).사용자하나원큐 앱(모바일)

R-TOP 이번 달 겹치는 날 TOP 5

  • 중요도: high
  • 설명: 시스템이 매달 1일 그 달(달력 월)의 겹치는 날 가운데 TOP 5 후보를 자동 산출하고, 운영자가 검수해 게시하면(D-11) 사용자가 서비스 첫 화면에서 이를 보고 상세로 들어간다. 순위는 정기장 장날과 겹치는 건을 먼저, 같은 조건이면 축제 기간이 짧은 순이다(D-7, D-25). 그다음 동률 기준은 D-30, 같은 축제의 중복 허용은 D-20, 후보가 5건 미만일 때의 표시는 D-26, 검수·게시 도구는 D-21, 「TOP 5 월 조회수」의 집계 정의는 D-18에서 정한다. 저장(D-9)과 알림(브리프 범위 밖)은 포함하지 않는다.

수락 기준

  • ☐ 첫 화면에 운영자가 게시한 이번 달 겹치는 날이 최대 5건 보인다. 후보는 정기장 장날과 겹치는 건이 먼저, 같은 조건이면 축제 기간이 짧은 건이 먼저 오도록 산출된다(D-7, D-25). 게시 단계에서 순서를 바꿀 수 있는지는 D-34를 따른다.
  • ☐ TOP 5의 각 항목은 겹치는 날 한 건(축제 × 시장 × 날짜, D-10)이며, 누르면 그 겹치는 날의 상세가 열린다.
  • ☐ 매달 1일 그 달의 TOP 5 후보가 자동으로 만들어지고, 운영자가 게시하기 전에는 사용자에게 보이지 않는다(D-11).
  • ☐ 로그인하지 않은 사용자도 게시된 TOP 5를 볼 수 있다(D-13).

기능

ID기능중요도설명역할디바이스
F-TOP01이번 달 TOP 5 보기high사용자가 첫 화면에서 게시된 이번 달 겹치는 날 TOP 5를 순위대로 보고, 항목을 눌러 상세(R-DTL)로 이동한다. 5건 미만일 때의 표시는 D-26, 조회수 집계는 D-18을 따른다. 비로그인도 볼 수 있다(D-13).사용자하나원큐 앱(모바일)
F-TOP02TOP 5 검수·게시high운영자가 매달 1일 자동 산출된 이번 달 TOP 5 후보(F-TOP03)를 검수하고 게시한다(D-11). 순위는 다시 계산하지 않고, 검수 때 할 수 있는 일은 D-34를 따른다. 검수·게시를 하는 도구와 디바이스는 D-21, 게시 뒤 일정 변경·취소 건의 처리는 D-27, 운영자에게 알리는 방식은 D-38에서 정한다.운영자미정(D-21)
F-TOP03이번 달 TOP 5 후보 자동 산출high시스템이 매달 1일 그 달(달력 월)의 겹치는 날(F-DAT03 결과)을 정기장 장날 우선, 같으면 축제 기간이 짧은 순(D-7, D-25)으로 줄 세운 순위 후보 목록을 만들고 운영자 검수(F-TOP02)로 넘긴다. 몇 건까지 넘길지는 D-34를 따른다. 다음 동률 기준은 D-30, 같은 축제 중복은 D-20, 5건 미만 처리는 D-26을 따른다.해당 없음(시스템 처리)해당 없음

R-SRC 날짜·지역으로 겹치는 날 찾기

  • 중요도: high
  • 설명: 사용자가 지역(시도→시군구)과 날짜를 골라 그 조건에 맞는 겹치는 날 목록을 보고, 그중 하나의 상세로 들어간다. 고를 수 있는 날짜는 오늘부터 3개월까지이다(D-14 지역 단위, D-28 기간). 결과의 정렬과 같은 축제 여러 줄의 묶음 방식은 D-23에서 정한다. 내 위치 기준 반경 검색(D-14에서 고르지 않음)과 찾은 결과 저장(범위 밖, D-9)은 포함하지 않는다.

수락 기준

  • ☐ 사용자가 지역(시도→시군구)과 날짜(오늘부터 3개월 안, D-28)를 고르면 그 조건에 해당하는 겹치는 날만 목록에 보인다.
  • ☐ 목록의 각 항목은 겹치는 날 한 건(축제 × 시장 × 날짜, D-10)이며, 누르면 그 겹치는 날의 상세가 열린다. 같은 축제 여러 줄의 묶음 표시는 D-23을 따른다.
  • ☐ 조건을 바꾸면 목록이 바뀐 조건으로 다시 보인다.
  • ☐ 로그인하지 않은 사용자도 찾기를 쓸 수 있다(D-13).

기능

ID기능중요도설명역할디바이스
F-SRC01날짜·지역 조건 선택high사용자가 찾을 지역과 날짜를 고르고 바꾼다. 지역은 시도→시군구, 날짜는 오늘부터 3개월 안에서 고를 수 있다(D-14 지역 단위, D-28 기간).사용자하나원큐 앱(모바일)
F-SRC02찾기 결과 목록 보기high사용자가 고른 조건의 겹치는 날 목록을 보고 항목을 눌러 상세(R-DTL)로 이동한다. 정렬과 같은 축제 여러 줄 처리는 D-23을 따른다.사용자하나원큐 앱(모바일)

R-DTL 겹치는 날 상세

  • 중요도: high
  • 설명: 사용자가 TOP 5나 찾기 결과에서 고른 겹치는 날 한 건에 대해 축제 정보, 그 건의 시장과 장날, 주변 관광정보를 한 화면에서 본다. 축제 정보는 관광공사 행사정보 조회(searchFestival2)와 상세 조회(detailIntro2, 콘텐츠 타입 15), 시장 정보는 전통시장 API, 주변 관광정보는 관광공사 위치기반 조회(locationBasedList2)를 쓴다(D-3). 같은 날 5km 안 다른 시장의 표시 범위는 D-22, 주변 관광정보의 종류·반경은 D-15, 축제공연행사(15)의 포함 여부는 D-31에서 정한다. 저장(범위 밖, D-9)은 포함하지 않는다.

수락 기준

  • ☐ 상세에 축제명, 주소, 시작일·종료일, 대표 이미지와 개최 장소, 행사 시간, 이용 요금, 프로그램, 주최가 API가 준 값대로 보인다(빈 값 표시는 기능 상세에서 정한다).
  • ☐ 상세에 그 건의 시장(축제 좌표 5km 이내, D-5)의 시장명·개설주기·위치가 보이고, 그 건의 날짜가 그 시장의 장날임을 알 수 있다.
  • ☐ 상세에 시장 주변 관광정보 목록이 보인다(종류·반경은 D-15).

기능

ID기능중요도설명역할디바이스
F-DTL01축제 정보 보기high사용자가 겹치는 날의 축제명, 주소, 시작일·종료일, 대표 이미지(searchFestival2)와 개최 장소, 행사 시간, 이용 요금, 프로그램, 주최(detailIntro2)를 본다. 상세 조회 항목은 축제에 따라 비어 있을 수 있다.사용자하나원큐 앱(모바일)
F-DTL025km 안 시장과 장날 보기high사용자가 그 겹치는 날의 시장명·개설주기·위치와 장날을 본다. 상설장·정기장 모두 장날에 포함한다(D-4). 같은 날 5km 안 다른 시장의 표시 범위는 D-22를 따른다.사용자하나원큐 앱(모바일)
F-DTL03주변 관광정보 보기high사용자가 시장 주변 관광정보를 관광공사 위치기반 조회(locationBasedList2) 결과로 본다. 종류·반경은 D-15, 축제공연행사(15) 포함 여부는 D-31, 불러오는 시점은 D-27을 따른다.사용자하나원큐 앱(모바일)

R-DAT 축제·시장 데이터 준비와 겹치는 날 산출

  • 중요도: high
  • 설명: 시스템이 관광공사 축제 데이터(searchFestival2·detailIntro2)와 전통시장 데이터를 가져오고, 시장의 개설주기로 장날 달력을 만든 뒤, 축제 좌표 5km 안 시장의 장날이 축제 기간과 같은 날을 축제 × 시장 × 날짜 건으로 산출해 TOP 5·찾기·상세에 넘긴다. 사용자나 운영자가 직접 쓰는 화면은 없다. 장날 정의(상설장 포함 D-4, 정기장 끝자리 방식 D-29), 5km 판정(D-5), 좌표 없는 시장 처리(D-16)는 이 영역 기능의 규칙이며 따로 기능으로 두지 않는다. 수집 시점·주기와 변경·취소 반영은 D-27에서 정한다. 엑셀 파일 적재는 없다(D-3).

수락 기준

  • ☐ 축제 데이터는 관광공사 KorService2에서, 시장 데이터는 전통시장 API에서 가져오며 엑셀 파일은 쓰지 않는다(D-3).
  • ☐ 산출 결과의 각 건은 축제 × 시장 × 날짜이고(D-10), 시장은 축제 좌표(mapx·mapy) 5km 이내이며(D-5), 날짜는 축제 기간 안이면서 그 시장의 장날이다(상설장 포함 D-4).
  • ☐ 개설주기 「1일+6일」인 시장은 끝자리가 1·6인 날(1·6·11·16·21·26일)만 장날로 계산된다(D-29).
  • ☐ 관광공사에서 축제 일정이 바뀌면 D-27에서 정한 시점에 산출 결과에 반영된다.

기능

ID기능중요도설명역할디바이스
F-DAT02축제·시장 데이터 가져오기high시스템이 관광공사 행사정보 조회(searchFestival2)·상세 조회(detailIntro2)로 축제 데이터를, 전통시장 API로 시장명·개설주기·위도·경도를 가져온다. 미리 받아 둘지 요청마다 부를지, 주기와 변경·취소 반영 시점은 D-27을 따른다.해당 없음(시스템 처리)해당 없음
F-DAT03겹치는 날 산출high시스템이 시장 개설주기로 장날 달력을 만들고(상설장 포함 D-4, 정기장 끝자리 방식 D-29), 축제 좌표 5km 안(D-5) 시장의 장날이 축제 기간과 같은 날을 축제 × 시장 × 날짜 건(D-10)으로 만든다. 결과는 TOP 5 후보 산출(F-TOP03)과 찾기(R-SRC)·상세(R-DTL)에 쓰인다. 좌표 없는 시장은 D-16을 따른다.해당 없음(시스템 처리)해당 없음

PRD 리스크의 (제안) 항목 — 기능이 아닌 슬롯 후보

PRD 리스크의 (제안)은 확정이 아니므로 기능으로 만들지 않고, 다음 단계(기능 상세)에서 해당 슬롯의 후보로 다룬다.

PRD (제안)슬롯 후보관련 결정
후보가 5건 미만이면 있는 건수만 보여 주고 「이번 달은 N건」이라고 알리며, 운영자는 검수 때 후보 수를 먼저 확인한다F-TOP01 display, F-TOP03 exceptions, F-TOP02 displayD-26
상세에 데이터 기준 시점을 표시한다F-DTL01 display (F-TOP01·F-SRC02 display도 검토)D-27
상세에 개최 장소(eventplace)와 주소를 함께 보여 실제 위치를 확인하게 한다F-DTL01 displayD-5
대표 이미지가 없는 축제는 기본 이미지로 대신한다F-DTL01 display (목록에 이미지를 보이면 F-TOP01·F-SRC02 display)—
외부 API 조회 실패 시 마지막으로 받은 데이터와 기준 시점을 보여 준다F-DAT02 exceptions, F-DTL03 exceptions·displayD-27
좌표 없는 시장은 5km 판정에서 빼고 노출하지 않는다F-DAT03 rulesD-16
첫 화면은 TOP 5 중심으로 단순하게 둔다F-TOP01 displayD-12

범위 밖

  • 알림 — 브리프·PRD에서 범위 밖이다.
  • 결제·쿠폰 — 브리프·PRD에서 범위 밖이다.
  • 저장(겹치는 날 저장과 「저장한 날」 목록) — D-9에서 저장 없이 조회수만 지표로 두기로 했다.

이후 버전으로 미룬 것

  • PRD에 「이후 버전」으로 미룬 항목이 없다. 위의 범위 밖 항목은 이후 버전 후보가 아니라 이번 기획에서 다루지 않는 것이다.

결정 필요

  • 반영한 결정: D-3(변경: 관광공사 KorService2 + 전통시장 API, 엑셀 안 씀), D-4, D-5, D-7, D-9, D-10, D-11, D-13, D-14, D-25, D-28(찾기 기간: 오늘부터 3개월), D-29
  • 보류(반영하지 않음): D-1, D-2 / D-3 변경으로 무효: D-6, D-8, D-17, D-19, D-24
  • 열린 질문(모두 차단 아님): D-12(F-ENT01), D-15(F-DTL03), D-16(F-DAT03), D-18(F-TOP01), D-20(F-TOP03·F-TOP01), D-21(F-TOP02), D-22(F-DTL02), D-23(F-SRC02), D-26(F-TOP01·F-TOP03), D-27(F-DAT02·F-DTL03·F-TOP02), D-30(F-TOP03), D-31(F-DTL03)
  • 새 질문: D-32(F-TOP01), D-33(F-TOP01), D-34(F-TOP02), D-35(F-SRC01), D-36(F-SRC01), D-37(F-SRC02·F-DAT03), D-38(F-TOP02 운영자 알림)

폐기한 ID

  • F-DAT01 「축제 데이터 반영과 겹치는 날 산출」 — 개발팀이 배포 때 축제 엑셀을 반영하는 기능(D-24)이었다. D-3 변경으로 엑셀 적재가 없어지고 D-24가 무효가 되어 의미가 바뀌었으므로 폐기한다. 데이터 수집은 F-DAT02, 겹치는 날 산출은 F-DAT03이 새로 맡는다.

단계 4 · 승인됨

기능 명세

docs/03-feature-specs/

요구사항 영역마다 파일 하나입니다. 기능마다 9개 슬롯(선행조건·트리거·동작·결과·예외·표시·권한·규칙·데이터)을 채웠습니다. 영역을 눌러 펼쳐 보세요.

R-ENT R-ENT 놀이터에서 서비스 진입 — 기능 상세 명세

단계: featureSpecs · 근거: docs/02-feature-map.md, docs/01-prd.md, docs/decisions.md(결정됨 행), docs/ref-hanaoneq-ia.md · 작성일: 2026-11-14 · 수정일: 2026-11-15(D-39 결정 반영)

사용자가 하나원큐 홈 바로가기 → 「놀이터」 → 여행 탭(화면 24) 안의 카드 하나를 눌러 이 서비스의 첫 화면(이번 달 겹치는 날 TOP 5)으로 들어간다(D-12). 카드는 여행 탭의 기존 카드 뒤 마지막에 둔다(D-39). 로그인하지 않은 사용자도 들어갈 수 있다(D-13). 홈 배너·AI 검색 같은 다른 진입점은 두지 않는다(D-12).


F-ENT01 놀이터 진입점

항목내용
중요도high
역할사용자
디바이스하나원큐 앱(모바일)

설명 — 사용자가 놀이터 여행 탭(화면 24)의 기존 카드 뒤 마지막에 있는 이 서비스 카드를 눌러 서비스 첫 화면인 「이번 달 겹치는 날 TOP 5」(F-TOP01)로 들어간다(D-39). 로그인 여부와 관계없이 들어갈 수 있다. 카드 밖의 다른 진입점(홈 배너, AI 검색, 놀이터 새 하위 탭)은 포함하지 않는다.

도입 이유 — 사용자가 별도 앱이나 사이트를 찾지 않고, 이미 쓰는 하나원큐 앱의 비금융 영역(놀이터)에서 바로 축제·장날 겹치는 날을 찾게 한다. 새 탭을 늘리지 않고 기존 여행 탭 안에 두어 앱 무게와 5060 인지 부하를 늘리지 않는다(PRD 리스크).

성공 기준 — 진입점 자체의 측정 지표는 따로 두지 않는다. 이 진입점을 거친 TOP 5 항목 상세 진입 횟수가 PRD 핵심 지표(TOP 5 월 조회수, D-18)로 이어진다. 목표 수치는 두지 않는다(D-1 보류).

슬롯

슬롯내용
선행조건- 사용자가 하나원큐 앱에서 홈 바로가기 → 놀이터 → 여행 탭(화면 24)에 들어와 있어야 한다.
- 로그인 상태는 선행조건이 아니다(D-13).
트리거- 놀이터 여행 탭(화면 24) 안의 이 서비스 카드를 누른다.
동작- 여행 탭을 열 때 이 서비스 카드를 기존 카드 뒤 마지막 자리에 보여 준다(D-39).
- 사용자가 카드를 누르면 서비스 첫 화면(F-TOP01)을 연다.
- 첫 화면의 내용(게시된 TOP 5, 준비 중 안내 등)은 F-TOP01이 정한다.
결과- 사용자가 서비스 첫 화면 「이번 달 겹치는 날 TOP 5」를 본다.
- 진입 자체로 저장·변경되는 데이터는 없다.
예외- 이번 달 TOP 5가 아직 게시되지 않았어도 카드는 그대로 보이고, 누르면 첫 화면에서 「이번 달 TOP 5 준비 중」 안내를 본다(D-33, F-TOP01).
- 첫 화면을 불러오는 중 네트워크가 끊기면 첫 화면의 실패 표시(F-TOP01 표시, D-55)를 따른다.
- 카드를 연달아 눌러도 첫 화면은 하나만 열린다.
표시- 카드는 여행 탭의 기존 카드 뒤 마지막에 둔다(D-39).
- 카드 제목은 「축제도 보고 장도 보는 날」, 설명은 「이번 달 축제×장날 TOP 5」이다(D-39).
- 카드는 로그인·비로그인 사용자에게 똑같이 보인다(D-13).
권한&접근- 사용자는 로그인하지 않아도 카드를 보고 눌러 첫 화면에 들어갈 수 있다(D-13).
- 로그인 사용자와 비로그인 사용자의 차이는 없다.
- 운영자 역할은 이 기능을 쓰지 않는다.
비즈니스 규칙- 진입점은 놀이터 여행 탭(화면 24) 안 카드 하나뿐이다(D-12).
- 카드 위치는 여행 탭의 기존 카드 뒤 마지막이고, 문구는 위 표시 슬롯의 제목·설명으로 고정한다(D-39).
- 놀이터 새 하위 탭, 홈 배너, AI 검색에는 진입점을 두지 않는다(D-12).
데이터해당 없음

반영한 결정

  • D-39: 카드는 여행 탭의 기존 카드 뒤 마지막에 두고, 제목 「축제도 보고 장도 보는 날」·설명 「이번 달 축제×장날 TOP 5」로 한다(추천안과 다르게 「기존 카드 뒤 마지막」으로 정해졌다).
  • D-55: 첫 화면 불러오기 실패 표시는 F-TOP01의 공통 실패 문구를 따른다.

열린 질문

없음

R-TOP R-TOP 이번 달 겹치는 날 TOP 5 — 기능 상세 명세

단계: featureSpecs · 근거: docs/02-feature-map.md, docs/01-prd.md, docs/decisions.md(결정됨 행) · 작성일: 2026-11-14 · 수정일: 2026-11-15(D-40~D-47·D-55·D-56·D-61~D-63·D-65·D-66 결정과 검토 지적 반영)

시스템이 매달 1일 그 달(달력 월)의 겹치는 날 가운데 TOP 5 후보 20건을 자동 산출하고(D-43), 운영자가 하나원큐 기존 운영 관리 시스템(CMS)에서 검수자 검수 → 게시 승인자 승인의 2단계로 게시하면(D-11, D-21, D-46) 사용자가 서비스 첫 화면에서 이를 보고 상세로 들어간다. 순위는 정기장 장날과 겹치는 건 우선 → 축제 기간이 짧은 순 → 날짜가 빠른 순 → 축제–시장 거리가 가까운 순이다(D-7, D-25, D-30, D-42). 같은 축제는 한 칸만 둔다(D-20). 저장(D-9), 사용자 대상 알림, 결제·쿠폰은 포함하지 않는다.


F-TOP01 이번 달 TOP 5 보기

항목내용
중요도high
역할사용자
디바이스하나원큐 앱(모바일)

설명 — 사용자가 서비스 첫 화면에서 운영자가 게시한 이번 달 겹치는 날 TOP 5를 순위대로 보고, 항목을 눌러 그 겹치는 날의 상세(R-DTL)로 이동한다. 각 항목은 겹치는 날 한 건(축제 × 시장 × 날짜, D-10)이다. 첫 화면 위쪽에는 모든 상태에서 「날짜·지역으로 찾기」 고정 버튼이 있다(D-62). 로그인하지 않아도 볼 수 있다(D-13). 순위 계산(F-TOP03), 검수·게시(F-TOP02), 조회수 집계(F-DTL01), 저장(D-9)은 포함하지 않는다.

도입 이유 — 사용자가 축제 일정과 시장 개설주기를 따로 찾아 비교하지 않고, 이번 달에 「축제도 보고 장도 보는」 드문 날을 첫 화면에서 바로 고르게 한다.

성공 기준 — PRD 핵심 지표 「TOP 5 콘텐츠 월 조회수」를 잰다. 한 번의 조회는 TOP 5 항목의 상세 진입 1회이며, 집계는 상세를 연 시점에 F-DTL01이 한 곳에서 한다(D-18). 목표 수치는 두지 않는다(D-1 보류).

슬롯

슬롯내용
선행조건- 사용자가 놀이터 진입점(F-ENT01)으로 서비스에 들어와 있어야 한다.
- 항목 목록을 보려면 이번 달(달력 월) TOP 5가 게시돼 있어야 한다(D-11, D-46). 게시 전이면 준비 중 안내를 보여 준다(D-33).
트리거- 놀이터 여행 탭의 서비스 카드(F-ENT01)를 눌러 첫 화면이 열린다.
- 상세(R-DTL)나 찾기(R-SRC)에서 뒤로 돌아와 첫 화면이 다시 보인다.
- 첫 화면의 TOP 5 항목을 누른다(상세 이동).
동작- 첫 화면을 열면 모든 상태(게시됨·준비 중·0건·실패)에서 TOP 5 위쪽에 고정 버튼 「날짜·지역으로 찾기」를 보여 준다(D-62, D-55). 이 버튼을 누르면 찾기(F-SRC01)를 연다.
- 오늘이 속한 달의 게시된 TOP 5를 불러오고, 불러오는 동안 TOP 5 자리에 스켈레톤(목록 자리 표시)을 보여 준다(D-41).
- 게시된 TOP 5가 있으면 게시된 순위대로 최대 5건을 게시 당시 복사해 둔 정보로 보여 준다(D-61).
- 오늘보다 앞선 날짜의 항목은 목록에 그대로 두고 「지난 날」로 표시한다(D-32).
- 게시된 TOP 5가 없으면 「이번 달 TOP 5 준비 중」 안내를 보여 준다(D-33).
- 그 달이 0건으로 게시돼 있으면 「이번 달은 겹치는 날이 없어요」를 보여 준다(D-41).
- 사용자가 항목을 누르면 그 겹치는 날 한 건(축제 contentid + 시장 ID + 날짜)의 상세(F-DTL01)를 열고, 진입 경로 「TOP 5」와 게시 대상 월을 함께 넘긴다. 조회수는 이 기능에서 세지 않고 F-DTL01이 상세를 연 시점에 센다(D-18).
결과- 사용자가 이번 달 게시된 TOP 5를 순위대로 보거나, 게시 전이면 준비 중 안내를, 0건 게시면 0건 안내를 본다.
- 항목을 누르면 상세가 열린다. 이 기능에서 저장·변경되는 데이터는 없다.
예외- 게시된 건수가 1~4건이면 있는 건수만 보여 주고 「이번 달은 N건」이라고 알린다(D-26).
- 그 달 후보가 0건이면 운영자가 0건으로 게시하고, 첫 화면은 「이번 달은 겹치는 날이 없어요」와 찾기 고정 버튼을 보여 준다(D-41, D-62).
- 매달 1일 새 달로 바뀐 뒤 새 TOP 5가 게시되기 전에는 지난달 TOP 5를 보여 주지 않고 준비 중 안내를 보여 준다(D-33).
- 게시된 항목이 관광공사·전통시장 데이터에서 취소·변경돼도, 운영자가 내리거나 고쳐 다시 게시하기 전까지(D-27, D-44, F-TOP02) 사용자 화면은 게시 당시 복사해 둔 정보 그대로이다(D-61).
- TOP 5를 불러오다 네트워크가 실패하면 공통 실패 문구와 [다시 시도] 버튼을 보여 주고, 찾기 고정 버튼은 그대로 보여 준다(D-55, D-62).
- 같은 항목을 여러 번 눌러 상세에 들어가는 경우의 조회수 처리는 F-DTL01을 따른다(D-18).
표시- TOP 5 위쪽에 「날짜·지역으로 찾기」 고정 버튼을 모든 상태(게시됨·준비 중·0건·실패)에서 보여 준다(D-62, D-55).
- 각 항목에 순위, 축제명, 날짜(요일), 시장명, 정기장/상설장 구분, 대표 이미지를 보여 준다(D-40).
- 대표 이미지가 없으면 기본 이미지를 쓰고, 빈 항목은 숨기며, 화면에 「데이터 기준 YYYY-MM-DD」를 보여 준다(D-56). 기준 날짜는 게시 당시 복사해 둔 정보의 수집 날짜이다.
- 지난 날짜의 항목에는 「지난 날」 표시를 붙인다(D-32).
- 로딩 중에는 TOP 5 자리에 스켈레톤을 보여 준다(D-41).
- 1~4건이면 「이번 달은 N건」 안내를 보여 준다(D-26).
- 게시 전에는 「이번 달 TOP 5 준비 중」 안내를 보여 준다(D-33).
- 0건 게시면 「이번 달은 겹치는 날이 없어요」를 보여 준다(D-41).
- 불러오기 실패 시 「정보를 불러오지 못했어요. 잠시 후 다시 시도해 주세요.」와 [다시 시도] 버튼을 보여 준다(D-55).
- 첫 화면은 TOP 5 중심으로 단순하게 두는 것이 PRD 리스크의 (제안)이며, 찾기 고정 버튼 외 다른 요소는 이 명세에 넣지 않는다.
권한&접근- 로그인·비로그인 사용자 모두 게시된 TOP 5를 보고 상세로 들어갈 수 있다(D-13).
- 사용자는 게시되지 않은 후보를 볼 수 없다(D-11).
- 운영자의 검수·게시는 이 기능이 아니라 F-TOP02에서 한다.
비즈니스 규칙- 「이번 달」은 오늘이 속한 달력 월이다(D-11).
- 보여 주는 순서는 게시된 순서이며, 이 순서는 F-TOP03 순위(정기장 우선 → 축제 기간이 짧은 순 → 날짜가 빠른 순 → 축제–시장 거리가 가까운 순, D-7·D-25·D-30·D-42)에서 제외된 후보만 빠진 것이다(D-34).
- 같은 축제는 TOP 5에 한 칸만 나온다(D-20).
- 최대 5건을 보여 준다.
- 「지난 날」은 항목의 날짜가 오늘보다 앞선 경우이다(D-32).
- 정기장/상설장 구분은 시장 개설주기가 「매일」이면 상설장, 아니면 정기장이다(D-4).
- TOP 5 월 조회수는 F-DTL01이 진입 경로가 TOP 5인 상세 진입을 달마다 센 값이다(D-18). 이 기능은 진입 경로만 넘긴다.
데이터- 게시된 TOP 5(F-TOP02의 TopPublication)를 조회한다: 대상 월(YYYY-MM, 필수), 상태(필수), 게시 순위별 항목(순위 1~5, 겹치는 날 건 참조, 게시 당시 복사본) — 필드는 F-TOP02 데이터와 같다.
- 상세로 넘기는 값: 겹치는 날 건 참조(축제 contentid, 시장 ID(Market 참조, F-DAT02), 날짜), 진입 경로(「TOP 5」), 게시 대상 월(YYYY-MM). 조회수 저장 구조(TopViewCount)는 F-DTL01 데이터에서 정한다.

F-TOP02 TOP 5 검수·게시

항목내용
중요도high
역할운영자(검수자, 게시 승인자)
디바이스하나원큐 기존 운영 관리 시스템(CMS)에 추가한 메뉴(D-21)

기능 맵 표기는 미정(D-21)이었으며 D-21 결정으로 채웠다.

설명 — 운영자가 하나원큐 CMS의 새 메뉴에서 매달 1일 자동 산출된 이번 달 TOP 5 후보 20건(F-TOP03, D-43)을 검수하고 게시한다(D-11, D-21). 게시는 검수자가 검수하고 게시 승인자가 승인하는 2단계이다(D-46). 검수 때는 후보를 뺄 수 있고, 빼면 다음 순위 후보가 자동으로 올라온다. 순서는 바꾸지 않는다(D-34). 게시 전 후보와 게시된 건 모두 매일 점검해, 어떤 필드든 바뀌었거나 새 산출에서 없어진 건에 CMS 안 취소·변경 표시를 붙인다(D-27, D-38, D-45, D-63). 하루 1회 수집이 끝내 실패하면 CMS에 실패를 표시한다(D-47). 순위 재계산, 후보의 내용(축제명·날짜 등) 수정, 운영자 외부 알림(메일·메신저)은 포함하지 않는다.

도입 이유 — 자동 산출 결과를 그대로 내보내면 취소된 축제나 부적절한 건이 첫 화면에 오를 수 있다. 운영자가 게시 전에 확인하고 다른 운영자가 승인해 첫 화면 콘텐츠의 정확성을 지킨다(D-11, D-46).

성공 기준 — 매달 그 달의 TOP 5가 게시되어 PRD 핵심 지표(TOP 5 월 조회수, D-18)를 잴 수 있는 상태가 된다. 게시 기한·목표 수치는 두지 않는다(D-1 보류).

슬롯

슬롯내용
선행조건- 운영자가 하나원큐 CMS에 로그인해 이 메뉴의 검수자 권한 또는 게시 승인자 권한을 갖고 있어야 한다(D-46).
- 그 달의 TOP 5 후보 목록이 F-TOP03으로 산출돼 있어야 한다.
트리거- 검수자가 CMS의 TOP 5 검수 메뉴를 연다.
- 게시 승인자가 검수가 끝난 그 달 게시안을 연다.
- 매달 1일 F-TOP03 후보 산출이 끝나면 그 달 후보가 CMS 메뉴에 「검수 대기」로 나타난다.
- 하루 1회 데이터 반영(F-DAT02·F-DAT03) 뒤 게시 전 후보나 게시된 건에 취소·변경이 확인되면 CMS 메뉴 안에 표시된다(D-27, D-38, D-63).
- 하루 1회 수집이 재시도 끝에 실패하면 CMS 메뉴 안에 수집 실패가 표시된다(D-47).
동작- 그 달 후보 목록(최대 20건, D-43)을 순위대로 보여 주고, 현재 상위 5건을 게시 대상으로 표시한다.
- 검수 단계: 검수자가 후보를 빼면 그 후보를 제외 처리하고, 다음 순위 후보를 게시 대상으로 올린다(D-34). 검수자가 검수를 마치면 게시 대상(최대 5건, 0건 포함)을 게시 승인 단계로 넘긴다(D-46).
- 승인 단계: 게시 승인자가 넘어온 게시 대상을 확인하고 승인하면 그 순서대로 게시하고, 사용자 첫 화면(F-TOP01)에 보이게 한다(D-46). 승인하지 않으면 그 게시안을 검수 단계(검수 대기)로 되돌리고, 검수자가 다시 검수해 넘긴다(D-65).
- 게시할 때 각 건의 표시 정보(축제명, 날짜, 시장명, 시장 주소, 정기장/상설장 구분, 대표 이미지, 수집 날짜)를 게시 당시 값으로 복사해 둔다(D-61).
- 매일 데이터 반영 뒤 게시 전 후보와 게시된 각 건을 새 산출 결과·새 수집 데이터와 비교한다. 새 산출에서 그 건(축제 × 시장 × 날짜)이 없어졌거나, 그 건의 축제·시장 데이터에 F-DAT02가 그날 「필드 변경」을 기록했으면(어떤 필드든) 취소·변경 표시를 붙인다(D-45, D-63).
- 게시된 건에 표시가 붙으면 검수자가 그 건을 내리거나 고친다(D-65). 내리면 같은 달 남은 후보 중 다음 순위가 자동으로 게시 대상에 올라오고, 변경은 최신 산출로 같은 건을 확인한다(D-44). 검수자가 처리한 게시안은 게시 승인 단계로 넘어가며, 게시 승인자가 승인해야 다시 게시된다(D-44, D-65).
- 하루 1회 수집이 재시도 끝에 실패하면 전날 데이터로 산출됐다는 수집 실패 표시를 CMS 메뉴에 보여 준다(D-47).
결과- 승인 뒤 그 달의 TopPublication이 「게시됨」이 되고, 게시된 건들이 사용자 첫 화면에 순위대로 보인다.
- 제외한 후보는 「제외」 상태로 남아 그 달 게시에서 빠진다.
- 취소·변경 표시가 붙은 후보·게시 건은 운영자가 처리할 때까지 CMS 메뉴에 표시가 남는다.
예외- 후보가 1~4건이면 있는 건수만 게시할 수 있고, 사용자 화면에는 「이번 달은 N건」이 보인다(D-26).
- 후보를 빼서 남은 후보가 5건 미만이 되면 남은 건수만 게시 대상이 된다(D-26, D-34).
- 후보가 0건인 달은 0건으로 게시하며, 사용자 화면에는 「이번 달은 겹치는 날이 없어요」가 보인다(D-41). 0건 게시도 검수 → 승인 2단계를 거친다(D-46).
- 게시 승인이 끝나지 않으면 사용자 첫 화면은 계속 「이번 달 TOP 5 준비 중」을 보여 준다(D-33).
- 새 달이 되면 사용자 첫 화면은 새 달의 게시만 보여 주므로, 지난달 후보는 사용자 화면에 쓰이지 않는다(D-11 달력 월, D-33).
- 게시 승인자가 승인하지 않음 → 게시안을 검수 단계(검수 대기)로 되돌리고, 검수자가 다시 검수해 넘긴다(D-65). 처음 게시하는 달이면 사용자 첫 화면은 계속 「이번 달 TOP 5 준비 중」을 보여 준다(D-33).
- 게시된 건을 내리거나 고침 → 검수자가 맡고, 다시 게시도 게시 승인자의 승인을 거친다(D-65). 내린 뒤 올라오는 다음 순위 건도 승인 없이 바로 게시하지 않는다(D-65).
- 동시 작업: 검수는 검수자가, 게시 승인은 게시 승인자가 각 단계를 맡는다(D-46). 한 운영자는 두 권한을 함께 가질 수 없다(D-66).
- 같은 역할의 운영자 여럿이 같은 달을 동시에 다룸 → 먼저 저장한 내용을 기준으로 하고, 뒤에 저장하려는 운영자에게는 최신 상태를 다시 불러오게 한다(D-66).
- 게시 중 네트워크가 실패하면 게시 전 상태를 유지하고, 게시 승인자가 다시 승인해야 한다.
- 검수 중인 후보가 매일 데이터 반영으로 새 산출에서 사라지거나 필드가 바뀌면 그 후보에 취소·변경 표시를 붙인다(D-45, D-63).
- 시장의 이름이나 주소가 바뀌면 새 시장(새 시장 ID)으로 보므로(D-61), 이전 시장 ID의 건은 새 산출에서 없어진 건으로 표시된다. 게시된 TOP 5는 게시 당시 복사해 둔 정보로 계속 보인다(D-61).
- 하루 1회 수집이 끝내 실패하면 전날 데이터로 산출하므로 그날은 새 취소·변경 표시가 생기지 않을 수 있고, CMS에는 수집 실패를 표시한다(D-47).
표시- CMS 메뉴에 그 달 후보 수와 후보 목록(순위, 게시 대상 여부, 제외 여부, 취소·변경 표시)과 진행 단계(검수 대기·승인 대기·게시됨)를 보여 준다(D-46).
- 후보가 5건 미만이면 그 건수를 CMS 화면에서 알 수 있게 한다(D-26).
- 게시 전 후보와 게시된 건 중 취소·변경된 건은 CMS 메뉴 안에서 표시로 알린다. 메일·메신저 같은 외부 알림은 보내지 않는다(D-38, D-63).
- 하루 1회 수집이 재시도 끝에 실패하면 CMS 메뉴 안에 수집 실패와 전날 데이터로 산출했다는 사실을 표시한다(D-47).
- CMS 화면의 버튼·안내 문구는 하나원큐 CMS 화면 구성에 맞춰 정하며, 이 명세에서 정하지 않는다.
권한&접근- 이 메뉴의 권한은 검수자 권한과 게시 승인자 권한 2종이다(D-46). 사용자(로그인·비로그인)는 접근할 수 없다(D-21).
- 검수자는 후보를 빼고 검수를 마쳐 게시 승인 단계로 넘길 수 있다(D-34, D-46). 게시된 건의 내리기·변경도 검수자가 맡는다(D-65).
- 게시 승인자는 넘어온 게시 대상을 승인해 게시하거나, 승인하지 않고 검수 단계로 되돌릴 수 있다(D-46, D-65).
- 어느 역할도 순서를 바꾸거나 후보에 없는 건을 추가하거나 후보의 축제·시장·날짜 내용을 고칠 수 없다(D-34).
- 한 운영자는 검수자 권한과 게시 승인자 권한을 함께 가질 수 없다(D-66).
- 같은 역할의 운영자 여럿이 같은 달을 다룰 수 있으며, 먼저 저장한 내용이 기준이 되고 뒤에 저장하려는 운영자는 최신 상태를 다시 불러온다(D-66).
비즈니스 규칙- 순위는 다시 계산하지 않고 F-TOP03의 순위를 따른다(D-34).
- 후보를 빼면 다음 순위가 자동으로 올라오고, 순서는 바꾸지 않는다(D-34).
- 게시하는 건은 최대 5건이다.
- 같은 축제는 한 칸만 둔다(D-20). 후보 목록에는 축제마다 대표 건 하나만 있으므로, 대표 건을 빼면 다음 순위의 다른 축제 건이 올라온다(D-20, D-34).
- 게시 전 후보는 사용자에게 보이지 않는다(D-11).
- 게시는 검수자 검수 → 게시 승인자 승인의 2단계를 거친다(D-46). 승인하지 않으면 검수로 되돌리고, 게시된 건의 내리기·변경 뒤 다시 게시도 같은 2단계를 거친다(D-65).
- 취소·변경 점검 범위는 게시 전 후보와 게시된 건 모두이고, 매일 데이터 반영 뒤 점검한다(D-63).
- 취소·변경은 새 산출에서 그 건이 없어진 경우와, 그 건의 축제·시장 필드 중 어떤 필드든 바뀐 경우이다(D-45).
- 게시된 건의 취소·변경은 CMS 안 표시로 알려 내리거나 고친다(D-27, D-38, D-44).
- 게시된 TOP 5는 게시 당시 정보를 복사해 두고 사용자 화면에 그 복사본을 보여 준다(D-61).
데이터- TopCandidate: 대상 월(YYYY-MM, 필수), 순위(정수 1~20, 필수, D-43), 겹치는 날 건 참조(축제 contentid + 시장 ID(Market 참조, F-DAT02) + 날짜, 필수), 상태(후보·제외, 필수, 기본값 후보), 취소·변경 표시(불리언, 필수, 기본값 아님), 표시 시각(일시, 선택).
- TopPublication: 대상 월(YYYY-MM, 필수), 상태(검수 대기·승인 대기·게시됨, 필수, 기본값 검수 대기, D-46), 검수한 운영자(CMS 계정 ID, 검수 완료 시 필수), 검수 완료 일시(일시, 검수 완료 시 필수), 게시 승인한 운영자(CMS 계정 ID, 게시 시 필수), 게시 일시(일시, 게시 시 필수), 게시 항목(0~5건).
- 수정 게시안(D-67): 이미 「게시됨」인 달에서 검수자가 내리기·변경을 처리하면, 게시된 TopPublication은 「게시됨」 그대로 두고 수정 게시안을 따로 만든다. 수정 게시안은 대상 월(YYYY-MM, 필수), 원본 TopPublication 참조(필수), 상태(승인 대기·반려, 필수), 검수한 운영자(CMS 계정 ID, 필수), 게시 항목(0~5건, 게시 항목과 같은 필드)을 가진다. 승인되면 원본의 게시 항목을 이것으로 바꾸고, 반려되면 검수로 되돌린다(D-65). 승인 전까지 첫 화면은 원본의 게시 당시 복사본을 보여 준다.
- 게시 항목(TopPublication 하위): 순위(정수 1~5, 필수), 겹치는 날 건 참조(축제 contentid + 시장 ID + 날짜, 필수), 취소·변경 표시(불리언, 필수, 기본값 아님), 게시 당시 복사본(D-61): 축제명(문자열, 필수), 날짜(YYYY-MM-DD, 필수), 시장명(문자열, 필수), 시장 주소(도로명, 없으면 지번, 문자열), 장날 구분(상설·정기, 필수), 대표 이미지(URL, 빈 값 가능), 수집 날짜(날짜, 필수).
- CollectionStatus(F-DAT02 기록을 읽기만 한다): 수집 일자, 결과(성공·실패), 산출에 쓴 데이터의 수집 날짜(D-47).

F-TOP03 이번 달 TOP 5 후보 자동 산출

항목내용
중요도high
역할해당 없음(시스템 처리)
디바이스해당 없음

설명 — 시스템이 매달 1일 그 달(달력 월) 날짜의 겹치는 날(F-DAT03 결과)을 순위 규칙으로 줄 세우고, 같은 축제는 한 칸만 남긴 순위 후보 목록 20건을 만들어 운영자 검수(F-TOP02)로 넘긴다(D-43). 게시는 하지 않는다(D-11). 겹치는 날 자체의 계산(장날·5km 판정)은 F-DAT03이, 매일 취소·변경 점검은 F-TOP02가 맡는다.

도입 이유 — 상설장 포함(D-4)으로 겹치는 날이 많아져도, 드물게 오는 정기장 장날과 짧은 축제를 앞에 두는 같은 규칙으로 매달 후보를 만들어 「겹치는 날은 드물다」는 희소성을 지키고 운영자의 선정 부담을 줄인다.

성공 기준 — 매달 1일 그 달의 후보 목록이 순위 규칙(D-7, D-25, D-30, D-42)과 같은 축제 한 칸 규칙(D-20)대로 최대 20건(D-43) 만들어져 F-TOP02에서 검수할 수 있다. 목표 수치는 두지 않는다(D-1 보류).

슬롯

슬롯내용
선행조건- 그달 1일의 하루 1회 데이터 가져오기(F-DAT02)와 겹치는 날 산출(F-DAT03)이 끝나 있어야 한다(수집이 끝내 실패하면 전날 데이터로 산출한 결과, D-47).
트리거- 매달 1일 스케줄로 시작한다(D-11). 그날 새벽 4시(한국 시간) 수집(D-47)과 이어지는 F-DAT03 산출이 끝난 뒤 실행한다.
동작- F-DAT03 결과 가운데 날짜가 그 달 1일부터 말일까지인 건을 모은다.
- 각 건을 정기장 장날과 겹치는 건 먼저(D-7), 같으면 축제 기간이 짧은 건 먼저(D-25), 같으면 날짜가 빠른 건 먼저(D-30), 같으면 축제–시장 거리가 가까운 건 먼저(D-42) 줄 세운다.
- 같은 축제의 건이 여럿이면 순위가 가장 높은 건 하나만 남기고 나머지를 뺀다(D-20).
- 남은 목록의 상위 20건에 1부터 순위를 매겨 그 달 TopCandidate로 저장하고(D-43), F-TOP02 CMS 메뉴에 「검수 대기」로 넘긴다.
결과- 그 달의 순위 후보 목록(TopCandidate, 최대 20건)과 「검수 대기」 상태의 TopPublication이 생긴다.
- 사용자 첫 화면은 게시 승인 전까지 「이번 달 TOP 5 준비 중」을 보여 준다(D-33).
예외- 그 달 후보가 20건 미만이면 있는 건수만 넘긴다. 5건 미만이면 사용자 화면에 「이번 달은 N건」이 보인다(D-26).
- 그 달 후보가 0건이면 0건 목록을 「검수 대기」로 넘기고, 운영자가 0건으로 게시한다(D-41).
- 1일 데이터 가져오기가 재시도(30분 간격 3회) 끝에 실패하면 전날 데이터로 산출한 F-DAT03 결과로 후보를 만든다(D-47).
- 같은 달 산출이 두 번 실행되면(재시도 등) 그 달의 후보 목록은 하나만 남긴다. 이미 게시된 달은 게시 내용을 바꾸지 않고, 게시 뒤 변경은 F-TOP02의 표시로만 다룬다(D-27, D-38).
- 그 달 중간에 새로 등록된 축제나 바뀐 일정은 이미 만든 후보 목록에 다시 순위를 매겨 넣지 않는다. 후보와 게시된 건의 취소·변경은 F-TOP02가 매일 점검해 표시한다(D-27, D-34, D-63).
표시해당 없음
권한&접근- 시스템이 자동으로 실행하며, 사용자와 운영자가 직접 실행하지 않는다.
- 산출된 후보는 운영자(검수자·게시 승인자)만 CMS에서 볼 수 있고 사용자에게는 보이지 않는다(D-11, D-46).
비즈니스 규칙- 「그 달」은 실행일이 속한 달력 월이다(D-11). 오늘 이전 날짜도 그 달이면 후보에 포함한다(D-32와 일관).
- 1순위 기준: 정기장 장날과 겹치는 건(시장 개설주기가 「매일」이 아닌 건)이 상설장 건보다 앞선다(D-7, D-4).
- 2순위 기준: 축제 기간(종료일 − 시작일 + 1일)이 짧은 건이 앞선다(D-25).
- 3순위 기준: 날짜가 빠른 건이 앞선다(D-30).
- 4순위 기준: 축제–시장 거리(F-DAT03이 계산한 직선 거리)가 가까운 건이 앞선다(D-42). 찾기(F-SRC02) 정렬과 같다(D-53).
- 같은 축제(같은 contentid)는 한 칸만 두며, 위 순위가 가장 높은 축제 × 시장 × 날짜를 대표로 올린다(D-20).
- 검수로 넘기는 후보는 최대 20건이다(D-43).
- 순위는 산출 때 한 번 정하고, 검수에서 다시 계산하지 않는다(D-34).
데이터- 입력: F-DAT03의 겹치는 날 건(Overlap: 축제 contentid, 시장 ID(Market 참조, F-DAT02), 날짜, 장날 구분(상설·정기), 축제 기간 일수, 축제–시장 거리).
- 출력: TopCandidate(F-TOP02 데이터와 같다, 최대 20건), TopPublication(상태 검수 대기).

반영한 결정

  • D-40: TOP 5 항목에 축제명·날짜(요일)·시장명·정기장/상설장 구분·대표 이미지를 보여 준다(F-TOP01).
  • D-41: 로딩은 스켈레톤, 0건인 달은 0건으로 게시하고 「이번 달은 겹치는 날이 없어요」와 찾기 진입을 보여 준다(F-TOP01·F-TOP02·F-TOP03).
  • D-42: 마지막 동률 기준은 축제–시장 거리가 가까운 순이다(F-TOP03).
  • D-43: 검수로 넘기는 후보는 20건이다(추천안 10건과 다르게 정해졌다, F-TOP03·F-TOP02).
  • D-44: 내리면 다음 순위가 자동으로 올라와 다시 게시되고, 변경은 최신 산출로 같은 건을 확인해 다시 게시한다(F-TOP02).
  • D-45: 어떤 필드든 바뀌면 취소·변경으로 표시한다(새 산출에서 없어진 경우 + 축제·시장 필드 변경, 추천안과 다르게 정해졌다, F-TOP02).
  • D-46: 검수자와 게시 승인자를 나눈 2단계, 권한 2종이다(추천안과 다르게 정해졌다, F-TOP02).
  • D-47: 매일 새벽 4시 수집, 30분 간격 3회 재시도, 실패하면 전날 데이터로 산출하고 CMS에 실패를 표시한다(F-TOP02·F-TOP03).
  • D-55: 실패 문구 「정보를 불러오지 못했어요. 잠시 후 다시 시도해 주세요.」+[다시 시도], 찾기 진입 버튼 「날짜·지역으로 찾기」(F-TOP01).
  • D-56: 빈 항목 숨김, 이미지가 없으면 기본 이미지, 「데이터 기준 YYYY-MM-DD」 표시(F-TOP01).
  • D-61: 시장은 시장명+도로명 주소(없으면 지번)로 알아보고, 바뀌면 새 시장으로 보며, 게시된 TOP 5는 게시 당시 정보를 복사해 둔다(F-TOP01·F-TOP02).
  • D-62: 모든 상태에서 TOP 5 위쪽에 찾기 고정 버튼을 둔다(F-TOP01).
  • D-63: 게시 전 후보와 게시된 건을 모두 매일 점검한다(F-TOP02·F-TOP03).
  • D-65: 승인하지 않으면 검수로 되돌리고, 내리기·변경은 검수자가 맡아 다시 게시도 승인을 거친다(F-TOP02 action·exceptions·permissions·rules).
  • D-66: 검수자·게시 승인자 겸임 불가, 같은 역할끼리는 먼저 저장한 내용 기준으로 뒤 사람이 최신 상태를 다시 불러온다(F-TOP02 permissions·exceptions).
  • D-67: 게시된 달의 내리기·변경은 「게시됨」을 그대로 두고 수정 게시안을 따로 「승인 대기」로 둔다(F-TOP02 데이터).

열린 질문

없음

R-SRC R-SRC 날짜·지역으로 겹치는 날 찾기 — 기능 상세 명세

단계: featureSpecs · 근거: docs/02-feature-map.md, docs/01-prd.md, docs/decisions.md(결정됨 행) · 작성일: 2026-11-14 · 수정일: 2026-11-15(D-49~D-56·D-62·D-64 결정과 검토 지적 반영)

사용자가 서비스 첫 화면의 고정 버튼 「날짜·지역으로 찾기」(D-62)로 들어와 지역(시도→시군구)과 날짜 기간(오늘부터 3개월 뒤 같은 날까지, D-50)을 골라 그 조건에 맞는 겹치는 날(축제 × 시장 × 날짜) 목록을 보고, 그중 하나의 상세(R-DTL)로 들어간다. 내 위치 기준 반경 검색과 찾은 결과 저장(D-9)은 포함하지 않는다.


F-SRC01 날짜·지역 조건 선택

항목내용
중요도high
역할사용자
디바이스하나원큐 앱(모바일)

설명 — 사용자가 찾을 지역(시도→시군구)과 날짜 기간(시작일~종료일)을 고르거나 바꾼다. 지역은 전국 행정구역 고정 목록에서 시도를 먼저 고르고 그 시도의 시군구를 고르며, 시군구는 「전체」도 고를 수 있다(D-14, D-36, D-51). 날짜는 오늘부터 3개월 뒤 같은 날까지에서 기간으로 고른다(D-28, D-35, D-50). 「찾기」 버튼으로 실행한다(D-52). 결과 목록을 보여 주는 일은 F-SRC02가 맡는다. 내 위치 기준 반경 검색은 포함하지 않는다.

도입 이유 — TOP 5는 이번 달 전국 기준 다섯 건뿐이라, 사용자가 가려는 지역과 날짜에 맞는 겹치는 날을 직접 좁혀 볼 방법이 필요하다.

성공 기준 — 미정. 찾기에 해당하는 PRD 핵심 지표가 없고(PRD 핵심 지표는 TOP 5 월 조회수, D-18), 목표 수치도 두지 않는다.

슬롯

슬롯내용
선행조건- 사용자가 놀이터 진입점(F-ENT01)으로 서비스에 들어와 첫 화면(F-TOP01)을 보고 있다.
- 로그인 여부는 따지지 않는다(D-13).
- 전국 행정구역 고정 목록(시도·시군구, 일반구는 시 단위로 묶음)이 준비되어 있다(D-51).
트리거- 서비스 첫 화면 TOP 5 위쪽의 고정 버튼 「날짜·지역으로 찾기」를 누른다. 이 버튼은 게시됨·준비 중·0건·실패 모든 상태에서 보인다(D-62, D-55).
동작- 찾기 화면을 처음 열면 지역은 비워 두고, 기간은 오늘부터 오늘의 3개월 뒤 같은 날까지로 채워 둔다(D-52, D-50).
- 시도 목록을 보여 주고 사용자가 시도 하나를 고르게 한다.
- 고른 시도의 시군구 목록을 맨 앞의 「전체」와 함께 보여 주고 사용자가 하나를 고르게 한다(D-36).
- 시도를 바꾸면 이미 고른 시군구 선택을 지우고 새 시도의 시군구 목록을 보여 준다.
- 오늘부터 3개월 뒤 같은 날까지의 날짜만 고를 수 있는 달력을 보여 주고 사용자가 시작일과 종료일을 고르게 한다(D-35, D-50).
- 사용자가 「찾기」 버튼을 누르면 조건을 확인하고 찾기를 실행해 F-SRC02로 결과를 넘긴다(D-52).
- 결과를 본 뒤 같은 찾기 화면에서 조건을 바꾸고 다시 「찾기」를 누르면 새 조건으로 실행한다(D-52).
- 상세(R-DTL)에 다녀와도 서비스 안에서는 고른 조건을 유지하고, 앱을 다시 열면 처음 상태로 돌린다(D-52).
결과- 시도, 시군구(또는 「전체」), 시작일, 종료일로 이루어진 찾기 조건이 정해진다.
- 사용자는 F-SRC02의 결과 목록을 본다.
예외- 시도·시군구나 기간을 고르지 않고 「찾기」를 누름 → 찾기를 실행하지 않고 「지역과 날짜를 골라 주세요.」를 보여 준다(D-55).
- 종료일을 시작일보다 앞으로 고르려 함 → 그 날짜를 고를 수 없게 한다.
- 오늘 이전 날짜나 3개월 뒤 같은 날을 넘는 날짜 → 고를 수 없게 한다(D-50). 3개월 뒤 같은 날이 그 달에 없으면(예: 11월 30일 → 2월 30일) 그 달 말일까지 고를 수 있다(D-64).
- 화면을 연 채 날짜가 바뀌어 시작일이 오늘 이전이 됨 → 찾기 실행 때 그날의 오늘로 범위를 다시 확인하고, 범위를 벗어나면 실행하지 않고 다시 고르게 한다.
- 시도·시군구 목록을 불러오지 못함(네트워크 실패) → 「정보를 불러오지 못했어요. 잠시 후 다시 시도해 주세요.」와 [다시 시도] 버튼을 보여 준다(D-55).
- 찾기 버튼을 연달아 누름 → 마지막 조건의 찾기 한 번만 실행한다(D-52).
표시- 시도 목록, 시군구 목록(맨 앞 「전체」), 시작일·종료일 달력, 「찾기」 버튼을 보여 준다(D-52).
- 고를 수 없는 날짜는 흐리게 보여 주고 누를 수 없게 한다.
- 고른 조건을 「시도 시군구 · 시작일~종료일」 형태로 조건 영역에 보여 준다.
- 목록을 불러오는 동안 로딩 표시를 보여 준다.
- 빠진 조건은 「지역과 날짜를 골라 주세요.」, 불러오기 실패는 「정보를 불러오지 못했어요. 잠시 후 다시 시도해 주세요.」+[다시 시도]이다(D-55).
권한&접근- 로그인한 사용자와 로그인하지 않은 사용자 모두 쓸 수 있다(D-13).
- 운영자 전용 동작은 없다.
비즈니스 규칙- 지역 단위는 시도→시군구이다(D-14).
- 지역 목록은 전국 행정구역 고정 목록이고, 일반구가 있는 시(예: 수원시)는 시 단위로 묶어 보여 준다(D-51).
- 시군구 「전체」를 고르면 그 시도 전체를 조건으로 한다(D-36).
- 시군구가 없는 시도(세종특별자치시)는 「전체」만 고를 수 있다.
- 지역 조건은 축제의 시도·시군구와 맞춘다. 시장 소재지는 지역 조건에 쓰지 않는다(D-37).
- 날짜는 시작일~종료일 기간으로 고른다(D-35).
- 고를 수 있는 마지막 날은 오늘부터 3개월 뒤 같은 날이고(예: 2026-11-15 → 2027-02-15), 그 안에서 기간 길이 제한은 없다(D-28, D-50).
- 3개월 뒤 같은 날이 그 달에 없으면 그 달 말일을 마지막 날로 한다(D-64, 예: 2026-11-30 → 2027-02-28). 이 마지막 날은 F-DAT02 수집 기간과 F-DAT03 산출 기간의 끝으로도 쓴다.
- 시작일은 종료일과 같거나 앞이어야 한다(하루만 고르려면 시작일과 종료일을 같은 날로 고른다).
- 처음 열 때 기본 조건은 지역 비움, 기간 오늘~3개월 뒤 같은 날이다(D-52).
- 「찾기」 버튼을 눌러야 실행한다. 조건을 바꾸는 것만으로는 결과가 바뀌지 않는다(D-52).
- 조건은 상세에 다녀와도 서비스 안에서 유지하고, 앱을 다시 열면 초기화한다. 조건은 서버에 저장하지 않는다(D-9, D-52).
데이터- 찾기 조건: 시도명(문자열, 필수), 시군구명(문자열 또는 「전체」, 필수), 시작일(날짜 YYYY-MM-DD, 필수), 종료일(날짜 YYYY-MM-DD, 필수)을 가진다.
- 지역 목록: 전국 행정구역 고정 목록. 시도명(문자열, 필수)과 그 아래 시군구명 목록(문자열 배열, 일반구는 시 단위로 묶음)을 가진다(D-51).
- 찾기 조건은 앱 안에서만 유지하고 서버에 저장하지 않는다(D-9, D-52).

F-SRC02 찾기 결과 목록 보기

항목내용
중요도high
역할사용자
디바이스하나원큐 앱(모바일)

설명 — 사용자가 F-SRC01에서 고른 조건(축제 기준 지역, 기간)에 해당하는 겹치는 날 목록을 보고, 항목을 눌러 그 건의 상세(R-DTL)로 이동한다. 목록의 각 항목은 축제 × 시장 × 날짜 한 건이며(D-10), TOP 5와 같은 순서로 보여 주고 같은 축제는 한 묶음으로 접어 보여 준다(D-23, D-53). 묶음은 20개씩 스크롤하며 더 불러온다(D-54). 겹치는 날 산출 자체는 F-DAT03이 맡고, 결과 저장(D-9)은 포함하지 않는다.

도입 이유 — 사용자가 축제 일정과 시장 개설주기를 따로 찾아 날짜를 손으로 비교하지 않고도, 원하는 지역·기간의 겹치는 날을 한 목록에서 고를 수 있게 한다.

성공 기준 — 미정. 찾기에 해당하는 PRD 핵심 지표가 없고(PRD 핵심 지표는 TOP 5 월 조회수, D-18), 목표 수치도 두지 않는다.

슬롯

슬롯내용
선행조건- F-SRC01에서 시도, 시군구(또는 「전체」), 시작일, 종료일이 모두 정해져 있다.
- F-DAT02가 하루 1회 수집한 데이터(D-27, D-47)로 F-DAT03이 겹치는 날 산출 결과를 만들어 두었다.
- 로그인 여부는 따지지 않는다(D-13).
트리거- F-SRC01에서 「찾기」 버튼을 누른다(D-52).
- 결과 목록 아래쪽까지 스크롤한다(다음 묶음 20개 불러오기, D-54).
- 상세(R-DTL)에서 뒤로 돌아온다(조건 유지, D-52).
동작- 겹치는 날 산출 결과(Overlap)에서 날짜가 시작일~종료일 안인 건만 고른다.
- 그중 축제 시도가 고른 시도와 같고, 축제 시군구가 고른 시군구와 같은 건만 남긴다(시군구 「전체」면 시도만 맞춘다, D-36, D-37). 축제 시도·시군구는 Overlap에 붙은 관광공사 지역 코드 값이다(D-49).
- 남은 건을 정기장 장날과 겹치는 건 먼저(D-7) → 축제 기간이 짧은 건 먼저(D-25) → 날짜가 빠른 건 먼저(D-30) → 축제–시장 거리가 가까운 건 먼저(D-42) 줄 세운다(TOP 5와 같은 순서, D-53).
- 같은 축제(같은 contentid)의 건을 한 묶음으로 모으고 접은 상태로 보여 준다(D-23). 묶음 안 건은 위 순서이고, 묶음끼리는 묶음 안 1순위 건의 순서로 둔다(D-53).
- 처음에 묶음 20개를 보여 주고, 사용자가 아래로 스크롤하면 다음 묶음 20개를 더 불러온다(D-54).
- 사용자가 묶음을 누르면 펼쳐 그 축제의 건(시장 × 날짜)을 모두 보여 준다.
- 사용자가 건 하나를 누르면 그 건(축제 contentid, 시장 ID, 날짜)의 상세(F-DTL01)를 진입 경로 「찾기」로 연다.
결과- 조건에 맞는 겹치는 날이 축제별 묶음으로 화면에 보인다.
- 건을 누르면 그 건의 상세 화면이 열린다. 찾기에서 들어간 상세는 TOP 5 조회수에 넣지 않는다(D-18).
- 저장되거나 바뀌는 데이터는 없다(D-9).
예외- 조건에 맞는 건이 0건 → 「이 조건에는 축제와 장날이 겹치는 날이 없어요. 지역이나 날짜를 바꿔 보세요.」를 보여 준다(D-55).
- 결과가 많음(상설장 근처 축제는 기간 내내 매일 건이 생긴다, D-4) → 같은 축제는 한 묶음으로 접고(D-23), 묶음 20개씩 스크롤하며 더 불러온다(D-54).
- 더 불러올 묶음이 없음 → 더 불러오지 않는다.
- 결과나 다음 묶음을 불러오지 못함(네트워크 실패) → 「정보를 불러오지 못했어요. 잠시 후 다시 시도해 주세요.」와 [다시 시도] 버튼을 보여 준다(D-55). 이미 보인 묶음은 그대로 둔다.
- 결과를 불러오는 중 조건을 바꿔 다시 찾기 → 마지막 조건의 결과만 보여 준다.
- 목록을 본 뒤 하루 1회 수집(D-27)으로 축제 일정이 바뀌거나 취소됨 → 목록은 다시 찾을 때 새 산출 결과로 바뀐다. 이미 연 목록에서 사라진 건을 누르면 마지막으로 받은 정보로 상세를 보여 주고 「일정 변경 가능」을 표시한다(D-57, F-DTL01).
표시- 화면 위에 현재 찾기 조건(시도 시군구 · 시작일~종료일)을 보여 준다.
- 접힌 묶음에는 축제명, 대표 이미지, 축제 기간, 겹치는 날 건수를 보여 준다(D-54).
- 펼친 줄에는 날짜, 시장명, 정기장/상설장 구분을 보여 준다(D-54).
- 대표 이미지가 없으면 기본 이미지를 쓰고, 빈 항목은 숨기며, 목록에 「데이터 기준 YYYY-MM-DD」를 보여 준다(D-56).
- 불러오는 동안 로딩 표시를 보여 준다.
- 빈 결과·실패 문구는 위 예외 슬롯의 D-55 문구이다.
권한&접근- 로그인한 사용자와 로그인하지 않은 사용자 모두 볼 수 있다(D-13).
- 운영자 전용 동작은 없다.
비즈니스 규칙- 결과의 한 건은 축제 × 시장 × 날짜이다(D-10). 같은 축제·같은 날이라도 5km 안 시장이 다르면 다른 건이다.
- 지역 조건은 F-DAT03 겹치는 날 건(Overlap)의 축제 시도·시군구로 맞춘다(관광공사 지역 코드, D-49, D-37). 그래서 시장은 고른 시군구 밖에 있을 수 있다(축제 좌표 5km 안, D-5).
- 정렬은 정기장 우선 → 축제 기간 짧은 순(D-25) → 날짜 빠른 순(D-30) → 축제–시장 거리 가까운 순(D-42, D-53)이다. TOP 5(F-TOP03)와 같다.
- 같은 축제는 한 묶음으로 접어 보여 주고, 묶음끼리는 묶음 안 1순위 건의 순서를 따른다(D-23, D-53).
- 한 번에 묶음 20개를 불러온다(D-54).
- 장날에는 상설장(개설주기 「매일」)도 포함한다(D-4). 정기장/상설장 구분은 개설주기 「매일」 여부로 정한다(D-4).
- 좌표 없는 시장은 결과에 나오지 않는다(D-16).
- 결과는 하루 1회 수집한 데이터로 산출한 것이다(D-27).
데이터- 겹치는 날 건(Overlap, F-DAT03 결과를 읽기만 한다): 축제 contentid(문자열, 필수), 시장 ID(Market 참조, F-DAT02, 필수), 날짜(날짜 YYYY-MM-DD, 필수), 장날 구분(상설·정기, 필수), 축제 기간 일수(정수, 필수), 축제–시장 거리(실수, 필수), 축제 시도·시군구(관광공사 지역 코드, D-49)를 쓴다.
- 축제(Festival): 축제명(title, 문자열, 필수), 시작일·종료일(eventstartdate·eventenddate, YYYYMMDD, 필수), 대표 이미지(firstimage, URL, 빈 값 가능), 수집 시각(일시, 데이터 기준 표시용, D-56)을 쓴다.
- 시장(Market): 시장명(mrktNm, 문자열, 필수)을 쓴다.
- 결과 목록은 저장하지 않는다(D-9).

반영한 결정

  • D-49: 축제 시도·시군구는 관광공사 응답의 지역 코드로 얻고, 찾기는 Overlap의 이 값으로 맞춘다(F-SRC02).
  • D-50: 3개월 뒤 같은 날까지 고를 수 있고 기간 길이 제한은 없다(F-SRC01).
  • D-51: 전국 행정구역 고정 목록, 일반구는 시 단위로 묶는다(F-SRC01).
  • D-52: 지역 비움·기간 오늘~3개월 끝 기본값, 「찾기」 버튼 실행, 상세에 다녀와도 조건 유지(앱 재실행 시 초기화)(F-SRC01·F-SRC02).
  • D-53: TOP 5와 같은 순서(날짜 빠른 순 → 축제–시장 거리 가까운 순), 묶음은 묶음 안 1순위 건의 순서(F-SRC02).
  • D-54: 접힌 묶음에 축제명·대표 이미지·기간·건수, 펼친 줄에 날짜·시장명·정기장/상설장 구분, 묶음 20개씩 스크롤하며 더 불러온다(추천안과 다르게 정해졌다, F-SRC02).
  • D-55: 실패·결과 없음·조건 없음 문구와 찾기 진입 버튼 이름(F-SRC01·F-SRC02).
  • D-56: 빈 항목 숨김, 기본 이미지, 「데이터 기준 YYYY-MM-DD」(F-SRC02).
  • D-57: 사라진 건은 마지막으로 받은 정보로 상세를 보여 주고 「일정 변경 가능」을 표시한다(F-SRC02 예외에서 참조).
  • D-62: 찾기 진입은 첫 화면 TOP 5 위쪽 고정 버튼 하나이다(F-SRC01 트리거).
  • D-64: 「3개월 뒤 같은 날」이 그 달에 없으면 그 달 말일을 고를 수 있는 마지막 날로 한다(F-SRC01 rules·exceptions, F-DAT02·F-DAT03 기간 끝에도 같다).

열린 질문

없음

R-DTL R-DTL 겹치는 날 상세 — 기능 상세 명세

단계: featureSpecs · 근거: docs/02-feature-map.md, docs/01-prd.md, docs/decisions.md(결정됨 행) · 작성일: 2026-11-14 · 수정일: 2026-11-15(D-55~D-59·D-60(변경)·D-61 결정과 검토 지적 반영)

사용자가 TOP 5(F-TOP01)나 찾기 결과(F-SRC02)에서 고른 겹치는 날 한 건(축제 × 시장 × 날짜, D-10)에 대해 축제 정보, 그 건의 시장과 장날(같은 날 5km 안 다른 시장 목록 포함), 시장 주변 관광지·음식점을 한 화면에서 본다. 주변 관광정보는 상세를 열 때 불러오고, 같은 시장 결과는 그날 하루 다시 쓴다(D-60). TOP 5 월 조회수는 이 상세를 연 시점에 진입 경로가 TOP 5일 때 한 번 센다(D-18). 저장(D-9)은 포함하지 않는다. 길찾기·예약·공유·전화 연결·숙박은 기능 맵에 없어 포함하지 않는다.


F-DTL01 축제 정보 보기

항목내용
중요도high
역할사용자
디바이스하나원큐 앱(모바일)

설명 — 사용자가 고른 겹치는 날 건의 축제명, 주소, 시작일·종료일, 대표 이미지(searchFestival2)와 개최 장소, 행사 시간, 이용 요금, 프로그램, 주최(detailIntro2, 콘텐츠 타입 15)를 본다. 상세 조회 항목은 축제에 따라 비어 있을 수 있다. 이 기능은 상세를 연 시점에 진입 경로가 TOP 5이면 TOP 5 월 조회수를 한 번 센다(D-18). 시장 정보는 F-DTL02, 주변 관광정보는 F-DTL03이 맡는다. 축제 홈페이지 이동·길찾기·공유는 기능 맵에 없어 포함하지 않는다.

도입 이유 — 사용자가 축제가 어디서, 언제, 무엇을 하는지 따로 검색하지 않고 겹치는 날 화면에서 바로 확인해 나들이를 정할 수 있게 한다.

성공 기준 — PRD 핵심 지표 「TOP 5 콘텐츠 월 조회수」는 진입 경로가 TOP 5인 이 상세의 진입 횟수로 센다(D-18). 집계는 이 기능 한 곳에서만 한다. 목표 수치는 두지 않는다(D-1 보류).

슬롯

슬롯내용
선행조건- 사용자가 겹치는 날 한 건(축제 contentid, 시장 ID, 날짜)을 골랐다.
- F-DAT02가 하루 1회 수집한 축제 데이터(searchFestival2·detailIntro2)가 있다(D-27, D-47).
- 로그인 여부는 따지지 않는다(D-13).
트리거- 첫 화면의 이번 달 TOP 5 항목을 누른다(F-TOP01, 진입 경로 「TOP 5」).
- 찾기 결과 목록의 건을 누른다(F-SRC02, 진입 경로 「찾기」).
- 상세의 「같은 날 5km 안 다른 시장」 목록에서 시장을 누른다(F-DTL02, 진입 경로 「다른 시장」, D-58).
동작- 상세를 열면, 진입 경로가 「TOP 5」인 경우에 한해 넘겨받은 게시 대상 월과 겹치는 날 건의 TopViewCount 상세 진입 횟수를 1 더한다(D-18). 다른 진입 경로는 세지 않는다.
- 진입한 건의 축제 contentid로 수집해 둔 축제 기본 정보(searchFestival2)와 상세 정보(detailIntro2)를 읽는다.
- 그 건(축제 contentid + 시장 ID + 날짜)이 오늘의 겹치는 날 산출 결과(Overlap)에 있는지 확인한다.
- 축제명, 대표 이미지, 주소, 시작일~종료일, 개최 장소, 행사 시간, 이용 요금, 프로그램, 주최를 화면에 채운다. 값의 HTML 태그는 표시용으로 정리한다.
- 진입한 건의 날짜(겹치는 날)를 함께 보여 준다.
- 그 건이 산출 결과에 없으면 마지막으로 받은 정보로 보여 주고 「일정 변경 가능」을 표시한다(D-57).
- 그 건의 날짜가 오늘보다 앞서면 그대로 열고 「지난 날」을 표시한다(D-57, D-32).
결과- 사용자는 그 건의 축제 정보를 상세 화면 위쪽에서 본다.
- 진입 경로가 TOP 5이면 TopViewCount가 1 늘어난다(D-18).
- 그 밖에 바뀌는 데이터는 없다(D-9).
예외- detailIntro2 항목(개최 장소·행사 시간·이용 요금·프로그램·주최)이 비어 있음 → 그 항목을 숨긴다(D-56).
- 대표 이미지(firstimage)가 없음(2026-01-01 이후 진행 축제 863건 중 6건) → 기본 이미지를 쓴다(D-56).
- 값에 HTML 태그(줄바꿈 태그 등)가 섞여 옴 → 태그를 화면에 그대로 보이지 않게 글자로 정리해 보여 준다(표시용 정리, 비즈니스 규칙의 예외).
- 목록을 연 뒤 하루 1회 수집(D-27)으로 그 축제가 사라지거나 일정이 바뀌어 그 건이 더는 겹치는 날이 아님 → 마지막으로 받은 정보로 보여 주고 「일정 변경 가능」을 표시한다(D-57).
- 그 건의 날짜가 이미 지남(TOP 5에 남은 「지난 날」 건, D-32) → 상세를 그대로 열고 「지난 날」을 표시한다(D-57).
- 정보를 불러오지 못함(네트워크 실패) → 「정보를 불러오지 못했어요. 잠시 후 다시 시도해 주세요.」와 [다시 시도] 버튼을 보여 준다(D-55).
- 같은 건을 연달아 누름 → 상세 화면을 한 번만 열고, 조회수도 한 번만 센다.
- 같은 TOP 5 항목으로 상세에 여러 번 들어감(상세를 닫았다가 다시 들어감) → 들어갈 때마다 센다(D-18 「상세 진입 횟수」).
- 조회수 기록이 네트워크 실패로 저장되지 않음 → 상세 표시는 막지 않는다.
표시- 대표 이미지, 축제명, 겹치는 날 날짜, 축제 기간(시작일~종료일), 주소, 개최 장소, 행사 시간, 이용 요금, 프로그램, 주최를 보여 준다.
- 주소(addr1)와 개최 장소(eventplace)를 함께 보여 사용자가 실제 개최 위치를 확인하게 한다(PRD 리스크 「좌표 품질」).
- 빈 항목은 숨기고, 이미지가 없으면 기본 이미지를 쓰며, 상세에 「데이터 기준 YYYY-MM-DD」를 보여 준다(D-56).
- 사라진 건에는 「일정 변경 가능」, 지난 건에는 「지난 날」을 표시한다(D-57).
- 불러오는 동안 로딩 표시를 보여 준다.
- 실패 문구는 「정보를 불러오지 못했어요. 잠시 후 다시 시도해 주세요.」+[다시 시도]이다(D-55).
권한&접근- 로그인한 사용자와 로그인하지 않은 사용자 모두 볼 수 있다(D-13).
- 비로그인 진입도 같은 방식으로 조회수를 센다(D-13, D-18).
- 운영자 전용 동작은 없다.
비즈니스 규칙- 상세 한 화면은 겹치는 날 한 건(축제 × 시장 × 날짜)을 보여 준다(D-10).
- 축제 정보는 하루 1회 수집한 관광공사 데이터에서 읽는다(D-27).
- TOP 5 월 조회수는 이 기능이 상세를 연 시점에 진입 경로가 TOP 5일 때 한 번 센다. 찾기 결과·다른 시장 목록에서 들어온 진입은 세지 않는다(D-18). 다른 기능(F-TOP01 등)은 조회수를 세지 않는다.
- 월 조회수는 TopViewCount를 대상 월별로 더한 값이다(D-18).
- API가 준 값을 고치거나 보태지 않고 그대로 보여 준다. 단, 표시용 HTML 태그 정리는 예외이다.
- 「사라진 건」은 그 건이 오늘의 Overlap에 없는 경우이고, 「지난 날」은 그 건의 날짜가 오늘보다 앞선 경우이다(D-57, D-32).
데이터- 상세 입력값: 축제 contentid(문자열, 필수), 시장 ID(Market 참조, F-DAT02, 필수), 날짜(YYYY-MM-DD, 필수), 진입 경로(TOP 5·찾기·다른 시장, 필수), 게시 대상 월(YYYY-MM, 진입 경로가 TOP 5일 때 필수).
- 축제 기본(searchFestival2): contentid(문자열, 필수), title(문자열, 필수), addr1(문자열), eventstartdate·eventenddate(YYYYMMDD, 필수), firstimage(URL, 빈 값 가능), 수집 시각(일시, 데이터 기준 표시용, D-56)을 읽는다.
- 축제 상세(detailIntro2, contentTypeId=15): eventplace, playtime, usetimefestival, program, sponsor1(모두 문자열, 빈 값 가능)을 읽는다.
- TopViewCount(TOP 5 조회수의 유일한 저장 구조): 대상 월(YYYY-MM, 필수), 겹치는 날 건 참조(축제 contentid + 시장 ID + 날짜, 필수), 상세 진입 횟수(정수, 필수, 기본값 0)(D-18).

F-DTL02 5km 안 시장과 장날 보기

항목내용
중요도high
역할사용자
디바이스하나원큐 앱(모바일)

설명 — 사용자가 그 겹치는 날 건의 시장(축제 좌표 5km 이내, D-5)의 시장명·개설주기·위치(도로명 주소, 없으면 지번 주소와 축제에서의 직선거리)를 보고, 그 건의 날짜가 그 시장의 장날임을 확인한다(D-58). 그 건의 시장을 중심으로 보여 주고, 같은 날 축제 5km 안에서 장이 서는 다른 시장은 거리가 가까운 순 목록으로 함께 보여 준다(D-22, D-58). 상설장·정기장 모두 장날에 포함한다(D-4). 장날 계산은 F-DAT03이 맡는다.

도입 이유 — 축제 장소와 시장이 얼마나 가까운지, 그날 정말 장이 서는지를 따로 찾지 않고 확인하게 해 「축제도 보고 장도 본다」는 계획을 세우게 한다.

성공 기준 — PRD 핵심 지표 「TOP 5 콘텐츠 월 조회수」(상세 진입 횟수, D-18)가 측정되는 상세 화면의 일부이다. 이 기능만의 지표와 목표 수치는 두지 않는다.

슬롯

슬롯내용
선행조건- 사용자가 겹치는 날 한 건으로 상세에 들어와 있다(F-DTL01 트리거).
- F-DAT02가 수집한 시장 데이터와 F-DAT03의 겹치는 날 산출 결과가 있다.
- 로그인 여부는 따지지 않는다(D-13).
트리거- 상세 화면이 열린다(TOP 5, 찾기 결과, 다른 시장 목록 중 어디서 들어왔든 같다).
동작- 그 건의 시장 정보(시장명, 개설주기, 도로명·지번 주소)와 그 건의 축제–시장 거리를 읽어 보여 준다.
- 개설주기가 「매일」이면 상설장, 아니면 정기장으로 구분해 보여 준다(D-4).
- 그 건의 날짜가 그 시장의 장날임을 표시한다.
- 겹치는 날 산출 결과에서 같은 축제·같은 날짜이면서 시장만 다른 건을 모두 찾는다.
- 찾은 시장을 축제–시장 거리가 가까운 순으로 「같은 날 5km 안 다른 시장」 목록에 보여 준다(D-22, D-58).
- 사용자가 다른 시장을 누르면 그 시장 건(같은 축제·같은 날·그 시장)의 상세로 바꾼다(D-58, 진입 경로 「다른 시장」).
결과- 사용자는 그 건의 시장, 그날이 장날이라는 표시, 같은 날 축제 5km 안 다른 시장 목록을 본다.
- 다른 시장을 누르면 그 시장 건의 상세가 보인다.
- 바뀌는 데이터는 없다(D-9).
예외- 같은 날 5km 안 다른 시장이 0곳 → 다른 시장 목록 영역을 숨긴다(D-58).
- 시장의 도로명 주소(rdnmadr)가 비어 있음 → 지번 주소(lnmadr)를 보여 준다(D-58). 둘 다 비어 있으면 주소 항목을 숨긴다(D-56).
- 상설장 근처 축제라 같은 날 다른 시장이 여러 곳 → D-22에 따라 그 시장들을 모두 거리순 목록에 보여 준다(D-58).
- 그 건이 오늘 산출 결과에 없는 사라진 건 → 마지막으로 받은 시장 정보로 보여 주고(D-57), 다른 시장 목록은 오늘 산출 결과에서 같은 축제·같은 날짜 건으로 찾는다(없으면 숨긴다, D-58).
- 시장 정보를 불러오지 못함(네트워크 실패) → 「정보를 불러오지 못했어요. 잠시 후 다시 시도해 주세요.」와 [다시 시도] 버튼을 보여 준다(D-55).
표시- 그 건의 시장을 상세의 시장 영역 맨 위에 보여 준다.
- 시장명, 개설주기 원문(예: 「1일+6일」, 「매일」), 정기장/상설장 구분, 위치를 보여 준다.
- 위치는 도로명 주소(없으면 지번 주소)와 축제에서의 직선거리(km)이다(D-58).
- 그 건의 날짜가 그 시장의 장날이라는 표시를 보여 준다.
- 그 아래 「같은 날 5km 안 다른 시장」 목록에 시장명과 정기장/상설장 구분을 거리가 가까운 순으로 보여 준다(D-58). 0곳이면 영역을 숨긴다(D-58).
- 불러오는 동안 로딩 표시를, 실패하면 D-55의 실패 문구와 [다시 시도]를 보여 준다.
권한&접근- 로그인한 사용자와 로그인하지 않은 사용자 모두 볼 수 있다(D-13).
- 운영자 전용 동작은 없다.
비즈니스 규칙- 시장은 축제 좌표(mapx·mapy)에서 5km 이내여야 한다(5km와 같아도 포함, D-5).
- 장날에는 상설장(개설주기 「매일」)과 정기장을 모두 포함한다(D-4).
- 정기장 개설주기는 적힌 날짜마다 끝자리 방식으로 장날을 정하고, 31일은 장날로 보지 않는다(D-29, D-48). 「1일+6일」은 1·6·11·16·21·26일, 「5일+10일」은 5·10·15·20·25·30일이다.
- 좌표가 없는 시장은 5km 판정에서 빠지므로 이 화면에 나오지 않는다(D-16).
- 다른 시장 목록은 같은 축제·같은 날짜의 다른 겹치는 날 건이다. 각 시장은 따로 한 건이다(D-10, D-22).
- 다른 시장 목록은 축제–시장 직선거리가 가까운 순이다(D-58).
- 다른 시장에서 들어간 상세는 TOP 5 조회수에 넣지 않는다(D-18, F-DTL01).
데이터- 시장(Market, F-DAT02 데이터를 읽기만 한다): 시장 ID(Market 참조, F-DAT02, 필수), 시장명(mrktNm, 문자열, 필수), 개설주기(mrktEstblCycle, 문자열, 필수, 정기장/상설장 구분에 쓴다), 도로명 주소(rdnmadr, 문자열, 빈 값 가능), 지번 주소(lnmadr, 문자열, 빈 값 가능), 위도(latitude, 실수, 필수), 경도(longitude, 실수, 필수)를 쓴다.
- 겹치는 날 건(Overlap, F-DAT03 결과): 축제 contentid, 시장 ID, 날짜, 장날 구분(상설·정기), 축제–시장 거리(실수, 거리 표시와 정렬에 쓴다, D-58)를 쓴다.

F-DTL03 주변 관광정보 보기

항목내용
중요도high
역할사용자
디바이스하나원큐 앱(모바일)

설명 — 사용자가 그 건의 시장 좌표 기준 5km 안 관광지와 음식점을 본다(D-15). 상세를 열 때 관광공사 위치기반 조회(locationBasedList2)로 불러오고, 같은 시장 결과는 그날 하루 다시 쓰며 날짜가 바뀌면 새로 부른다(D-60). 하루 1회 미리 받기(D-27)는 축제·시장 데이터에만 적용하고 주변 관광정보에는 적용하지 않는다(D-60). 불러오지 못하면 그날 그 시장을 「호출 실패」로 저장해 그날은 다시 부르지 않고(D-68), 그 시장의 마지막 성공 결과와 기준 시점을, 마지막 결과가 없으면 실패 안내를 보여 준다(D-60, D-55). 종류별 거리순 5건까지 보여 준다(D-59). 축제공연행사(콘텐츠 타입 15)는 넣지 않는다(D-31). 숙박은 D-15에서 고르지 않았고, 길찾기·예약·전화 연결은 기능 맵에 없어 포함하지 않는다.

도입 이유 — 축제와 장을 본 뒤 함께 들를 관광지·음식점을 따로 찾지 않고 상세 한 화면에서 나들이 계획을 끝내게 한다.

성공 기준 — PRD 핵심 지표 「TOP 5 콘텐츠 월 조회수」(상세 진입 횟수, D-18)가 측정되는 상세 화면의 일부이다. 이 기능만의 지표와 목표 수치는 두지 않는다.

슬롯

슬롯내용
선행조건- 사용자가 겹치는 날 한 건으로 상세에 들어와 있다(F-DTL01 트리거).
- 그 건의 시장에 위도·경도가 있다(좌표 없는 시장은 겹치는 날이 되지 않는다, D-16).
- 관광공사 KorService2를 부를 수 있는 서비스 키가 발급돼 있다(F-DAT02 선행조건과 같은 키).
- 로그인 여부는 따지지 않는다(D-13).
트리거- 상세 화면이 열린다(TOP 5, 찾기 결과, 다른 시장 목록 중 어디서 들어왔든 같다).
동작- 상세를 열면 이 영역에 로딩 표시를 보여 준다.
- 그 건의 시장 ID로 그 시장의 오늘 기록(성공 결과 또는 「호출 실패」)이 있는지 확인한다(D-60, D-68).
- 오늘 성공 결과가 있으면 관광공사 API를 부르지 않고 그 결과를 쓴다(D-60).
- 오늘 「호출 실패」 기록이 있으면 관광공사 API를 부르지 않고, 마지막 성공 결과가 있으면 그 결과와 기준 시점을, 없으면 실패 안내를 보여 준다(D-68).
- 오늘 기록이 없으면 locationBasedList2를 시장 경도·위도(mapX·mapY), 반경 5000m(radius=5000), 거리순 정렬(arrange=E)로 관광지(contentTypeId=12)와 음식점(contentTypeId=39) 각각 불러 종류별로 가까운 5건을 받는다(D-15, D-59, D-60).
- 같은 시장 결과를 아직 받는 중에 다른 사용자가 같은 시장 상세를 열면, 한 번만 부르고 그 결과를 함께 쓴다.
- 받은 결과를 시장 ID, 결과 날짜(오늘), 받은 시각과 함께 저장해 그날 같은 시장 상세에서 다시 쓴다(D-60).
- 결과를 관광지와 음식점으로 나눠, 종류마다 거리가 가까운 순으로 5건까지 보여 준다(D-59).
- 각 항목에 이름, 거리, 주소, 대표 이미지를 보여 준다(D-59).
- 부르기가 실패하면 그 시장의 오늘 기록을 「호출 실패」로 저장하고, 마지막 성공 결과가 있으면 그 결과와 기준 시점을, 없으면 실패 안내를 보여 준다(D-60, D-68, D-55, D-56).
- 사용자가 항목을 눌러도 다른 화면으로 이동하지 않는다(D-59).
결과- 사용자는 시장 주변 5km 안 관광지·음식점을 종류별 5건까지 본다.
- 그날 그 시장을 처음 불러 성공했으면 그 시장의 그날 결과(NearbyPlace)가 저장되고, 그날 같은 시장 상세는 이 결과를 다시 쓴다(D-60).
- 그날 처음 부르기가 실패했으면 그 시장의 그날 기록이 「호출 실패」로 저장되고, 그날 같은 시장 상세는 다시 부르지 않는다(D-68).
- 바뀌는 사용자 데이터는 없다(D-9).
예외- 관광지나 음식점이 0건 → 그 종류 영역에 「주변에 보여 드릴 정보가 없어요.」를 보여 준다(D-55).
- 관광공사 API 부르기가 실패함(응답 없음, 네트워크 실패, 호출 한도로 거절)이고 그 시장의 마지막 결과가 있음 → 마지막 결과와 그 결과의 기준 시점 「데이터 기준 YYYY-MM-DD」를 보여 준다(D-60, D-56).
- 관광공사 API 부르기가 실패했고 그 시장의 마지막 결과가 없음 → 이 영역에만 실패 안내 「지금은 주변 정보를 불러올 수 없어요. 내일 다시 확인해 주세요.」를 보여 준다. 그날은 다시 부르지 않으므로 이 영역에는 [다시 시도] 버튼을 두지 않는다(D-68, D-69).
- 실패도 그날 기록으로 「호출 실패」로 저장한다. 같은 날 다시 상세를 열어도 다시 부르지 않고, 날짜가 바뀌면 새로 부른다(D-68).
- 같은 시장 상세를 여러 사용자가 동시에 처음 엶 → 한 번만 부르고 결과를 함께 쓴다.
- 날짜가 바뀜 → 전날 결과나 전날 「호출 실패」 기록은 그날 기록으로 다시 쓰지 않고 새로 부른다. 새로 부르기가 실패하면 전날 결과를 마지막 결과로 보여 준다(D-60).
- 사라진 건(D-57)이라 그 시장이 오늘 산출에 없음 → 마지막으로 받은 시장 정보의 좌표로 같은 방식으로 불러온다(D-57, D-60).
- 5km 안 결과가 5건보다 많음 → 거리순 5건만 보여 주고 더 보기는 두지 않는다(D-59).
- 축제 정보·시장 정보가 아직 불러와지는 중 → 주변 관광정보는 따로 불러오고, 늦게 와도 다른 영역의 표시를 막지 않는다.
- 호출량 → 그날 상세가 처음 열린 시장마다 관광지·음식점 2종을 한 번만 부른다(성공이든 실패든, D-68). D-60 근거로 하루 최대 약 814회이다(모든 시장 미리 받기는 약 2,764회). 공공데이터포털 호출 한도로 거절되면 위 실패 처리를 따른다.
표시- 「관광지」와 「음식점」을 나눠 보여 준다.
- 한 항목에 이름, 거리, 주소, 대표 이미지를 보여 준다. 대표 이미지가 없으면 이미지를 숨긴다(D-59). 전화번호는 보여 주지 않는다(D-59).
- 「더 보기」는 두지 않는다(D-59).
- 불러오는 동안 이 영역에만 로딩 표시를 보여 준다.
- 빈 안내는 「주변에 보여 드릴 정보가 없어요.」, 실패는 「지금은 주변 정보를 불러올 수 없어요. 내일 다시 확인해 주세요.」이며, 이 영역에는 [다시 시도] 버튼을 두지 않는다(D-68, D-69). 다른 영역의 실패 문구는 D-55를 따른다.
- 데이터 기준 시점은 상세 공통 「데이터 기준 YYYY-MM-DD」를 따른다(D-56). 부르기에 실패해 마지막 결과를 보여 줄 때는 이 영역에 그 결과의 결과 날짜를 「데이터 기준 YYYY-MM-DD」로 보여 준다(D-56, D-60).
- 항목을 눌러도 다른 화면으로 이동하지 않는다(D-59).
권한&접근- 로그인한 사용자와 로그인하지 않은 사용자 모두 볼 수 있다(D-13).
- 관광공사 API 서비스 키는 시스템만 쓰며 사용자 화면에 노출하지 않는다.
- 운영자 전용 동작은 없다.
비즈니스 규칙- 기준 좌표는 축제가 아니라 그 건의 시장 좌표이다(D-15).
- 반경은 5km(5000m)이다(D-15). 관광공사 API 명세상 locationBasedList2의 반경 최대값은 20000m이며 5000m는 그 안이다.
- 종류는 관광지(12)와 음식점(39)뿐이다(D-15). 축제공연행사(15)는 넣지 않는다(D-31).
- 정렬은 거리순(arrange=E)이고 종류별 5건까지이다(D-59).
- 주변 관광정보는 상세를 열 때 불러온다. 하루 1회 미리 받기(D-27)는 축제·시장 데이터에만 적용한다(D-60).
- 같은 시장 결과는 그날 하루 다시 쓰고, 날짜가 바뀌면 새로 부른다(D-60).
- 부르기가 실패해도 그날 기록을 「호출 실패」로 저장해 그날은 그 시장을 다시 부르지 않는다. 시장마다 하루에 관광지·음식점 각 1회까지만 부른다(D-68).
- 부르기가 실패하면 그 시장의 마지막 결과와 기준 시점을, 없으면 실패 안내를 보여 준다(D-60, D-55).
- 같은 시장을 동시에 처음 부르는 요청은 한 번만 부르고 결과를 함께 쓴다.
- 이렇게 하는 이유는 호출 수를 줄이기 위해서다. 하루 최대 약 814회로, 모든 시장을 미리 받는 방식(약 2,764회)보다 적다(D-60).
데이터- 입력: 시장 ID(Market 참조, F-DAT02, 필수), 시장 위도(latitude)·경도(longitude)(실수, 필수)를 Market에서 읽는다.
- NearbyFetch(이 기능이 저장하고 읽는다, 시장별 하루 호출 기록): 시장 ID(Market 참조, 필수), 결과 날짜(날짜, 필수), 종류(관광지 12·음식점 39, 필수), 호출 결과(성공·호출 실패, 필수), 받은 시각(일시, 필수). (시장 ID, 결과 날짜, 종류) 조합은 하나뿐이다(D-68).
- NearbyPlace(이 기능이 저장하고 읽는다, 성공한 호출의 항목): 시장 ID(Market 참조, F-DAT02, 필수), 결과 날짜(날짜, 필수), 받은 시각(일시, 필수), 종류(관광지 12·음식점 39, 필수), 순서(정수 1~5, 거리순, 필수), title(문자열, 필수), addr1(문자열, 빈 값 가능), dist(시장에서의 거리 m, 실수, 필수), firstimage(URL, 빈 값 가능)(D-59, D-60).
- (시장 ID, 결과 날짜, 종류, 순서) 조합은 하나뿐이다. 「오늘 결과」는 결과 날짜가 오늘인 것이고, 「마지막 결과」는 그 시장의 성공한 결과 중 결과 날짜가 가장 최근인 것이다(D-60, D-68).
- 전화번호는 받지 않는다(D-59).
- 사용자별로 저장하지 않는다.

반영한 결정

  • D-55: 실패 「정보를 불러오지 못했어요. 잠시 후 다시 시도해 주세요.」+[다시 시도], 상세 빈 영역 「주변에 보여 드릴 정보가 없어요.」(F-DTL01~03).
  • D-56: 빈 항목 숨김, 기본 이미지, 「데이터 기준 YYYY-MM-DD」(F-DTL01~03 공통).
  • D-57: 사라진 건도 마지막으로 받은 정보로 보여 주고 「일정 변경 가능」 표시, 지난 건은 그대로 열고 「지난 날」 표시(추천안과 다르게 정해졌다, F-DTL01·F-DTL02·F-DTL03).
  • D-58: 위치는 도로명 주소(없으면 지번)와 직선거리(km), 다른 시장은 거리순, 누르면 그 시장 건의 상세, 0곳이면 영역 숨김(F-DTL02).
  • D-59: 거리순 종류별 5건, 이름·거리·주소·대표 이미지(없으면 숨김), 전화번호·더 보기 없음, 눌러도 이동하지 않음(F-DTL03).
  • D-60(2026-11-15 변경): 하루 1회 반영(D-27)은 축제·시장 데이터에만 적용한다. 주변 관광정보는 상세를 열 때 불러오고 같은 시장 결과는 그날 하루 다시 쓰며, 실패하면 마지막 결과와 기준 시점, 없으면 실패 안내를 보여 준다(F-DTL03).
  • D-68(사용자 지시): 주변 관광정보 호출이 실패해도 그날 기록을 「호출 실패」로 저장해 그날은 다시 부르지 않는다. 이 영역에는 [다시 시도] 버튼을 두지 않는다(F-DTL03).
  • D-69(사용자 지시): 주변 관광정보 영역의 실패 문구는 「지금은 주변 정보를 불러올 수 없어요. 내일 다시 확인해 주세요.」로 한다(F-DTL03).
  • D-61: 시장 ID는 F-DAT02가 시장명+도로명 주소(없으면 지번)로 알아본 Market을 가리킨다(F-DTL01~03 데이터).
  • D-18: TOP 5 월 조회수는 F-DTL01이 상세를 연 시점에 진입 경로가 TOP 5일 때 한 번 센다(검토 지적으로 집계 위치를 한 곳으로 맞췄다).

열린 질문

없음

R-DAT R-DAT 축제·시장 데이터 준비와 겹치는 날 산출 — 기능 상세 명세

단계: featureSpecs · 근거: docs/02-feature-map.md, docs/01-prd.md, docs/decisions.md(결정됨 행) · 작성일: 2026-11-14 · 수정일: 2026-11-15(D-45·D-47~D-50·D-60(변경)·D-61·D-63·D-64 결정과 검토 지적 반영)

시스템이 매일 새벽 4시(한국 시간) 관광공사 축제 데이터(searchFestival2·detailIntro2)와 전통시장 데이터를 가져오고(D-3, D-27, D-47), 시장 개설주기로 장날 달력을 만든 뒤, 축제 좌표 5km 안 시장의 장날이 축제 기간과 같은 날을 축제 × 시장 × 날짜 건으로 산출해(D-4, D-5, D-10, D-29, D-48) TOP 5·찾기·상세에 넘긴다. 사용자나 운영자가 직접 쓰는 화면은 없다. 엑셀 파일 적재는 없다(D-3). 시장 주변 관광지·음식점은 이 영역에서 미리 받지 않고, 상세를 열 때 F-DTL03이 불러온다(D-60). F-DAT01은 폐기된 ID이다.


F-DAT02 축제·시장 데이터 가져오기

항목내용
중요도high
역할해당 없음(시스템 처리)
디바이스해당 없음

설명 — 시스템이 매일 새벽 4시(한국 시간) 관광공사 국문 관광정보 서비스_GW(KorService2)의 행사정보 조회(searchFestival2)와 상세 조회(detailIntro2, 콘텐츠 타입 15)로 축제 데이터를, 전국전통시장표준데이터(전통시장 API)로 시장 데이터를 가져와 저장한다(D-3, D-27, D-47). 축제·시장 데이터는 사용자 조회 때마다 원본 API를 부르지 않는다(D-27). 하루 1회 수집(D-27)은 축제·시장 데이터에만 적용하며, 시장 주변 관광지·음식점은 이 기능에서 받지 않고 상세를 열 때 F-DTL03이 불러온다(D-60). 엑셀 파일은 포함하지 않는다.

도입 이유 — 관광공사 축제 데이터는 등록·수정이 계속되므로, 정해진 주기로 받아 두어야 일정 변경·취소가 겹치는 날 계산과 TOP 5 후보·게시 건 점검에 반영된다(D-27, D-63). 미리 받아 두면 사용자 조회가 외부 API 장애에 바로 막히지 않는다(PRD 리스크).

성공 기준 — 매일 수집이 끝나 그날의 겹치는 날 산출(F-DAT03)에 최신 데이터가 쓰인다. 목표 수치는 두지 않는다(D-1 보류).

슬롯

슬롯내용
선행조건- 관광공사 KorService2와 전통시장 API를 부를 수 있는 서비스 키가 발급돼 있어야 한다.
트리거- 매일 새벽 4시(한국 시간) 스케줄로 시작한다(D-27, D-47).
- 실패하면 30분 간격으로 최대 3회 다시 시작한다(D-47).
동작- searchFestival2로 수집 대상 기간(비즈니스 규칙)에 하루라도 진행되는 축제 목록을 모두 페이지를 넘겨 가며 받는다. 축제마다 관광공사 응답의 지역 코드(시도 코드·시군구 코드)를 함께 받는다(D-49).
- 받은 축제마다 detailIntro2(콘텐츠 타입 15)로 개최 장소·행사 시간·이용 요금·프로그램·주최를 받는다.
- 전통시장 API로 시장 전체(시장명·개설주기·도로명/지번 주소·위도·경도)를 모두 페이지를 넘겨 가며 받는다.
- 시장마다 시장명+도로명 주소(없으면 지번 주소)로 기존 Market과 맞춰 본다. 같은 조합이 있으면 그 시장 ID를 쓰고, 없으면 새 시장 ID를 부여한다(D-61).
- 받은 데이터로 저장된 축제·시장 데이터를 바꾸고, 수집 시각을 기록한다.
- 저장된 값과 비교해 축제·시장의 어떤 필드든 바뀌었으면 그 축제·시장에 그날의 「필드 변경」을 기록한다(F-TOP02 취소·변경 점검용, D-45, D-63).
- 이번 수집에서 목록에 없어진 축제와 시장은 저장 데이터에서 지우지 않고 「목록에 없음」으로 처리해 산출(F-DAT03)에서 뺀다. 마지막으로 받은 정보는 상세의 사라진 건 표시에 쓴다(D-57).
- 그날 수집 결과(성공·실패, 산출에 쓰는 데이터의 수집 날짜)를 CollectionStatus로 남긴다(D-47).
- 수집이 끝나면 겹치는 날 산출(F-DAT03)을 시작시킨다.
결과- 축제(Festival)·시장(Market) 데이터가 그날 받은 값으로 바뀌고 수집 시각이 남는다.
- 바뀐 축제·시장에 그날의 「필드 변경」이 기록된다(D-45).
- 관광공사에서 바뀐 축제 일정·취소가 그날 산출에 반영된다(D-27).
예외- API 호출이 실패하거나 응답이 없음 → 30분 간격으로 3회 다시 시도하고, 그래도 실패하면 전날 데이터로 산출하고 CMS에 수집 실패를 표시한다(D-47, F-TOP02 표시).
- 수집 도중 일부 페이지만 실패해 목록이 불완전함 → 빠진 축제·시장을 「목록에 없음」으로 처리하지 않는다(취소로 잘못 보지 않기 위해서다). 재시도 끝에도 불완전하면 전날 데이터를 쓴다(D-47).
- 공공데이터포털 API 호출 한도 → 매일 축제 목록(searchFestival2) 페이지 호출과 축제별 detailIntro2 호출(축제 수백 건 × 1회)이 이어진다. 이 호출량은 공공데이터포털이 서비스 키에 주는 API 호출 한도를 넘을 수 있다. 한도 수치는 확인되지 않았다. 한도를 넘어 호출이 거절되면 위 실패 처리(재시도, 끝내 실패하면 전날 데이터와 CMS 실패 표시, D-47)를 따른다. 주변 관광정보(locationBasedList2) 호출은 이 수집에 들어가지 않는다(D-60, F-DTL03).
- detailIntro2 항목(eventplace·playtime·usetimefestival·program·sponsor1)이 빈 값이면 빈 값 그대로 저장한다. 화면의 빈 값 표시는 F-DTL01이 정한다(D-56).
- 대표 이미지(firstimage)가 빈 값이면 빈 값 그대로 저장한다.
- 시장 좌표(latitude·longitude)가 빈 값인 시장(현재 21곳)도 저장하되, 5km 판정에서는 뺀다(D-16, F-DAT03).
- 시장의 이름이나 주소(도로명, 없으면 지번)가 바뀜 → 새 시장으로 보고 새 시장 ID를 부여한다. 이전 시장 ID는 「목록에 없음」이 되어 그 시장의 건은 새 산출에서 없어진다(D-61). 게시된 TOP 5는 게시 당시 복사해 둔 정보로 계속 보인다(D-61, F-TOP02).
- 시장명+주소 조합이 같은 시장이 한 번 수집 안에 둘 이상 있음 → 같은 시장으로 보아 시장 ID 하나에 묶는다(D-61).
- 전날 수집이 아직 끝나지 않았는데 다음 수집이 시작되면 겹쳐 실행하지 않는다.
- 수집 건수가 많아(축제 수백 건 × detailIntro2 1회, 시장 1,403곳) 한 번에 받지 못하면 페이지·시장 단위로 나눠 받는다.
표시해당 없음(수집 실패의 CMS 표시는 F-TOP02 표시에서 다룬다, D-47).
권한&접근- 시스템 스케줄만 실행한다. 사용자와 운영자는 이 기능을 직접 실행하지 않는다.
- API 서비스 키는 시스템만 쓰며 사용자 화면에 노출하지 않는다.
비즈니스 규칙- 수집은 매일 새벽 4시(한국 시간) 한 번이며, 축제·시장 데이터를 함께 받는다(D-27, D-47). 하루 1회 수집은 축제·시장 데이터에만 적용하고, 주변 관광정보는 받지 않는다(D-60).
- 실패하면 30분 간격 3회 재시도하고, 끝내 실패하면 전날 데이터로 산출하고 CMS에 실패를 표시한다(D-47).
- 축제 데이터는 관광공사 KorService2에서만, 시장 데이터는 전통시장 API에서만 가져온다. 엑셀 파일은 쓰지 않는다(D-3).
- 수집 대상 축제는 그 달 1일부터 F-SRC01에서 고를 수 있는 마지막 날(오늘부터 3개월 뒤 같은 날, D-50)까지의 날짜에 하루라도 진행되는 축제이다. TOP 5는 그 달 전체(지난 날 포함, D-32)를, 찾기는 오늘부터 그 마지막 날까지를 쓰기 때문이다. 3개월 뒤 같은 날이 그 달에 없으면 그 달 말일을 마지막 날로 한다(D-64, 예: 11월 30일 → 2월 말일).
- 축제의 시도·시군구는 관광공사 응답의 지역 코드(시도 코드·시군구 코드)로 얻는다(D-49). 주소(addr1) 글자를 읽어 얻지 않는다.
- 시장은 시장명+도로명 주소(없으면 지번 주소)로 알아본다. 이 조합이 바뀌면 새 시장으로 본다(D-61).
- 「필드 변경」은 저장된 값과 새로 받은 값이 어떤 필드든 다를 때 기록한다(D-45).
데이터- Festival: contentid(문자열, 필수, 식별자), title(문자열, 필수), addr1(문자열, 필수), 시도 코드(관광공사 지역 코드, 필수, D-49), 시군구 코드(관광공사 지역 코드, 선택 — 시군구가 없는 시도가 있다, D-49), eventstartdate(날짜 YYYYMMDD, 필수), eventenddate(날짜 YYYYMMDD, 필수), mapx(실수 경도, 필수), mapy(실수 위도, 필수), firstimage(문자열 URL, 선택, 빈 값 가능), eventplace(문자열, 선택), playtime(문자열, 선택), usetimefestival(문자열, 선택), program(문자열, 선택), sponsor1(문자열, 선택, 빈 값 가능), 목록 상태(있음·목록에 없음, 필수, 기본값 있음), 필드 변경 일자(날짜, 선택, D-45), 수집 시각(일시, 필수).
- Market: 시장 ID(시스템이 부여, 필수, 식별자 — 다른 기능은 「시장 ID(Market 참조, F-DAT02)」로 참조한다), mrktNm(문자열, 필수), mrktEstblCycle(문자열, 필수, 예: 매일·1일+6일 — 장날 계산과 정기장/상설장 구분에 쓴다, D-4), rdnmadr(문자열, 선택), lnmadr(문자열, 선택), latitude(실수, 선택, 21곳 빈 값), longitude(실수, 선택, 21곳 빈 값), 목록 상태(있음·목록에 없음, 필수, 기본값 있음), 필드 변경 일자(날짜, 선택, D-45), 수집 시각(일시, 필수).
- 시장 ID의 식별 기준: (mrktNm, rdnmadr — 없으면 lnmadr) 조합은 「있음」 상태 Market 안에서 하나뿐이다(D-61). 전통시장 API에 시장 고유 번호가 없기 때문이다.
- 시장 유형(mrktType)은 수집하지 않는다. 정기장/상설장 구분은 개설주기 「매일」 여부로 정한다(D-4).
- CollectionStatus: 수집 일자(날짜, 필수), 결과(성공·실패, 필수), 재시도 횟수(정수 0~3, 필수), 산출에 쓴 데이터의 수집 날짜(날짜, 필수)(D-47).

F-DAT03 겹치는 날 산출

항목내용
중요도high
역할해당 없음(시스템 처리)
디바이스해당 없음

설명 — 시스템이 시장 개설주기로 장날 달력을 만들고(상설장 포함 D-4, 정기장 끝자리 방식 D-29·D-48), 축제 좌표 5km 안(D-5) 시장의 장날이 축제 기간과 같은 날을 축제 × 시장 × 날짜 건(D-10)으로 만든다. 결과는 TOP 5 후보 산출(F-TOP03), 찾기(R-SRC), 상세(R-DTL)와 TOP 5 후보·게시 건의 매일 점검(F-TOP02, D-63)에 쓰인다. 순위 매기기는 F-TOP03이, 지역 조건 맞추기는 R-SRC가 맡는다.

도입 이유 — 사용자가 축제 일정과 시장 개설주기를 손으로 비교하던 일을 시스템이 대신해, 「축제도 보고 장도 보는 날」만 골라 준다.

성공 기준 — 산출 결과의 모든 건이 「시장은 축제 좌표 5km 이내, 날짜는 축제 기간 안이면서 그 시장의 장날」을 만족하고(D-4, D-5, D-10), 개설주기 「1일+6일」 시장은 1·6·11·16·21·26일만 장날로 계산된다(31일 제외, D-29, D-48). 목표 수치는 두지 않는다(D-1 보류).

슬롯

슬롯내용
선행조건- 그날의 축제·시장 데이터 가져오기(F-DAT02)가 끝나 있어야 한다. 재시도 끝에 실패하면 전날 데이터로 산출한다(D-47).
트리거- F-DAT02 매일 새벽 4시 수집(재시도 포함)이 끝나면 시작한다(D-27, D-47).
동작- 시장마다 개설주기(mrktEstblCycle)를 장날 규칙으로 바꾼다. 「매일」은 매일 장날(상설장, D-4)이고, 그 밖의 표기는 적힌 날짜마다 끝자리 방식(D-29, D-48)으로 바꾼다.
- 산출 기간(비즈니스 규칙)의 날짜마다 시장별 장날 여부를 정한다.
- 「목록에 있음」이고 좌표가 있는 축제마다, 「목록에 있음」이고 좌표가 있는 각 시장과의 거리를 계산해 5km 이내 시장을 고른다(D-5, D-16).
- 축제 기간(시작일~종료일)과 산출 기간이 겹치는 날 가운데, 고른 시장의 장날인 날마다 축제 × 시장 × 날짜 건을 하나 만든다(D-10).
- 건마다 장날 구분(상설·정기), 축제 기간 일수, 축제–시장 거리, 지역 조건용 축제 시도·시군구(Festival의 관광공사 지역 코드, D-37, D-49)를 붙인다.
- 그날의 산출 결과로 이전 산출 결과를 바꾼다.
- 산출이 끝나면 F-TOP02가 게시 전 후보와 게시된 건을 새 결과로 점검한다(D-63).
결과- 그날 기준 겹치는 날 건(Overlap) 목록이 새로 만들어진다.
- 찾기(R-SRC)·상세(R-DTL)는 이 목록을 쓰고, 매달 1일 TOP 5 후보 산출(F-TOP03)도 이 목록을 쓴다.
- 게시 전 후보나 게시된 TOP 5의 건이 새 목록에 없거나, 그 건의 축제·시장에 그날 「필드 변경」이 기록돼 있으면 F-TOP02가 취소·변경 표시를 붙인다(D-27, D-38, D-45, D-63).
예외- 좌표가 없는 시장(21곳)은 5km 판정에서 빼고 어떤 건에도 넣지 않는다(D-16).
- 축제 좌표(mapx·mapy)가 비어 있으면 5km 판정을 할 수 없어 그 축제의 건은 만들어지지 않는다.
- 끝자리로 바꿀 수 없는 개설주기 표기와 빈 개설주기를 가진 시장은 산출에서 뺀다(D-48). 「2일+4일+7일+9일」, 「4일」처럼 날짜가 적힌 표기는 바꿀 수 있는 표기이다(비즈니스 규칙).
- 끝자리가 1인 정기장도 31일은 장날로 보지 않는다(D-48).
- 5km 안 시장이 없거나 장날이 축제 기간과 하루도 겹치지 않는 축제는 건이 0건이다.
- 산출 결과 전체가 0건이어도 오류로 보지 않고 0건 목록을 넘긴다. TOP 5 0건 처리는 0건 게시이다(D-41).
- 상설장 근처 축제는 축제 기간 하루마다 건이 생겨 건수가 많아진다(축제 수 × 5km 안 시장 수 × 날짜). 매일 전체를 다시 계산하므로 하루 1회 실행 안에 끝나야 한다.
- 수집이 끝내 실패한 날은 전날 데이터로 산출한다(D-47).
- 산출 도중 실패하면 이전 산출 결과를 그대로 둔다.
표시해당 없음
권한&접근- 시스템 스케줄만 실행한다. 사용자와 운영자는 직접 실행하지 않는다.
- 산출 결과는 사용자에게 찾기·상세·게시된 TOP 5를 통해서만 보이며, 로그인·비로그인 모두 같다(D-13).
비즈니스 규칙- 겹치는 날 한 건은 축제 × 시장 × 날짜이다. 같은 축제·같은 날이라도 시장이 다르면 다른 건이다(D-10).
- 시장은 축제 좌표(mapx 경도·mapy 위도)와 시장 좌표(latitude·longitude) 사이 거리가 5km 이내여야 한다(D-5). 거리는 두 좌표 사이의 직선(구면) 거리이고, 「이내」이므로 5km와 같아도 포함한다(D-5).
- 날짜는 축제 시작일(eventstartdate)부터 종료일(eventenddate)까지(양 끝 포함) 안이어야 한다.
- 개설주기 「매일」인 상설장은 모든 날이 장날이다(D-4).
- 정기장 표기는 적힌 날짜마다 끝자리 방식을 적용한다(D-29, D-48). 적힌 각 날짜의 끝자리(10일·20일·30일은 0)와 끝자리가 같은 날이 장날이다.
- 31일은 끝자리가 1이어도 장날로 보지 않는다(D-48).
- 예: 「1일+6일」 → 1·6·11·16·21·26일, 「2일+7일」 → 2·7·12·17·22·27일, 「5일+10일」 → 5·10·15·20·25·30일, 「4일」 → 4·14·24일, 「2일+4일+7일+9일」 → 끝자리 2·4·7·9인 날(D-29, D-48).
- 끝자리 방식으로 바꿀 수 없는 표기와 빈 표기는 산출에서 뺀다(D-48).
- 장날 구분은 개설주기가 「매일」이면 상설, 끝자리 방식으로 바꾼 표기면 정기이다. TOP 5 순위의 「정기장 장날과 겹치는 건」은 정기 구분 건이다(D-7).
- 축제 기간 일수는 종료일 − 시작일 + 1일이다(D-25 순위에 쓴다).
- 축제–시장 거리는 TOP 5·찾기의 마지막 동률 기준(D-42, D-53)과 상세 거리 표시(D-58)에 쓴다.
- 지역 조건(찾기)은 축제의 시도·시군구를 기준으로 맞춘다(D-37). 축제의 시도·시군구는 관광공사 응답의 지역 코드이다(D-49).
- 산출 기간은 그 달 1일부터 F-SRC01에서 고를 수 있는 마지막 날(오늘부터 3개월 뒤 같은 날, D-50)까지이다(F-DAT02 수집 대상과 같다). 3개월 뒤 같은 날이 그 달에 없으면 그 달 말일을 마지막 날로 한다(D-64).
- 좌표 없는 시장은 판정에서 빼고 노출하지 않는다(D-16).
데이터- 입력: Festival, Market(F-DAT02 데이터, 「목록에 있음」 상태만).
- Overlap: 축제 contentid(문자열, 필수, Festival 참조), 시장 ID(Market 참조, F-DAT02, 필수), 날짜(날짜, 필수), 장날 구분(상설·정기, 필수), 축제 기간 일수(정수, 필수), 축제–시장 거리(실수, 필수), 축제 시도(관광공사 시도 코드, 필수, D-49), 축제 시군구(관광공사 시군구 코드, 선택 — 시군구가 없는 시도가 있다, D-49), 산출 시각(일시, 필수).
- (축제 contentid, 시장 ID, 날짜) 조합은 산출 결과 안에서 하나뿐이다.
- 상세의 「같은 날 5km 안 다른 시장」(D-22)은 같은 축제 contentid·같은 날짜의 다른 Overlap 건으로 찾는다.

반영한 결정

  • D-45: 어떤 필드든 바뀌면 취소·변경으로 본다. F-DAT02가 「필드 변경」을 기록하고 F-DAT03 결과와 함께 F-TOP02 점검에 쓴다(추천안과 다르게 정해졌다).
  • D-47: 매일 새벽 4시(한국 시간) 축제·시장 데이터를 함께 받고, 30분 간격 3회 재시도, 끝내 실패하면 전날 데이터로 산출하고 CMS에 실패를 표시한다(F-DAT02·F-DAT03).
  • D-48: 31일은 장날이 아니고, 적힌 날짜마다 끝자리 방식을 적용하며, 바꿀 수 없는 표기와 빈 표기는 산출에서 뺀다(F-DAT03).
  • D-49: 축제 시도·시군구는 관광공사 응답의 지역 코드를 수집 필드에 추가해 얻는다(F-DAT02·F-DAT03).
  • D-50: 수집·산출 기간의 끝은 F-SRC01에서 고를 수 있는 마지막 날(오늘부터 3개월 뒤 같은 날)이다(F-DAT02·F-DAT03).
  • D-60(2026-11-15 변경): 하루 1회 수집(D-27)은 축제·시장 데이터에만 적용한다. 주변 관광정보는 F-DAT02 수집 대상에서 빼고, 상세를 열 때 F-DTL03이 불러와 같은 시장 결과를 그날 하루 다시 쓴다(F-DAT02).
  • D-61: 시장은 시장명+도로명 주소(없으면 지번)로 알아보고, 바뀌면 새 시장으로 보며, 게시된 TOP 5는 게시 당시 정보를 복사해 둔다(F-DAT02).
  • D-63: 게시 전 후보와 게시된 건을 모두 매일 점검한다(F-DAT03 결과).
  • D-64: 「3개월 뒤 같은 날」이 그 달에 없으면 그 달 말일을 수집·산출 기간의 마지막 날로 한다(F-DAT02·F-DAT03).

열린 질문

없음

단계 5 · 승인됨

유저플로우

docs/04-user-flow.md

단계: userFlow · 근거: docs/03-feature-specs/(R-ENT, R-TOP, R-SRC, R-DTL, R-DAT 승인됨), docs/01-prd.md(사용자 시나리오), docs/decisions.md(결정됨 행), docs/ref-hanaoneq-ia.md · 작성일: 2026-11-15 · 수정일: 2026-11-15(검토 지적과 D-70~D-73 결정 반영)

읽는 법: ([ ]) 시작, [ ] 화면, ( ) 동작, { } 분기, [( )] 화면에 보이는 데이터이다. ↗ 노드는 다른 구간으로 이어지는 곳이다(노드 수에 세지 않는다). 점선 화살표는 결정이 남은 경로이다.

구간 요약

구간이름노드 수관련 기능
s1진입과 이번 달 TOP 515F-ENT01, F-TOP01
s2날짜·지역으로 찾기18F-SRC01, F-SRC02
s3겹치는 날 상세18F-DTL01, F-DTL02, F-DTL03
s4운영자 TOP 5 검수·게시19F-TOP02, F-TOP03
s5데이터 수집과 산출(시스템)15F-DAT02, F-DAT03, F-TOP03

s1 진입과 이번 달 TOP 5

사용자가 하나원큐 홈 바로가기 → 놀이터 → 여행 탭(화면 24)의 서비스 카드(기존 카드 뒤 마지막, D-39)를 눌러 첫 화면에 들어온다. 로그인하지 않아도 들어올 수 있다(D-13). 「날짜·지역으로 찾기」 고정 버튼은 모든 상태에서 TOP 5 위쪽에 보인다(D-62). 첫 화면에서 뒤로 가면 놀이터 여행 탭으로 돌아간다(D-71).

flowchart TD
  n1(["하나원큐 홈 바로가기 → 놀이터 · F-ENT01"])
  n15(["상세나 찾기에서 뒤로 돌아옴 · F-TOP01"])
  n2["놀이터 여행 탭 화면 24 · 기존 카드 뒤 마지막에 서비스 카드 「축제도 보고 장도 보는 날」 · F-ENT01"]
  n3("서비스 카드 누르기 · 로그인 여부와 관계없음 · F-ENT01")
  n4["서비스 첫 화면 · TOP 5 위쪽 고정 버튼 「날짜·지역으로 찾기」 · 로딩 중 스켈레톤 · F-TOP01"]
  n5{"이번 달 TOP 5 불러오기 결과는? · F-TOP01"}
  n6[("게시된 TOP 5 · 순위·축제명·날짜(요일)·시장명·정기장/상설장·대표 이미지, 없으면 기본 이미지 · 빈 항목 숨김 · 지난 날짜는 「지난 날」 · 데이터 기준 YYYY-MM-DD · F-TOP01")]
  n7["「이번 달은 N건」 안내와 있는 건수만 목록 · F-TOP01"]
  n8["「이번 달 TOP 5 준비 중」 안내 · F-TOP01"]
  n9["「이번 달은 겹치는 날이 없어요」 안내 · F-TOP01"]
  n10["「정보를 불러오지 못했어요. 잠시 후 다시 시도해 주세요.」 + 「다시 시도」 · F-TOP01"]
  n11("「다시 시도」 누르기 · F-TOP01")
  n12("TOP 5 항목 누르기 · 진입 경로 TOP 5와 게시 대상 월 전달 · F-TOP01")
  n13("고정 버튼 「날짜·지역으로 찾기」 누르기 · F-TOP01")
  n14("뒤로 가기 → 놀이터 여행 탭 · F-TOP01")
  x_s2["↗ s2 날짜·지역으로 찾기 · 찾기 화면"]
  x_s3["↗ s3 겹치는 날 상세 · 상세 진입"]
  n1 --> n2
  n2 --> n3
  n3 --> n4
  n15 --> n4
  n4 --> n5
  n5 -->|게시됨 5건| n6
  n5 -->|게시됨 1~4건| n7
  n5 -->|게시 전| n8
  n5 -->|0건 게시| n9
  n5 -->|불러오기 실패| n10
  n7 --> n6
  n10 --> n11
  n11 --> n4
  n6 --> n12
  n12 --> x_s3
  n4 -->|모든 상태에서 보임| n13
  n13 --> x_s2
  n6 --> n14
  n8 --> n14
  n9 --> n14
  n10 --> n14
  n14 --> n2
노드타입라벨다음
n1start하나원큐 홈 바로가기 → 놀이터 · F-ENT01n2
n15start상세나 찾기에서 뒤로 돌아옴 · F-TOP01n4
n2page놀이터 여행 탭 화면 24 · 기존 카드 뒤 마지막에 서비스 카드 「축제도 보고 장도 보는 날」 · F-ENT01n3
n3action서비스 카드 누르기 · 로그인 여부와 관계없음(D-13) · F-ENT01n4
n4page서비스 첫 화면 · TOP 5 위쪽 고정 버튼 「날짜·지역으로 찾기」(D-62) · 로딩 중 스켈레톤(D-41) · F-TOP01n5, n13(모든 상태)
n5branch이번 달 TOP 5 불러오기 결과는? · F-TOP01n6(게시됨 5건), n7(게시됨 1~4건, D-26), n8(게시 전, D-33), n9(0건 게시, D-41), n10(불러오기 실패, D-55)
n6data게시된 TOP 5 · 순위·축제명·날짜(요일)·시장명·정기장/상설장·대표 이미지(D-40), 없으면 기본 이미지 · 빈 항목 숨김(D-56) · 지난 날짜는 「지난 날」(D-32) · 데이터 기준(D-56) · F-TOP01n12, n14
n7page「이번 달은 N건」 안내와 있는 건수만 목록 · F-TOP01n6
n8page「이번 달 TOP 5 준비 중」 안내 · F-TOP01n14
n9page「이번 달은 겹치는 날이 없어요」 안내 · F-TOP01n14
n10page「정보를 불러오지 못했어요. 잠시 후 다시 시도해 주세요.」 + 「다시 시도」 · F-TOP01n11, n14
n11action「다시 시도」 누르기 · F-TOP01n4
n12actionTOP 5 항목 누르기 · 진입 경로 TOP 5와 게시 대상 월 전달 · F-TOP01↗ s3
n13action고정 버튼 「날짜·지역으로 찾기」 누르기 · F-TOP01↗ s2
n14action뒤로 가기 → 놀이터 여행 탭(D-71) · F-TOP01n2

s2 날짜·지역으로 찾기

조건은 시도 → 시군구(맨 앞 「전체」, D-36), 기간은 오늘부터 3개월 뒤 같은 날까지이다(D-28, D-50, D-64). 「찾기」 버튼으로 실행하고, 상세에 다녀와도 조건을 유지한다(D-52). 상세에서 돌아오면 펼친 묶음·스크롤 위치·이미 불러온 묶음을 모두 유지한다(D-73). 찾기 화면의 어느 상태에서든 뒤로 가면 서비스 첫 화면으로 간다(F-TOP01 트리거).

flowchart TD
  n20(["첫 화면 고정 버튼으로 찾기 진입 · F-SRC01"])
  n35(["상세에서 뒤로 돌아옴 · F-SRC02"])
  n21["찾기 화면 · 지역 비움, 기간은 오늘~3개월 뒤 같은 날로 채움 · 서비스 안에서 조건 유지 · 목록 불러오는 동안 로딩 표시 · F-SRC01"]
  n22{"시도·시군구 목록을 불러왔나? · F-SRC01"}
  n23["「정보를 불러오지 못했어요. 잠시 후 다시 시도해 주세요.」 + 「다시 시도」 · F-SRC01"]
  n24("시도 고르기 → 시군구 고르기, 맨 앞 「전체」 · F-SRC01")
  n25("기간 고르기 · 오늘~3개월 뒤 같은 날, 그날이 없으면 그 달 말일 · F-SRC01")
  n26("「찾기」 누르기 · 연달아 누르면 마지막 조건 한 번 · F-SRC01")
  n27{"지역과 기간을 다 골랐고 기간이 오늘 기준 범위 안인가? · F-SRC01"}
  n28["「지역과 날짜를 골라 주세요.」 · F-SRC01"]
  n36["「고를 수 있는 날짜가 바뀌었어요. 날짜를 다시 골라 주세요.」 · F-SRC01"]
  n29{"결과 불러오기 결과는? · 불러오는 중 조건을 바꿔 다시 찾으면 마지막 조건 결과만 · 로딩 표시 · F-SRC02"}
  n30["「이 조건에는 축제와 장날이 겹치는 날이 없어요. 지역이나 날짜를 바꿔 보세요.」 · F-SRC02"]
  n31["첫 결과 불러오기 실패 · 「정보를 불러오지 못했어요. 잠시 후 다시 시도해 주세요.」 + 「다시 시도」 · F-SRC02"]
  n32[("결과 목록 · 위에 찾기 조건 · 축제별 묶음 접힘 20개씩 · 축제명·대표 이미지·축제 기간·건수 · 데이터 기준 YYYY-MM-DD · 불러오는 동안 로딩 표시 · F-SRC02")]
  n37["다음 묶음 불러오기 실패 · 「정보를 불러오지 못했어요. 잠시 후 다시 시도해 주세요.」 + 「다시 시도」 · 이미 보인 묶음 유지 · F-SRC02"]
  n33("묶음 누르기 → 펼침 · 날짜·시장명·정기장/상설장 · F-SRC02")
  n34("건 하나 누르기 · 진입 경로 찾기 · F-SRC02")
  x_s1["↗ s1 진입과 이번 달 TOP 5 · 서비스 첫 화면"]
  x_s3["↗ s3 겹치는 날 상세 · 상세 진입"]
  n20 --> n21
  n21 --> n22
  n22 -->|예| n24
  n22 -->|실패| n23
  n23 -->|다시 시도| n22
  n24 --> n25
  n25 --> n26
  n26 --> n27
  n27 -->|조건 빠짐| n28
  n28 --> n24
  n27 -->|기간이 범위 밖| n36
  n36 --> n25
  n27 -->|예| n29
  n29 -->|0건| n30
  n30 -->|조건 바꾸기| n24
  n29 -->|실패| n31
  n31 -->|다시 시도| n29
  n29 -->|1건 이상| n32
  n35 -->|펼친 묶음·스크롤·불러온 묶음 유지| n32
  n32 -->|아래로 스크롤, 다음 묶음 20개| n32
  n32 -->|다음 묶음 불러오기 실패| n37
  n37 -->|다시 시도| n32
  n32 -->|조건 바꾸기| n24
  n32 --> n33
  n33 --> n34
  n34 --> x_s3
  n21 -->|뒤로| x_s1
  n23 -->|뒤로| x_s1
  n28 -->|뒤로| x_s1
  n36 -->|뒤로| x_s1
  n30 -->|뒤로| x_s1
  n31 -->|뒤로| x_s1
  n37 -->|뒤로| x_s1
  n32 -->|뒤로| x_s1
노드타입라벨다음
n20start첫 화면 고정 버튼으로 찾기 진입 · F-SRC01n21
n35start상세에서 뒤로 돌아옴 · F-SRC02n32(펼친 묶음·스크롤·불러온 묶음 유지, D-73)
n21page찾기 화면 · 지역 비움, 기간은 오늘~3개월 뒤 같은 날로 채움 · 서비스 안에서 조건 유지(D-52) · 목록 불러오는 동안 로딩 표시 · F-SRC01n22, ↗ s1(뒤로)
n22branch시도·시군구 목록을 불러왔나? · F-SRC01n24(예), n23(실패)
n23page「정보를 불러오지 못했어요. 잠시 후 다시 시도해 주세요.」 + 「다시 시도」(D-55) · F-SRC01n22(다시 시도), ↗ s1(뒤로)
n24action시도 고르기 → 시군구 고르기, 맨 앞 「전체」(D-36) · F-SRC01n25
n25action기간 고르기 · 오늘~3개월 뒤 같은 날, 그날이 없으면 그 달 말일(D-50, D-64) · F-SRC01n26
n26action「찾기」 누르기 · 연달아 누르면 마지막 조건 한 번 · F-SRC01n27
n27branch지역과 기간을 다 골랐고 기간이 오늘 기준 범위 안인가? · F-SRC01n29(예), n28(조건 빠짐), n36(기간이 범위 밖)
n28page「지역과 날짜를 골라 주세요.」(D-55) · F-SRC01n24, ↗ s1(뒤로)
n36page「고를 수 있는 날짜가 바뀌었어요. 날짜를 다시 골라 주세요.」(D-72) · F-SRC01n25, ↗ s1(뒤로)
n29branch결과 불러오기 결과는? · 불러오는 중 조건을 바꿔 다시 찾으면 마지막 조건 결과만 · 로딩 표시 · F-SRC02n32(1건 이상), n30(0건), n31(실패)
n30page「이 조건에는 축제와 장날이 겹치는 날이 없어요. 지역이나 날짜를 바꿔 보세요.」(D-55) · F-SRC02n24(조건 바꾸기), ↗ s1(뒤로)
n31page첫 결과 불러오기 실패 · 「정보를 불러오지 못했어요. 잠시 후 다시 시도해 주세요.」 + 「다시 시도」 · F-SRC02n29(다시 시도), ↗ s1(뒤로)
n32data결과 목록 · 위에 찾기 조건 · 축제별 묶음 접힘 20개씩(D-23, D-54) · 축제명·대표 이미지·축제 기간·건수 · 데이터 기준(D-56) · 불러오는 동안 로딩 표시 · F-SRC02n32(스크롤, 다음 20개), n37(다음 묶음 실패), n24(조건 바꾸기), n33, ↗ s1(뒤로)
n37page다음 묶음 불러오기 실패 · 「정보를 불러오지 못했어요. 잠시 후 다시 시도해 주세요.」 + 「다시 시도」 · 이미 보인 묶음 유지 · F-SRC02n32(다시 시도), ↗ s1(뒤로)
n33action묶음 누르기 → 펼침 · 날짜·시장명·정기장/상설장 · F-SRC02n34
n34action건 하나 누르기 · 진입 경로 찾기 · F-SRC02↗ s3

s3 겹치는 날 상세

TOP 5나 찾기 결과에서 건을 골라 상세를 연다. 상세 안의 「같은 날 5km 안 다른 시장」을 누르면 그 시장 건의 상세로 바뀌고(D-58), 거기서 뒤로 가면 바꾸기 전 시장의 상세로 한 단계씩 돌아간다(D-70). 처음 연 상세에서 뒤로 가면 진입 경로(TOP 5 → s1, 찾기 → s2)로 간다. TOP 5로 들어온 경우에만 상세 진입 횟수를 1 더하고, 이 기록이 실패해도 상세 표시는 막지 않는다(D-18). 주변 관광정보(F-DTL03)는 축제·시장 영역과 따로 불러오며, 늦게 와도 다른 영역의 표시를 막지 않는다. 이 영역에는 「다시 시도」 버튼이 없다(D-68, D-69).

flowchart TD
  n40(["TOP 5나 찾기 결과에서 건 선택으로 상세 진입 · F-DTL01"])
  n41{"축제·시장 정보를 불러왔나? · 불러오는 동안 로딩 표시 · F-DTL01"}
  n42["「정보를 불러오지 못했어요. 잠시 후 다시 시도해 주세요.」 + 「다시 시도」 · F-DTL01"]
  n56{"진입 경로가 TOP 5인가? · F-DTL01"}
  n57("그 월·그 건의 TOP 5 상세 진입 횟수 1 더함 · 저장 실패해도 상세 표시는 막지 않음 · F-DTL01")
  n43{"그 건의 상태는? · 사라짐과 지남이 함께면 두 표시 모두 · F-DTL01"}
  n44["겹치는 날 상세 · 대표 이미지, 없으면 기본 이미지 · 축제명·겹치는 날·축제 기간·주소·개최 장소·행사 시간·이용 요금·프로그램·주최, 빈 항목 숨김 · 데이터 기준 YYYY-MM-DD · F-DTL01"]
  n45[("그 건의 시장 · 시장명·개설주기 원문·정기장/상설장·도로명 또는 지번 주소·축제에서 거리 km · 장날 표시 · F-DTL02")]
  n46{"같은 날 5km 안 다른 시장이 있나? · F-DTL02"}
  n47[("같은 날 5km 안 다른 시장 목록 · 시장명·정기장/상설장, 거리순 · F-DTL02")]
  n48{"그 시장의 오늘 주변 관광정보 기록은? · 이 영역만 로딩 표시 · F-DTL03"}
  n49{"관광지·음식점 5km 거리순 호출 결과는? · F-DTL03"}
  n50{"그 시장의 마지막 성공 결과가 있나? · F-DTL03"}
  n51[("주변 관광정보 · 관광지·음식점 각 거리순 5건 · 이름·거리·주소·이미지 · 0건이면 「주변에 보여 드릴 정보가 없어요.」 · F-DTL03")]
  n52[("마지막 성공 결과와 그 결과의 데이터 기준 YYYY-MM-DD · F-DTL03")]
  n53["「지금은 주변 정보를 불러올 수 없어요. 내일 다시 확인해 주세요.」 · 다시 시도 없음 · F-DTL03"]
  n54{"뒤로 가기 · 다른 시장으로 바꿔 들어온 상세인가? · F-DTL02"}
  n55{"처음 진입 경로는? · F-DTL01"}
  x_s1["↗ s1 진입과 이번 달 TOP 5 · 상세에서 돌아옴"]
  x_s2["↗ s2 날짜·지역으로 찾기 · 상세에서 돌아옴, 결과 목록 상태 유지"]
  n40 --> n41
  n41 -->|실패| n42
  n42 -->|다시 시도| n41
  n42 -->|뒤로| n54
  n41 -->|예| n56
  n56 -->|예| n57
  n57 --> n43
  n56 -->|아니오, 찾기 또는 다른 시장| n43
  n43 -->|오늘 산출에 있음| n44
  n43 -->|산출에서 사라짐, 일정 변경 가능 표시| n44
  n43 -->|날짜가 지남, 지난 날 표시| n44
  n44 --> n45
  n44 -->|주변 관광정보는 따로 불러옴, 늦어도 다른 영역을 막지 않음| n48
  n45 --> n46
  n46 -->|0곳, 영역 숨김| n54
  n46 -->|1곳 이상| n47
  n47 -->|시장 누르기, 그 시장 건 상세로 바뀜| n41
  n47 --> n54
  n48 -->|오늘 성공 결과 있음| n51
  n48 -->|오늘 호출 실패 기록 있음| n50
  n48 -->|기록 없음, 호출| n49
  n49 -->|성공, 오늘 결과 저장| n51
  n49 -->|실패, 호출 실패 기록| n50
  n50 -->|있음| n52
  n50 -->|없음| n53
  n51 --> n54
  n52 --> n54
  n53 --> n54
  n54 -->|예, 바꾸기 전 시장 상세로| n41
  n54 -->|아니오, 처음 연 상세| n55
  n55 -->|TOP 5| x_s1
  n55 -->|찾기| x_s2
노드타입라벨다음
n40startTOP 5나 찾기 결과에서 건 선택으로 상세 진입 · F-DTL01n41
n41branch축제·시장 정보를 불러왔나? · 불러오는 동안 로딩 표시 · F-DTL01n56(예), n42(실패)
n42page「정보를 불러오지 못했어요. 잠시 후 다시 시도해 주세요.」 + 「다시 시도」(D-55) · F-DTL01n41(다시 시도), n54(뒤로)
n56branch진입 경로가 TOP 5인가? · F-DTL01n57(예), n43(아니오, 찾기 또는 다른 시장)
n57action그 월·그 건의 TOP 5 상세 진입 횟수 1 더함(D-18) · 저장 실패해도 상세 표시는 막지 않음 · F-DTL01n43
n43branch그 건의 상태는? · 사라짐과 지남이 함께면 두 표시 모두 · F-DTL01n44(오늘 산출에 있음), n44(산출에서 사라짐 → 「일정 변경 가능」, D-57), n44(날짜가 지남 → 「지난 날」, D-57)
n44page겹치는 날 상세 · 대표 이미지(없으면 기본) · 축제명·겹치는 날·축제 기간·주소·개최 장소·행사 시간·이용 요금·프로그램·주최, 빈 항목 숨김 · 데이터 기준(D-56) · F-DTL01n45, n48(따로 불러옴)
n45data그 건의 시장 · 시장명·개설주기 원문·정기장/상설장(D-4)·도로명 또는 지번 주소·축제에서 거리 km · 장날 표시(D-58) · F-DTL02n46
n46branch같은 날 5km 안 다른 시장이 있나? · F-DTL02n47(1곳 이상), n54(0곳, 영역 숨김, D-58)
n47data같은 날 5km 안 다른 시장 목록 · 시장명·정기장/상설장, 거리순(D-22, D-58) · F-DTL02n41(시장 누르기 → 그 시장 건 상세로 바뀜), n54
n48branch그 시장의 오늘 주변 관광정보 기록은? · 이 영역만 로딩 표시 · F-DTL03n51(오늘 성공 결과 있음, D-60), n50(오늘 호출 실패 기록 있음, D-68), n49(기록 없음 → 호출)
n49branch관광지·음식점 5km 거리순 호출 결과는?(D-15, D-59) · F-DTL03n51(성공, 오늘 결과 저장), n50(실패, 호출 실패 기록, D-68)
n50branch그 시장의 마지막 성공 결과가 있나? · F-DTL03n52(있음), n53(없음)
n51data주변 관광정보 · 관광지·음식점 각 거리순 5건 · 이름·거리·주소·이미지(D-59) · 0건이면 「주변에 보여 드릴 정보가 없어요.」 · F-DTL03n54
n52data마지막 성공 결과와 그 결과의 데이터 기준 YYYY-MM-DD(D-60, D-56) · F-DTL03n54
n53page「지금은 주변 정보를 불러올 수 없어요. 내일 다시 확인해 주세요.」 · 다시 시도 없음(D-68, D-69) · F-DTL03n54
n54branch뒤로 가기 · 다른 시장으로 바꿔 들어온 상세인가? · F-DTL02n41(예, 바꾸기 전 시장 상세로, D-70), n55(아니오, 처음 연 상세)
n55branch처음 진입 경로는? · F-DTL01↗ s1(TOP 5), ↗ s2(찾기, 조건·결과 목록 상태 유지 D-52, D-73)

s4 운영자 TOP 5 검수·게시

운영자는 하나원큐 기존 운영 관리 시스템(CMS)의 TOP 5 메뉴에서 검수자 검수 → 게시 승인자 승인의 2단계로 게시한다(D-21, D-46). 한 운영자는 두 권한을 함께 가질 수 없고, 같은 역할의 운영자 여럿이 같은 달을 동시에 다루면 먼저 저장한 내용을 기준으로 하며 뒤에 저장하려는 운영자는 최신 상태를 다시 불러온다(D-66). 처음 게시하는 달의 반려는 검수 대기로 돌아가고, 이미 게시된 달의 수정 게시안 반려는 원본을 게시됨 그대로 두고 수정 게시안만 반려해 검수자가 다시 처리한다(D-65, D-67). CMS 화면의 버튼·문구는 하나원큐 CMS 구성에 맞춰 정하며 이 흐름도에서 정하지 않는다(F-TOP02 표시 슬롯).

flowchart TD
  n60(["매달 1일 수집·산출 끝 · F-TOP03"])
  n61("그 달 건을 정기장 우선 → 기간 짧은 순 → 날짜 빠른 순 → 거리 가까운 순으로 줄 세우고 같은 축제는 1건, 상위 20건 후보 저장 → 검수 대기로 넘김 · F-TOP03")
  n62["CMS TOP 5 검수 메뉴 · 후보 수·순위·게시 대상·제외·취소·변경 표시·진행 단계 · F-TOP02"]
  n63("검수자 · 후보 빼기 → 다음 순위가 게시 대상으로 올라옴 · F-TOP02")
  n64("검수자 · 검수 마침 → 게시 대상 최대 5건, 0건 포함 승인 단계로 넘김 · F-TOP02")
  n65["CMS 게시 승인 · 승인 대기, 수정 게시안 포함 · 게시 승인자, 검수자와 겸임 불가 · F-TOP02"]
  n66{"게시 승인자가 승인하나? · F-TOP02"}
  n77{"게시 저장에 성공했나? · F-TOP02"}
  n68{"이미 게시된 달의 수정 게시안인가? · F-TOP02"}
  n69[("원본은 게시됨 그대로, 수정 게시안만 반려 · 첫 화면은 게시 당시 복사본 유지 · F-TOP02")]
  n67[("게시됨 · 표시 정보를 게시 당시 값으로 복사 · F-TOP02")]
  n70(["매일 수집·산출 끝 · F-TOP02"])
  n71{"그날 수집이 재시도 끝에 실패했나? · F-TOP02"}
  n72[("CMS 수집 실패 표시 · 전날 데이터로 산출 · F-TOP02")]
  n73{"게시 전 후보나 게시된 건이 새 산출에서 사라졌거나 어떤 필드든 바뀌었나? · F-TOP02"}
  n74[("CMS 메뉴 안 취소·변경 표시 · 외부 알림 없음 · F-TOP02")]
  n75{"표시가 붙은 건이 게시된 건인가? · F-TOP02"}
  n76("검수자 · 게시된 건 내리기 → 다음 순위가 게시 대상으로 자동, 또는 변경 → 최신 산출로 같은 건 확인 · 수정 게시안, 게시됨 상태는 유지 · F-TOP02")
  n78("상태 그대로 · 다음 날 다시 점검 · F-TOP02")
  x_s1["↗ s1 진입과 이번 달 TOP 5 · 첫 화면에 게시 순위대로"]
  n60 --> n61
  n61 --> n62
  n62 --> n63
  n63 --> n62
  n62 --> n64
  n64 --> n65
  n65 --> n66
  n66 -->|승인| n77
  n77 -->|예| n67
  n77 -->|아니오, 게시 전 상태 유지, 다시 승인| n65
  n66 -->|반려| n68
  n68 -->|아니오, 첫 게시 달은 검수 대기로| n62
  n68 -->|예| n69
  n69 -->|검수자가 다시 처리| n76
  n67 --> x_s1
  n70 --> n71
  n71 -->|예| n72
  n72 --> n73
  n71 -->|아니오| n73
  n73 -->|예| n74
  n74 --> n75
  n73 -->|아니오, 표시 없음| n78
  n78 -->|다음 날| n70
  n75 -->|게시 전 후보, 검수에서 처리| n62
  n75 -->|게시된 건| n76
  n76 --> n65
노드타입라벨다음
n60start매달 1일 수집·산출 끝(D-11, D-47) · F-TOP03n61
n61action그 달 건을 정기장 우선 → 기간 짧은 순 → 날짜 빠른 순 → 거리 가까운 순(D-7, D-25, D-30, D-42)으로 줄 세우고 같은 축제는 1건(D-20), 상위 20건 후보 저장(D-43) → 검수 대기로 넘김 · F-TOP03n62
n62pageCMS TOP 5 검수 메뉴(D-21) · 후보 수·순위·게시 대상·제외·취소·변경 표시·진행 단계(D-46) · F-TOP02n63, n64
n63action검수자 · 후보 빼기 → 다음 순위가 게시 대상으로 올라옴(D-34) · F-TOP02n62
n64action검수자 · 검수 마침 → 게시 대상 최대 5건, 0건 포함(D-26, D-41) 승인 단계로 넘김 · F-TOP02n65
n65pageCMS 게시 승인 · 승인 대기, 수정 게시안 포함(D-67) · 게시 승인자, 검수자와 겸임 불가(D-66) · F-TOP02n66
n66branch게시 승인자가 승인하나? · F-TOP02n77(승인), n68(반려, D-65)
n77branch게시 저장에 성공했나? · F-TOP02n67(예), n65(아니오, 게시 전 상태 유지, 다시 승인)
n68branch이미 게시된 달의 수정 게시안인가? · F-TOP02n69(예), n62(아니오, 첫 게시 달은 검수 대기로, D-65)
n69data원본은 게시됨 그대로, 수정 게시안만 반려 · 첫 화면은 게시 당시 복사본 유지(D-61, D-67) · F-TOP02n76(검수자가 다시 처리)
n67data게시됨 · 표시 정보를 게시 당시 값으로 복사(D-61) · F-TOP02↗ s1
n70start매일 수집·산출 끝(D-27) · F-TOP02n71
n71branch그날 수집이 재시도 끝에 실패했나? · F-TOP02n72(예), n73(아니오)
n72dataCMS 수집 실패 표시 · 전날 데이터로 산출(D-47) · F-TOP02n73
n73branch게시 전 후보나 게시된 건이 새 산출에서 사라졌거나 어떤 필드든 바뀌었나?(D-45, D-63) · F-TOP02n74(예), n78(아니오, 표시 없음)
n74dataCMS 메뉴 안 취소·변경 표시 · 외부 알림 없음(D-38) · F-TOP02n75
n75branch표시가 붙은 건이 게시된 건인가? · F-TOP02n76(게시된 건), n62(게시 전 후보 → 검수에서 처리)
n76action검수자 · 게시된 건 내리기 → 다음 순위가 게시 대상으로 자동, 또는 변경 → 최신 산출로 같은 건 확인(D-44) · 수정 게시안, 게시됨 상태는 유지(D-65, D-67) · F-TOP02n65
n78action상태 그대로 · 다음 날 다시 점검 · F-TOP02n70(다음 날)

s5 데이터 수집과 산출(시스템)

사용자·운영자 화면이 없는 시스템 처리이다. 매일 새벽 4시(한국 시간) 수집하고, 이어서 겹치는 날을 다시 산출한다(D-27, D-47).

flowchart TD
  n80(["매일 새벽 4시 한국 시간 스케줄 · F-DAT02"])
  n81("축제 searchFestival2·detailIntro2와 전통시장 API 수집 · 필드 변경·목록에 없음 기록 · F-DAT02")
  n82{"수집에 성공했나? · 일부 페이지만 실패해도 실패로 봄 · F-DAT02"}
  n83{"재시도 3회를 다 썼나? · F-DAT02"}
  n84("30분 뒤 다시 수집 · F-DAT02")
  n85[("전날 데이터로 산출 · 수집 실패 기록 · F-DAT02")]
  n86("시장 개설주기를 장날 달력으로 · 매일은 상설장, 그 밖은 끝자리 방식, 31일 제외 · F-DAT03")
  n87{"개설주기를 장날로 바꿀 수 있나? · F-DAT03"}
  n88[("산출에서 제외 · 변환 불가·빈 개설주기 시장, 좌표 없는 시장·축제, 목록에 없음 축제·시장 · F-DAT03")]
  n89{"축제와 시장에 좌표가 있나? · F-DAT03"}
  n90("축제 좌표 5km 안 시장의 장날이 축제 기간과 같은 날마다 축제×시장×날짜 건 만들기 · F-DAT03")
  n93{"산출이 끝까지 성공했나? · F-DAT03"}
  n94[("이전 산출 결과를 그대로 둠 · F-DAT03")]
  n91[("오늘의 겹치는 날 산출 결과 · 0건도 정상 · F-DAT03")]
  n92{"오늘이 매달 1일인가? · F-TOP03"}
  x_s4a["↗ s4 운영자 TOP 5 검수·게시 · 매달 1일 후보 산출"]
  x_s4b["↗ s4 운영자 TOP 5 검수·게시 · 매일 취소·변경 점검"]
  n80 --> n81
  n81 --> n82
  n82 -->|성공| n86
  n82 -->|실패| n83
  n83 -->|아니오| n84
  n84 --> n81
  n83 -->|예| n85
  n85 --> n86
  n86 --> n87
  n87 -->|아니오| n88
  n87 -->|예| n89
  n89 -->|없음| n88
  n89 -->|있음| n90
  n88 -->|나머지로 계속| n90
  n90 --> n93
  n93 -->|예| n91
  n93 -->|아니오| n94
  n94 --> x_s4b
  n94 -->|1일이면 이전 결과로 후보 산출 D-74| n92
  n91 --> x_s4b
  n91 --> n92
  n92 -->|예| x_s4a
  n92 -->|아니오, 다음 날 새벽 4시| n80
노드타입라벨다음
n80start매일 새벽 4시 한국 시간 스케줄(D-27, D-47) · F-DAT02n81
n81action축제 searchFestival2·detailIntro2와 전통시장 API 수집 · 필드 변경·목록에 없음 기록(D-45, D-57, D-63) · F-DAT02n82
n82branch수집에 성공했나? · 일부 페이지만 실패해도 실패로 봄 · F-DAT02n86(성공), n83(실패)
n83branch재시도 3회를 다 썼나? · F-DAT02n84(아니오), n85(예)
n84action30분 뒤 다시 수집(D-47) · F-DAT02n81
n85data전날 데이터로 산출 · 수집 실패 기록(D-47) · F-DAT02n86
n86action시장 개설주기를 장날 달력으로 · 매일은 상설장(D-4), 그 밖은 끝자리 방식(D-29), 31일 제외(D-48) · F-DAT03n87
n87branch개설주기를 장날로 바꿀 수 있나? · F-DAT03n89(예), n88(아니오, D-48)
n88data산출에서 제외 · 변환 불가·빈 개설주기 시장(D-48), 좌표 없는 시장·축제(D-16), 「목록에 없음」 축제·시장(D-57) · F-DAT03n90(나머지로 계속)
n89branch축제와 시장에 좌표가 있나? · F-DAT03n90(있음), n88(없음, D-16)
n90action축제 좌표 5km 안(D-5) 시장의 장날이 축제 기간과 같은 날마다 축제×시장×날짜 건(D-10) 만들기 · F-DAT03n93
n93branch산출이 끝까지 성공했나? · F-DAT03n91(예), n94(아니오)
n94data이전 산출 결과를 그대로 둠 · F-DAT03↗ s4 매일 점검, n92(1일이면 이전 산출 결과로 후보 산출, D-74)
n91data오늘의 겹치는 날 산출 결과 · 0건도 정상(D-41) · F-DAT03↗ s4 매일 점검, n92
n92branch오늘이 매달 1일인가? · F-TOP03↗ s4 매달 1일 후보 산출(예), n80(아니오, 다음 날)

s5의 산출 결과(n91)는 s2 찾기 결과와 s3 상세(오늘 산출에 있는지 확인)에서도 읽는다. 화면 이동이 아니라 데이터 참조이므로 화살표로 잇지 않는다.

흐름에 연결되지 않은 기능

  • 없음. high 기능 11개(F-ENT01, F-TOP01, F-TOP02, F-TOP03, F-SRC01, F-SRC02, F-DTL01, F-DTL02, F-DTL03, F-DAT02, F-DAT03)가 모두 노드로 나온다.

결정 필요

  • 반영한 결정: D-4, D-5, D-7, D-10, D-11, D-13, D-15, D-16, D-18, D-20, D-21, D-22, D-23, D-25, D-26, D-27, D-28, D-29, D-30, D-32, D-33, D-34, D-36, D-38, D-39, D-40, D-41, D-42, D-43~D-48, D-50, D-52, D-54~D-74
  • 열린 질문: 없음(D-70~D-74는 결정됨으로 반영했다. D-74: 매달 1일 산출이 실패하면 남아 있는 이전 산출 결과로 그날 후보를 만든다)

기록

결정 기록

docs/decisions.md

기획 중에 나온 질문 74개와 답입니다. 결정됨 67개, 보류 7개입니다. ◆는 추천안과 다르게 정했거나 확인을 거쳐 정한 결정입니다.

ID단계질문 · 선택지(★ 추천)상태결정
D-1◆PRDTOP 5 콘텐츠의 월 조회수·저장 수 목표를 어떻게 둘까?
출시 후 첫 달 실측값을 기준선으로 삼고 이후 목표를 정한다★ / 지금 절대 수치를 정한다 / 목표 없이 추이만 본다
보류무시한다(사용자). 목표 수치를 두지 않는다.
D-2◆PRD출시 일정·예산·규제 제약이 있는가?
강의 과제용으로 일정·예산 제약 없음★ / 출시 일정이 있다(날짜 입력) / 모름
보류무시한다(사용자). 일정·예산 제약을 두지 않는다.
D-3◆PRD축제 데이터의 출처를 무엇으로 할까?
2026_festival.xlsx를 기본으로 하고 관광공사 축제공연행사로 좌표·이미지를 보강한다★ / 엑셀만 쓴다 / 관광공사 API만 쓴다
결정됨(2026-11-14 변경) 엑셀파일은 전혀 사용하지 않고, 한국관광공사 국문 관광정보 서비스_GW의 축제·관광정보를 활용한다. 시장 정보는 전통시장 API를 쓴다. (이전 결정: 축제 데이터는 엑셀만)
D-4◆PRD「장날」에 개설주기가 「매일」인 상설장을 포함할까?
날짜가 정해진 정기장(1일+6일 등)만 장날로 본다★ / 상설장도 포함한다 / 상설장은 별도 표시로만 보여 준다
결정됨상설장 포함한다.
D-5◆PRD축제와 시장을 「가깝다」고 보는 기준은?
같은 시군구★ / 시장 좌표 반경 N km(관광공사 좌표 필요) / 둘 다 지원
결정됨5km 이내로 한다.
D-6PRD엑셀 축제에는 위도·경도가 없다(D-3 엑셀만 활용). 5km 반경 매칭(D-5)에 쓸 축제 좌표를 어떻게 얻을까?
축제의 시도·시군구·읍면동을 행정구역 중심 좌표로 바꾼다★ / 장소명+주소를 지오코딩 API(예: 브이월드)로 좌표화한다 / 시군구 중심 좌표만 쓴다
보류D-3 변경으로 무효. 관광공사 축제 데이터에 좌표(mapx·mapy)가 있다.
D-7◆PRD상설장 포함(D-4)이면 상설장 근처 축제는 축제 기간 내내 「겹치는 날」이 된다. 「이번 달 겹치는 날 TOP 5」 순위를 무엇으로 매길까?
정기장(1일+6일 등) 장날과 겹치는 날을 우선하고, 같은 조건이면 축제 전년 방문객 수가 많은 순★ / 축제 전년 방문객 수만 / 5km 내 시장 수가 많은 순
결정됨정기장 장날과 겹치는 날을 우선하고, 같은 조건이면 축제 전년 방문객 수가 많은 순으로 한다. (2026-11-14 변경: 동률 기준은 D-25의 「축제 기간이 짧은 순」으로 바뀐다)
D-8기능 맵엑셀 1,266건 중 466건은 일(日)이 없다(월만 405건, 월도 없음 61건). 이 축제를 어떻게 다룰까?
겹치는 날 계산에서 빼고 상세·목록에도 노출하지 않는다★ / 계산에서 빼되 「날짜 미정 축제」로 따로 보여 준다 / 월 전체를 축제 기간으로 본다
보류D-3 변경으로 무효. 관광공사 축제 데이터는 시작일·종료일이 일 단위로 있다.
D-9◆PRD성공 지표에 「저장 수」가 있는데 브리프 MVP 표에는 저장이 없다. 저장 기능을 MVP에 넣을까?
겹치는 날 저장과 「저장한 날」 목록 보기를 MVP에 넣는다★ / 저장 없이 조회수만 지표로 둔다 / 하나원큐 공유·캘린더 내보내기로 대신한다
결정됨저장 없이 조회수만 지표로 둔다.
D-10◆PRD「겹치는 날」 한 건이자 TOP 5 한 칸의 단위는?
축제×날짜 1건(5km 안 시장 여러 곳을 묶어 보여 줌)★ / 축제×시장×날짜 1건 / 날짜 1건(그날 겹치는 축제·시장을 묶음)
결정됨축제 × 시장 × 날짜를 한 건으로 센다.
D-11기능 맵「이번 달」 기준과 TOP 5 게시 방식은? (자동 게시는 승인된 PRD의 「운영자가 TOP 5를 올린다」와 충돌하므로 고르면 PRD 수정 제안이 필요하다)
달력 월 기준, 매달 1일 D-7 규칙으로 후보를 자동 산출하고 운영자가 검수해 게시한다★ / 운영자가 규칙 결과를 참고해 직접 고른다 / 자동 산출·자동 게시(PRD 수정 필요)
결정됨달력 월 기준, 매달 1일 D-7 규칙으로 후보를 자동 산출하고 운영자가 검수해 게시한다.
D-12기능 맵놀이터 안 어디에 두고, 다른 진입점도 둘까?
놀이터 여행 탭(화면 24) 안 카드 하나로 둔다★ / 놀이터에 새 하위 탭을 만든다 / 놀이터에 더해 홈 배너(기존 배너 교체)·AI 검색에도 진입점을 둔다
결정됨추천안으로 정한다(사용자): 놀이터 여행 탭(화면 24) 안 카드 하나로 둔다
D-13◆기능 맵하나원큐에 로그인하지 않은 사람은 어떻게 처리할까?
로그인 사용자만 쓸 수 있다(하나원큐 기본 동작)★ / 비로그인도 조회할 수 있다
결정됨비로그인도 조회할 수 있다.
D-14◆기능 맵날짜·지역으로 찾기에서 지역 단위와 조회 기간은?
시도→시군구 선택, 오늘부터 2026-12-31까지(엑셀 수록 범위)★ / 시도만 선택, 2026년 전체 / 내 위치 기준 반경 검색
결정됨시도→시군구를 고르고, 오늘부터 2026-12-31까지 찾는다. (2026-11-14 변경: 기간은 D-28의 「오늘부터 3개월」로 바뀐다. 시도→시군구는 유지)
D-15기능 명세상세의 주변 관광정보는 어떤 종류를, 어떤 반경으로 보여 줄까?
시장 좌표 기준 5km 안 관광지·음식점★ / 시장 기준 2km 안 관광지·음식점 / 5km 안 관광지·음식점·숙박
결정됨추천안으로 정한다(사용자): 시장 좌표 기준 5km 안 관광지·음식점
D-16기능 명세좌표가 없는 시장 21곳은 어떻게 할까?
5km 판정에서 빼고 노출하지 않는다★ / 같은 읍면동 축제와 매칭한다 / 주소를 지오코딩해 좌표를 보강한다
결정됨추천안으로 정한다(사용자): 5km 판정에서 빼고 노출하지 않는다
D-17기능 명세D-7 동률 기준의 「전년 방문객 수」로 어느 값을 쓰고, 빈 값은 어떻게 할까?
엑셀 「전체」 값을 쓰고, 빈 값은 같은 조건 안에서 맨 뒤로 둔다★ / 내국인+외국인 합계를 쓰고 빈 값은 맨 뒤로 / 빈 값인 축제는 TOP 5 후보에서 뺀다
보류D-3 변경으로 무효. 관광공사 축제 데이터에 방문객 수가 없다(D-25에서 동률 기준을 다시 정한다).
D-18기능 맵「TOP 5 월 조회수」는 무엇을 셀까?
TOP 5 항목의 상세 진입 횟수★ / TOP 5 목록 노출 횟수 / 순 사용자 수
결정됨추천안으로 정한다(사용자): TOP 5 항목의 상세 진입 횟수
D-19기능 명세축제 데이터(2026년 개최 계획 엑셀)는 언제 바꿀까? 반영은 개발팀이 배포 때 한다(D-24).
새 연도 엑셀이 나오면 연 1회 반영한다★ / 2026년 한정 서비스로 운영한다 / 분기마다 수정본을 반영한다
보류D-3 변경으로 무효. 엑셀 교체가 없어진다.
D-20기능 명세D-10 때문에 한 축제가 같은 날 시장만 달리해 TOP 5의 여러 칸을 차지할 수 있다. TOP 5 안에 같은 축제가 두 번 이상 나와도 될까?
같은 축제는 TOP 5에 한 칸만 두고, D-7 순위가 가장 높은 축제×시장×날짜를 대표로 올린다★ / 중복을 허용한다(D-10 그대로) / 같은 축제·같은 날짜만 한 칸으로 묶고 날짜가 다르면 허용한다
결정됨추천안으로 정한다(사용자): 같은 축제는 TOP 5에 한 칸만 두고, D-7 순위가 가장 높은 축제×시장×날짜를 대표로 올린다
D-21기능 명세PRD 디바이스는 하나원큐 앱(모바일)뿐이다. 운영자의 TOP 5 검수·게시는 어디서 할까? (앱 밖 도구를 고르면 PRD 디바이스 추가가 필요하다)
하나원큐 기존 운영 관리 시스템(CMS)에 메뉴를 추가한다★ / 별도 웹 관리자 화면(PC, PRD 디바이스 추가 필요) / 개발팀이 검수 결과를 받아 배포로 게시한다
결정됨추천안으로 정한다(사용자): 하나원큐 기존 운영 관리 시스템(CMS)에 메뉴를 추가한다
D-22기능 명세한 건의 단위는 축제×시장×날짜를 유지한다(D-10). 상세에서 그 건의 시장만 보여 줄까, 같은 날 5km 안 다른 시장도 참고로 보여 줄까?
해당 건의 시장을 중심으로 보여 주고 같은 날 5km 안 다른 시장은 목록으로 함께 보여 준다★ / 해당 건의 시장만 보여 준다 / 축제 기간 전체의 5km 안 시장과 장날을 모두 보여 준다
결정됨추천안으로 정한다(사용자): 해당 건의 시장을 중심으로 보여 주고 같은 날 5km 안 다른 시장은 목록으로 함께 보여 준다
D-23기능 명세한 건의 단위는 축제×시장×날짜를 유지한다(D-10). 찾기 결과에서 같은 축제가 시장별로 여러 줄 나올 때 어떤 순서로 보여 주고, 화면에서 묶을까?
D-7과 같은 순서로 보여 주고 같은 축제는 한 묶음으로 접어 보여 준다★ / 날짜순으로 보여 주고 묶지 않는다 / 축제에서 시장까지 거리가 가까운 순으로 보여 준다
결정됨추천안으로 정한다(사용자): D-7과 같은 순서로 보여 주고 같은 축제는 한 묶음으로 접어 보여 준다
D-24기능 맵축제 엑셀을 올리고 교체하는 일을 운영자 기능으로 만들까, 개발·배포 작업으로 처리할까? (운영 기능의 디바이스 D-21과 연결)
개발팀이 배포 때 반영하고 운영자 기능은 두지 않는다★ / 운영자가 관리 도구에서 직접 올린다 / 운영자가 파일을 전달하면 개발팀이 반영한다
보류D-3 변경으로 무효. 엑셀 반영 작업이 없어진다.
D-25PRDD-7의 동률 기준인 「축제 전년 방문객 수」가 관광공사 데이터에는 없다. 정기장 장날 우선은 그대로 두고, 같은 조건일 때 무엇으로 순위를 매길까?
축제 기간이 짧은 순(드문 기회 우선)★ / 축제 좌표 5km 안 정기장 수가 많은 순 / 축제 시작일이 빠른 순
결정됨정기장 장날 우선은 그대로 두고, 같은 조건이면 축제 기간이 짧은 순으로 한다.
D-26기능 명세그 달의 겹치는 날 후보가 5건 미만이면 TOP 5를 어떻게 보여 줄까?
있는 건수만 보여 주고 「이번 달은 N건」이라고 알린다★ / 다음 달 초 겹치는 날로 채운다 / 상설장 포함 후보까지 기준을 낮춰 5건을 채운다
결정됨추천안으로 정한다(사용자): 있는 건수만 보여 주고 「이번 달은 N건」이라고 알린다
D-27기능 명세관광공사 축제 데이터의 일정 변경·취소를 언제 반영하고, 이미 게시한 TOP 5의 취소·변경 건은 어떻게 할까?
하루 1회 받아 계산에 반영하고, 게시된 TOP 5의 취소·변경 건은 운영자에게 알려 내리거나 고친다★ / 사용자 조회 때마다 원본 API를 부른다 / 매달 1일 TOP 5 산출 때만 받는다
결정됨추천안으로 정한다(사용자): 하루 1회 받아 계산에 반영하고, 게시된 TOP 5의 취소·변경 건은 운영자에게 알려 내리거나 고친다
D-28◆기능 맵찾기 종료일 2026-12-31은 엑셀 수록 범위를 근거로 정했다. 관광공사 데이터는 연도를 넘어 계속 갱신된다. 종료일을 어떻게 할까?
「오늘부터 N개월」처럼 이동하는 기간으로 바꾼다(D-14 수정)★ / 2026-12-31을 유지하고 2026년 한정으로 운영한다 / 관광공사에 등록된 가장 늦은 종료일까지 찾는다
결정됨오늘부터 3개월처럼 이동하는 기간으로 바꾼다(N = 3개월).
D-29PRD개설주기 「1일+6일」 같은 정기장 표기를 어떤 날짜로 바꿀까?
끝자리가 1·6인 날(1·6·11·16·21·26일, 5일장 관례)로 본다★ / 적힌 날짜(매달 1일·6일)만 장날로 본다 / 표기 유형별 변환표를 따로 정하고 변환할 수 없는 표기는 계산에서 뺀다
결정됨끝자리 방식으로 본다(「1일+6일」 → 1·6·11·16·21·26일).
D-30기능 명세정기장 우선 여부와 축제 기간이 모두 같으면 무엇으로 순위를 매길까?
날짜가 빠른 순★ / 축제와 시장 사이 거리가 가까운 순 / 운영자가 검수 때 정한다
결정됨추천안으로 정한다(사용자): 날짜가 빠른 순
D-31기능 명세주변 관광정보에 관광공사 축제공연행사(콘텐츠 타입 15)를 넣을까?
넣지 않는다(상세의 축제와 겹침)★ / 같은 날 진행 중인 다른 축제만 넣는다 / 모두 넣는다
결정됨추천안으로 정한다(사용자): 넣지 않는다(상세의 축제와 겹침)
D-32기능 명세매달 1일 달력 월 전체로 TOP 5를 산출하면, 그 달 중순 이후에는 이미 지난 날짜의 건이 게시된 채 남는다. 지난 건을 어떻게 할까?
그대로 두고 「지난 날」로 표시한다★ / 지난 건은 숨긴다 / 지난 건을 숨기고 다음 순위 후보로 채운다
결정됨추천안으로 정한다(사용자): 그대로 두고 「지난 날」로 표시한다
D-33기능 명세매달 1일 후보가 산출된 뒤 운영자가 게시하기 전까지 첫 화면에는 무엇을 보여 줄까?
「이번 달 TOP 5 준비 중」 안내와 찾기 진입을 보여 준다★ / 지난달 TOP 5를 「지난달」 표시와 함께 계속 보여 준다
결정됨추천안으로 정한다(사용자): 「이번 달 TOP 5 준비 중」 안내와 찾기 진입을 보여 준다
D-34기능 명세운영자는 검수 때 무엇까지 할 수 있을까?
후보를 빼면 다음 순위가 자동으로 올라오고, 순서는 바꾸지 않는다★ / 게시 승인·보류만 한다(내용 수정 없음) / 순서와 항목을 자유롭게 바꾼다
결정됨추천안으로 정한다(사용자): 후보를 빼면 다음 순위가 자동으로 올라오고, 순서는 바꾸지 않는다
D-35기능 명세찾기의 「날짜」는 하루 하나를 고르는가, 기간을 고르는가?
시작일~종료일 기간을 고른다★ / 하루 하나만 고른다 / 「이번 주말」 같은 빠른 선택에 기간 선택을 더한다
결정됨추천안으로 정한다(사용자): 시작일~종료일 기간을 고른다
D-36기능 명세시도만 고르고 시군구는 「전체」로 찾을 수 있게 할까?
시군구 「전체」를 허용한다★ / 시군구까지 꼭 고른다
결정됨추천안으로 정한다(사용자): 시군구 「전체」를 허용한다
D-37기능 명세지역 조건을 축제 주소 기준으로 맞출까, 시장 위치 기준으로 맞출까? (5km 매칭이라 서로 다른 시군구일 수 있다)
축제 주소의 시군구 기준★ / 시장 소재지의 시군구 기준(F-DAT02에 시장 주소 필드 추가 필요) / 둘 중 하나라도 맞으면 포함한다
결정됨추천안으로 정한다(사용자): 축제 주소의 시군구 기준
D-38기능 명세D-27 추천안의 「게시된 TOP 5 취소·변경 건을 운영자에게 알린다」가 범위 밖 「알림」과 부딪칠 수 있다. 범위 밖 알림은 사용자 대상만 뜻하는가?
사용자 대상 알림만 범위 밖이고, 운영자는 검수 도구 안 표시로 알린다★ / 운영자 알림도 두지 않고 운영자가 정기적으로 직접 확인한다 / 운영자 알림(메일·메신저)을 둔다(브리프 범위 수정 제안 필요)
결정됨추천안으로 정한다(사용자): 사용자 대상 알림만 범위 밖이고, 운영자는 검수 도구 안 표시로 알린다
D-39◆기능 명세여행 탭(화면 24) 안 진입 카드의 위치와 제목·설명 문구는?
맨 위 첫 카드, 제목 「축제도 보고 장도 보는 날」·설명 「이번 달 축제×장날 TOP 5」★ / 기존 카드 뒤 마지막, 같은 문구 / 운영자가 CMS에서 위치·문구를 바꾼다
결정됨기존 카드 뒤 마지막에 둔다. 문구는 제목 「축제도 보고 장도 보는 날」·설명 「이번 달 축제×장날 TOP 5」로 한다.
D-40기능 명세TOP 5 항목에 순위 외에 무엇을 보여 줄까? (이미지 없음·데이터 기준 시점은 D-56)
축제명·날짜(요일)·시장명·정기장/상설장 구분·대표 이미지★ / 축제명·날짜·시장명만 글자로 / 이미지 카드에 축제명·날짜만, 시장은 상세에서
결정됨축제명·날짜(요일)·시장명·정기장/상설장 구분·대표 이미지를 보여 준다.
D-41기능 명세TOP 5의 로딩과 후보 0건인 달은 어떻게 보여 줄까? (실패 문구는 D-55, 1~4건은 D-26)
로딩은 스켈레톤, 0건인 달은 운영자가 0건으로 게시하고 「이번 달은 겹치는 날이 없어요」와 찾기 진입을 보여 준다★ / 0건인 달은 준비 중 안내를 한 달 내내 유지한다 / 0건이면 찾기 화면으로 보낸다
결정됨로딩은 스켈레톤, 0건인 달은 운영자가 0건으로 게시하고 「이번 달은 겹치는 날이 없어요」와 찾기 진입을 보여 준다.
D-42기능 명세정기장 여부·축제 기간·날짜가 모두 같은 서로 다른 축제의 순서는?
축제–시장 거리가 가까운 순★ / contentid 오름차순 / 축제명 가나다순
결정됨축제–시장 거리가 가까운 순으로 한다.
D-43◆기능 명세운영자 검수로 넘기는 후보는 몇 건인가?
10건★ / 20건 / 그 달 전체
결정됨20건을 넘긴다.
D-44기능 명세게시된 건이 취소·변경됐을 때 「내리거나 고친다」(D-27)를 어떻게 할까?
내리면 다음 순위가 자동으로 올라와 다시 게시되고, 「고친다」는 최신 산출로 같은 건을 확인해 다시 게시한다★ / 내리기만 하고 빈 칸으로 둔다 / 그 달 후보를 다시 산출해 처음부터 검수한다
결정됨내리면 다음 순위가 자동으로 올라와 다시 게시되고, 변경은 최신 산출로 같은 건을 확인해 다시 게시한다.
D-45◆기능 명세어떤 변화를 「취소·변경」으로 보고 CMS에 표시할까?
새 산출 결과에서 그 건(축제×시장×날짜)이 없어진 경우만★ / 축제명·주소·이미지 변경도 포함 / 어떤 필드든 바뀌면
결정됨어떤 필드든 바뀌면 취소·변경으로 표시한다.
D-46◆기능 명세CMS 메뉴 권한은 누구에게 주고, 여러 운영자가 동시에 다루면 어떻게 할까?
권한 받은 운영자 누구나 검수·게시하고, 먼저 게시한 내용 기준으로 뒤 사람에게 최신 상태를 다시 불러오게 한다★ / 검수자와 게시 승인자를 나눈 2단계 / 달마다 담당 운영자 한 명만 다루도록 잠근다
결정됨검수자와 게시 승인자를 나눈 2단계로 한다.
D-47기능 명세하루 1회 수집 시각, 재시도, 끝내 실패하면, 시장 데이터 수집 주기는?
매일 새벽 4시(한국 시간) 축제·시장을 함께 받고 30분 간격 3회 재시도, 그래도 실패하면 전날 데이터로 산출하고 CMS에 실패 표시★ / 축제는 매일·시장은 매월 1일, 재시도 1회 / 실패하면 그날 산출을 건너뛴다
결정됨매일 새벽 4시(한국 시간)에 축제·시장을 함께 받고 30분 간격 3회 재시도, 그래도 실패하면 전날 데이터로 산출하고 CMS에 실패를 표시한다.
D-48기능 명세끝자리 방식 세부: ① 끝자리 1인 정기장의 31일 ② 「2일+4일+7일+9일」·「4일」·빈 표기의 변환
① 31일은 장날로 보지 않는다 ② 적힌 날짜마다 끝자리 방식을 똑같이 적용하고(「4일」→4·14·24일) 바꿀 수 없는 표기와 빈 표기는 산출에서 뺀다★ / ① 31일도 장날 ② 같은 방식 / 「N일+M일」 두 날짜 표기만 변환하고 나머지는 뺀다
결정됨31일은 장날로 보지 않는다. 적힌 날짜마다 끝자리 방식을 적용하고(「4일」→4·14·24일), 바꿀 수 없는 표기와 빈 표기는 산출에서 뺀다.
D-49기능 명세찾기 지역 조건(D-37)에 쓸 축제의 시도·시군구를 어디서 얻을까?
관광공사 응답의 지역 코드(시도·시군구 코드)를 수집 필드에 추가한다★ / addr1 앞부분 글자를 읽는다 / 좌표를 주소 변환 API로 바꾼다
결정됨관광공사 응답의 지역 코드(시도·시군구 코드)를 수집 필드에 추가한다.
D-50기능 명세「오늘부터 3개월」의 마지막 날과 기간 최대 길이는?
3개월 뒤 같은 날까지 고를 수 있고 기간 길이 제한은 없다★ / 오늘부터 90일, 제한 없음 / 3개월 뒤 같은 날까지, 한 번에 최대 1개월
결정됨3개월 뒤 같은 날까지 고를 수 있고 기간 길이 제한은 없다.
D-51기능 명세시도·시군구 목록은 어디서 만들고, 일반구가 있는 시는 어떻게 보여 줄까?
전국 행정구역 고정 목록, 일반구는 시 단위로 묶는다★ / 찾기 기간 안에 축제가 있는 지역만(시 단위) / 전국 목록, 일반구까지 나눠 고른다
결정됨전국 행정구역 고정 목록을 쓰고, 일반구는 시 단위로 묶는다.
D-52기능 명세처음 열 때 기본 조건, 실행 방식, 조건 유지 범위는?
지역 미선택·기간은 오늘~3개월 끝으로 채워 두고 「찾기」 버튼으로 실행하며, 상세에 다녀와도 서비스 안에서 조건을 유지한다(앱을 다시 열면 초기화)★ / 기본 조건 없이 바꿀 때마다 바로 반영 / 매번 초기화
결정됨지역은 비워 두고 기간은 오늘~3개월 끝으로 채운다. 「찾기」 버튼으로 실행하고, 상세에 다녀와도 조건을 유지한다(앱을 다시 열면 초기화).
D-53기능 명세찾기 결과에서 D-7 순서가 같은 건끼리, 묶음끼리는 어떤 순서로 둘까? (TOP 5의 D-30·D-42와 맞춘다)
건은 날짜가 빠른 순, 그다음 축제–시장 거리가 가까운 순(TOP 5와 같게), 묶음은 묶음 안 1순위 건의 순서로★ / 건은 시장 이름순, 묶음은 축제명 가나다순 / 둘 다 날짜순
결정됨TOP 5와 같은 순서로 둔다. 건은 날짜가 빠른 순, 그다음 축제–시장 거리가 가까운 순이고, 묶음은 묶음 안 1순위 건의 순서를 따른다.
D-54◆기능 명세찾기 목록에 무엇을 보여 주고 한 번에 몇 개를 보여 줄까? (이미지 없음·기준 시점은 D-56)
접힌 묶음은 축제명·대표 이미지·기간·건수, 펼친 줄은 날짜·시장명·정기장/상설장 구분, 한 번에 모두 보여 준다★ / 같은 항목으로 묶음 20개씩 더 불러온다
결정됨접힌 묶음에 축제명·대표 이미지·기간·건수, 펼친 줄에 날짜·시장명·정기장/상설장 구분을 보여 주고, 묶음 20개씩 스크롤하며 더 불러온다.
D-55기능 명세TOP 5·찾기·상세 공통 안내 문구와 버튼 이름은? (불러오기 실패, 빈 결과, 빠진 조건, 상세 빈 섹션, 찾기 진입 버튼)
제안 세트★: 실패 「정보를 불러오지 못했어요. 잠시 후 다시 시도해 주세요.」+[다시 시도], 빈 결과 「이 조건에는 축제와 장날이 겹치는 날이 없어요. 지역이나 날짜를 바꿔 보세요.」, 빠진 조건 「지역과 날짜를 골라 주세요.」, 상세 빈 섹션 「주변에 보여 드릴 정보가 없어요.」, 찾기 진입 버튼 「날짜·지역으로 찾기」 / 하나원큐 공통 오류 화면·공통 문구를 쓴다 / 디자인 단계에서 정한다
결정됨제안 문구 세트를 쓴다: 실패 「정보를 불러오지 못했어요. 잠시 후 다시 시도해 주세요.」+[다시 시도], 결과 없음 「이 조건에는 축제와 장날이 겹치는 날이 없어요. 지역이나 날짜를 바꿔 보세요.」, 조건 없음 「지역과 날짜를 골라 주세요.」, 상세 빈 영역 「주변에 보여 드릴 정보가 없어요.」, 찾기 진입 버튼 「날짜·지역으로 찾기」.
D-56기능 명세TOP 5·찾기·상세 공통: 빈 값, 이미지 없는 축제, 데이터 기준 시점은 어떻게 보여 줄까?
빈 항목은 숨기고, 이미지가 없으면 기본 이미지를 쓰고, TOP 5·찾기 목록·상세에 「데이터 기준 YYYY-MM-DD」를 보여 준다★ / 빈 항목은 「정보 없음」, 이미지 영역은 숨김, 기준 시점 없음 / 빈 항목은 숨기고 기본 이미지, 기준 시점은 상세에만
결정됨빈 항목은 숨기고, 이미지가 없으면 기본 이미지를 쓰며, TOP 5·찾기 목록·상세에 「데이터 기준 YYYY-MM-DD」를 보여 준다.
D-57◆기능 명세취소·변경으로 사라진 건과 날짜가 지난 건(D-32)의 상세는?
사라진 건은 「일정이 바뀌었거나 종료된 축제예요」와 목록으로 돌아가기, 지난 건은 그대로 열고 「지난 날」 표시★ / 사라진 건도 마지막 수집 정보로 보여 주고 「일정 변경 가능」 표시 / 둘 다 안내만 보여 준다
결정됨사라진 건도 마지막으로 받은 정보로 보여 주고 「일정 변경 가능」이라고 표시한다. 지난 건은 그대로 열고 「지난 날」로 표시한다.
D-58기능 명세시장 위치 표시, 같은 날 5km 안 다른 시장 목록의 순서·누르기 동작, 0곳일 때는?
도로명 주소(없으면 지번)와 축제에서의 직선거리(km), 거리 가까운 순, 누르면 그 시장 건의 상세로 바꾸고, 0곳이면 영역을 숨긴다★ / 주소만, 정기장 먼저·이름순, 누를 수 없음, 0곳이면 안내 문구 / 주소와 지도, 거리순, 누르면 그 시장 정보만 펼친다
결정됨도로명 주소(없으면 지번)와 축제에서의 직선거리(km)를 보여 준다. 다른 시장은 거리가 가까운 순이고 누르면 그 시장 건의 상세로 바뀌며, 없으면 영역을 숨긴다.
D-59기능 명세주변 관광지·음식점의 정렬, 건수, 표시 항목, 누르기 동작은?
거리순으로 종류별 5건까지, 이름·거리·주소·대표 이미지(없으면 숨김), 전화번호·더 보기 없음, 눌러도 다른 화면으로 이동하지 않는다★ / 거리순 종류별 10건, 이름·거리만 / 종류별 5건 뒤 「더 보기」로 5km 안 전체
결정됨거리순으로 종류별 5건까지, 이름·거리·주소·대표 이미지(없으면 숨김)를 보여 준다. 전화번호·더 보기는 없고, 눌러도 다른 화면으로 이동하지 않는다.
D-60◆기능 명세주변 관광정보는 언제 불러오고 실패하면 어떻게 할까? D-27(하루 1회 반영)이 주변 관광정보에도 적용되는가?
D-27은 축제·시장 데이터에만 적용하고, 주변 관광정보는 상세를 열 때 불러와 같은 시장 결과를 그날 하루 다시 쓰며, 실패하면 마지막 결과와 기준 시점, 없으면 실패 안내★ / D-27을 그대로 적용해 하루 1회 모든 시장의 주변 정보를 미리 받는다 / 열 때마다 새로 부르고 실패 시 안내만
결정됨(2026-11-15 변경) D-27은 축제·시장 데이터에만 적용한다. 주변 관광정보는 상세를 열 때 불러오고 같은 시장 결과는 그날 하루 다시 쓰며, 실패하면 마지막 결과와 기준 시점, 없으면 실패 안내를 보여 준다. 호출 수를 줄이기 위해서다(하루 최대 약 814회, 모든 시장 미리 받기는 약 2,764회). (이전 결정: 하루 1회 모든 시장 미리 받기)
D-61기능 명세전통시장 데이터에 고유 번호가 없다. 같은 시장을 무엇으로 알아보고, 이름·주소가 바뀌거나 겹치면 어떻게 할까?
시장명+도로명 주소(없으면 지번)로 알아보고, 바뀌면 새 시장으로 보며 게시된 TOP 5는 게시 당시 정보를 복사해 둔다★ / 시장명+좌표로 알아본다 / 매일 새로 만들고 게시된 TOP 5는 그날 산출의 복사본으로 남긴다
결정됨시장명+도로명 주소(없으면 지번)로 알아보고, 바뀌면 새 시장으로 보며, 게시된 TOP 5는 게시 당시 정보를 복사해 둔다.
D-62기능 명세첫 화면의 찾기 진입은 어디에, 어떤 상태에서 보여 줄까?
모든 상태(게시·준비 중·0건·실패)에서 TOP 5 위쪽에 고정 버튼으로 보여 준다★ / TOP 5 목록 아래에 둔다 / 준비 중·0건일 때만 보여 준다
결정됨모든 상태(게시됨·준비 중·0건·실패)에서 TOP 5 위쪽에 고정 버튼으로 보여 준다.
D-63기능 명세게시 전 검수 중인 후보에도 매일 취소·변경 표시를 붙일까?
붙인다(게시 전 후보와 게시된 건 모두 매일 점검)★ / 게시된 건만 붙인다
결정됨붙인다. 게시 전 후보와 게시된 건을 모두 매일 점검한다.
D-64기능 명세「3개월 뒤 같은 날」이 그 달에 없을 때(예: 11-30 → 2-30) 마지막 날을 언제로 할까?
그 달 말일★ / 다음 달 1일
결정됨그 달 말일로 한다.
D-65기능 명세2단계에서 승인자가 승인하지 않으면 어떻게 하고, 게시된 건을 내리거나 고쳐 다시 게시할 때(D-44)는 누가 맡고 승인을 다시 거칠까?
승인하지 않으면 검수로 되돌리고, 내리기·변경은 검수자가 맡아 다시 게시도 승인을 거친다★ / 되돌리되 다음 순위 자동 재게시는 승인 없이 바로 반영한다 / 게시 승인자가 혼자 처리한다
결정됨승인하지 않으면 검수로 되돌리고, 내리기·변경은 검수자가 맡아 다시 게시도 승인을 거친다.
D-66기능 명세한 운영자가 검수자·승인자 권한을 함께 가질 수 있을까? 같은 역할 여럿이 같은 달을 동시에 다루면?
겸임 불가, 같은 역할끼리는 먼저 저장한 내용 기준으로 뒤 사람이 최신 상태를 다시 불러온다★ / 겸임은 허용하되 같은 달의 검수와 승인은 다른 사람이 한다 / 달마다 역할별 담당자 한 명만 다루도록 잠근다
결정됨겸임할 수 없다. 같은 역할끼리는 먼저 저장한 내용 기준으로 뒤 사람이 최신 상태를 다시 불러온다.
D-67기능 명세이미 게시된 달에서 내리기·변경이 승인 대기인 동안 게시 상태를 어떻게 둘까? (첫 화면은 다시 게시 전까지 게시 당시 복사본을 보여 준다)
게시됨 상태는 그대로 두고 수정 게시안을 따로 「승인 대기」로 둔다★ / 상태에 「재게시 승인 대기」를 추가한다
결정됨게시됨 상태는 그대로 두고 수정 게시안을 따로 「승인 대기」로 둔다(추천안).
D-68◆기능 명세주변 관광정보 호출이 실패하면 그날 다시 부를까?
(사용자 지시로 결정) 실패도 그날 기록으로 「호출 실패」 저장, 그날은 다시 부르지 않는다
결정됨실패한 조회도 「호출 실패」로 저장해 하루에 추가로 호출하지 않는다. 이 영역에는 [다시 시도] 버튼을 두지 않는다.
D-69◆기능 명세주변 관광정보는 실패하면 그날 다시 부르지 않는데(D-68), 공통 실패 문구의 「잠시 후 다시 시도」와 맞지 않는다. 이 영역 문구를 바꿀까?
(사용자 지시로 결정) 「지금은 주변 정보를 불러올 수 없어요. 내일 다시 확인해 주세요.」로 바꾼다
결정됨주변 관광정보 영역의 실패 문구만 「지금은 주변 정보를 불러올 수 없어요. 내일 다시 확인해 주세요.」로 바꾼다.
D-70◆유저플로우「같은 날 5km 안 다른 시장」을 눌러 바뀐 상세에서 뒤로 가면 어디로 갈까?
처음 들어온 목록(TOP 5 또는 찾기 결과)으로 바로 돌아간다★ / 바꾸기 전 시장의 상세로 한 단계씩 돌아간다
결정됨바꾸기 전 시장의 상세로 한 단계씩 돌아간다.
D-71유저플로우서비스 첫 화면(TOP 5)에서 뒤로 가면 어디로 갈까?
놀이터 여행 탭(화면 24)으로 돌아간다★ / 하나원큐 홈으로 간다 / 하나원큐 앱의 기본 뒤로 가기 동작에 맡긴다
결정됨놀이터 여행 탭(화면 24)으로 돌아간다.
D-72◆유저플로우찾기 화면을 연 채 날짜가 바뀌어 고른 기간이 범위를 벗어나면 어떤 안내를 보일까?
「지역과 날짜를 골라 주세요.」를 그대로 쓴다★ / 새 문구 「고를 수 있는 날짜가 바뀌었어요. 날짜를 다시 골라 주세요.」 / 안내 없이 기간을 새 오늘 기준 기본값으로 다시 채운다
결정됨새 문구 「고를 수 있는 날짜가 바뀌었어요. 날짜를 다시 골라 주세요.」를 쓴다.
D-73유저플로우상세에서 찾기 결과로 돌아올 때 펼친 묶음, 스크롤 위치, 이미 불러온 묶음을 유지할까?
모두 유지한다★ / 조건만 유지하고 결과는 처음 20개 접힌 상태로 다시 보여 준다
결정됨펼친 묶음, 스크롤 위치, 이미 불러온 묶음을 모두 유지한다.
D-74유저플로우매달 1일 겹치는 날 산출이 도중에 실패해 이전 산출 결과가 남았을 때, 그 달 TOP 5 후보는 어떻게 만들까?
남아 있는 이전 산출 결과로 그날 후보를 만든다★ / 산출을 다시 돌려 성공한 뒤 만든다 / 그날은 만들지 않고 다음 날 산출 뒤 만든다
결정됨남아 있는 이전 산출 결과로 그날 후보를 만든다.

기록

특별 결정

docs/decisions_special.md

작성일: 2026-11-15(유저플로우 단계 결정 추가) · 원본: docs/decisions.md
추천안(★)과 다르게 정했거나, 추천안이라도 세부 설명·계산·재검토를 거쳐 정한 결정만 모았다. 질문·선택지·결정 문장은 docs/decisions.md에서 그대로 옮겼다.

요약

구분결정 ID
추천안과 다르게 정함D-3, D-4, D-5, D-9, D-10, D-13, D-39, D-43, D-45, D-46, D-54, D-57, D-70, D-72
추천안이지만 세부 확인 후 정함 / 정한 뒤 바뀜 / 사용자 직접 지시D-1·D-2, D-7, D-14, D-28, D-60, D-68, D-69

1. 추천안(★)과 다르게 정한 결정

D-3 축제 데이터 출처

  • 경위: ★ 엑셀 기본 + 관광공사로 보강 → 처음엔 「엑셀만」을 골랐다가, PRD 승인 뒤 「엑셀은 전혀 쓰지 않고 관광공사 API」로 전면 변경했다. 브리프·PRD·기능 맵을 재검토했다.
  • D-3 질문: 축제 데이터의 출처를 무엇으로 할까?
  • 선택지: 2026_festival.xlsx를 기본으로 하고 관광공사 축제공연행사로 좌표·이미지를 보강한다★ / 엑셀만 쓴다 / 관광공사 API만 쓴다
  • 추천안: 2026_festival.xlsx를 기본으로 하고 관광공사 축제공연행사로 좌표·이미지를 보강한다
  • 최종 결정(결정됨): (2026-11-14 변경) 엑셀파일은 전혀 사용하지 않고, 한국관광공사 국문 관광정보 서비스_GW의 축제·관광정보를 활용한다. 시장 정보는 전통시장 API를 쓴다. (이전 결정: 축제 데이터는 엑셀만)

D-4 장날에 상설장 포함

  • 경위: ★ 정기장만 → 상설장도 포함. 이 결정 때문에 희소성을 지키는 TOP 5 순위 규칙(D-7·D-25)이 중요해졌다.
  • D-4 질문: 「장날」에 개설주기가 「매일」인 상설장을 포함할까?
  • 선택지: 날짜가 정해진 정기장(1일+6일 등)만 장날로 본다★ / 상설장도 포함한다 / 상설장은 별도 표시로만 보여 준다
  • 추천안: 날짜가 정해진 정기장(1일+6일 등)만 장날로 본다
  • 최종 결정(결정됨): 상설장 포함한다.

D-5 축제–시장 매칭 기준

  • 경위: ★ 같은 시군구 → 5km 이내. 축제 좌표가 필요해졌다(D-6, 이후 관광공사 좌표로 해결).
  • D-5 질문: 축제와 시장을 「가깝다」고 보는 기준은?
  • 선택지: 같은 시군구★ / 시장 좌표 반경 N km(관광공사 좌표 필요) / 둘 다 지원
  • 추천안: 같은 시군구
  • 최종 결정(결정됨): 5km 이내로 한다.

D-9 저장 기능

  • 경위: ★ 저장·저장 목록 포함 → 저장 없이 조회수만. 브리프의 성공 지표 「저장 수」를 뺐다.
  • D-9 질문: 성공 지표에 「저장 수」가 있는데 브리프 MVP 표에는 저장이 없다. 저장 기능을 MVP에 넣을까?
  • 선택지: 겹치는 날 저장과 「저장한 날」 목록 보기를 MVP에 넣는다★ / 저장 없이 조회수만 지표로 둔다 / 하나원큐 공유·캘린더 내보내기로 대신한다
  • 추천안: 겹치는 날 저장과 「저장한 날」 목록 보기를 MVP에 넣는다
  • 최종 결정(결정됨): 저장 없이 조회수만 지표로 둔다.

D-10 겹치는 날 한 건의 단위

  • 경위: ★ 축제×날짜 → 축제×시장×날짜. 같은 축제가 여러 칸을 차지하는 문제(D-20)와 찾기 묶음(D-23)이 이어서 생겼다.
  • D-10 질문: 「겹치는 날」 한 건이자 TOP 5 한 칸의 단위는?
  • 선택지: 축제×날짜 1건(5km 안 시장 여러 곳을 묶어 보여 줌)★ / 축제×시장×날짜 1건 / 날짜 1건(그날 겹치는 축제·시장을 묶음)
  • 추천안: 축제×날짜 1건(5km 안 시장 여러 곳을 묶어 보여 줌)
  • 최종 결정(결정됨): 축제 × 시장 × 날짜를 한 건으로 센다.

D-13 비로그인 처리

  • 경위: ★ 로그인 사용자만 → 비로그인도 조회 가능.
  • D-13 질문: 하나원큐에 로그인하지 않은 사람은 어떻게 처리할까?
  • 선택지: 로그인 사용자만 쓸 수 있다(하나원큐 기본 동작)★ / 비로그인도 조회할 수 있다
  • 추천안: 로그인 사용자만 쓸 수 있다(하나원큐 기본 동작)
  • 최종 결정(결정됨): 비로그인도 조회할 수 있다.

D-39 진입 카드 위치

  • 경위: ★ 여행 탭 맨 위 → 기존 카드 뒤 마지막.
  • D-39 질문: 여행 탭(화면 24) 안 진입 카드의 위치와 제목·설명 문구는?
  • 선택지: 맨 위 첫 카드, 제목 「축제도 보고 장도 보는 날」·설명 「이번 달 축제×장날 TOP 5」★ / 기존 카드 뒤 마지막, 같은 문구 / 운영자가 CMS에서 위치·문구를 바꾼다
  • 추천안: 맨 위 첫 카드, 제목 「축제도 보고 장도 보는 날」·설명 「이번 달 축제×장날 TOP 5」
  • 최종 결정(결정됨): 기존 카드 뒤 마지막에 둔다. 문구는 제목 「축제도 보고 장도 보는 날」·설명 「이번 달 축제×장날 TOP 5」로 한다.

D-43 검수로 넘기는 후보 수

  • 경위: ★ 10건 → 20건.
  • D-43 질문: 운영자 검수로 넘기는 후보는 몇 건인가?
  • 선택지: 10건★ / 20건 / 그 달 전체
  • 추천안: 10건
  • 최종 결정(결정됨): 20건을 넘긴다.

D-45 취소·변경으로 볼 범위

  • 경위: ★ 그 건이 없어진 경우만 → 어떤 필드든 바뀌면.
  • D-45 질문: 어떤 변화를 「취소·변경」으로 보고 CMS에 표시할까?
  • 선택지: 새 산출 결과에서 그 건(축제×시장×날짜)이 없어진 경우만★ / 축제명·주소·이미지 변경도 포함 / 어떤 필드든 바뀌면
  • 추천안: 새 산출 결과에서 그 건(축제×시장×날짜)이 없어진 경우만
  • 최종 결정(결정됨): 어떤 필드든 바뀌면 취소·변경으로 표시한다.

D-46 CMS 권한 구조

  • 경위: ★ 누구나 검수·게시 → 검수자·게시 승인자 2단계. 이어서 D-65·D-66·D-67이 생겼다.
  • D-46 질문: CMS 메뉴 권한은 누구에게 주고, 여러 운영자가 동시에 다루면 어떻게 할까?
  • 선택지: 권한 받은 운영자 누구나 검수·게시하고, 먼저 게시한 내용 기준으로 뒤 사람에게 최신 상태를 다시 불러오게 한다★ / 검수자와 게시 승인자를 나눈 2단계 / 달마다 담당 운영자 한 명만 다루도록 잠근다
  • 추천안: 권한 받은 운영자 누구나 검수·게시하고, 먼저 게시한 내용 기준으로 뒤 사람에게 최신 상태를 다시 불러오게 한다
  • 최종 결정(결정됨): 검수자와 게시 승인자를 나눈 2단계로 한다.

D-54 찾기 목록 불러오기

  • 경위: 「접힌 묶음·펼친 줄·같은 항목」의 뜻을 설명받은 뒤, ★ 한 번에 모두 → 묶음 20개씩 더 불러오기를 골랐다.
  • D-54 질문: 찾기 목록에 무엇을 보여 주고 한 번에 몇 개를 보여 줄까? (이미지 없음·기준 시점은 D-56)
  • 선택지: 접힌 묶음은 축제명·대표 이미지·기간·건수, 펼친 줄은 날짜·시장명·정기장/상설장 구분, 한 번에 모두 보여 준다★ / 같은 항목으로 묶음 20개씩 더 불러온다
  • 추천안: 접힌 묶음은 축제명·대표 이미지·기간·건수, 펼친 줄은 날짜·시장명·정기장/상설장 구분, 한 번에 모두 보여 준다
  • 최종 결정(결정됨): 접힌 묶음에 축제명·대표 이미지·기간·건수, 펼친 줄에 날짜·시장명·정기장/상설장 구분을 보여 주고, 묶음 20개씩 스크롤하며 더 불러온다.

D-57 사라진 건·지난 건의 상세

  • 경위: 선택지를 섞어 직접 정했다: 사라진 건은 2번(마지막 정보 + 「일정 변경 가능」), 지난 건은 1번처럼 그대로 열고 「지난 날」 표시.
  • D-57 질문: 취소·변경으로 사라진 건과 날짜가 지난 건(D-32)의 상세는?
  • 선택지: 사라진 건은 「일정이 바뀌었거나 종료된 축제예요」와 목록으로 돌아가기, 지난 건은 그대로 열고 「지난 날」 표시★ / 사라진 건도 마지막 수집 정보로 보여 주고 「일정 변경 가능」 표시 / 둘 다 안내만 보여 준다
  • 추천안: 사라진 건은 「일정이 바뀌었거나 종료된 축제예요」와 목록으로 돌아가기, 지난 건은 그대로 열고 「지난 날」 표시
  • 최종 결정(결정됨): 사라진 건도 마지막으로 받은 정보로 보여 주고 「일정 변경 가능」이라고 표시한다. 지난 건은 그대로 열고 「지난 날」로 표시한다.

D-70 다른 시장 상세에서 뒤로 가기

  • 경위: ★ 처음 들어온 목록으로 바로 → 바꾸기 전 시장의 상세로 한 단계씩.
  • D-70 질문: 「같은 날 5km 안 다른 시장」을 눌러 바뀐 상세에서 뒤로 가면 어디로 갈까?
  • 선택지: 처음 들어온 목록(TOP 5 또는 찾기 결과)으로 바로 돌아간다★ / 바꾸기 전 시장의 상세로 한 단계씩 돌아간다
  • 추천안: 처음 들어온 목록(TOP 5 또는 찾기 결과)으로 바로 돌아간다
  • 최종 결정(결정됨): 바꾸기 전 시장의 상세로 한 단계씩 돌아간다.

D-72 날짜가 바뀌어 찾기 기간을 벗어날 때 안내

  • 경위: ★ 기존 문구 「지역과 날짜를 골라 주세요.」 → 새 문구 「고를 수 있는 날짜가 바뀌었어요. 날짜를 다시 골라 주세요.」.
  • D-72 질문: 찾기 화면을 연 채 날짜가 바뀌어 고른 기간이 범위를 벗어나면 어떤 안내를 보일까?
  • 선택지: 「지역과 날짜를 골라 주세요.」를 그대로 쓴다★ / 새 문구 「고를 수 있는 날짜가 바뀌었어요. 날짜를 다시 골라 주세요.」 / 안내 없이 기간을 새 오늘 기준 기본값으로 다시 채운다
  • 추천안: 「지역과 날짜를 골라 주세요.」를 그대로 쓴다
  • 최종 결정(결정됨): 새 문구 「고를 수 있는 날짜가 바뀌었어요. 날짜를 다시 골라 주세요.」를 쓴다.

2. 추천안이지만 세부 확인 후 정했거나, 정한 뒤 바뀌었거나, 직접 지시한 결정

D-1·D-2 목표 수치·일정·예산

  • 경위: 추천안이 있었지만 「무시」하라고 해 보류했다. 목표 수치와 일정·예산 제약을 두지 않는다.
  • D-1 질문: TOP 5 콘텐츠의 월 조회수·저장 수 목표를 어떻게 둘까?
  • 선택지: 출시 후 첫 달 실측값을 기준선으로 삼고 이후 목표를 정한다★ / 지금 절대 수치를 정한다 / 목표 없이 추이만 본다
  • 추천안: 출시 후 첫 달 실측값을 기준선으로 삼고 이후 목표를 정한다
  • 최종 결정(보류): 무시한다(사용자). 목표 수치를 두지 않는다.
  • D-2 질문: 출시 일정·예산·규제 제약이 있는가?
  • 선택지: 강의 과제용으로 일정·예산 제약 없음★ / 출시 일정이 있다(날짜 입력) / 모름
  • 추천안: 강의 과제용으로 일정·예산 제약 없음
  • 최종 결정(보류): 무시한다(사용자). 일정·예산 제약을 두지 않는다.

D-7 TOP 5 순위

  • 경위: ★로 정했지만, 데이터 출처 변경(D-3)으로 「전년 방문객 수」가 없어져 동률 기준을 D-25(축제 기간이 짧은 순, ★)로 바꿨다.
  • D-7 질문: 상설장 포함(D-4)이면 상설장 근처 축제는 축제 기간 내내 「겹치는 날」이 된다. 「이번 달 겹치는 날 TOP 5」 순위를 무엇으로 매길까?
  • 선택지: 정기장(1일+6일 등) 장날과 겹치는 날을 우선하고, 같은 조건이면 축제 전년 방문객 수가 많은 순★ / 축제 전년 방문객 수만 / 5km 내 시장 수가 많은 순
  • 추천안: 정기장(1일+6일 등) 장날과 겹치는 날을 우선하고, 같은 조건이면 축제 전년 방문객 수가 많은 순
  • 최종 결정(결정됨): 정기장 장날과 겹치는 날을 우선하고, 같은 조건이면 축제 전년 방문객 수가 많은 순으로 한다. (2026-11-14 변경: 동률 기준은 D-25의 「축제 기간이 짧은 순」으로 바뀐다)

D-14 찾기 지역·기간

  • 경위: ★(시도→시군구, 오늘~2026-12-31)로 정했지만, 종료일 근거(엑셀)가 사라져 D-28에서 기간을 다시 정했다.
  • D-14 질문: 날짜·지역으로 찾기에서 지역 단위와 조회 기간은?
  • 선택지: 시도→시군구 선택, 오늘부터 2026-12-31까지(엑셀 수록 범위)★ / 시도만 선택, 2026년 전체 / 내 위치 기준 반경 검색
  • 추천안: 시도→시군구 선택, 오늘부터 2026-12-31까지(엑셀 수록 범위)
  • 최종 결정(결정됨): 시도→시군구를 고르고, 오늘부터 2026-12-31까지 찾는다. (2026-11-14 변경: 기간은 D-28의 「오늘부터 3개월」로 바뀐다. 시도→시군구는 유지)

D-28 찾기 기간

  • 경위: 질문 전체를 다시 받아 본 뒤 1번(이동하는 기간)을 고르고 N=3개월로 정했다.
  • D-28 질문: 찾기 종료일 2026-12-31은 엑셀 수록 범위를 근거로 정했다. 관광공사 데이터는 연도를 넘어 계속 갱신된다. 종료일을 어떻게 할까?
  • 선택지: 「오늘부터 N개월」처럼 이동하는 기간으로 바꾼다(D-14 수정)★ / 2026-12-31을 유지하고 2026년 한정으로 운영한다 / 관광공사에 등록된 가장 늦은 종료일까지 찾는다
  • 추천안: 「오늘부터 N개월」처럼 이동하는 기간으로 바꾼다(D-14 수정)
  • 최종 결정(결정됨): 오늘부터 3개월처럼 이동하는 기간으로 바꾼다(N = 3개월).

D-60 주변 관광정보 불러오는 시점

  • 경위: 처음엔 2번(하루 1회 모든 시장 미리 받기)을 골랐다. API 호출 수를 실제 데이터로 계산(미리 받기 약 2,764회, 열 때 받기 최대 약 814회)해 본 뒤 원래 1번(상세를 열 때 받고 하루 다시 쓰기)으로 바꿨다.
  • D-60 질문: 주변 관광정보는 언제 불러오고 실패하면 어떻게 할까? D-27(하루 1회 반영)이 주변 관광정보에도 적용되는가?
  • 선택지: D-27은 축제·시장 데이터에만 적용하고, 주변 관광정보는 상세를 열 때 불러와 같은 시장 결과를 그날 하루 다시 쓰며, 실패하면 마지막 결과와 기준 시점, 없으면 실패 안내★ / D-27을 그대로 적용해 하루 1회 모든 시장의 주변 정보를 미리 받는다 / 열 때마다 새로 부르고 실패 시 안내만
  • 추천안: D-27은 축제·시장 데이터에만 적용하고, 주변 관광정보는 상세를 열 때 불러와 같은 시장 결과를 그날 하루 다시 쓰며, 실패하면 마지막 결과와 기준 시점, 없으면 실패 안내
  • 최종 결정(결정됨): (2026-11-15 변경) D-27은 축제·시장 데이터에만 적용한다. 주변 관광정보는 상세를 열 때 불러오고 같은 시장 결과는 그날 하루 다시 쓰며, 실패하면 마지막 결과와 기준 시점, 없으면 실패 안내를 보여 준다. 호출 수를 줄이기 위해서다(하루 최대 약 814회, 모든 시장 미리 받기는 약 2,764회). (이전 결정: 하루 1회 모든 시장 미리 받기)

D-68 실패한 조회 처리

  • 경위: 명세 검토 때 「실패하면 같은 날 다시 부른다」는 해석을 보고, 실패도 「호출 실패」로 저장해 그날 다시 부르지 않도록 직접 지시했다.
  • D-68 질문: 주변 관광정보 호출이 실패하면 그날 다시 부를까?
  • 선택지: (사용자 지시로 결정) 실패도 그날 기록으로 「호출 실패」 저장, 그날은 다시 부르지 않는다
  • 추천안: (추천안 없음)
  • 최종 결정(결정됨): 실패한 조회도 「호출 실패」로 저장해 하루에 추가로 호출하지 않는다. 이 영역에는 [다시 시도] 버튼을 두지 않는다.

D-69 주변 정보 실패 문구

  • 경위: D-68 때문에 공통 문구 「잠시 후 다시 시도」가 맞지 않게 되어, 이 영역 문구를 「지금은 주변 정보를 불러올 수 없어요. 내일 다시 확인해 주세요.」로 바꿨다.
  • D-69 질문: 주변 관광정보는 실패하면 그날 다시 부르지 않는데(D-68), 공통 실패 문구의 「잠시 후 다시 시도」와 맞지 않는다. 이 영역 문구를 바꿀까?
  • 선택지: (사용자 지시로 결정) 「지금은 주변 정보를 불러올 수 없어요. 내일 다시 확인해 주세요.」로 바꾼다
  • 추천안: (추천안 없음)
  • 최종 결정(결정됨): 주변 관광정보 영역의 실패 문구만 「지금은 주변 정보를 불러올 수 없어요. 내일 다시 확인해 주세요.」로 바꾼다.

기록

참고: 하나원큐 IA

docs/ref-hanaoneq-ia.md

출처: https://www.figma.com/board/7xdmxWV14KknPdAJqRizL8/ (FigJam, 2026-11-14 열람)
파이프라인 단계 문서가 아니라 PRD·유저플로우 작성 때 참고하는 자료이다. 보드에 적힌 내용만 옮겼다.

1. 보드 구성

구역내용
① 과제 개요은행 앱 안에 공공데이터를 활용한 신규 서비스를 런칭하는 과제
② IA 플로우차트하단 탭 5개 기준 서비스 구조
③ 화면 지도실제 화면(마스킹)과 와이어프레임, 화면 번호 01~24
④ 진입점 맵신규 생활밀착 서비스를 어디에 붙일지 후보 위치
⑤ 조별 작업 공간1~4조 결과 정리 공간

2. 과제 배경 (보드에 적힌 가정)

  • 하나은행은 차세대 디지털 플랫폼 구축사업 이후 개편된 하나원큐를 출시했고, 「MZ세대 고객」과 「자산관리(WM) 고객」 특성을 정의하는 데서 출발했다.
  • 이슈사항(가정): 건강자산관리, 축구/농구 play, 놀이터/이벤트 등 라이프스타일 서비스로 방문 빈도는 늘었지만, 앱이 무거워지면서 구형 단말기 사용자 이탈과 「금융 본연의 목적을 방해한다」는 불만이 제기되고 있다.
  • 데이터 상황(더미): 비금융 콘텐츠 업데이트 후 앱 실행 속도 1.5초 지연 / MAU 15% 상승했지만 앱 내 송금 성공률은 3% 하락 / MZ세대 유입은 늘었지만 자산 규모가 큰 5060 고객의 앱 체류 시간 20% 감소.
  • 핵심 키워드: 비금융 MAU, 금융 거래 전환율, 앱 로딩 속도, 테크 뎁트, 사용자 인지 부하, 구형 단말기 점유율, 크로스셀링 시너지.
  • 미션: ① 제시된 데이터로 현황 분석 ② 금융 vs 비금융 중 더 강화할 영역 선택과 사유 제시 ③ 비금융 강화 차원에서 공공데이터 하나를 선택해 도입 사유·기획서 초안·프로토타입 제작.
  • 제공 공공데이터 6종: 사주와 역법(한국천문연구원 음양력) / 영화(KOBIS 박스오피스) / 여행(한국관광공사 국문 관광정보 서비스) / 여객 운항(인천국제공항공사) / 네이버지도(지도·주소변환) / 부동산(국토교통부 아파트 매매 실거래가).

3. IA — 하단 탭 5개

범례: 주황 = 비금융/생활 서비스, 민트 = 하단 탭, 흰색 = 금융 기능

홈 탭

  • MY / 홈-간편 전환 / 알림
  • 대표계좌 카드: 가져오기 / 보내기
  • 전체계좌 보기
  • 배너 캐러셀(10개) — 비금융. 「출석체크 배너」로 놀이터에 연결된다.
  • 바로가기: 공과금 / 이벤트 / 모임서비스 / 청약홈추천 / 메뉴추가 → 놀이터, 하나의 운세로 연결된다.
  • 하나금융그룹: 카드 / 머니 / 증권 / 캐피탈
  • 내 자산(분석)
  • 하단 퀵링: 검색 / FX마켓 / 건강자산관리 / 마이데이터 / 개인사업자

놀이터 (비금융/생활, 홈 바로가기에서 진입)

  • 캐시·쿠폰 잔액 / 설렘 이야기 → 할까말까 / 오늘의 운세 / OX게임 → 캐시 PICK(행운룰렛·축구퀴즈·하나머니·CU·현금) → 100% 당첨 / 혜택 / 캐시톡
  • 하위 탭
  • 여행: 트래블로그 카드 / 환전 / 스마트패스 / 바이오항공권 / 적립 챌린지
  • 심리테스트 / 운세: 하루 점수 / 재물운
  • 재미: 출석체크 / 메뉴추천 / 퀴즈 등
  • 화면 번호: 20 놀이터 메인, 21 캐시PICK·100% 당첨, 22 재미, 23 심리테스트·운세, 24 여행

자산 탭

  • 예적금 추천 카드 / 아파트 시세 알림(비금융) / 월 지출·소비 스타일 / 신용정보 조회 알림 / 건강자산관리(비금융) / 하나로 자산관리 / 총자산(계좌·투자·대출·연금·외화·보험) → 실물자산(부동산·자동차 등, 비금융) / 리포트 / 요즘, 한 페이지(콘텐츠, 비금융) / 자산연동·연결 관리

상품 탭

  • 대표 상품 배너 / ETF·모임통장·FX마켓 / 상품 검색·모든 상품

투자 탭

  • 투자계좌 금액순 확인 / 코스피·코스닥·환율 카드 / 오늘의 지수·환율·증권

메뉴 탭(전체메뉴)

  • AI 검색(음성) / 인증·보안·쿠폰함·영업점·고객센터 / 최근 이용 메뉴
  • 카테고리 탭: 조회 / 이체 / 자산관리 / 예적금 / 퇴직연금 / 펀드·신탁 / ISA / 대출 / 외환 / 보험 / 공과금 / 번호표·출금·월렛

4. 진입점 맵 — 신규 생활밀착 서비스 후보 위치

보드 안내: 앱이 무거워지는 문제(실행 1.5초 지연)와 5060 고객 인지 부하를 함께 고려한다. 괄호 안 번호는 ③ 화면 지도의 화면 번호이다.

후보 위치어울리는 공공 API(보드 예시)따져볼 점(보드 메모)
홈 › 바로가기 「메뉴 추가」 슬롯 (03)사주와 역법: 하나의 운세 옆 음양력·절기 기반 「금융 달력」사용자가 직접 추가하는 방식이라 기본 홈을 무겁게 만들지 않는다
홈 › 배너 캐러셀 10개 (01·02)영화/여행: 이번 주 박스오피스·주말 축제 기반 이벤트 배너이미 10개 순환 중이므로 배너 추가보다 기존 배너 교체가 현실적이다
홈 › 하단 퀵칩 (01)네이버지도: 내 주변 영업점·ATM·환전 가능 지점노출은 최강이지만 공간이 가장 좁다. 칩 1개 = 기능 1개
놀이터 › 여행 탭 확장 (24)여객 운항 + 관광정보: 내 항공편 실시간 상태 → 환전·트래블로그 연결비금융 MAU와 금융 전환(환전·카드)을 한 동선에서 연결한다
놀이터 › 재미 탭 / 하나의 운세 (22·23)영화 / 사주와 역법: 박스오피스 OX퀴즈, 특일·기념일 운세캐시 보상 구조(캐시PICK)에 묶으면 참여 유도가 쉽다
자산 › 실물자산·아파트 시세 알림 (04·07)부동산 실거래가: 관심 단지 실거래 알림 → 대출·청약 연결5060 자산가 체류 시간 회복에 직접 기여한다
자산 › 요즘, 한 페이지 (08)부동산 / 여행: 콘텐츠 큐레이션콘텐츠형이라 별도 화면 개발 부담이 적다
메뉴 › AI 검색·영업점 (11)네이버지도 / 전체 API: 「근처 영업점」, 「이번 주 축제」 자연어 질의신규 메뉴 없이 기존 검색 진입점을 재활용한다

5. 이 서비스와 관련해 눈여겨볼 점 (사실 정리)

  • 브리프의 진입 위치인 「놀이터」는 홈 바로가기에서 들어가는 비금융 영역이며, 이미 여행 탭(화면 24)이 있다.
  • 보드의 진입점 후보 중 「홈 배너 — 주말 축제 기반 이벤트 배너」, 「놀이터 여행 탭 확장」, 「메뉴 AI 검색 — 이번 주 축제」, 「자산 요즘, 한 페이지(여행 콘텐츠)」가 축제·관광과 직접 관련된다.
  • 보드는 앱 무게(실행 속도)와 5060 인지 부하를 진입점 선택의 고려 사항으로 둔다.