AI 可执行 Use Case 与追踪矩阵

2026-09-24 · 规划级 Draft · DoR: BLOCKED。API 均为拟议契约，未核真实代码；原型模拟不能替代开发测试。

系统边界

个人用户、企业权益管理员、渠道人员、平台商品/营养审核者、财务、支付机构和发货方共同完成服务与商品闭环。健康资料仅本人及被授权专业角色可见，商业渠道关系不自动授予健康访问权。未接入生产，未创建云效工作项：目标项目和唯一负责人尚未确定，状态为待提交云效。

通用非功能与接口约束

NFR-01 建议目标：100 并发/20 QPS、10万订单数据、预热5分钟后持续30分钟；非模型核心接口 p95≤800ms、错误率<1%。模型回答单独测首字/完整时延，目标由模型与任务类型评审；当前未压测，容量与指标待Q07关闭。

NFR-02 所有支付/订单/权益幂等测试不得出现重复扣款、重复发放或跨租户泄漏；100%覆盖列明的P0分支。

NFR-03 拟议错误语义：401未登录、403无权限、409库存/状态变化、429配额/限流、503依赖不可用；前端可恢复。写入请求含幂等键，金额用整数分，服务端重算，敏感字段最小化。

NFR-04 正式看板刷新延迟建议≤5分钟，财务结算按外部回执确认；不达标显示更新时间及延迟状态。

NFR-05 prototype.html只有前端模拟，localStorage仅保存合成数据；生产必须后端鉴权/计数/支付，不得复用原型本地状态作为可信数据。

UC-NP-001｜每日体验与付费额度

• Use Case ID：UC-NP-001；优先级 P0；DoR: BLOCKED（Q01/Q02/Q06）。
• 角色/边界：个人用户；只操作本人或明确授权的数据，参见通用NFR。
• 触发：进入 U02 发送问题。前置：已登录，项目允许AI；Q01待确认。
• 成功后置：本UC目标完成且状态、页面和账本一致；失败后置：不产生未授权扣款/权益/重复收益，保留可恢复记录。

主流程

• M1：校验平台身份、项目状态和权益。
• M2：原子预占可用名额。
• M3：调用模型。
• M4：成功确认扣次并展示剩余次数。

分支流程

• A1：免费第4问进入U03；付费用户使用套餐额度；匿名先登录；到期回免费。

异常/恢复

• E1/R1：模型失败或拒答释放预占，记录成本；同请求重试回读结果；跨零点更新原日期账本；平台余额耗尽显示服务暂停。

规则与页面/API/数据

• 规则：BR-01至BR-08。
• 页面：U01/U02/U03；默认、加载、空、成功、校验失败、系统错误、无权限、重复提交按角色显式处理。
• API（草案）：POST /quota/reservations; POST /ai/answers。
• 数据/状态：QuotaLedger: reserved→consumed/released；user/date/request唯一。生产迁移/回滚：[待技术设计，不在本轮规划实现]。
• 性能/安全：NFR-01至NFR-05；当前仅设计，不能标记实测通过。

验收标准

• AC-001：给定对应前置和测试数据，当主/分支/异常执行时，必须满足：剩1次并发2请求仅1次放行；免费第4次模型调用数为0；失败不扣次；重复request_id只扣1次。

测试矩阵

• TEST-001：业务规则单元＋API契约＋端到端；覆盖 并发、跨日、跨入口、付费、到期、失败、匿名、关开关、伪造身份。
• 生产测试命令：[待真实代码定位和测试工程确认]；原型检查见 evidence/validation.md，不能视为本UC完成。
• 追踪：UC-NP-001/M/A/E/R → U01/U02/U03 → 上述API/状态 → 规则 → AC-001 → TEST-001 → 未实现 → 本方案与原型。

UC-NP-002｜购买与续费年度服务

• Use Case ID：UC-NP-002；优先级 P0；DoR: BLOCKED（Q02/Q04/Q05）。
• 角色/边界：个人用户/企业受益人；只操作本人或明确授权的数据，参见通用NFR。
• 触发：点击 U03 购买。前置：销售/支付主体和退款协议已审；Q02/Q04未定。
• 成功后置：本UC目标完成且状态、页面和账本一致；失败后置：不产生未授权扣款/权益/重复收益，保留可恢复记录。

主流程

• M1：回读服务价格与已有权益。
• M2：创建订单冻结渠道及规则。
• M3：唤起支付。
• M4：后台通知/查单验真。
• M5：幂等开通。
• M6：创建待结算收益。
• M7：返回未发问题。

分支流程

