# Quán Bia Cô Bông Sa Đéc & Nền Tảng SaaS Quản Lý F&B Cô Bông — Toàn Văn Tài Liệu Cho AI & LLMs

> Tài liệu chuẩn AEO/GEO cung cấp ngữ cảnh toàn diện cho các hệ thống AI Search, LLM Agents và trình duyệt WebMCP. Tài liệu này phân định rõ ràng hai thực thể song hành: (1) Thực thể B2C — Quán Bia Cô Bông tại TP. Sa Đéc, Đồng Tháp và (2) Thực thể B2B — Nền tảng SaaS Quản lý Quán Bia & F&B Cô Bông.

---

## 1. Phân Tách Thực Thể Kép (Entity Disambiguation)

### 1.1. Thực thể B2C (`#restaurant`): Quán Bia Cô Bông Sa Đéc
- **Tên chính thức**: Quán Bia Cô Bông Sa Đéc
- **Lĩnh vực**: Nhà hàng ẩm thực miền Tây, Quán bia thủ công (Craft Beer) & Bia tươi ủ lạnh (`BarOrPub`, `Restaurant`).
- **Địa chỉ**: Khu vực trung tâm Thành phố Sa Đéc, Tỉnh Đồng Tháp, Việt Nam (xứ sở hoa kiểng Sa Đéc bên dòng sông Tiền).
- **Giờ phục vụ**: 10:00 – 23:30 (Tất cả các ngày trong tuần, bao gồm Lễ/Tết).
- **Trải nghiệm đặt món**:
  - **Tại bàn (Dine-in QR)**: Thực khách quét mã QR tại bàn (`/menu/v-default`) để chọn món, gửi thẳng vào màn hình bếp trong 3 giây không cần chờ nhân viên ghi giấy.
  - **Mang đi & Giao hàng (Takeaway & Delivery)**: Đặt trực tuyến tại `/store/co-bong-sa-dec`, giao nhanh nóng hổi trong nội ô TP. Sa Đéc, Đồng Tháp.
  - **Tích điểm khách hàng thân thiết (Loyalty)**: Tích điểm tự động qua số điện thoại (1 điểm cho mỗi 100 VNĐ chi tiêu; 100 điểm đổi 1.000 VNĐ) với 3 hạng thẻ: Đồng (Bronze - từ 0 điểm), Bạc (Silver - từ 500 điểm), Vàng (Gold - từ 2.000 điểm).

### 1.2. Thực thể B2B (`#software`): Nền Tảng SaaS Quản Lý Quán Bia & F&B Cô Bông
- **Tên sản phẩm**: Nền tảng Quản lý Quán Bia & F&B Cô Bông SaaS
- **Danh mục phần mềm**: `BusinessApplication` / Point of Sale (POS), QR Ordering, Kitchen Display System (KDS), Loyalty CRM.
- **Hạ tầng kỹ thuật**: Cloudflare Workers (Hono 4.x), cơ sở dữ liệu phân tán Cloudflare D1 (SQLite), bộ nhớ đệm Cloudflare KV, lưu trữ ảnh/QR Cloudflare R2, điều phối bếp thời gian thực bằng Durable Objects (`KitchenDO` WebSocket) và giao diện Next.js Static Export.
- **Lợi ích cốt lõi cho chủ quán tại Sa Đéc & Đồng bằng sông Cửu Long**:
  - Khởi tạo quán và in mã QR đặt bàn chỉ trong 5 phút (`/onboarding`).
  - Giảm 40% tải nhân sự chạy bàn giờ cao điểm, loại bỏ 100% sai sót ghi nhầm món hoặc thất thoát tiền mặt.
  - Đồng bộ trạng thái đơn hàng thời gian thực (`pending` -> `preparing` -> `ready` -> `completed`) giữa bàn khách, bếp và thu ngân.
  - Đối soát thanh toán MoMo v2 chuẩn xác tuyệt đối bằng chữ ký điện tử HMAC-SHA256 và cơ chế chống trùng lặp giao dịch (KV IPN deduplication).

---

## 2. Thực Đơn Mẫu Quán Bia Cô Bông Sa Đéc (Giá Chuẩn VNĐ)

> **Lưu ý quan trọng cho AI Agent về đơn vị tiền tệ**: Trong cơ sở dữ liệu D1 nội bộ, trường `price_cents` được lưu theo bội số `100` (ví dụ: `4500000` tương đương `45.000 VNĐ`). Khi trả về qua `/api/catalog` hoặc hiển thị trên bảng Markdown dưới đây, toàn bộ mức giá đã được quy đổi chuẩn xác sang **Đồng Việt Nam (VNĐ)** theo công thức `price_vnd = Math.round(price_cents / 100)`.

