智能图表生成助手

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  subgraph lane1["用户"]
    u_open([打开App [入口][触点]])
    u_inputPhone([输入手机号 [触点]])
    u_inputCode([输入验证码 [触点]])
  end

  subgraph lane2["App"]
    app_launch([启动应用])
    app_reqCode([获取验证码请求])
    app_check([提交验证码进行校验])
    app_verify([验证成功])
    app_home([进入首页 [出口]])
    app_prompt_expire([提示：验证码已过期])
    app_prompt_timeout([提示：网络超时，请重试])
    app_prompt_unreg([提示：账号未注册])
  end

  subgraph lane3["短信服务"]
    sms_send([发送短信验证码])
    sms_validate([校验验证码])
  end

  subgraph lane4["用户中心"]
    uc_check([检查账号注册状态])
  end

  %% 主路径
  u_open --> app_launch
  app_launch --> u_inputPhone
  u_inputPhone --> app_reqCode
  app_reqCode -->|依赖：短信API| sms_send
  sms_send -->|验证码下发| u_inputCode
  u_inputCode --> app_check
  app_check -->|依赖：短信API| sms_validate
  sms_validate --> app_verify
  app_verify -->|依赖：用户中心API| uc_check
  uc_check --> app_home

  %% 异常分支（红色虚线）
  sms_validate -.->|验证码过期| app_prompt_expire
  app_prompt_expire -.-> app_reqCode

  app_reqCode -.->|网络超时| app_prompt_timeout
  app_prompt_timeout -.-> app_reqCode

  app_check -.->|网络超时| app_prompt_timeout
  app_prompt_timeout -.-> app_check

  uc_check -.->|账号未注册| app_prompt_unreg
  app_prompt_unreg -.-> u_inputPhone

  %% 将异常分支连线设为红色虚线
  linkStyle 10 stroke:#d73a49,stroke-width:2px,stroke-dasharray:5 5,color:#d73a49
  linkStyle 11 stroke:#d73a49,stroke-width:2px,stroke-dasharray:5 5,color:#d73a49
  linkStyle 12 stroke:#d73a49,stroke-width:2px,stroke-dasharray:5 5,color:#d73a49
  linkStyle 13 stroke:#d73a49,stroke-width:2px,stroke-dasharray:5 5,color:#d73a49
  linkStyle 14 stroke:#d73a49,stroke-width:2px,stroke-dasharray:5 5,color:#d73a49
  linkStyle 15 stroke:#d73a49,stroke-width:2px,stroke-dasharray:5 5,color:#d73a49
  linkStyle 16 stroke:#d73a49,stroke-width:2px,stroke-dasharray:5 5,color:#d73a49
  linkStyle 17 stroke:#d73a49,stroke-width:2px,stroke-dasharray:5 5,color:#d73a49

%%{init: {"theme":"dark","themeCSS":".note{fill:#FFF3CD;stroke:#FFC107;color:#111;font-weight:600}.actor{stroke:#CFCFCF}.messageLine{stroke:#D9D9D9}.messageText{fill:#EAEAEA}"}}%%
sequenceDiagram
title 支付流程（同步/异步、超时与重试、重复回调去重与幂等）

participant C as 客户端
participant G as API网关
participant O as 订单服务
participant P as 支付聚合
participant T as 第三方渠道

C->>G: 创建订单【同步】
activate G
G->>O: 创建订单【同步】
activate O
O-->>G: 订单已创建【异步】
deactivate O
G-->>C: 返回订单ID/状态【异步】
deactivate G

C->>G: 预下单【同步】
activate G
G->>O: 校验并锁定订单【同步】
activate O
O->>P: 预下单请求【同步】
activate P
P-->>T: 预下单【异步】
activate T
Note right of T: ⚠️ 第三方网络不稳定，可能超时
T-->>P: 预下单响应【异步】
deactivate T
P-->>O: 返回支付参数【异步】
deactivate P
O-->>G: 返回预下单参数【异步】
deactivate O
G-->>C: 下发前端支付参数【异步】
deactivate G

C-->>G: 支付请求【异步】
activate G
G->>P: 幂等键校验（Idempotency-Key）【同步】
activate P
Note over G,P: 使用幂等键确保支付请求幂等与去重
P->>T: 发起支付【同步】
activate T
alt 第三方响应超时
    T-->>P: 无响应/超时【异步】
    Note right of P: ⚠️ 启动重试（指数回退，最大3次）
    loop 重试最多3次
        P-->>T: 重试请求【异步】
        T-->>P: 响应/受理结果【异步】
    end
else 成功受理
    T-->>P: 支付受理/结果【异步】
end
deactivate T
P-->>G: 支付中/已受理【异步】
deactivate P
G-->>C: 显示支付中【异步】
deactivate G

T-->>P: 回调通知【异步】
activate P
Note right of P: 回调去重：基于 orderId+channel+nonce\n幂等校验：幂等键与回调流水
alt 首次回调
    P->>O: 更新订单状态【同步】
    activate O
    O-->>P: 状态已更新【异步】
    deactivate O
else 重复回调
    Note right of P: ⚠️ 去重拦截，记录回调流水，拒绝重复处理
end
P-->>T: 回调确认【异步】
P-->>G: 结果确认【异步】
G-->>C: 显示支付结果【异步】
deactivate P