• A1：企业已有同类权益则展示而非再收费；续费从较晚日期延长；沙箱只能模拟。

异常/恢复

• E1/R1：取消保持未支付；延迟显示确认中并查单；付费未开通由补偿任务发放；重复通知不重复开通；失败可从订单恢复。

规则与页面/API/数据

• 规则：BR-PAY：金额/币种/商户/订单匹配、验签；订单发放权益唯一键。
• 页面：U03/U08/U10；默认、加载、空、成功、校验失败、系统错误、无权限、重复提交按角色显式处理。
• API（草案）：POST /service-orders; GET /orders/:id; POST /payments/notify。
• 数据/状态：Order pending→paid/closed；Entitlement active/expired；Revenue pending。生产迁移/回滚：[待技术设计，不在本轮规划实现]。
• 性能/安全：NFR-01至NFR-05；当前仅设计，不能标记实测通过。

验收标准

• AC-002：给定对应前置和测试数据，当主/分支/异常执行时，必须满足：重复10次支付通知只有1份权益和1条收益；取消无权益；续费不缩短旧期；已有企业权益不误导购买。

测试矩阵

• TEST-002：业务规则单元＋API契约＋端到端；覆盖 回调重复/乱序/伪造、并发购买、通知丢失、退款、企业权益、沙箱。
• 生产测试命令：[待真实代码定位和测试工程确认]；原型检查见 evidence/validation.md，不能视为本UC完成。
• 追踪：UC-NP-002/M/A/E/R → U03/U08/U10 → 上述API/状态 → 规则 → AC-002 → TEST-002 → 未实现 → 本方案与原型。

UC-NP-003｜个人营养方案与商品匹配

• Use Case ID：UC-NP-003；优先级 P0；DoR: BLOCKED（Q03/Q06）。
• 角色/边界：个人用户/专业审核者；只操作本人或明确授权的数据，参见通用NFR。
• 触发：进入 U04 生成或更新方案。前置：本人授权必要资料；商品规则已审；Q03/Q06未定。
• 成功后置：本UC目标完成且状态、页面和账本一致；失败后置：不产生未授权扣款/权益/重复收益，保留可恢复记录。

主流程

• M1：确认目标及资料来源。
• M2：形成饮食行动。
• M3：执行适用限制。
• M4：从批准SKU匹配或给出无需商品。
• M5：用户查看依据后自主选购。

分支流程

• A1：资料不足补最少信息；无需要显示不必购买；特殊情形转专业确认；可浏览普通商品但不作个性化适用承诺。

异常/恢复

• E1/R1：撤回授权停止个人匹配；商品撤审后隐藏购买；规则服务失败禁自动商品推荐；不适反馈暂停提醒并进入专业帮助。

规则与页面/API/数据

• 规则：BR-NUT：允许零商品；不按佣金排序；不虚构缺乏/剂量；订单不代表已使用。
• 页面：U04/U05/U06/U09；默认、加载、空、成功、校验失败、系统错误、无权限、重复提交按角色显式处理。
• API（草案）：POST /nutrition-plans; GET /approved-products。
• 数据/状态：Consent/Recommendation/rule_version/approved_sku_ids。生产迁移/回滚：[待技术设计，不在本轮规划实现]。
• 性能/安全：NFR-01至NFR-05；当前仅设计，不能标记实测通过。

验收标准

• AC-003：给定对应前置和测试数据，当主/分支/异常执行时，必须满足：拒绝授权仍可普通浏览；未审SKU推荐数0；禁忌匹配自动推荐数0；无需求可完成饮食方案。

测试矩阵

• TEST-003：业务规则单元＋API契约＋端到端；覆盖 缺资料、撤回、规则失败、未审/下架SKU、特殊人群、零商品。
• 生产测试命令：[待真实代码定位和测试工程确认]；原型检查见 evidence/validation.md，不能视为本UC完成。
• 追踪：UC-NP-003/M/A/E/R → U04/U05/U06/U09 → 上述API/状态 → 规则 → AC-003 → TEST-003 → 未实现 → 本方案与原型。

UC-NP-004｜营养品购买与履约

• Use Case ID：UC-NP-004；优先级 P0；DoR: BLOCKED（Q03/Q04/Q07）。
• 角色/边界：买家/销售方/发货方；只操作本人或明确授权的数据，参见通用NFR。
• 触发：进入 U06/U07 选购。前置：SKU价格库存标签和销售方已确认；Q03/Q04未定。
• 成功后置：本UC目标完成且状态、页面和账本一致；失败后置：不产生未授权扣款/权益/重复收益，保留可恢复记录。