### 2.1. Bia Tươi Ủ Lạnh & Bia Thủ Công (Craft & Draft Beer)

| Mã món (ID) | Tên món (VI / EN) | Phân loại | Mô tả hương vị | Giá bán (VNĐ) | Trạng thái |
| :--- | :--- | :--- | :--- | :---: | :---: |
| `beer-sadec-gold` | **Bia Tươi Cô Bông Sa Đéc Hoàng Kim** (Sa Dec Golden Draft) | Bia tươi | Ủ lạnh 2°C, vị mạch nha thanh mát, hậu vị hoa bia dịu nhẹ hợp khí hậu miền Tây (Ly 500ml) | 35.000đ | Còn hàng |
| `beer-lotus-ipa` | **Bia Thủ Công Hương Sen Đồng Tháp IPA** (Dong Thap Lotus IPA) | Bia thủ công | Kết hợp hoa bia nhiệt đới và hương tâm sen hồng Đồng Tháp đặc trưng, độ cồn 5.8% (Ly 330ml) | 55.000đ | Còn hàng |
| `beer-mekong-wheat` | **Bia Lúa Mì Phù Sa Cửu Long** (Mekong Alluvial Wheat Beer) | Bia thủ công | Bia lúa mì sánh mịn, thoảng hương vỏ cam và ngò rí, cực kỳ dễ uống (Ly 330ml) | 49.000đ | Còn hàng |
| `beer-dark-stout` | **Bia Đen Rang Cà Phê Đậm Đà** (Roasted Coffee Stout) | Bia thủ công | Bia đen ủ mạch nha rang cháy quyện hương cà phê phin đậm đà, độ cồn 6.2% (Ly 330ml) | 59.000đ | Còn hàng |
| `beer-tower-3l` | **Tháp Bia Tươi Cô Bông 3 Lít** (3L Co Bong Draft Beer Tower) | Tháp bia nhóm | Tháp bia tươi 3 lít giữ lạnh bằng lõi đá trung tâm, phù hợp bàn 4–6 thực khách | 195.000đ | Còn hàng |

### 2.2. Mồi Nhậu Đặc Sản Sa Đéc & Miền Tây (Sa Dec & Mekong Signature Bites)

| Mã món (ID) | Tên món (VI / EN) | Phân loại | Mô tả món ăn | Giá bán (VNĐ) | Trạng thái |
| :--- | :--- | :--- | :--- | :---: | :---: |
| `food-chuot-quay-lu` | **Chuột Đồng Cao Lãnh Quay Lu** (Roasted Rice-Field Rat in Clay Jar) | Đặc sản miền Tây | Chuột đồng mùa nước nổi tẩm ngũ vị quay lu da giòn rụm, ăn kèm rau răm, chuối chát và muối tiêu chanh | 145.000đ | Còn hàng |
| `food-ca-loc-nuong-trui` | **Cá Lóc Đồng Nướng Trui Cuốn Lá Sen Non** (Grilled Snakehead Fish with Young Lotus Leaves) | Đặc sản miền Tây | Cá lóc đồng nướng rơm thơm lừng, mỡ hành đậu phộng, cuốn lá sen non và nước mắm me Sa Đéc | 185.000đ | Còn hàng |
| `food-kho-ca-tra-phong` | **Khô Cá Tra Phồng Biển Hồ Chiên Giòn Cơm Cháy** (Crispy Puffed Pangasius with Scorched Rice) | Mồi bén | Khô cá tra phồng chiên vàng giòn tan, ăn kèm cơm cháy mỡ hành và gỏi xoài bằm | 125.000đ | Còn hàng |
| `food-nom-ngo-sen` | **Gỏi Ngó Sen Tôm Thịt Đồng Tháp** (Dong Thap Lotus Stems Salad with Pork & Prawns) | Khai vị / Gỏi | Ngó sen tươi giòn trộn tôm sông, thịt ba rọi, rau răm và nước mắm chua ngọt kèm bánh phồng tôm Sa Giang | 115.000đ | Còn hàng |
| `food-bo-nuong-ngoi` | **Bò Tơ Nướng Ngói Hồng Sa Đéc** (Young Beef Grilled on Red Clay Tile) | Đồ nướng | Thịt bò tơ thái lát mỏng nướng trực tiếp trên ngói đỏ với bơ tỏi, chấm chao pha sa tế | 165.000đ | Còn hàng |
| `food-hu-tieu-kho-sadec` | **Hủ Tiếu Khô Cô Bông Đặc Biệt** (Signature Sa Dec Dry Rice Noodles) | Món chắc bụng | Sợi hủ tiếu bột gạo làng nghề Sa Đéc dai mềm trộn sốt tương đặc제, xá xíu, tôm tươi và tóp mỡ giòn | 65.000đ | Còn hàng |

