上下游依赖图
目的
记录本项目依赖谁、谁依赖本项目、依赖失败时影响什么。
三角色关注点
产品负责人关注的用户 / 业务影响:
技术负责人关注的系统风险:
平台 / 资深工程师关注的降级、重试、监控:
总览图
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 修改依赖相关代码前必须检查:
- 是否影响上游契约。
- 是否影响下游调用频率、重试、超时。
- 是否需要更新 mock、fixture、contract test。
- 是否需要人工 approval。
下一步阅读
读完或填完这份文档后,通常继续看:
- 41-项目架构文档包-project-architecture-pack.md:依赖图完成后,回到项目架构文档包检查是否齐全。
- 系统架构-architecture.md:如果影响系统边界,继续更新系统架构。