主流程

• M1：选规格数量入车。
• M2：确认地址运费实付。
• M3：后台校验及预占库存。
• M4：创建商品订单。
• M5：用户确认支付。
• M6：回调确认并生成待发货。
• M7：发货跟踪收货。

分支流程

• A1：服务会员与商品分开；无需会员可买商品；缺货/调价提示重新确认；可取消未支付单。

异常/恢复

• E1/R1：重复提交返回同单；超时关单释放库存；晚到付款先查单，无法履约进入异常退款；地址校验失败不扣款。

规则与页面/API/数据

• 规则：BR-GOODS：金额用分；后端重算；不超卖；不静默替换商品。
• 页面：U05/U06/U07/U08；默认、加载、空、成功、校验失败、系统错误、无权限、重复提交按角色显式处理。
• API（草案）：POST /goods-orders; POST /shipments; GET /orders/:id。
• 数据/状态：Inventory reserved/committed/released；GoodsOrder pending→paid→shipped→completed。生产迁移/回滚：[待技术设计，不在本轮规划实现]。
• 性能/安全：NFR-01至NFR-05；当前仅设计，不能标记实测通过。

验收标准

• AC-004：给定对应前置和测试数据，当主/分支/异常执行时，必须满足：仅1件库存时并发下单无超卖；空车/缺地址不下单；支付重复不重复发货；每单发货方可追溯。

测试矩阵

• TEST-004：业务规则单元＋API契约＋端到端；覆盖 库存并发、调价、关单与晚通知、缺地址、重复支付、物流失败。
• 生产测试命令：[待真实代码定位和测试工程确认]；原型检查见 evidence/validation.md，不能视为本UC完成。
• 追踪：UC-NP-004/M/A/E/R → U05/U06/U07/U08 → 上述API/状态 → 规则 → AC-004 → TEST-004 → 未实现 → 本方案与原型。

UC-NP-005｜退款与收益冲回

• Use Case ID：UC-NP-005；优先级 P0；DoR: BLOCKED（Q02/Q03/Q05）。
• 角色/边界：买家/客服/财务；只操作本人或明确授权的数据，参见通用NFR。
• 触发：U08 申请售后。前置：已确认退款政策、权限及结算责任。
• 成功后置：本UC目标完成且状态、页面和账本一致；失败后置：不产生未授权扣款/权益/重复收益，保留可恢复记录。

主流程

• M1：按服务/商品分别核验。
• M2：创建退款单。
• M3：支付机构确认结果。
• M4：调整权益/退货库存。
• M5：记录收益冲回。
• M6：回显到账进度。

分支流程

• A1：部分退款按行/数量核算；已结算订单形成回退/抵扣账；商品退货验收后才释放可售库存。

异常/恢复

• E1/R1：申请失败原状态不伪装退款成功；结果未知查单；重复回调只冲回一次；人工处理留下审计。

规则与页面/API/数据

• 规则：BR-REFUND：退款累计≤原实付；商品售后与服务退款独立；外部回执为准。
• 页面：U08/C04/C05/P03/P04；默认、加载、空、成功、校验失败、系统错误、无权限、重复提交按角色显式处理。
• API（草案）：POST /refunds; GET /refunds/:id。
• 数据/状态：Refund pending→success/failed；Revenue reversal；原流水保留。生产迁移/回滚：[待技术设计，不在本轮规划实现]。
• 性能/安全：NFR-01至NFR-05；当前仅设计，不能标记实测通过。

验收标准

• AC-005：给定对应前置和测试数据，当主/分支/异常执行时，必须满足：重复退款通知不重复返钱/冲回；全退购买人数重算；已结算收益有明确负向账。

测试矩阵

• TEST-005：业务规则单元＋API契约＋端到端；覆盖 全额/部分退款、通知丢失、重复、已结算后退款、权益取消。
• 生产测试命令：[待真实代码定位和测试工程确认]；原型检查见 evidence/validation.md，不能视为本UC完成。
• 追踪：UC-NP-005/M/A/E/R → U08/C04/C05/P03/P04 → 上述API/状态 → 规则 → AC-005 → TEST-005 → 未实现 → 本方案与原型。

UC-NP-006｜使用反馈、复盘与补购

• Use Case ID：UC-NP-006；优先级 P0；DoR: BLOCKED（Q03/Q06）。
• 角色/边界：个人用户；只操作本人或明确授权的数据，参见通用NFR。
• 触发：收到商品后进入 U09。前置：本人确认已开始；使用说明已审。
• 成功后置：本UC目标完成且状态、页面和账本一致；失败后置：不产生未授权扣款/权益/重复收益，保留可恢复记录。