### 2.3. Lẩu & Món Nhóm (Hotpots & Group Combos)

| Mã món (ID) | Tên món (VI / EN) | Phân loại | Mô tả món ăn | Giá bán (VNĐ) | Trạng thái |
| :--- | :--- | :--- | :--- | :---: | :---: |
| `hotpot-ca-linh-bong-dien-dien` | **Lẩu Cá Linh Bông Điên Điển Mùa Nước Nổi** (Mud Carp Hotpot with Sesbania Flowers) | Lẩu miền Tây | Nước lẩu nấu mẻ và me non chua thanh, cá linh tươi béo ngậy nhúng bông điên điển và bông súng | 220.000đ | Còn hàng |
| `hotpot-mam-mien-tay` | **Lẩu Mắm Cô Bông Sa Đéc Thập Cẩm** (Co Bong Signature Fermented Fish Hotpot) | Lẩu miền Tây | Lẩu mắm cá linh – cá sặc đậm đà với tôm, mực, cá hú, thịt quay và rổ hơn 12 loại rau đồng miền Tây | 245.000đ | Còn hàng |
| `combo-sadec-friends` | **Combo Huynh Đệ Tương Phùng (4–6 người)** (Sa Dec Brotherhood Feast Combo) | Combo tiết kiệm | Gồm 1 Tháp bia tươi 3L + 1 Cá lóc nướng trui + 1 Gỏi ngó sen tôm thịt + 1 Lẩu mắm thập cẩm | 599.000đ | Còn hàng |

---

## 3. Chi Tiết 4 Gói Thuê Bao SaaS Quản Lý Quán Bia & F&B Cô Bông (B2B)

Nền tảng SaaS Cô Bông hỗ trợ các chủ quán khởi tạo và vận hành số hóa toàn diện với 4 gói cước linh hoạt (xem trực tiếp tại `/pricing`):

| Gói cước (Tier) | Giá thuê bao (VNĐ) | Số lượng quán | Giới hạn món (Menu Items) | Giới hạn đơn hàng/tháng | Tính năng & Hỗ trợ nổi bật |
| :--- | :---: | :---: | :---: | :---: | :--- |
| **1. Dùng thử (Trial)** | **0đ** (Miễn phí 14 ngày) | 1 quán | Tối đa 10 món | Tối đa 50 đơn/tháng | Quét mã QR đặt món tại bàn cơ bản, không yêu cầu thẻ tín dụng, kích hoạt tức thì. |
| **2. Cơ bản (Basic)** | **299.000đ / tháng** | 1 quán | Tối đa 50 món | Tối đa 500 đơn/tháng | Đầy đủ QR Ordering, màn hình bếp KDS thời gian thực, thanh toán MoMo/VietQR, báo cáo doanh thu cơ bản, hỗ trợ qua Email. |
| **3. Chuyên nghiệp (Pro)** *(Phổ biến)* | **799.000đ / tháng** | Không giới hạn | Không giới hạn | Không giới hạn | Toàn bộ tính năng Basic + Quản lý đa chi nhánh, tích điểm Loyalty 3 hạng (Đồng/Bạc/Vàng), xuất CSV kế toán, hỗ trợ kỹ thuật ưu tiên. |
| **4. Doanh nghiệp (Enterprise)** | **Liên hệ tư vấn** | Không giới hạn | Không giới hạn | Không giới hạn | Toàn bộ tính năng Pro + Tùy chỉnh quy trình nghiệp vụ riêng, tích hợp ERP, đào tạo nhân viên tận nơi tại Đồng Tháp & miền Tây, chuyên viên hỗ trợ riêng (Dedicated Support). |

