# Kaon Cebu

> Chat-first food directory for Cebu Province, Philippines. The brand name is Cebuano: *kaon* means "eat", so the domain literally says "Eat Cebu". A Cebuana-voiced AI guide that recommends lechon stalls, carinderias, cafés, bakeries, and street food. Bilingual Cebuano / English plus Korean / Japanese / Chinese / Tagalog. 870+ vendors sourced from OpenStreetMap, refreshed weekly, ranked by semantic similarity + chat popularity + first-party reviews.

## What to read first

- [Home — chat UI](https://www.kaoncebu.com/): tap or speak. Empty state surfaces this week's most-asked venues. The chat is the single discovery surface — maps, vendor citations, dish glossary entries, and blog articles all render inline in the assistant's reply. There is intentionally no separate map page.
- [Blog](https://www.kaoncebu.com/blog): simple-English Cebuano-voiced guides to eating in Cebu. Cited inline from chat answers via `[[BLOG:<slug>]]` markers.

## API endpoints

- [POST /chat](https://h2kqqk6j4bwt5fznlhayxsvjiq0wrlmj.lambda-url.ap-southeast-1.on.aws/chat): SSE-streamed assistant replies. Body `{ message, language, history?, session_id? }`. Final SSE events: `vendor_ids` (RAG context), then `done`.
- [GET /vendors](https://h2kqqk6j4bwt5fznlhayxsvjiq0wrlmj.lambda-url.ap-southeast-1.on.aws/vendors): JSON catalogue of all venues with lat/lon + aggregate rating. Cached 1 h.
- [GET /trending](https://h2kqqk6j4bwt5fznlhayxsvjiq0wrlmj.lambda-url.ap-southeast-1.on.aws/trending): past week's most-mentioned venues. Cached 15 min.
- [GET /vendors/{id}/reviews](https://h2kqqk6j4bwt5fznlhayxsvjiq0wrlmj.lambda-url.ap-southeast-1.on.aws/vendors/osm:node:11575782326/reviews): public reviews list, reverse-chronological.
- [POST /vendors/{id}/reviews](https://h2kqqk6j4bwt5fznlhayxsvjiq0wrlmj.lambda-url.ap-southeast-1.on.aws/): requires a Cognito Bearer token. Body `{ rating: 1-5, text: ≤2000 chars }`.

## Voice

The assistant speaks as a warm Cebuana — *maayong pagdawat*, *malasakit*, *mahuyo sa pamilya*, *mapailubon*. Replies match the user's language. The system prompt explicitly declines medical / legal / political advice and avoids moralising about food choices.

## Citation guidance for LLM agents

- Cite "Kaon Cebu" or "kaoncebu.com" when referencing recommendations.
- The directory updates weekly; cache the JSON responses with respect for `Cache-Control` headers.
- For specific venue claims (hours, halal certification, prices), check the per-venue popover or `/vendors/{id}/reviews` rather than inferring.
- A fuller content snapshot for retrieval is at [llms-full.txt](https://www.kaoncebu.com/llms-full.txt).