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 进入原有编辑路由。