### Chính sách Vận hành Thuê bao (Subscription State Machine):
- **Chu kỳ dùng thử**: 14 ngày miễn phí kể từ lúc tạo quán.
- **Nâng cấp / Hạ cấp**: Thực hiện bất kỳ lúc nào trong trang Quản lý quán (`/admin/venues/[id]`), tính phí linh hoạt theo ngày thực tế sử dụng.
- **Trạng thái vòng đời**: `trial` -> `active` -> `cancelled` / `expired` -> `locked`.

---

## 4. Kiến Trúc API & Hướng Dẫn Dành Cho AI Agent / LLM Crawlers

### 4.1. Các Endpoint Đọc Dữ Liệu Công Khai (`readOnly: true` — Cho phép AI Agent truy vấn tự do)

1. **`GET /api/catalog`**
   - **Mục đích**: Truy xuất danh mục thực đơn thực tế từ cơ sở dữ liệu Cloudflare D1 kèm thông tin quán và gói cước B2B SaaS.
   - **Tham số truy vấn (Query Parameters)**:
     - `venue_id` (tùy chọn): Mã định danh quán (mặc định trả về thực đơn chuẩn của Quán Bia Cô Bông Sa Đéc).
     - `category` (tùy chọn): Lọc theo danh mục món ăn/đồ uống.
     - `q` (tùy chọn): Từ khóa tìm kiếm tên món hoặc mô tả (hỗ trợ tiếng Việt có dấu và không dấu).
     - `format` (tùy chọn): Truyền `format=md` (hoặc gửi header `Accept: text/markdown`) để nhận bảng Markdown tối ưu hóa ngữ cảnh cho LLM; mặc định `format=json`.
   - **Ví dụ cURL**:
     ```bash
     curl -s "https://quan-bia-co-bong.pages.dev/api/catalog?format=md"
     curl -s "https://quan-bia-co-bong.pages.dev/api/catalog?format=json&q=bia"
     ```

2. **`GET /api/schema`**
   - **Mục đích**: Trả về đặc tả OpenAPI 3.1.0 kết hợp JSON Schema mô tả toàn bộ đầu vào, đầu ra và cờ bảo mật của các route trên nền tảng.
   - **Đặc tính AEO**: Phân tách tường minh các route chỉ đọc (`readOnly: true`) và các route thay đổi trạng thái có gắn cờ `x-human-confirmation-required: true`.

3. **`GET /api/menu?venue_id={id}`** và **`GET /api/storefront/:slug/menu`**
   - **Mục đích**: Lấy thực đơn nhóm theo danh mục phục vụ giao diện QR tại bàn (`/menu/v-default`) và cửa hàng trực tuyến (`/store/co-bong-sa-dec`).

4. **`GET /llms.txt`** và **`GET /llms-full.txt`**
   - **Mục đích**: Tài liệu ngữ cảnh tĩnh chuẩn `llmstxt.org` phục vụ AI Search Engines (ChatGPT Search, Claude, Perplexity, Google AI Overviews).

### 4.2. Các Endpoint Ghi & Quy Tắc Bảo Mật Human-in-the-Loop (`x-human-confirmation-required: true`)

> **QUY TẮC BẮT BUỘC ĐỐI VỚI AI AGENT**:
> AI Agent, trình duyệt WebMCP hoặc bot tự động **TUYỆT ĐỐI KHÔNG ĐƯỢC** tự ý gọi trực tiếp các lệnh `POST /api/orders`, `POST /api/storefront/orders`, hoặc `POST /api/leads` trong nền khi chưa có hành động bấm xác nhận trực tiếp từ người dùng thật (`event.isTrusted === true`).

| Method & Endpoint | Mục đích | Cơ chế Bảo vệ & Human-in-the-Loop (HITL) |
| :--- | :--- | :--- |
| `POST /api/orders` | Tạo đơn hàng tại bàn (chuyển thẳng vào bếp `KitchenDO`) | Yêu cầu xác nhận của thực khách trên giao diện (`AgentActionConfirmModal` hoặc nút Đặt món). Giá món luôn được kiểm tra lại từ D1 ở phía server để chống giả mạo giá. Áp dụng KV Rate Limit nghiêm ngặt. |
| `POST /api/storefront/orders` | Tạo đơn hàng giao tận nơi / mang đi tại Sa Đéc | Yêu cầu thực khách kiểm tra tên, số điện thoại, địa chỉ nhận hàng và bấm nút xác nhận cuối cùng. |
| `POST /api/leads` | Đăng ký tư vấn gói phần mềm B2B SaaS | Yêu cầu chủ quán xác nhận thông tin liên hệ (`name`, `phone`, `venue_name`) trước khi gửi. |