主流程

• M1：用户记录开始与完成。
• M2：自主反馈余量和困难。
• M3：形成复盘。
• M4：重新检查适用性。
• M5：需要时提示补购。
• M6：用户确认进入U06。

分支流程

• A1：可以暂停、不买或仅调整饮食；未使用不记为完成；提醒须授权。

异常/恢复

• E1/R1：不适反馈暂停相关提醒并提示专业帮助；资料过期先核对；消息不可达保留站内待办；撤回授权停个性化处理。

规则与页面/API/数据

• 规则：BR-USE：不自动下单/扣款；反馈与销售订单分离。
• 页面：U09/U04/U06；默认、加载、空、成功、校验失败、系统错误、无权限、重复提交按角色显式处理。
• API（草案）：POST /usage-records; POST /review; POST /reminders。
• 数据/状态：UsageRecord started/paused；Reminder pending/cancelled。生产迁移/回滚：[待技术设计，不在本轮规划实现]。
• 性能/安全：NFR-01至NFR-05；当前仅设计，不能标记实测通过。

验收标准

• AC-006：给定对应前置和测试数据，当主/分支/异常执行时，必须满足：暂停后无自动补购提醒；订单支付不会生成已使用记录；未授权通知不发送。

测试矩阵

• TEST-006：业务规则单元＋API契约＋端到端；覆盖 暂停、撤回、无余量、无需要、不适、推送失败、数据缺失。
• 生产测试命令：[待真实代码定位和测试工程确认]；原型检查见 evidence/validation.md，不能视为本UC完成。
• 追踪：UC-NP-006/M/A/E/R → U09/U04/U06 → 上述API/状态 → 规则 → AC-006 → TEST-006 → 未实现 → 本方案与原型。

UC-NP-007｜渠道查看经营与收益

• Use Case ID：UC-NP-007；优先级 P0；DoR: BLOCKED（Q05/Q06/Q07）。
• 角色/边界：渠道管理员/财务；只操作本人或明确授权的数据，参见通用NFR。
• 触发：进入 C01/C04。前置：渠道角色经后台认证且归属规则明确。
• 成功后置：本UC目标完成且状态、页面和账本一致；失败后置：不产生未授权扣款/权益/重复收益，保留可恢复记录。

主流程

• M1：确定可见渠道。
• M2：选择日期。
• M3：分别展示服务买家、商品买家、激活数与活跃。
• M4：查看收益分栏及账单。

分支流程

• A1：空渠道显示0与空态；服务人员无财务角色则隐藏金额；可看退款冲回；按日趋势。

异常/恢复

• E1/R1：无权访问返回403；指标延迟展示最后更新时间，不以0代替失败；归属争议订单暂缓结算并可申诉。

规则与页面/API/数据

• 规则：BR-DATA：去重、企业采购与激活分离、渠道隔离；不含个人报告/对话。
• 页面：C01/C02/C04/C05；默认、加载、空、成功、校验失败、系统错误、无权限、重复提交按角色显式处理。
• API（草案）：GET /channel/metrics; GET /channel/revenues。
• 数据/状态：DailyMetric + RevenueLedger；基于服务端角色范围。生产迁移/回滚：[待技术设计，不在本轮规划实现]。
• 性能/安全：NFR-01至NFR-05；当前仅设计，不能标记实测通过。

验收标准

• AC-007：给定对应前置和测试数据，当主/分支/异常执行时，必须满足：服务商品重叠买家合计去重；企业100账号记1采购主体+100权益；渠道A无法读B；测试活跃排除。

测试矩阵

• TEST-007：业务规则单元＋API契约＋端到端；覆盖 空态、错误、权限、退款、重叠用户、企业采购、迟到事件。
• 生产测试命令：[待真实代码定位和测试工程确认]；原型检查见 evidence/validation.md，不能视为本UC完成。
• 追踪：UC-NP-007/M/A/E/R → C01/C02/C04/C05 → 上述API/状态 → 规则 → AC-007 → TEST-007 → 未实现 → 本方案与原型。

UC-NP-008｜渠道推广归属与结算

• Use Case ID：UC-NP-008；优先级 P0；DoR: BLOCKED（Q04/Q05）。
• 角色/边界：渠道管理员/平台财务；只操作本人或明确授权的数据，参见通用NFR。
• 触发：C03 邀请；C05 对账结算。前置：渠道合同、付款主体、归属规则和结算条件批准。
• 成功后置：本UC目标完成且状态、页面和账本一致；失败后置：不产生未授权扣款/权益/重复收益，保留可恢复记录。

