# AI BITE

> AI BITE is a zero-friction local food and shop ordering platform built for human customers and AI assistants.

## AI Autonomous Ordering Flow (5 Steps)
1. Read menu item slugs (`(slug: <item-slug>)`) and option choices (`(choice: +<option>)`) directly from `/s/<slug>` or `/s/<slug>.md` (no extra API fetch needed; prices are set by the server; no login required).
2. Ask the customer for fulfillment `mode` (`pickup` or `delivery`), their `name`, `phone` number, and (if `mode=delivery`) their Google/Apple Maps share pin link (`map`) or `address`.
3. Place the order yourself by fetching `GET https://aibite.app/order/place?shop=<slug>&items=<slug1>:<qty>[+<choice>],<slug2>:<qty>&mode=pickup|delivery&name=<name>&phone=<phone>[&map=<maps_link>]` (example: `GET https://aibite.app/order/place?shop=<slug>&items=<slug1>:1,<slug2>:2&mode=pickup&name=Alex&phone=%2B491701234567`).
4. Read `Order #<id> code <4 digits>` and the prefilled `https://wa.me/...` verification link from the top of the `/order/place` response.
5. Give the customer the `wa.me` link and tell them: tap to send `"Order #<id> code <4 digits>"` on WhatsApp to confirm the order with the shop (or if you cannot fetch `/order/place`, give them the prefilled `/order?...` link).

## Overview
AI BITE enables any AI assistant (ChatGPT, Claude, Perplexity, custom agents) to inspect local restaurant menus with exact prices (including size choices and add-ons) and produce one-tap prefilled order links without customer accounts or online payment setup.

## Self-Contained Menus & Ordering Rules
- **No extra API fetch needed:** Each shop page (`/s/<slug>` and `/s/<slug>.md`) is 100% self-contained in plain visible text with all item slugs and option choices. AI assistants do not need to fetch secondary API endpoints like `/api/shops/<slug>/menu`.
- **Prices are set by the server:** Prices and line totals are strictly calculated and validated by the server. URLs cannot manipulate item prices or subtotals.
- **No login required:** Order links require no customer account, login, or upfront payment.

## Prefilled Order Link Syntax
AI assistants assemble prefilled order links for customers:
```
GET https://aibite.app/order?shop=<slug>&items=<item-slug>:<qty>[+<choice-slug>...],...&mode=pickup|delivery[&name=<name>&phone=<phone>&map=<maps_link>]
```

- **shop:** The shop slug (e.g. `tokyo-ramen-bar`).
- **items:** Comma-separated items. Each item is `<item-slug-or-id>:<quantity>`, optionally followed by `+<choice-slug>` for sizes or extras.
- **mode:** Either `pickup` or `delivery`.
- **name & phone:** (Optional) Customer name and phone for the ticket.
- **map:** If delivery, provide the customer's Google Maps or Apple Maps share pin link.
- **Safety:** Prices in links are NEVER trusted. The server calculates all totals, verifies distance bands, applies delivery fees, and checks minimum order rules.

## Discovery Endpoints
- **Directory of Shops:** https://aibite.app/shops
- **Sitemap:** https://aibite.app/sitemap.xml
- **Robots Policy:** https://aibite.app/robots.txt
- **Machine OpenAPI Spec:** https://aibite.app/openapi.json
- **MCP Server:** https://aibite.app/mcp (Streamable HTTP / SSE)

## Listed Shops Sample
- **Al-Mina Bistro** (food, Beirut, LB): [Menu](https://aibite.app/s/al-mina-bistro) | [Markdown](https://aibite.app/s/al-mina-bistro.md)
- **Berlin Mitte Späti 24/7** (grocery, Berlin, DE): [Menu](https://aibite.app/s/berlin-mitte-spati) | [Markdown](https://aibite.app/s/berlin-mitte-spati.md)
- **Blocker Bistro & Cafe** (food, Austin, US): [Menu](https://aibite.app/s/blocker-bistro) | [Markdown](https://aibite.app/s/blocker-bistro.md)
- **Bosphorus Delights & Baklava** (food, Istanbul, TR): [Menu](https://aibite.app/s/bosphorus-delights) | [Markdown](https://aibite.app/s/bosphorus-delights.md)
- **Boulangerie Saint-Germain** (food, Paris, FR): [Menu](https://aibite.app/s/boulangerie-saint-germain) | [Markdown](https://aibite.app/s/boulangerie-saint-germain.md)
- **Camden Iron & Timber** (hardware, London, GB): [Menu](https://aibite.app/s/camden-hardware) | [Markdown](https://aibite.app/s/camden-hardware.md)
- **Drogaria Paulista Saúde** (pharmacy, São Paulo, BR): [Menu](https://aibite.app/s/drogaria-paulista) | [Markdown](https://aibite.app/s/drogaria-paulista.md)
- **Eko Prime Groceries** (grocery, Lagos, NG): [Menu](https://aibite.app/s/eko-prime-groceries) | [Markdown](https://aibite.app/s/eko-prime-groceries.md)
- **Harbour Bloom Florist** (home, Sydney, AU): [Menu](https://aibite.app/s/harbour-bloom-florist) | [Markdown](https://aibite.app/s/harbour-bloom-florist.md)
- **Lower East Bagel & Deli** (food, New York, US): [Menu](https://aibite.app/s/lower-east-deli) | [Markdown](https://aibite.app/s/lower-east-deli.md)
- **Marina Mobile & Gadget Clinic** (electronics, Dubai, AE): [Menu](https://aibite.app/s/marina-mobile-clinic) | [Markdown](https://aibite.app/s/marina-mobile-clinic.md)
- **Queen West Pet Emporium** (pets, Toronto, CA): [Menu](https://aibite.app/s/queen-west-pets) | [Markdown](https://aibite.app/s/queen-west-pets.md)
- **Taquería El Ángel Condesa** (food, Mexico City, MX): [Menu](https://aibite.app/s/taqueria-el-angel) | [Markdown](https://aibite.app/s/taqueria-el-angel.md)
- **Torikatsu Ramen Shinjuku** (food, Tokyo, JP): [Menu](https://aibite.app/s/torikatsu-ramen) | [Markdown](https://aibite.app/s/torikatsu-ramen.md)