服务依赖关系文档

1 服务依赖概览

1.1 服务列表

服务ID	服务名称	端口	数据库	职责
user-svc	User Service	8081	db_user	用户账户、身份认证、档案管理
product-svc	Product Service	8082	db_product	产品发布、行程管理、团期管理
order-svc	Order Service	8083	db_order	订单管理、拼团管理、状态流转
payment-svc	Payment Service	8084	db_payment	支付、结算、资金托管
guide-svc	Guide Service	8085	db_guide	导游管理、接团、排班
trip-svc	Trip Service	8086	db_trip	行程执行、签到、定位、内容
review-svc	Review Service	8087	db_review	评价、内容管理
admin-svc	Admin Service	8088	db_admin	运营管理、审核、数据报表
notify-svc	Notify Service	8089	db_notify	消息推送、短信、邮件

2 服务依赖矩阵

                    被依赖服务 (Provider)
         user  product order payment guide trip  review admin notify
       ┌─────┬──────┬──────┬────────┬──────┬──────┬───────┬──────┬──────┐
   U   │  ●  │      │      │        │      │      │       │      │      │
       ├─────┼──────┼──────┼────────┼──────┼──────┼───────┼──────┼──────┤
   P   │      │  ●   │      │        │      │      │       │      │      │
       ├─────┼──────┼──────┼────────┼──────┼──────┼───────┼──────┼──────┤
   O   │  ●   │  ●   │  ●   │        │  ●   │      │       │      │      │
       ├─────┼──────┼──────┼────────┼──────┼──────┼───────┼──────┼──────┤
  Pa   │  ●   │      │  ●   │   ●    │      │      │       │      │      │
       ├─────┼──────┼──────┼────────┼──────┼──────┼───────┼──────┼──────┤
   G   │  ●   │  ●   │  ●   │        │  ●   │      │       │      │      │
       ├─────┼──────┼──────┼────────┼──────┼──────┼───────┼──────┼──────┤
   T   │      │      │  ●   │   ●    │  ●   │  ●   │       │      │      │
       ├─────┼──────┼──────┼────────┼──────┼──────┼───────┼──────┼──────┤
   R   │      │      │  ●   │        │  ●   │  ●   │   ●   │      │      │
       ├─────┼──────┼──────┼────────┼──────┼──────┼───────┼──────┼──────┤
   N   │  ●   │      │  ●   │        │  ●   │  ●   │       │      │  ●   │
       ├─────┼──────┼──────┼────────┼──────┼──────┼───────┼──────┼──────┤
   A   │  ●   │  ●   │  ●   │   ●    │  ●   │  ●   │   ●   │  ●   │  ●   │
       └─────┴──────┴──────┴────────┴──────┴──────┴───────┴──────┴──────┘
       
U=User, P=Product, O=Order, Pa=Payment, G=Guide, T=Trip, R=Review, N=Notify, A=Admin
● = 被依赖

3 详细依赖关系

3.1 User Service (8081)

被依赖方（提供）：

用户基本信息查询
用户认证/授权
用户档案管理

依赖方：

依赖服务	依赖内容	调用方式
Order Service	下单用户身份验证	HTTP API
Guide Service	导游身份认证	HTTP API
Notify Service	获取用户联系方式	HTTP API
Admin Service	用户管理	HTTP API

3.2 Product Service (8082)

被依赖方（提供）：

产品信息查询
团期信息查询
价格信息

依赖方：

依赖服务	依赖内容	调用方式
Order Service	获取产品详情、价格	HTTP API
Guide Service	获取产品信息	HTTP API
Admin Service	产品管理	HTTP API

3.3 Order Service (8083)

被依赖方（提供）：

订单创建/查询
订单状态管理
拼团状态管理

依赖方：

依赖服务	依赖内容	调用方式
User Service	获取用户信息	HTTP API
Product Service	获取产品/团期信息	HTTP API
Guide Service	获取导游信息	HTTP API
Payment Service	支付状态查询	HTTP API
Trip Service	行程订单信息	HTTP API
Review Service	订单完成状态	HTTP API
Notify Service	订单通知	Event
Admin Service	订单管理	HTTP API

3.4 Payment Service (8084)

被依赖方（提供）：

支付处理
退款处理
资金托管
结算

依赖方：