主流程

• M1：带渠道来源进入。
• M2：校验/确认归属。
• M3：订单冻结规则。
• M4：计算单一模式收益。
• M5：售后窗口后对账。
• M6：审核结算。
• M7：回执确认到账。

分支流程

• A1：已有归属不覆盖；转移只影响约定的未来订单；渠道自收款不重复领平台佣金。

异常/恢复

• E1/R1：支付机构分账失败保持待处理；退款进入冲回；更改渠道/费率不回溯改老订单；超分账能力不发起超限请求。

规则与页面/API/数据

• 规则：BR-CHANNEL：一种订单一种结算模式；资金回执与业务记账分离。
• 页面：C03/C04/C05/P04；默认、加载、空、成功、校验失败、系统错误、无权限、重复提交按角色显式处理。
• API（草案）：POST /attributions; POST /settlements; GET /settlements/:id。
• 数据/状态：Attribution effective_range；Settlement pending→processing→paid/failed。生产迁移/回滚：[待技术设计，不在本轮规划实现]。
• 性能/安全：NFR-01至NFR-05；当前仅设计，不能标记实测通过。

验收标准

• AC-008：给定对应前置和测试数据，当主/分支/异常执行时，必须满足：历史单收益不随费率改写；重复结算不重复打款；无回执不显示已到账。

测试矩阵

• TEST-008：业务规则单元＋API契约＋端到端；覆盖 归属覆盖、过期/转移、重复结算、机构失败、退款冲回。
• 生产测试命令：[待真实代码定位和测试工程确认]；原型检查见 evidence/validation.md，不能视为本UC完成。
• 追踪：UC-NP-008/M/A/E/R → C03/C04/C05/P04 → 上述API/状态 → 规则 → AC-008 → TEST-008 → 未实现 → 本方案与原型。

UC-NP-009｜平台配置项目与预算

• Use Case ID：UC-NP-009；优先级 P0；DoR: BLOCKED（Q01/Q07）。
• 角色/边界：平台管理员/运营；只操作本人或明确授权的数据，参见通用NFR。
• 触发：P01/P05 配置。前置：权限、审计、预算负责人明确。
• 成功后置：本UC目标完成且状态、页面和账本一致；失败后置：不产生未授权扣款/权益/重复收益，保留可恢复记录。

主流程

• M1：选项目。
• M2：配置试用/正式及功能开关。
• M3：设置免费3问与付费额度版本。
• M4：配置预算告警。
• M5：保存审核。
• M6：调用入口执行。

分支流程

• A1：关闭问答保留团餐基础业务；已购买服务无法履约时提示并暂停新售；白名单限期有预算。

异常/恢复

• E1/R1：模型欠费/超预算熔断；恢复先检查可用性；配置失败沿用最后有效版本；不把平台欠费转嫁用户。

规则与页面/API/数据

• 规则：BR-OPS：项目开关服务端强制；测试支付/指标隔离。
• 页面：P01/P05/U02/U03；默认、加载、空、成功、校验失败、系统错误、无权限、重复提交按角色显式处理。
• API（草案）：PUT /projects/:id/ai-policy; GET /service-status。
• 数据/状态：Policy version；enabled/paused；BudgetLedger。生产迁移/回滚：[待技术设计，不在本轮规划实现]。
• 性能/安全：NFR-01至NFR-05；当前仅设计，不能标记实测通过。

验收标准

• AC-009：给定对应前置和测试数据，当主/分支/异常执行时，必须满足：关闭后无新模型调用；基础订餐支付不受影响；付费状态仍保留；配置变更有审计。

测试矩阵

• TEST-009：业务规则单元＋API契约＋端到端；覆盖 权限、熔断、恢复、过期白名单、环境隔离。
• 生产测试命令：[待真实代码定位和测试工程确认]；原型检查见 evidence/validation.md，不能视为本UC完成。
• 追踪：UC-NP-009/M/A/E/R → P01/P05/U02/U03 → 上述API/状态 → 规则 → AC-009 → TEST-009 → 未实现 → 本方案与原型。

云效提交准备

创建父需求时必须将本文件详细UC直接放进正文，不可只粘链接；开发子任务保留父UC、覆盖步骤、异常、规则、AC和测试切片。目标项目、负责人和P0决策确认后再提交，CLI/OpenAPI回读Use Case ID、主流程、异常/恢复、验收标准、测试矩阵、DoR。当前未提交，不称已在云效体现。