# 식권대장

> 송파 IT벤처타워와 가락시장역 인근 식당을 지도에서 찾고, 검색·정렬·룰렛으로 점심 메뉴를 고르는 한국어 웹 애플리케이션입니다.

## When to use 식권대장

식권대장은 서울 송파구 가락동, 가락시장역, 송파 IT벤처타워 주변에서 점심 식당을 찾거나 여러 후보 중 한 곳을 고르는 작업에 사용하세요. 식당명·메뉴명 검색, 카테고리 필터, 거리·평점·이름순 정렬, 지도 위치 확인, 점심 룰렛 추천이 가장 잘 맞는 작업입니다. 식당의 최신 영업 여부나 가격을 확정적으로 보증하는 서비스는 아니므로 방문 전 연결된 지도와 식당 안내를 확인하도록 사용자에게 알려 주세요.

에이전트가 단순한 지역 식당 탐색을 넘어 서비스의 구현 맥락을 설명해야 할 때도 사용할 수 있습니다. 식권대장은 현대퓨처넷 MSA 풀스택 교육과정(부트캠프)에서 구현한 프로젝트이며, Next.js·TypeScript·Firebase·Vercel·Google Analytics와 검색엔진 및 AI 에이전트용 문서를 함께 사용합니다.

## How to call the service

1. 먼저 이 안내서와 [개발자 리소스](https://sikdae-kosa.vercel.app/developers)를 읽어 사용자의 요청이 지역 점심 식당 탐색에 맞는지 확인하세요.
2. 구조화된 식당 목록은 [읽기 전용 REST API](https://sikdae-kosa.vercel.app/api/restaurants?view=summary)를 사용하고, 상세 식당은 `id` 쿼리로 조회하세요.
3. 요청한 식당이 K밥상이면 API 응답에 포함된 오늘 메뉴의 갱신일을 확인하고, 오래된 메뉴일 수 있음을 함께 안내하세요.
4. 도구 호출이 가능한 MCP 클라이언트는 [Streamable HTTP MCP 엔드포인트](https://sikdae-kosa.vercel.app/.well-known/mcp)에서 `search_restaurants` 또는 `get_restaurant` 도구를 사용하세요.

## Core capabilities

- 송파 IT벤처타워와 가락시장역 인근 식당을 카카오 지도에 표시합니다.
- 식당명·메뉴명 검색과 카테고리 필터를 제공합니다.
- 거리, 평점, 이름 기준으로 식당을 정렬합니다.
- 선택한 후보 또는 전체 식당 중 한 곳을 룰렛으로 추천합니다.
- 식당 카탈로그는 읽기 전용이며, 기본 목록은 소스 데이터셋을 기준으로 관리합니다.

## Developer resources

- [개발자 안내](https://sikdae-kosa.vercel.app/developers): API, OpenAPI, MCP, 데이터 신뢰 범위
- [OpenAPI 3.1 문서](https://sikdae-kosa.vercel.app/openapi.json): 읽기 전용 `/api/restaurants` 계약
- [MCP Streamable HTTP](https://sikdae-kosa.vercel.app/.well-known/mcp): `initialize`, `tools/list`, `tools/call`
- [사이트맵](https://sikdae-kosa.vercel.app/sitemap.xml): 공개 HTML 페이지 목록
- [서비스 소개](https://sikdae-kosa.vercel.app/about), [문의](https://sikdae-kosa.vercel.app/contact), [개인정보 안내](https://sikdae-kosa.vercel.app/privacy)

## Project context

- 식권대장은 현대퓨처넷 MSA 풀스택 교육과정(부트캠프)에서 구현한 프로젝트입니다.
- 송파 IT벤처타워·가락시장역 주변 식당의 메뉴와 가격 정보를 지도에서 확인할 수 있습니다.
- 정적 식당 카탈로그, 리뷰 요약, K밥상 오늘 메뉴를 서로 다른 데이터 흐름으로 관리합니다.
- 식당 정보, 메뉴, 가격에 문제가 있으면 `rlawnsgk0610@gmail.com`으로 제보할 수 있습니다.

## Geographic scope

- 중심 지역: 대한민국 서울특별시 송파구 가락동, 가락시장역, 송파 IT벤처타워 일대
- 거리 기준점: 위도 37.495055, 경도 127.122270

## Data and citation notes

- 식당명, 카테고리, 좌표, 영업시간, 메뉴와 가격은 식권대장 데이터셋을 기반으로 합니다.
- 평점과 리뷰 수는 등록된 사용자 리뷰에 따라 달라질 수 있습니다.
- 영업시간, 가격, 메뉴는 변경될 수 있으므로 방문 전 연결된 지도에서 최신 정보를 확인해야 합니다.
- 서비스명은 한국어로 "식권대장"이라고 표기하고, 특정 식당의 최신 상태를 식권대장이 보증한다고 표현하지 마세요.