上下游依赖图

目的

记录本项目依赖谁、谁依赖本项目、依赖失败时影响什么。

三角色关注点

产品负责人关注的用户 / 业务影响:

技术负责人关注的系统风险:

平台 / 资深工程师关注的降级、重试、监控:

总览图

flowchart LR
  Upstream["上游系统 / 用户"] --> This["本项目"]
  This --> Downstream["下游服务"]
  This --> Infra["共享基础设施"]
  This --> ThirdParty["第三方服务"]

上游依赖本项目

上游 依赖方式 依赖接口 / 事件 SLA / 期望 Owner
HTTP / RPC / webhook / event / manual

本项目依赖下游

下游 用途 调用方式 失败影响 降级 / 重试 Owner

第三方服务

服务 用途 凭证位置 沙箱环境 失败模式 替代方案

共享基础设施

资源 用途 环境 Owner 风险
数据库 dev/staging/prod
缓存
队列
对象存储
Feature flag
Secret manager

关键依赖路径

路径 1:名称

上游
-> 本项目入口
-> 下游依赖
-> 返回 / 事件

风险:

降级策略:

验证方式:

后续 Agent 注意事项

人类依赖关系稳定后再填这一节。

Agent 修改依赖相关代码前必须检查:

  1. 是否影响上游契约。
  2. 是否影响下游调用频率、重试、超时。
  3. 是否需要更新 mock、fixture、contract test。
  4. 是否需要人工 approval。

下一步阅读

读完或填完这份文档后,通常继续看: