94 lines
3.4 KiB
Markdown
94 lines
3.4 KiB
Markdown
# 架构说明
|
||
|
||
## 一、子服务内部分层（DDD + CQRS）
|
||
|
||
每个子服务（如 rc-service-other）都遵循以下固定分层：
|
||
|
||
```
|
||
{service}-adapter # 适配层：Controller，对外 REST API
|
||
{service}-application # 应用层：ServiceImpl、CmdExe、QryExe、Manager、Scheduler
|
||
{service}-client # 客户端接口层：Service 接口、Cmd、CO、枚举
|
||
{service}-domain # 领域层：Entity、领域服务接口（纯业务，无框架依赖）
|
||
{service}-infrastructure # 基础设施层：DAO、DatabaseService、Gateway、缓存、MQ
|
||
{service}-inner-endpoint # 内部服务端点：供其他微服务 Feign 调用的实现
|
||
{service}-start # 启动模块：Spring Boot 入口、application.yml
|
||
```
|
||
|
||
---
|
||
|
||
## 二、层次调用链
|
||
|
||
```
|
||
HTTP 请求
|
||
↓
|
||
Controller（adapter）
|
||
↓
|
||
ServiceImpl（application）
|
||
↓
|
||
CmdExe / QryExe（application）
|
||
↓ 简单场景 ↓ 复杂场景
|
||
DatabaseService Gateway（封装锁+缓存+多数据源）
|
||
↓ ↓
|
||
DAO DAO / Redis / MongoDB
|
||
```
|
||
|
||
**强制规则**：
|
||
- Controller 只调用 Service
|
||
- Service 只调用 CmdExe/QryExe
|
||
- CmdExe 可直接调用 DatabaseService（简单）或 Gateway（复杂）
|
||
- 禁止跨层调用
|
||
|
||
---
|
||
|
||
## 三、跨服务调用（Feign）
|
||
|
||
```
|
||
调用方服务
|
||
└── 注入 Feign 客户端（来自 rc-inner-api/{service}-inner/{service}-inner-api）
|
||
|
||
rc-inner-api/
|
||
└── {service}-inner/
|
||
├── {service}-inner-api/ # Feign 接口定义（endpoint 包）
|
||
├── {service}-inner-model/ # 传输数据模型（model 包）
|
||
└── （实现在 {service}-inner-endpoint 子服务中）
|
||
```
|
||
|
||
---
|
||
|
||
## 四、文件路径速查（以 other 服务为例）
|
||
|
||
| 文件类型 | 路径 |
|
||
|---------|------|
|
||
| Controller | `other-adapter/src/.../adapter/app/{模块}/` |
|
||
| Service 接口 | `other-client/src/.../app/service/{模块}/` |
|
||
| Cmd / QryCmd | `other-client/src/.../app/dto/cmd/{模块}/` |
|
||
| CO（返回对象） | `other-client/src/.../app/dto/clientobject/{模块}/` |
|
||
| CmdExe | `other-application/src/.../app/command/{模块}/` |
|
||
| QryExe | `other-application/src/.../app/command/{模块}/query/` |
|
||
| ServiceImpl | `other-application/src/.../app/service/{模块}/` |
|
||
| Manager | `other-application/src/.../app/manager/{模块}/` |
|
||
| Gateway 接口+实现 | `other-infrastructure/src/.../infra/gateway/{模块}/` |
|
||
| DAO | `other-infrastructure/src/.../infra/database/rds/dao/` |
|
||
| Entity | `other-infrastructure/src/.../infra/database/rds/entity/` |
|
||
| DatabaseService | `other-infrastructure/src/.../infra/database/rds/service/` |
|
||
| MongoDB | `other-infrastructure/src/.../infra/database/mongo/` |
|
||
| Cache | `other-infrastructure/src/.../infra/database/cache/` |
|
||
| Inner API 接口 | `rc-inner-api/other-inner/other-inner-api/endpoint/{模块}/` |
|
||
| Inner Model | `rc-inner-api/other-inner/other-inner-model/model/{模块}/` |
|
||
| Inner 实现 | `other-inner-endpoint/src/.../app/inner/service/{模块}/` |
|
||
|
||
---
|
||
|
||
## 五、常见功能模块目录名
|
||
`user` / `room` / `activity` / `game` / `family` / `gift` / `task` / `material` / `ranking` / `vip`
|
||
|
||
---
|
||
|
||
## 六、Gateway 使用原则
|
||
|
||
**需要 Gateway 的场景**：分布式锁、缓存+DB 双写、多数据源聚合、复杂事务协调
|
||
|
||
**不需要 Gateway 的场景**：简单 CRUD、单表查询、无缓存的简单操作
|
||
|
||
**原则：简单直接，复杂封装，不过度设计**
|