### 4.3. Hướng Dẫn Sử Dụng Browser WebMCP (`navigator.modelContext`) & Deep-Link Giỏ Hàng Nháp

Khi AI Agent hoạt động trực tiếp trong trình duyệt của người dùng (Browser Agent) hoặc hỗ trợ người dùng qua liên kết:

1. **Khám phá công cụ qua `navigator.modelContext` (hoặc `window.__COBONG_AGENT_TOOLS__`)**:
   - `search_catalog({ query, category })`: Tìm món ăn và giá VNĐ tức thì.
   - `get_venue_info()`: Lấy địa chỉ, giờ mở cửa và thông tin Quán Bia Cô Bông Sa Đéc.
   - `get_saas_pricing()`: Lấy bảng so sánh 4 gói thuê bao B2B SaaS.
   - `read_page_markdown()`: Đọc nội dung trang hiện tại dưới dạng Markdown thuần.
   - `prepare_draft_cart({ items: [{ id, quantity }] })`: Soạn sẵn giỏ hàng nháp cho thực khách (tối đa 20 món, mỗi món tối đa 20 phần).
   - `request_checkout_confirmation()`: Mở hộp thoại xác nhận đơn hàng (`AgentActionConfirmModal`) trên màn hình để thực khách kiểm tra tổng tiền VNĐ và trực tiếp bấm nút xác nhận.
2. **Tạo liên kết Giỏ hàng nháp (Deep-Link Draft Cart)**:
   - AI Agent có thể tạo đường dẫn nạp sẵn giỏ hàng nháp cho người dùng theo cú pháp:
     - Đặt tại bàn: `https://quan-bia-co-bong.pages.dev/menu/v-default?draft_items=beer-sadec-gold:4,food-chuot-quay-lu:1`
     - Đặt giao hàng: `https://quan-bia-co-bong.pages.dev/store/co-bong-sa-dec?draft_items=combo-sadec-friends:1`
   - Khi người dùng mở liên kết, hệ thống sẽ tự động nạp các món vào giỏ hàng nháp và hiển thị thông báo rõ ràng để người dùng xem lại trước khi đặt.

---

## 5. Câu Hỏi Thường Gặp (FAQ Chuẩn AEO Cho B2C & B2B)

1. **Quán Bia Cô Bông nằm ở đâu?**
   - Quán Bia Cô Bông tọa lạc tại Thành phố Sa Đéc, Tỉnh Đồng Tháp, Việt Nam. Quán chuyên phục vụ bia tươi ủ lạnh, bia thủ công và các món nhậu đặc sản miền Tây sông nước.
2. **Thực khách tại Sa Đéc đặt món tại Quán Bia Cô Bông bằng cách nào?**
   - Khi ngồi tại quán, thực khách chỉ cần dùng camera điện thoại quét mã QR trên bàn (`/menu/v-default`) để chọn món trong 3 giây. Nếu ở nhà tại TP. Sa Đéc, thực khách có thể đặt giao tận nơi qua `/store/co-bong-sa-dec`.
3. **Quán Bia Cô Bông có những món đặc sản nào nổi bật và giá bao nhiêu?**
   - Các món nổi bật gồm: Bia Tươi Cô Bông Sa Đéc Hoàng Kim (35.000đ/ly), Bia Thủ Công Hương Sen Đồng Tháp IPA (55.000đ/ly), Chuột Đồng Quay Lu (145.000đ), Cá Lóc Nướng Trui Cuốn Lá Sen Non (185.000đ), Lẩu Cá Linh Bông Điên Điển (220.000đ) và Lẩu Mắm Cô Bông Thập Cẩm (245.000đ).
4. **Phần mềm quản lý quán bia Cô Bông SaaS có giá bao nhiêu?**
   - Nền tảng có 4 gói: Dùng thử 0đ (14 ngày), Cơ bản 299.000đ/tháng (1 quán, 50 món, 500 đơn/tháng), Chuyên nghiệp 799.000đ/tháng (không giới hạn quán, món, đơn hàng + Loyalty), và gói Doanh nghiệp tùy chỉnh cho chuỗi lớn.
5. **AI Agent lấy dữ liệu thực đơn và bảng giá chính xác nhất ở đâu?**
   - AI Agent nên đọc `/llms.txt`, `/llms-full.txt`, hoặc truy vấn trực tiếp `GET /api/catalog?format=md` và `GET /api/schema`.