---
kit_version: "1.0.0"
doc_id: "UMAY-DOC-08"
project_name: "UmayShop"
module: "08"
prepared_by: "示例编写角色"
content_owner: "待指派"
document_date: "2026-10-01"
status: "example"
language: "zh-CN"
revision_id: "example-r1"
source_revision_id: null
translation_status: "not_requested"
classification: "internal"
reference_eligibility: "example_only"
---

# UmayShop — 08. Delivery / 配送与物流

> **虚构示例**：下文用于演示填写方法，不是 UmayShop 的实际实现、权限、部署或批准结论。虚构样例不能进入正式参考资料。

独立记录从下单到交付、失败和退货的全链路；订单、支付和物流状态分开。

[返回总目录](../README.md) · [统一填写与核验规则](../AUTHORING-GUIDE.md)

## 目录

- [文档信息](#文档信息)
- [适用范围与核验结论](#适用范围与核验结论)
- [参与方与交接边界](#参与方与交接边界)
- [正向配送流程](#正向配送流程)
- [状态字典与转换](#状态字典与转换)
- [承运商接口与事件](#承运商接口与事件)
- [退货与逆向交接](#退货与逆向交接)
- [异常时限与追踪](#异常时限与追踪)
- [可视化图表](#可视化图表)
- [来源、最终决策与代码核验](#来源-最终决策与代码核验)
- [附件与图片资源](#附件与图片资源)
- [人工维护区](#人工维护区)
- [语言与下载检查](#语言与下载检查)
- [修改历史](#修改历史)
- [相关文档](#相关文档)

<a id="文档信息"></a>

## 文档信息

| 字段 | 填写内容 |
| --- | --- |
| 内容负责人 / 确认人 | 待指派 / 未确认；编写人不是自动批准者 |
| 技术负责人 / 目标期限 | 阿宗 / 2026-10-19；模板须经其确认后生效 |
| 模板版本 / 当前状态 | 1.0.0 / example；未发布 |
| 项目 / 编写人 | UmayShop / 示例编写角色 |
| 适用版本 / 环境 | 示例数据集 r1 / 虚构测试环境 |
| 代码仓库 / 采集分支 / 完整 SHA | 未取得真实快照；虚构样例不填假 SHA |
| 最近确认时间 / 确认依据 | 未确认 / 未取得确认记录 |
| 访问分级 | internal：内部；涉及受限信息时提高分级，继承源权限 |
| 语言 / 原文修订 | zh-CN / example-r1；英文和俄文尚未生成 |


<a id="适用范围与核验结论"></a>

## 适用范围与核验结论

| 项目 | 结论 |
| --- | --- |
| 覆盖范围 | 独立记录从下单到交付、失败和退货的全链路；订单、支付和物流状态分开。 |
| 采集排除项 | umay/cis-mep 及其全部子树不采集、不翻译、不导出、不计验收 |
| 已验证范围 | 仅提供虚构填写示例，未核验私有代码 |
| 已核验参考资料数量 | 0；本文未执行真实 Issue/源码核验 |
| 证据可信程度 | 真实系统结论：低/未知；已确认需求范围：高（用户单一来源，非代码证明） |
| 限制 / 缺口 | 需补最终决策、确认权限、精确 SHA、实现位置和验证记录；不把前端静态检查扩展为后端或生产结论 |


<a id="参与方与交接边界"></a>

## 参与方与交接边界

> 填写说明：物流商接口能力和人工操作分别列出。

| 参与方 | 责任 | 交给谁 | 交接凭据 | 实现方式 | 证据 |
| --- | --- | --- | --- | --- | --- |
| 用户 / Web 或 Mobile | 提交订单与收货信息 | API-DEMO | 订单确认记录 | 页面请求示例 | EXAMPLE-E08 |
| 仓库 | 拣货、包装、出库 | CARRIER-DEMO | 出库单和交接凭据 | 系统 + 人工 | EXAMPLE-E08 |
| 物流商 | 运输与交付 | 用户 / 售后 | 轨迹和签收记录 | 回调示例，人工异常跟进 | EXAMPLE-E08 |


<a id="正向配送流程"></a>

## 正向配送流程

> 填写说明：所有步骤都应出现在独立配送图中；支付确认不等于出库。

| 节点 | 进入条件 | 动作 | 退出条件 | 责任 | 失败分支 |
| --- | --- | --- | --- | --- | --- |
| 下单 | 资料有效 | 创建订单 | 订单受理 | 示例业务角色 | 校验失败返回修改 |
| 支付确认 | 订单待付款 | 核对支付结果 | 付款来源确认 | 示例支付角色 | 失败保持待付款或按规则关闭 |
| 仓库处理 | 允许履约 | 拣货包装复核 | 形成出库凭据 | 示例仓库角色 | 短拣/破损处理 |
| 承运商交接 | 包裹可交接 | 承运商接收 | 交接凭据确认 | 示例物流角色 | 拒收进入异常 |
| 运输与签收 | 已接收 | 跟踪与投递 | 签收证据确认 | 示例物流角色 | 延误/拒收/丢失进入异常 |


<a id="状态字典与转换"></a>

## 状态字典与转换

> 填写说明：不要把不同系统的状态拼成一个未定义枚举。每条转换给出事件和守卫条件（允许转换的前提）。

| 状态域 | 原状态 | 目标状态 | 触发事件 | 前置条件 | 来源 |
| --- | --- | --- | --- | --- | --- |
| 订单示例 | CREATED | FULFILLING | 允许履约 | 支付来源已确认 | API-DEMO |
| 支付示例 | PENDING | PAID | 支付通知核验通过 | 签名与金额匹配 | PAY-DEMO |
| 仓储示例 | PICKED | DISPATCHED | 出库复核 | 数量/包裹一致 | WMS-DEMO |
| 物流示例 | IN_TRANSIT | DELIVERED | 有效签收记录 | 时间顺序及运单一致 | CARRIER-DEMO |


<a id="承运商接口与事件"></a>

## 承运商接口与事件

> 填写说明：迟到、重复、乱序事件必须说明处理原则；不要依据回调到达次数重复写库存。

| 集成 ID | 方向 | 关键数据 | 认证 / 校验 | 重试与去重 | 异常处理 |
| --- | --- | --- | --- | --- | --- |
| INT-EX-CARRIER | 后端至承运商 | shipmentId, parcelId | 见 API-EX-02 | 超时先查询；幂等键 | 人工核对结果不明订单 |
| EVT-EX-DELIVERY | 承运商至后端 | eventId, trackingId, status, occurredAt | 见目录 09 回调校验 | eventId 去重；状态合法性校验 | 旧事件留日志不回退终态 |


<a id="退货与逆向交接"></a>

## 退货与逆向交接

> 填写说明：退货物流、售后审批、退款和库存恢复是不同动作，不能互相推定。

| 节点 | 输入 | 确认条件 | 输出 | 责任 | 异常 |
| --- | --- | --- | --- | --- | --- |
| 退货申请 | 原因 / 订单 | 满足售后规则 | 受理或拒绝记录 | 示例客服角色 | 材料不足要求补充 |
| 寄回运输 | 退货运单 | 承运商接收 | 退货轨迹 | 示例物流角色 | 丢失进入调查 |
| 仓库验收 | 退回实物 | 质检与数量确认 | 可重新入库或隔离 | 示例仓库角色 | 破损不自动恢复可售库存 |
| 退款处理 | 售后批准记录 | 支付渠道核验 | 退款结果独立记录 | 示例支付角色 | 失败转人工，不假定退货即退款 |


<a id="异常时限与追踪"></a>

## 异常时限与追踪

> 填写说明：所有时限填写实际批准值；样例不作为 SLA（对外服务承诺）。

| 异常 | 检测来源 | 实际时限 | 下一步 | 接收负责人 | 闭环证据 |
| --- | --- | --- | --- | --- | --- |
| 轨迹长时间无变化 | 监控或人工反馈 | 待批准 | 查询承运商再决定补偿 | 未指派 | 工单和处理结果 |
| 状态相互矛盾 | 订单/仓储/物流对账 | 待批准 | 冻结自动终态更新并核对 | 未指派 | 修正记录 |


<a id="可视化图表"></a>

## 可视化图表

图表只表达已核验范围；每条关键连线应关联来源。当前为虚构示例，不证明真实部署。

### 独立配送流程

![独立配送流程（虚构示例）](../assets/delivery.svg)

[可维护图源](../assets/delivery.mmd) · [独立图片](../assets/delivery.svg)

### 独立退货流程

![独立退货流程（虚构示例）](../assets/returns.svg)

[可维护图源](../assets/returns.mmd) · [独立图片](../assets/returns.svg)


<a id="来源-最终决策与代码核验"></a>

## 来源、最终决策与代码核验

**引入规则**：先确认“最终决定是什么”，再验证“目标版本实际做了什么”。Issue 关闭、最后一条评论、标题或“已处理”均不足以通过。同期只表示候选关联，不表示已实现。

| 证据 ID | 来源类型 / 定位 | 读取快照 / 时间 | 独立性与完整性 | 当前状态 |
| --- | --- | --- | --- | --- |
| EXAMPLE-E08 | 虚构需求说明 + 虚构代码线索 | 无真实快照 | 同一来源的转载不算独立来源；缺附件需标出 | example_only |

| 决策 ID | Issue / 评论 ID / 时间 | 最终决定与适用范围 | 确认者及权限依据 | 替代/冲突记录 | 决策状态 |
| --- | --- | --- | --- | --- | --- |
| EXAMPLE-D08 | EXAMPLE-ISSUE / EXAMPLE-NOTE / 虚构时点 | 显示未知配送状态，不推定已交付（虚构） | 未取得真实有权确认记录 | 真实冲突未知 | unresolved |

| 决策 ID | 仓库 / 分支 / 完整 SHA | 实现文件:行号 / 符号 | 测试或核验方法 / 结果 | 代码状态 / 范围 | 核验人 / 时间 | 差异与正式引入结论 |
| --- | --- | --- | --- | --- | --- | --- |
| EXAMPLE-D08 | 未取得，不使用假 SHA | 未取得真实实现位置 | 未执行真实核验 | unverified / 无 | 未核验 / 未确认 | 不得引入；补证后复核 |

决策状态：`unresolved`（未定）、`confirmed`（有效确认）、`superseded`（已被替代）。代码状态：`unverified`（未验证）、`partial`（仅部分）、`code_verified`（固定版本代码支持）、`runtime_verified`（目标环境实测支持）。**静态代码支持不等于生产运行通过。**

需要同时满足：决策已有效确认、无未解决冲突、相关代码覆盖完整、证据可定位、人工核验记录齐全，才可在其验证范围内列为正式参考。涉及部署、权限或外部服务真实行为的断言，另需对应环境的运行证据。旧决策保留为历史，不冒充当前规则。

| 缺口 ID | 缺失证据 | 影响 | 补充负责人 / 期限 | 解决条件 |
| --- | --- | --- | --- | --- |
| GAP-08-01 | 真实决策与代码快照 | 不能生成已核验业务结论 | 待指派 / 待确认 | 补齐并记录核验人、时间、范围与结果 |


<a id="附件与图片资源"></a>

## 附件与图片资源

| 资源 ID | 来源 / 权属 | 本地相对路径 | 完整性 / 读取状态 | 权限边界 | 语言处理 |
| --- | --- | --- | --- | --- | --- |
| delivery | 本包 tools/diagram_assets.py（本地图结构定义） | ../assets/delivery.svg + .mmd | 本地生成；XML 可校验 | internal / 无外部下载 | 图片内中文未译；当前只有中文图 |
| returns | 本包 tools/diagram_assets.py（本地图结构定义） | ../assets/returns.svg + .mmd | 本地生成；XML 可校验 | internal / 无外部下载 | 图片内中文未译；当前只有中文图 |

附件应记录原文件 URL、文件名、内容校验值、读取时间与访问分级；不得保存访问令牌或带签名的临时 URL。链接可打开不等于正文已读。重定向到登录页、损坏、加密、扫描件未识别，均标记未读取。转换后的正文必须链接原件与图片，不覆盖原件。


<a id="人工维护区"></a>

## 人工维护区

<!-- MANUAL:START -->
待填写：负责人确认的解释、例外和运维提示。后续自动更新须保留本区；与新证据冲突时提交差异，不能静默删除。本初始化脚本不会更新已有内容。
<!-- MANUAL:END -->


<a id="语言与下载检查"></a>

## 语言与下载检查

| 检查项 | 当前状态 / 要求 |
| --- | --- |
| 中文原文 | 本页为中文；按 revision_id 固定修订 |
| 英文 / 俄文 | 未生成。后续自动翻译绑定中文 source_revision_id；原文更新后旧译文标 stale（已过期） |
| 内容结构 | 翻译保留标题层级、目录、表格、代码、链接、字段和数值；术语按项目词汇表 |
| 图片与图内文字 | 原图和本地资源保留；图内中文单独重制或附译文说明，不把未译图算完整译文 |
| Markdown 下载 | 含图片时以 Markdown + assets + 资源清单的 ZIP 下载；不得只提供失效的远程链接 |
| PDF 下载 | 平台需实现分页、目录/书签、表格、中文/英文/俄文字体与本地图片嵌入；缺图应阻断完整成功 |
| 导出与权限 | 绑定文档修订、语言、图像版本与模板版本；继承源权限，不公开受限内容 |
| 本包能力边界 | 仅生成 Markdown 文档树与本地图源/SVG；不执行翻译、PDF 渲染、登录或平台发布 |


<a id="修改历史"></a>

## 修改历史

| 修订 | 日期 | 编写人 | 变更 | 确认 / 依据 |
| --- | --- | --- | --- | --- |
| example-r1 | 2026-10-01 | 示例编写角色 | 初始化虚构示例 | 未确认 / 模板 1.0.0 |


<a id="相关文档"></a>

## 相关文档

- [03. Backend / 后端服务](../03-backend/README.md)
- [07. WMS / 仓库管理系统](../07-wms/README.md)
- [09. API / 接口与系统集成](../09-api-integrations/README.md)
- [12. 监控、日志与错误处理](../12-observability/README.md)