32 KiB
32 KiB
宠小它智能预约助手：产品与技术方案 v0.1
日期：2026-08-02
状态：M0 产品/架构/数据契约已冻结；尚未实现；真实供应商与生产隐私评审未完成
目标用户：customer宠主
Workstream：Core Booking Flow
建议 Owner：Product Design+Customer Experience FE+Backend Core
Paired QA：Core Flow QA
Architecture Review Required：Yes
Data Model Review Required：Yes
Access / Privacy Review Required：Yes
RC 边界：不纳入phase2-pilot-rc6；当前 RC 仍以基础预约和真实门店试点为先
配套文档
1. 结论
建议将该能力定义为 「可执行的智能预约助手」，而不是泛化客服聊天机器。
它负责把宠主的自然语言转换为结构化预约草稿，通过现有 Petstore 预约域查询真实宠物、门店服务和可约时段。M0 只将草稿带入现有表单，仍由用户在普通表单中提交；对话内直接创建 Appointment 是 M1 候选能力。
核心原则：模型负责「听懂人话」，Petstore 预约域负责「决定什么能约」。
普通预约表单必须保留，智能助手是另一种输入方式，不是唯一入口，也不改变 Appointment 的 new -> doing -> done/cancel 履约状态机。
2. 产品机会与首发场景
2.1 要解决的问题
现有预约表单的门店、宠物、服务、日期、时段和备注结构是正确的，但对老客复约仍存在重复操作：
- 宠主心里通常已经有一句完整需求，例如「周六下午给球球再洗一次」；
- 门店、宠物和上次服务往往已有历史事实，但宠主需要重新选择；
- 「周六下午」「三点以后」「和上次一样」等意图需要先被理解，再转换为精确号源。
2.2 入口优先级
下列为长期入口价值排序。M0 已冻结为仅从 CustAppointmentCreate 顶部次级入口进入，且必须先用现有控件选定门店。
- 服务报告或历史预约：「跟助手约下次」 上下文最完整，可在登录与归属校验后预填门店、宠物和上次服务。
- 宠主首页：「一句话预约」 适合有明确需求的老客，与「普通预约」并列。
- 宠物档案：「给 TA 约服务」 预填宠物，只询问门店、服务和时间。
首发不建议在公开报告页直接开始匿名助手会话。若从公开报告进入，应先完成 customer 登录，再由后端校验源预约是否归属当前宠主；不得把完整 report_token 存入会话、日志或模型上下文。
2.3 核心假设
- 对已有宠物和服务历史的宠主，对话式复约比重新填六个字段更省力。
- 语音的核心价值是快速表达时间偏好和宠物备注，不是为了模拟真人客服。
- 「可修改的确认卡 + 明确确认」能在便捷性和业务确定性之间取得平衡。
3. 范围与非目标
3.1 MVP 范围
- 仅面向已登录
customer； - 支持文字与语音转写两种输入；
- 仅使用当前 customer 可访问的宠物档案；
- 仅使用目标门店真实在售服务和现有可约时段；
- 识别精确日期、相对日期、星期和时间段偏好；
- 生成可编辑的预约确认卡；
- 提供「改时间」「换服务」「切换到普通预约」；
- 记录助手漏斗事件，最终创建仍由现有预约域完成。
3.2 明确不做
- 不做泛化门店客服、开放问答或外部网络检索；
- 不允许模型自行生成服务、价格、门店承诺或可约时段；
- 不使用智能助手创建或修改宠物档案；
- 不做取消、改期或改服务等已有预约变更；
- 不做技师指定，直到技师排班和技能模型真实落地；
- 不提供宠物医疗建议，不将行为或健康备注转化为医疗结论；
- 不引入订单、支付、储值、套餐或跨店组织能力；
- 不替换普通预约表单。
4. 用户体验
4.1 标准对话
宠主语音：「周六下午给球球洗澡，三点以后都行。」
助手：「球球预约精洗护理，预计 60 分钟。本周六 15:00、16:30 和 17:00 可约，你选哪个？」
宠主：「三点。」
助手：展示确认卡，不自动提交。
确认卡至少展示：
- 门店名称；
- 宠物名称和类型；
- 服务项目和预计时长；
- 绝对日期、开始时间和预计结束时间；
- 宠主提供的备注；
- 「修改」「带入普通预约」和「普通预约」操作。M1 通过写路径安全评审后，才将主操作改为「确认预约」。
4.2 澄清规则
- 一次优先询问一个高价值缺失项，避免连续追问已知信息。
- 同名宠物或多只宠物时，必须让宠主选择，不用模型置信度自动判断。
- 「和上次一样」只能从归属当前 customer 的已有预约中解析。
- 「周六」「明天」等相对时间需按门店时区转换，确认卡必须展示绝对日期。
- 「下午」「晚一点」只形成搜索约束，不直接变成最终号源。
- 候选号源默认给出 3 个；少于 3 个时全部展示，无号源时建议下一个有号源日期。
4.3 登录与中断恢复
- 普通预约仍保持「提交时登录 + guest 草稿恢复」的现有口径。
- 智能助手 MVP 在创建服务端会话前要求 customer 登录，因为它需要读取归属宠物和历史事实。
- M0 在创建会话前还要求已选定有效门店；对话不负责选店，session 创建后不允许切店。
- 客户端可在登录前保存入口来源和非敏感意图，但不得在未登录状态调用宠物或历史数据工具。
- 会话过期后可将已解析的非敏感草稿回填到普通表单，不能自动续约或提交。
5. 会话状态机
智能会话状态与 Appointment.status 完全分离，不得为了对话流程新增预约状态。
stateDiagram-v2
[*] --> collecting
collecting --> proposing: 门店宠物服务和时间约束齐备
proposing --> collecting: 需要补充或修改
proposing --> confirmable: 选定真实可约时段
confirmable --> collecting: 用户修改草稿
confirmable --> submitting: 用户点击确认预约
submitting --> booked: 权限和容量复核通过
submitting --> needs_reselection: 号源已变化
needs_reselection --> proposing: 重新查询号源
collecting --> fallback: 模型不可用或用户选择表单
proposing --> fallback
confirmable --> fallback
collecting --> cancelled: 用户结束
collecting --> expired: 会话过期
| 状态 | 语义 | 允许写 Appointment |
|---|---|---|
collecting |
收集和解析需求 | 否 |
proposing |
查询真实号源并给出候选 | 否 |
confirmable |
草稿完整，等待明确确认 | 否 |
submitting |
加锁会话并复核预约规则 | 仅可调用预约域服务 |
booked |
已关联真实 Appointment |
已写入 |
needs_reselection |
确认时号源已变化 | 否 |
fallback / expired / cancelled |
结束智能会话 | 否 |
M0 只实现 collecting、proposing、confirmable、fallback、expired 和 cancelled。用户在 confirmable 点击「带入普通预约」时离开助手，由现有表单完成提交；submitting、booked 和 needs_reselection 是 M1 状态，M0 不实现。
6. 系统架构与权威边界
flowchart LR
A[宠主文字] --> D[会话编排器]
B[宠主语音] --> C[语音转写适配器]
C --> D
D --> E[模型：意图与约束提取]
E --> F[结构化输出校验]
F --> G[确定性预约状态机]
G --> H[宠物与归属查询]
G --> I[门店服务查询]
G --> J[真实可约时段查询]
H --> K[确认卡]
I --> K
J --> K
K --> L[M0 带入普通预约]
L --> M[CustAppointmentCreate 回填]
M --> N[现有预约域复核与创建]
K -. M1 另立 ADR 后 .-> O[对话内受控确认]
6.1 模型可以做的事
- 识别意图：创建预约、修改草稿、结束会话或切换表单；
- 提取非权威文本约束：宠物称呼、服务需求、相对日期、时间偏好、备注；
- 根据状态机的下一动作生成简短、可理解的回复。
模型输出必须通过冻结的 booking-intent-v1 JSON Schema：
{
"schemaVersion": "booking-intent-v1",
"intent": "book",
"petQuery": "球球",
"serviceQuery": "洗澡",
"dateExpression": "本周六",
"timeWindow": { "start": "15:00", "end": null },
"remark": null,
"clearFields": [],
"ambiguities": [],
"nextAction": "resolve_context"
}
petQuery 和 serviceQuery 只是搜索文本，不是业务 ID。所有 ID 必须由后端在当前登录上下文和门店数据范围中解析；未知字段和越界枚举直接拒绝，不从残缺输出猜测。
6.2 模型不可以做的事
- 不直接访问数据库或任意 HTTP 地址；
- 不传入
customerUserId、storeId或petId作为权限事实； - 不直接调用
AppointmentService.createBooking； - 不决定最终号源，不绕过服务时长、连续容量桶和门店锁；
- 不修改
Appointment.status； - 不获取手机号、完整
report_token、员工内部信息或与预约无关的客户时间线。
6.3 内部工具白名单
| 工具 | 权限 | 返回的最小数据 | 失败处理 |
|---|---|---|---|
load_booking_context |
只读 | 已验证的入口门店、源预约摘要 | 要求选门店或切换表单 |
list_customer_pets |
只读 | petId、展示名、类型 |
无档案时切换普通表单 |
list_store_services |
只读 | serviceTypeId、名称、时长 |
给出真实服务选项 |
search_available_slots |
只读 | 开始/结束时间、可约性 | 换日期或切换表单 |
resolve_previous_booking |
只读 | 归属校验后的门店/宠物/服务 ID | 忽略历史预填并继续收集 |
白名单中不包含写工具。M0 由普通表单在助手之外完成最终创建；M1 如增加确认 endpoint，也必须在模型调用之外进入预约域。
7. 预约草稿与数据模型提案
7.1 BookingDraft
| 字段 | 来源 | 是否业务权威 | 规则 |
|---|---|---|---|
customerUserId |
CurrentUserContext |
是 | 不接受客户端或模型传入 |
storeId |
已验证入口或用户选择 | 是 | 一次会话只有一个目标门店 |
petId |
归属宠物解析 | 是 | 必须属于当前 customer |
serviceTypeId |
门店服务解析 | 是 | 必须属于当前门店 |
dateConstraint |
模型提取 + 时区解析 | 否 | 用于搜索，不直接提交 |
timeWindow |
模型提取 | 否 | 只是偏好约束 |
appointmentTime |
真实号源选择 | 是 | 必须是精确的未来时间 |
remark |
宠主原意摘要 | 否 | 限长、可编辑，不生成医疗结论 |
draftVersion |
服务端 | 是 | 每次草稿变更递增，确认时防旧版提交 |
确认时不直接信任草稿中的展示快照。后端需重新加载 Pet、ServiceType、Store 和容量事实，再由现有预约域生成 petName、petType、serviceType和 durationMinutes 快照。
7.2 候选会话表
新增 t_booking_agent_session，不将对话状态塞入 t_appointment。M0 字段已由 ADR 冻结：
| 字段 | 语义 |
|---|---|
id |
BIGINT 自增内部主键 |
session_id |
VARCHAR(36) 唯一外部 UUID，不暴露内部主键 |
customer_user_id |
从登录上下文派生 |
store_id |
NOT NULL，会话固定数据范围 |
status |
M0 六个状态之一 |
draft_json |
最小结构化草稿，不存原始语音 |
draft_version |
乐观版本号 |
entry_source |
M0 固定 appointment_create |
input_modality |
text / voice / mixed |
expires_at |
创建后 30 分钟，不滑动续期 |
create_time / update_time |
审计时间 |
数据建议：
- 以
(customer_user_id, status, expires_at)建立查询索引； - 以
(status, expires_at)支持过期标记和清理； - 会话过期 24 小时后物理删除，M0 不增加
deleted； - M0 不增加
source_appointment_id或appointment_id； - 不新增
t_booking_agent_turn原文表；模型每轮以当前草稿和当次输入工作，避免默认持久化完整对话。
上述是 M0 已评审契约，不代表当前生产库已存在；迁移实现 diff 仍必须经 Data Model Review。
7.3 预约来源与事件
不改变现有 BusinessEvent.source=customer/admin的操作人语义。长期可在 appointment_created 的 metadata_json 评审独立维度：
{
"bookingOrigin": "customer",
"bookingChannel": "agent_voice",
"agentSessionId": "<opaque-session-id>"
}
bookingChannel 候选值：form、agent_draft、agent_text、agent_voice、admin、follow_up。agent_draft 只表示智能助手提供了已验证草稿；agent_text 和 agent_voice 保留给 M1 对话内直接创建路径。初始 M0 不修改 appointment_created 事件，如需归因表单提交，必须另行评审服务端验证的一次性草稿交接，不接受客户端自由上报渠道。不建议 MVP 为此修改 Appointment 主表。
冻结的 M0 新事件：
booking_agent_started；booking_agent_draft_ready；booking_agent_fallback。
这些事件只用于漏斗和运行分析；只有真实创建成功的 appointment_created 才计为预约。M0 不增加 booking_agent_confirmed，不修改现有 appointment_created。
8. M0 API 冻结契约
契约已冻结、尚未实现。唯一机读权威是 M0 OpenAPI；响应沿用当前 { code, message, bizCode, data } 外壳，除鉴权拦截的 HTTP 401 外，客户端以 body code 为业务结果。本功能不顺带重构全局响应语义。
8.1 Endpoint
| Method | Endpoint | M0 语义 |
|---|---|---|
POST |
/api/booking-agent/sessions |
以已选 storeId 创建 customer 会话；entrySource 由服务端固定 |
POST |
/api/booking-agent/sessions/{sessionId}/messages |
携带 draftVersion、inputType 和文本更新草稿 |
POST |
/api/booking-agent/sessions/{sessionId}/transcriptions |
在本人 session 下转写不超过 60 秒/3 MB 的短音频，仅返回可编辑文本 |
POST |
/api/booking-agent/sessions/{sessionId}/fallback |
携带 draftVersion，返回服务端验证的一次性回填草稿 |
DELETE |
/api/booking-agent/sessions/{sessionId} |
将本人非终态会话标记为 cancelled |
所有 endpoint 只允许已登录 customer；session 每次用 sessionId + current.userId 查询，他人 session 和不存在 session 统一为 SESSION_NOT_FOUND。创建后 storeId 固定，消息和 fallback 必须进行草稿版本检查。
M0 不注册 /confirm，不调用 AppointmentService.createBooking；M1 必须新立 ADR 审查写路径、行锁、幂等和事件归因。
8.2 业务码
| body code | bizCode |
语义 |
|---|---|---|
| 401 | UNAUTHENTICATED |
session token 缺失或失效 |
| 403 | FORBIDDEN |
非 customer 调用 |
| 503 | AGENT_DISABLED |
功能开关关闭 |
| 404 | STORE_NOT_FOUND |
创建时目标门店无效 |
| 404 | SESSION_NOT_FOUND |
session 不存在或不属于当前 customer |
| 410 | SESSION_EXPIRED |
会话 TTL 到期 |
| 409 | SESSION_TERMINAL |
会话已 fallback/cancelled |
| 409 | DRAFT_VERSION_CONFLICT |
客户端草稿版本过旧 |
| 400 | INVALID_INPUT |
空文本、超长或请求结构无效 |
| 400 | INVALID_AUDIO |
空音频、格式/MIME/文件头不匹配或时长非法 |
| 413 | AUDIO_TOO_LARGE |
超过 3 MB |
| 429 | RATE_LIMITED |
customer 请求频率超限 |
| 503 | AGENT_UNAVAILABLE |
LLM 超时、无效 JSON/schema 或外部失败 |
| 503 | ASR_UNAVAILABLE |
ASR 超时或外部失败 |
宠物/服务歧义、无号源和未选时段是正常 200 会话响应，不用异常码表达。
9. 语音与模型集成边界
9.1 供应商适配
语音转写和语言模型分别通过后端适配器接入，业务服务不依赖某一厂商 SDK 的对话状态。
生产配置至少包括：
- 模型和语音能力总开关；
- 供应商 endpoint、模型名称和超时；
- 服务端密钥环境变量；
- 单用户和单门店频率限制；
- 单轮输入长度、语音大小和时长限制；
- 模型失败时的降级开关和成本上限。
密钥不写入代码、文档、提示词、日志或前端产物。上线前应纳入 production configuration preflight。
9.2 超时与降级
- 语音失败：保留本地输入状态，提供「重新说」和「改用文字」。
- 模型失败：不自动重复多次调用；保留已验证草稿并导向普通表单。
- 工具查询失败：展示业务错误，不让模型根据记忆补齐结果。
- M1 最终号源冲突：会话进入
needs_reselection，不创建失败预约或假成功记录。M0 只查询候选号源并回填表单。
10. 安全、隐私与可观测性
10.1 身份与数据范围
- 所有助手 endpoint 要求 customer 登录；不允许 boss/staff 借该入口传入任意 customer ID。
- session 每次读写都校验
customer_user_id == CurrentUserContext.userId。 - Pet 必须属于当前 customer，ServiceType 必须属于 session 门店。
- 模型工具调用只使用服务端已验证 ID，不使用模型或客户端宣称的身份 ID。
10.2 最小化数据
- 不向模型提供手机号、完整
report_token、密钥、会话 token、员工信息或全量客户时间线。 - 只提供当次预约必需的宠物展示名、类型、门店服务名和时间约束。
- 原始录音不落通用文件存储，转写完成或失败后立即释放。
- 默认不持久化完整用户对话原文；运行日志只保留脱敏 request ID、结果码、耗时、输入长度区间和模型版本。
10.3 提示词注入与输出安全
- 用户文本始终作为数据，不作为系统指令拼接到工具权限中。
- 模型只能返回约束 JSON Schema；未通过 schema 和枚举校验时直接降级。
- 工具名称和参数在服务端白名单中，不允许模型发起任意请求。
- 客户端不展示模型思考过程、系统提示词、工具调用原文或内部异常。
10.4 观测指标
| 指标 | 口径 |
|---|---|
| 助手启动数 | booking_agent_started 去重 session |
| 草稿完成率 | draft_ready / started |
| 助手预约成功率 | 有 appointment_created 的 agent session / started |
| 中位对话轮次 | 成功 session 的 customer message 数中位数 |
| 确认前修改率 | 进入 confirmable 后又修改草稿的 session / confirmable |
| 表单降级率 | booking_agent_fallback / started |
| 语音识别修改率 | 宠主编辑转写结果的 voice session / voice session |
| 最终号源冲突率 | CAPACITY_FULL / confirm |
| 重复预约事故 | 同一 session 关联多个 Appointment，期望恒为 0 |
| 越权或数据泄漏事故 | 任意跨 customer/跨店读写，期望恒为 0 |
11. 异常场景与产品反应
| 场景 | 产品反应 | 业务约束 |
|---|---|---|
| 找不到宠物 | 请宠主选择已有宠物或转普通表单 | 助手不自动建档 |
| 匹配到多只宠物 | 展示选择芯片 | 不用置信度代替选择 |
| 服务表达模糊 | 展示门店真实服务选项 | 不创造服务名称 |
| 当日无号 | 给出下一个有号日期 | 不承诺排队或准点履约 |
| 语音识别失败 | 重新说或改用文字 | 不提交空文本 |
| 模型超时/无效输出 | 保留草稿并转普通表单 | 不用模型记忆猜测 |
| 确认时号源已满 | 立即推荐新时段 | 不产生超容量预约 |
| M1 重复点击确认 | 返回同一预约成功页 | 会话行锁 + appointment_id 幂等 |
| 会话过期 | 新建会话或回填普通表单 | 不自动提交旧草稿 |
12. 分阶段交付
M0：草稿助手（首发建议）
- 仅在现有
CustAppointmentCreate顶部增加「一句话预约」次级入口； - 支持文字和语音转写；
- 解析宠物、服务和时间偏好，查询真实号源；
- 生成确认卡，但「带入普通预约」只把草稿回填到现有
CustAppointmentCreate； - 最终仍由现有表单提交，不新增智能层写入路径；
- 先在 1 家试点门店对老客开放，不影响 RC6 基线验证。
M1：受控确认创建
- 在 M0 session 表上增加
appointment_id、确认 endpoint、行锁和幂等返回； - 确认时重新校验权限、宠物归属、服务和容量；
- 补齐助手漏斗事件和
bookingChannel； - 通过硬性安全验收后，再允许确认卡直接创建预约。
M2：个性化复约与对照实验
- 支持「和上次一样」和宠物档案入口；
- 在一家门店做智能助手与普通表单的小流量对照；
- 将最终履约率、取消率和复约率与
bookingChannel关联； - 只有在真实使用证明更快或更高转化后，才扩大门店范围。
13. MVP 验收与试点门槛
13.1 硬性门禁
- M0 不存在助手
/confirmendpoint，不调用预约写服务。 - 助手不会返回门店不存在的服务或后端未返回的号源。
- 草稿只使用当前 customer 的宠物、session 门店服务和后端真实号源。
- 门店在会话前选定，session 创建后不能跨店更改。
- A customer 不能查询或选择 B customer 的宠物、历史预约或 session。
- 不将手机号、完整
report_token、session token 或密钥发送给模型或写入日志。 - 原始语音转写后立即释放，不出现在通用上传目录或报告媒体中。
- 模型、语音或工具失败时能保留已验证草稿并切换普通表单。
Appointment.status仍只有new、doing、done、cancel。- 仅记录 M0 三个漏斗事件，不修改
appointment_created事件语义。
13.2 价值验证建议
首批 M0 先观察 draft_ready / started、fallback / started、语音转写修改率和普通表单回填成功率。下列「助手到真实预约」指标只能在有可验证的服务端草稿归因后使用，不接受客户端自由上报。
首批 20 个真实 session 用于发现语料和交互问题，不立即下商业化结论。稳定后可对 20～50 个老客 session 使用以下建议门槛：
- 助手启动到真实预约成功率 ≥ 70%；
- 成功 session 的宠主中位消息轮次 ≤ 4；
- 切换普通表单的比例 ≤ 25%；
- 进入确认卡后修改门店/宠物/服务/时间的 session 比例 ≤ 20%；
- 越权、超容量、重复预约和敏感数据泄漏事故 = 0。
上述价值门槛是试点假设，应在首批真实数据后与普通表单基线一起复核；不得用演示会话、测试预约或未履约预约代替真实样本。
14. M0 已冻结决策与生产前缺口
| ID | 决策 | 建议默认 | 责任人 |
|---|---|---|---|
| D1 | M0 首发入口 | CustAppointmentCreate 顶部次级入口；先选门店，再登录/创建 session |
Product Design |
| D2 | 是否支持匿名助手 | MVP 不支持，普通表单继续支持 guest 草稿 | Product Design + System Architect |
| D3 | M0 是否直接创建预约 | 否，先回填现有表单 | Product Design + Backend Core |
| D4 | 模型与语音供应商 | 开发适配目标已选；生产开启仍受语料对照、数据区域和隐私复核阻塞 | System Architect + Backend Ops |
| D5 | 原文保留 | 默认不持久化对话原文，不持久化原始语音 | Access / Privacy Review |
| D6 | session TTL | 创建后固定 30 分钟，不滑动续期；过期 24 小时后物理删除 | Data Model |
| D7 | 助手对话风格 | 简短、一次一个关键问题，不模拟人格客服 | Product Design |
| D8 | 试点启动时机 | RC6 基础链路已用真实门店跑通并建立普通表单基线后 | 主控 PM |
15. 实施任务队列
当前可执行状态、owner、锁、依赖和验收口径只以 M0 执行队列 为准。其中 Batch 1–3 已具备开发边界；真实供应商和生产开启仍为 Blocked。
已被独立执行队列取代的历史草案（仅供审计，不执行）
以下 BA-01～BA-07 是契约冻结前的原始 Backlog，不再表示当前任务状态。
BA-01 冻结智能预约产品与交互契约
Task Name: 冻结智能预约产品与交互契约
Role: Product Design
Owner Agent: Product Design
Paired QA: Core Flow QA
Workstream: Core Booking Flow
Track: Product
Status: Backlog
Priority: P1
Repo/Path: docs/宠小它智能预约助手-产品与技术方案-v0.1.md
Service Lock: docs:booking-agent
Depends On: RC6 真实预约基线可用
Acceptance: 入口、登录、对话、确认卡、降级文案和 M0/M1 边界通过评审
RC Included: No
Due Date: TBD
Output Link: 本文档定稿版
Blocker Owner: 主控 PM
Commit / RC: Not Frozen
Architecture Review Required: Yes
Data Model Review Required: Yes
Access / Privacy Review Required: Yes
BA-02 评审会话表、过期与幂等模型
Task Name: 评审智能预约会话数据模型
Role: Data Model
Owner Agent: Data Model
Paired QA: Core Flow QA
Workstream: Architecture
Track: Review
Status: Backlog
Priority: P1
Repo/Path: docs/ontology; backend/src/main/java/com/petstore/entity; backend/db/migrations
Service Lock: data-model:booking-agent-session
Depends On: BA-01
Acceptance: 冻结 session 字段、索引、行锁、幂等、TTL、清理和迁移/回滚口径
RC Included: No
Due Date: TBD
Output Link: TBD
Blocker Owner: Data Model
Commit / RC: Not Frozen
Architecture Review Required: Yes
Data Model Review Required: Yes
Access / Privacy Review Required: Yes
BA-03 实现智能预约会话、解析与只读工具后端
Task Name: 实现智能预约会话解析与只读工具后端
Role: Backend Core
Owner Agent: Backend Core
Paired QA: Core Flow QA
Workstream: Core Booking Flow
Track: Coding
Status: Backlog
Priority: P1
Repo/Path: backend/src/main/java/com/petstore; backend/db/migrations; docs/ontology
Service Lock: backend:booking-agent-session+read-tools
Depends On: BA-01, BA-02
Acceptance: 会话状态、结构化输出校验、只读工具、宠物/门店数据范围、真实号源和表单回填契约有自动化测试，不包含 Appointment 写工具
RC Included: No
Due Date: TBD
Output Link: TBD
Blocker Owner: Backend Core
Commit / RC: Not Frozen
Architecture Review Required: Yes
Data Model Review Required: Yes
Access / Privacy Review Required: Yes
BA-04 接入宠主文字语音、确认卡与表单降级
Task Name: 接入宠主文字语音与预约确认卡
Role: Customer Experience Frontend
Owner Agent: Customer Experience FE
Paired QA: Core Flow QA
Workstream: Core Booking Flow
Track: Coding
Status: Backlog
Priority: P1
Repo/Path: frontend/src/pages/appointment; frontend/src/api; frontend/src/utils; frontend/pages.json
Service Lock: frontend:customer-booking-agent+shared-api
Depends On: BA-01, BA-03
Acceptance: H5/小程序支持文字和语音转写、草稿修改、绝对日期确认、防重提交和回填普通表单
RC Included: No
Due Date: TBD
Output Link: TBD
Blocker Owner: Customer Experience FE
Commit / RC: Not Frozen
Architecture Review Required: Yes
Data Model Review Required: No
Access / Privacy Review Required: Yes
BA-05 实现受控确认与幂等预约创建
Task Name: 实现智能助手受控确认与幂等预约创建
Role: Backend Core
Owner Agent: Backend Core
Paired QA: Core Flow QA
Workstream: Core Booking Flow
Track: Coding
Status: Backlog
Priority: P1
Repo/Path: backend/src/main/java/com/petstore; backend/db/migrations; docs/ontology
Service Lock: backend:booking-agent-confirm+appointment-create
Depends On: BA-01, BA-02, BA-03
Acceptance: 用户明确确认后才进入写路径；确认时复核身份、草稿版本、宠物、服务和容量；同一 session 并发/重试只返回同一 Appointment；事件可追溯
RC Included: No
Due Date: TBD
Output Link: TBD
Blocker Owner: Backend Core
Commit / RC: Not Frozen
Architecture Review Required: Yes
Data Model Review Required: Yes
Access / Privacy Review Required: Yes
BA-06 配置模型、语音与生产降级边界
Task Name: 配置智能预约模型语音与生产降级边界
Role: Backend Ops
Owner Agent: Backend Ops
Paired QA: Core Flow QA
Workstream: Release
Track: Ops
Status: Backlog
Priority: P1
Repo/Path: backend/deploy; production environment; docs/production runbook
Service Lock: ops:booking-agent-provider-config
Depends On: BA-03, BA-05
Acceptance: 密钥仅存环境、preflight 拒绝缺失/弱配置、超时降级可验证、日志无密钥/原始语音/完整对话
RC Included: No
Due Date: TBD
Output Link: TBD
Blocker Owner: Backend Ops
Commit / RC: Not Frozen
Architecture Review Required: Yes
Data Model Review Required: No
Access / Privacy Review Required: Yes
BA-07 完成智能预约三类门禁与真实试点评估
Task Name: 完成智能预约安全功能与价值验收
Role: Core Flow QA
Owner Agent: Core Flow QA
Paired QA: Backend Core / Customer Experience FE
Workstream: Core Booking Flow
Track: QA
Status: Backlog
Priority: P1
Repo/Path: docs/qa-reports; backend tests; frontend smoke
Service Lock: qa:booking-agent
Depends On: BA-03, BA-04, BA-05, BA-06
Acceptance: 确定性、权限/隐私、并发/幂等硬门禁全通过，并归档 20～50 个真实老客 session 指标
RC Included: No
Due Date: TBD
Output Link: TBD
Blocker Owner: Core Flow QA
Commit / RC: Not Frozen
Architecture Review Required: Yes
Data Model Review Required: Yes
Access / Privacy Review Required: Yes
16. 开发与验证清单
实现时至少需要：
- 更新
docs/ontology/objects.md、actions.md、events.md、rules.md、relations.md和graph/ontology.jsonl； - 后端覆盖模型无效输出、跨 customer/跨店、宠物归属、服务下线、无号源、
draftVersion冲突、session 过期和「不存在助手写路径」； - 前端覆盖语音失败、模型失败、空输入、草稿修改、无号源、提交 loading 和普通表单降级；
- 生产前检查供应商密钥、允许数据区域、超时、频控、日志脱敏和降级开关；
- 以普通预约为基线，不用智能助手取代现有真实门店试点指标。
建议实现后必跑：
cd /Users/apple/_src/petstore/backend && mvn test
cd /Users/apple/_src/petstore/frontend && npm run build:h5
cd /Users/apple/_src/petstore/frontend && npm run build:mp-weixin
cd /Users/apple/_src/petstore && python3 docs/graph/validate_ontology.py docs
cd /Users/apple/_src/petstore && python3 docs/graph/audit_drift.py
git -C /Users/apple/_src/petstore/docs diff --check
17. 与现有实现的关系
| 现有能力 | 当前事实 | 智能层如何复用 |
|---|---|---|
| 宠主预约表单 | frontend/src/pages/appointment/CustAppointmentCreate.vue 已存在 |
M0 回填草稿和最终提交的降级路径 |
| 宠物列表 | 宠主可查询自己的 Pet | 只在 customer 归属范围内解析 petId |
| 门店服务 | 服务项目具有名称和 durationMinutes |
智能助手只从真实列表中匹配 |
| 可约时段 | /api/appointment/available-slots 按时长和容量返回 |
可复用领域服务，不由模型计算 |
| 预约创建 | AppointmentService.createBooking 复核宠物、服务、时间和容量 |
M1 确认 endpoint 的唯一写入权威 |
| 业务事件 | appointment_created 已持久化 |
M0 只增加三个助手漏斗事件；bookingChannel 与直接创建归因留待 M1 评审 |
本方案是对现有预约入口的语义化扩展，不建立第二套预约、容量或身份系统。