营销专家 + 数据专家 · Flutter SDK 与后端 API 对接说明
一个对话端点 + 一套 SSE 事件契约：接入前提与鉴权 · 请求体与两种响应形态 · 事件闭集与 final.note 分支 · 卡片与列表 form · 写操作的二次确认（在对话里，不另开提交接口）· 多轮 · 排障 · 完整 curl。
2.0 客户端能打的 20 条端点逐条：方法 · 路径 · 职责 · 包归属 · 鉴权 · 消费方。判据取自代码（非运营面 + 非 1.0 遗留对话面），不是手列白名单。
三件套入口：Demo App（Android APK 直接体验）+ Flutter SDK 包下载 + 后端 API。装 APK 即体验营销/数据两专家。
Flutter SDK 三档集成：一键集成 · 可定制 UI · 营销/数据两专家 · 故障排查。
不用 Flutter、自建 UI 的完全自定义方案：SSE 事件协议 · commit/action · 鉴权 · 错误码 · curl。
Python 服务从直连上游模型迁移至中转站统一出口：认证 · SSE 事件协议 · 错误码 · 幂等 · 切换步骤 · 回退。
给 Agent 使用的 nearboss 业务数据 API：数据查询/洞察 + 营销活动/会员操作。只列端点 + 输入/输出参数，公共信封/Money/分页一次定义。
给 Agent 使用的数据分析 API：metrics:query 统一取数（汇总/趋势/同比/客单价/维度，靠参数区分）+ capabilities 能力发现。含每参数说明、Agent 如何匹配参数、数据团队如何实现真实库取数。
针对现网契约 2026-06-10 数据专家部分(9 端点)：优点 7 条 + 缺点 13 条(P0/P1/P2，带原文出处) + 收敛为 2 端点的优化方案 + 迁移对照。给数据团队做评审依据。
针对现网契约 2026-06-10 营销专家部分(活动 9 + 会员 8 端点)：优点 7 条 + 缺点 15 条(P0/P1/P2，带原文出处) + 资源化/状态机/幂等优化方案 + 迁移对照。给数据团队做评审依据。
营销专家 API 目标态 v2：capabilities 1 + 活动 6 + 会员 5 = 12 端点；折扣收敛为带 model 判别式的 discount 子对象、活动类型(场景)×优惠机制解耦、capabilities 合一、写操作补 Idempotency-Key；含逐参数说明、Agent 确定性匹配、数据团队实现、v1→v2 / 现网→v2 迁移对照。