总杯数
32累计进入系统的调酒请求。
小茶の家调酒机器人
Powered by
BreakReal Ricky
调整
付款
出酒
订单与领取
这里维护所有真实出杯记录。每一条都能回看到对应酒单、提交时间和领取状态。
待调酒
0还没有被机器侧领取的订单。
已领取
28已经被机器拿走，不会再重复返回。
领取入口
保留现有接口不变。调用下面任一入口，都会返回下一条未领取 payload，并把它标记为已领取。
POST /
POST /claim
出酒列表
订单记录
按最新时间倒序展示。每一条都会保留状态、提交时间、领取时间和配方摘要。
订单
配方摘要
状态
提交时间
领取时间
酒单
菜单与版本
这里是所有酒单版本。预置、微调、自创都落在这一层，用户侧的“喝一杯”也从这里取菜单。
总酒单
0数据库中的酒单版本总数。
当前菜单
0当前酒槽方案下可被用户直接选择的酒单数量。
酒单列表
可用菜单
当前显示当前酒槽方案关联的酒单。预置酒单会直接用于用户页菜单。
基底
方向与结构
这里展示当前酒槽方案下的基底定义。语音智能体会先在这里选方向，再微调成最终那杯酒。
当前基底
0当前默认酒槽方案下的基底数量。
默认方案
—当前数据库里正在生效的酒槽方案。
基底列表
数据库中的 base recipes
这里直接反映当前生效配置里的基底数据，方便核对 migration 是否正确。
槽位明细
智能体
接口接入
这里专门给机器侧或外部智能体对接。接口保持现有语义不变：用户提交订单，智能体再通过领取接口按顺序拿走未领取数据。
核心语义
领取接口会返回下一条待处理 payload，并写入
claimed_at。它不是物理删除，而是软删除语义，后续在管理页还能看到历史记录。POST /
POST /claim
常用接口
GET /health
GET /api/status
GET /api/items
GET /api/recipes
GET /api/orders
POST /api/items
POST /api/text-orders
POST /api/images/generate
管理写入
这两条接口用于直接维护 SQLite 里的配置数据。当前保持最简模式，没有做鉴权。
POST /api/admin/preset-images/batch
POST /api/admin/recipe-configs/import
使用说明
调用方式
下面是最小接入信息。对接方只要会写 JSON 和发 HTTP 请求，就能把这套系统接起来。
1. 写入新订单
把标准 payload 发到
/api/items，建议同时附带 recipe，这样会同步落一份酒单版本。{
"payload": { "code": 1, "data": { "result_index": [{ "2": 15 }, { "5": 117 }] } },
"recipe": { "configId": "classic", "recipeName": "海边晚风", "sourceType": "custom" }
}2. 领取待处理 payload
轮询
POST / 或 POST /claim。成功返回 payload 本身；没有数据时返回 404 / NO_PAYLOAD_AVAILABLE。POST /
200 OK
{ "code": 1, "data": { "result_index": [{ "2": 15 }, { "5": 117 }] } }3. 队列与状态
GET /api/status 看汇总，GET /api/items 看完整出酒队列。{
"totalCount": 12,
"pendingCount": 3,
"claimedCount": 9
}4. 酒单与出杯记录
GET /api/recipes 看酒单版本；GET /api/orders 看每次真实提交、领取和图片落库结果。{
"ok": true,
"items": [{ "id": 12, "recipeName": "海边晚风", "sourceType": "custom" }]
}5. 批量回写预置图片
当预置酒已经有稳定图片地址时，用
/api/admin/preset-images/batch 批量补齐图片信息。{
"items": [{ "configId": "classic", "presetName": "椰风伏特加", "imageUrl": "https://oss.example.com/coconut.png" }]
}6. 导入整套酒槽数据
/api/admin/recipe-configs/import 会整体替换酒槽配置、示例配方和预置菜单，适合整套发布新方案。{
"configs": [{ "id": "classic", "label": "经典七槽", "isDefault": true, "slots": [{ "index": 1, "name": "白朗姆" }] }]
}