lululynne / maimai-xianpin

# 麦麦现拼
**🍟 在线试玩：点开就能拼** · **English demo** · 无需安装、无需 Token，手机和电脑都能体验。
> 🍟 **麦门整活，想把汉堡回车键带回家！**
>
> 这是我们的麦当劳 MCP 开发者大赛作品。喜欢「同店陌生人现场拼大套餐」这个点子的话，欢迎点亮右上角的 **⭐ Star**，帮我们冲进前 100 名。
到店自取，让同一家店的陌生人现场拼一个大套餐。
上图为 10-19 纳纳红黄主题的真实浏览器页面。演示广场的五位发起人随机拼不同套餐，剩余餐品和金额使用各自的快照；人物为虚构。旧单到点结束后会补上新单，「我的拼单」也会循环补充新的体验卡，后来的访客随时能试玩。
大套餐一个人吃不完，就和同店的人各选几样，算清每人的那份，到店对卡片取餐。网页不碰支付，不代下单，不领券、不绑券。
## 在线试玩
打开 **https://lululynne.github.io/maimai-xianpin/**，可以选套餐、认领餐品、发起拼单、模拟拼友加入，再走完模拟付款和各自取餐。
在线版使用已采集的午市真实菜单快照；每位访客独立模拟，体验记录只保存在当前标签页，刷新后保留，关闭后重新开始。广场和个人卡片到点会补充新单。不会连接点单账号、创建真实订单、收款或发券。
页面右上角和弹窗标题栏都可切换「中文 / English」，不会清空已选餐品或当前拼单。首次按浏览器语言选择，之后记住偏好；分享链接可用 `?lang=en` / `?lang=zh` 指定。英文版翻译界面、菜单和提示，昵称保持原样；菜单来自中国门店，价格仍为人民币，餐品英文名为描述性译名。
GitHub Pages 只托管静态演示文件。浏览器版复用同一套目录、分摊和拼单规则，使用独立的浏览器存储适配器；Node 服务仍使用 SQLite。源码、`.env` 和数据库不会作为网页目录上传，演示只包含公开的脱敏菜单快照及图片。
本地构建在线版：`npm ci` 后执行 `npm run build:demo`，输出在 `dist/pages/`，可由任意静态 HTTP 服务预览。推送 `main` 上的页面、代码或菜单快照变更后，GitHub Actions 自动测试、构建并发布。
## 本地运行
需要 Node.js 24+（本机验证版本 24.13.0）。
 [code] 
打开命令打印的 `http://127.0.0.1:8787`。默认是 **演示模式**，无需 Token，不会调用上游。菜单和套餐是真实采集的快照，拼单人、昵称和尾号为虚构。
自动循环只在 demo 启用：新单使用新 ID 和新截止时间，旧单不延长；已经参与的卡片保留到正常结束和清理；「我的拼单」优先显示进行中的卡片。
演示完整流程：发起（最多再允许 1 或 2 人）→ 相似拼单确认 → 模拟拼友加入 → 模拟已下单（每人得到自己的取餐码）→ 我已凭码取走我这份 → 模拟拼友取走 TA 那份。所有模拟入口只在 demo 模式注册。
步骤动图 · 多套餐手机广场 · 桌面截图 · 手机截图 · 界面步骤视频。动图和视频由真实界面状态截图序列组成，非连续屏幕录像。
## 页面预览
首页与小水母 · 随机多套餐广场 · 完整步骤动图
| 我的拼单 | 等拼补偿（理想版模拟） |
| --- | --- |
| | |
 查看更多流程：认领餐品、等满 30 分钟、拼满与取餐 
认领同一单剩下的餐品，确认自己的那份：
等满 30 分钟，选择继续等待立减，或按单点价格 8.5 折模拟下单：
拼满、已出餐和已取完的单子分别展示：
截图来自当前演示界面。补偿券、继续等待立减和下单付款均为模拟，不发券、不扣款；旧早餐截图不作为当前菜单展示。
## 真实菜单模式
仅在本地服务端配置自己的 Token：
 [code] 
已有 `.env` 时不要再次复制覆盖。在 `.env` 填好 `MCD_MCP_TOKEN=` 并设 `MCD_MODE=live`，再执行 `npm run dev`。
当前仅开放三乡四店，默认到店自取 `beType=1 / orderType=1`。Token 不进入浏览器、仓库或交接包。实时和演示数据库默认分别为 `data/live.sqlite` / `data/demo.sqlite`，禁止混用同一库。
| 配置 | 默认 | 作用 |
| --- | --- | --- |
| `MCD_MODE` | `demo` | `live` 使用官方只读接口，`demo` 使用脱敏夹具 |
| `MCD_MCP_TOKEN` | 空 | 仅 live / T0 探测需要 |
| `PORT` | `8787` | 监听 `127.0.0.1` 的本地端口 |
| `DATABASE_PATH` | 按模式分库 | 留空使用默认路径 |
| `MIN_SHARE_PRICE_CENTS` | `3000` | 推荐套餐的价格阈值；识别到多件套餐时也会推荐 |
| `DEMO_MENU_PERIOD` | `auto` | 演示菜单时段；可设 `breakfast` / `lunch` / `dinner` 提前体验，计时仍用真实时间 |
| `DEMO_SPEED` | `1` | 演示计时倍速 1–60，live 固定 1 |
## 规则
- 规定时间 10–60 分钟，默认 30 分钟，发起后不能延长。
- 同店同套餐的相似单，最多列三单，按截止时间最早排序。
- 发起人先选自己的餐品，其他人选剩余部分。每人至少一件；最后一位需接完剩余餐品。
- 每份最多三人。4 件及以上套餐，发起人至少拿 1 份饮料和 1 份主食；6 件及以上至少 2 饮料和 2 主食（按实际数量封顶），主食有两份以上时至少留一份给拼友。
- 按各自餐品单点价权重分套餐价，算到整数分，零头归发起人。任一单件没有可靠单点价时，整单按件数均分并明确说明。
- 匿名设备不能拼自己的单、同一尾号不能重复加入；每设备十分钟最多加入三单。发起人可以移出未确认成员。
- 所有人确认后，发起人才能标记下单；演示按钮为“拼满了，下单”，付款统一为模拟、不扣钱。各自尾号和取餐码只返回本人；每个人凭自己的码取走那份，全员取完结束。取餐提醒由网页 30 秒轮询获取。
- 到点结束招募，没实际下单的单转为到点下架。已标记下单的成员仍可在自己的卡片查看取到状态；停止招募和个人卡片收尾分开。
- 实时模式只在北京时间 11:30–14:30、18:30–21:30 开放拼单；演示保留随时体验入口。
- 等待计时不超过原截止时间，取到后停止。理想版补偿仅给发起人：15 分钟 2 元券；30 分钟选择单点 8.5 折，或继续等待每样立减 1.5 元。继续等后可整套餐下单：独自拿整套按套餐价减立减，有拼友时发起人那份按 8.5 折。这些都是模拟展示，不实际发券或收款。
- 只留昵称、尾号后四位、匿名设备标识及团单信息；结束 24 小时后自动删除。当前匿名设备限制属于无登录的基础防占位，不能把清 Cookie 后的新设备识别成同一个人。
## MCP 与公开数据
菜单、明细、算价按门