依赖服务	依赖内容	调用方式
Order Service	订单金额、状态	HTTP API
User Service	用户支付账户	HTTP API
Trip Service	备用金发放	HTTP API
Admin Service	财务对账	HTTP API

事件发布：

OrderPaidEvent → Order Service
RefundCompletedEvent → Order Service

3.5 Guide Service (8085)

被依赖方（提供）：

导游信息查询
导游接单管理
导游排班

依赖方：

依赖服务	依赖内容	调用方式
User Service	导游身份认证	HTTP API
Product Service	团单信息	HTTP API
Order Service	订单关联	HTTP API
Trip Service	行程关联	HTTP API
Review Service	导游评价	HTTP API
Notify Service	接单通知	Event
Admin Service	导游管理	HTTP API

3.6 Trip Service (8086)

被依赖方（提供）：

行程创建/查询
签到管理
位置服务

依赖方：

依赖服务	依赖内容	调用方式
Order Service	订单行程信息	HTTP API
Guide Service	导游信息	HTTP API
Payment Service	备用金发放	HTTP API
Review Service	行程评价入口	Event
Notify Service	行程通知	Event
Admin Service	行程管理	HTTP API

事件发布：

TripStartedEvent → Review Service
TripCompletedEvent → Review Service, Payment Service

3.7 Review Service (8087)

被依赖方（提供）：

评价查询/提交
评分统计

依赖方：

依赖服务	依赖内容	调用方式
Order Service	订单完成状态	HTTP API
Guide Service	导游评价	HTTP API
Trip Service	行程评价入口	HTTP API
Notify Service	评价通知	Event

事件订阅：

TripCompletedEvent → 开放评价入口

3.8 Notify Service (8089)

被依赖方（提供）：

消息推送
短信发送
邮件发送

依赖方：

依赖服务	依赖内容	调用方式
User Service	用户联系方式	HTTP API
Order Service	订单状态通知	Event
Guide Service	接单/行程通知	Event
Trip Service	行程动态通知	Event
Review Service	评价通知	Event

事件订阅：

UserRegisteredEvent → 欢迎短信
OrderCreatedEvent → 订单确认
OrderPaidEvent → 支付成功
GroupFormedEvent → 拼团成功
TripStartedEvent → 行程开始
TripCompletedEvent → 行程完成

4 禁止的依赖模式

4.1 循环依赖（严格禁止）

❌ 错误示例：
User Service ──► Order Service ──► User Service (循环)

❌ 错误示例：
Trip Service ──► Review Service ──► Trip Service (循环)

4.2 跨服务数据库访问（严格禁止）

❌ 错误示例：
Order Service 直接查询 db_user 数据库
  SELECT * FROM db_user.users WHERE id = ?

✅ 正确做法：
Order Service 调用 User Service API
  GET /api/v1/users/{userId}

4.3 服务间直接共享数据（禁止）

❌ 错误示例：
Order Service 和 Payment Service 共享同一个数据库表

✅ 正确做法：
Order Service 通过 HTTP API 与 Payment Service 通信
Payment Service 维护独立的 db_payment 数据库

5 依赖管理原则

5.1 接口稳定性

所有服务间 API 必须版本化：/api/v1/
API 变更需要兼容旧版本
重大变更需要新增版本号

5.2 降级处理

下游服务不可用时，上游服务需要有降级策略
使用熔断器模式防止级联故障
关键路径设置超时和重试机制

5.3 依赖超时

调用类型	超时时间	重试次数
同步 HTTP	5s	3次
gRPC 调用	3s	2次
消息队列	N/A	自动重试

文档版本：v1.0
创建日期：2026-03-09

DDDD

服务依赖关系文档

1 服务依赖概览

1.1 服务列表

2 服务依赖矩阵

3 详细依赖关系

3.1 User Service (8081)

3.2 Product Service (8082)

3.3 Order Service (8083)

3.4 Payment Service (8084)

3.5 Guide Service (8085)

3.6 Trip Service (8086)

3.7 Review Service (8087)

3.8 Notify Service (8089)

4 禁止的依赖模式

4.1 循环依赖（严格禁止）

4.2 跨服务数据库访问（严格禁止）

4.3 服务间直接共享数据（禁止）

5 依赖管理原则

5.1 接口稳定性

5.2 降级处理

5.3 依赖超时

搜索帮助