spec.md 3.0 KB

address-management Specification

Purpose

定义 PRI-MP-ADDRESS-001 收货地址列表、详情、新增、编辑、删除、地区选择和订单回填能力。地址写操作严格使用旧版接口字段,仅可由用户明确点击保存或删除后执行,页面生命周期不得自动触发。

Requirements

Requirement: REQ-ADDRESS-001-01 ADDRESS-001 地址管理与选择回填契约

系统 MUST 按 PRI-MP-ADDRESS-001 上下文包、功能点专项矩阵和集成队列裁定口径实现本模块能力,并保留跨模块契约、真实接口边界和人工联调边界。

  • 历史追溯:本模块最初从 develop@9a529fc 的 feature/PRI-MP-ADDRESS-001-address-management 分支开发;该记录不构成当前业务或验收要求。
  • MUST:覆盖当前模块功能点专项矩阵,并对每个功能点给出已实现、暂缓、划归其他模块、待确认或不属于本模块的结论。
  • MUST:记录契约与依赖闭环,未完成依赖必须使用待开放、禁用态或安全兜底。
  • MUST:自检报告包含新版设计基线、旧源码功能基线、视觉布局基线、真实接口与禁止模拟业务数据检查。
  • MUST:提交待集成时列出共享文件清单、固定检查结果和人工联调项。
  • MUST NOT:子 Agent 自行合并或推送 develop。
  • MUST NOT:使用 mock、本地假接口、硬编码业务返回或静态业务数据替代真实接口。
  • MUST:地址列表、详情、保存和删除分别按旧版 01020006、01020016、01020005、01020007 接口及字段执行,并支持订单配送/商品确认页回填。
  • MUST NOT:在页面加载、显示、回跳或刷新时自动触发支付、医保、退款、订单创建、预约提交、实名/OCR/人脸、IM/TRTC 等高风险写操作;地址保存和删除必须由用户明确触发。

Scenario: 模块提交待集成

  • Given PRI-MP-ADDRESS-001 模块开发完成
  • When 子 Agent 提交待集成材料
  • Then OpenSpec strict、功能点矩阵闭环、契约与依赖闭环、共享文件清单、禁止 mock/硬编码扫描、人工联调项和固定检查结果 MUST 齐全。

Scenario: 用户保存收货地址

  • Given 用户已填写合法的收货人、手机号、地区和详细地址
  • When 用户点击保存
  • Then 系统 MUST 按旧版 01020005 字段提交,并在服务端成功后返回地址列表或调用页;页面加载时 MUST NOT 自动提交。

Requirement: REQ-ADDRESS-001-02 地址卡片操作按钮稳定布局

地址列表页 MUST 在保留原有地址查询、选择和编辑路由契约的前提下,让地址卡片的“选择/编辑”按钮使用受控宽度,且不挤压姓名、手机号、地区和详细地址。

Scenario: 地址卡片显示编辑按钮

  • GIVEN 地址列表存在至少一条地址
  • WHEN 页面渲染地址卡片和“编辑”按钮
  • THEN “编辑”按钮 MUST 按设计宽度固定显示并保持文字居中
  • AND 按钮 MUST NOT 因原生最小宽度扩张或挤压地址信息区
  • AND 点击按钮仍 MUST 进入原有编辑路由。