# 服务拆分

> 项目拆分为 **公共服务** 和 **对外接口服务**：主要逻辑提供对外接口服务，公共服务提供基础服务（如微信接口服务、权限服务、用户服务等）。

### 为什么要拆分？

1. **提高可维护性**：拆分为较小服务（公共服务、对外接口服务等）使代码库清晰易管理，每个服务职责明确，减少复杂度，便于维护和更新。
2. **增强扩展性**：服务可独立扩容，例如微信接口服务负载增加时可单独扩容，而不影响其他服务。
3. **简化部署过程**：小型服务更易于部署，可更快发布新功能和修复 bug，降低整体风险。
4. **提升容错能力**：服务隔离，一个服务出错不会轻易影响其他服务。
5. **促进团队协作**：不同团队/成员可专注于不同服务并行开发，效率更高，也可选择最合适的技术栈。
6. **优化资源利用**：按服务需求分配资源（CPU/内存），提高资源利用率，降低成本。

---

## 整体架构图

> 使用时序图直观展示服务拆分与通信关系：

```mermaid
sequenceDiagram
    participant Client as HTTP API 接口
    participant User as 用户服务
    participant Perm as 权限服务
    participant WeChat as 微信服务
    participant Nacos as 注册中心

    Client->>User: JSON-RPC 请求
    Client->>Perm: JSON-RPC 请求
    Client->>WeChat: JSON-RPC 请求

    loop 服务注册/发现
        User->>Nacos: 注册/发现
        Perm->>Nacos: 注册/发现
        WeChat->>Nacos: 注册/发现
    end

    Note right of Nacos: 管理服务注册<br/>和健康检查

    User-->>Client: 返回用户数据
    Perm-->>Client: 返回权限数据
    WeChat-->>Client: 返回微信数据
```

---

## 核心组件说明

| 组件 | 作用 |
|------|------|
| **Nacos** | 服务注册与发现中心，管理服务实例和健康检查 |
| **JSON-RPC** | 轻量级服务间通信协议，结构清晰，跨语言调用友好 |
| **Hyperf** | 高性能协程框架，提供 RPC 客户端/服务端及服务治理能力 |

---

## 实现步骤详解

### 1️⃣ 安装依赖

```bash
composer require hyperf/json-rpc
composer require hyperf/rpc-server
```

---

### 2️⃣ 启动 Nacos 服务注册中心

可使用 Docker 快速启动：

```bash
docker run -d -p 8848:8848 --name nacos nacos/nacos-server
# 访问 http://localhost:8848/nacos 查看服务注册情况
```

---

### 3️⃣ 创建服务提供者

#### 定义接口（Interface）

```php
// app/Service/UserServiceInterface.php
namespace App\Service;

interface UserServiceInterface
{
    public function getUserById(int $id): array;
}
```

#### 实现接口逻辑

```php
// app/Service/Impl/UserServiceImpl.php
namespace App\Service\Impl;

use App\Service\UserServiceInterface;

class UserServiceImpl implements UserServiceInterface
{
    public function getUserById(int $id): array
    {
        // 模拟数据库查询
        return ['id' => $id, 'name' => '张三'];
    }
}
```

---

## 服务注册与发现流程

1. 公共服务启动后，通过 **JsonRpcServer** 在指定端口监听；
2. 并向 **Nacos** 注册服务名（如 `App\Service\UserServiceInterface`）和地址；
3. 对外接口服务启动后，从 **Nacos** 获取所需服务地址；
4. 通过 Hyperf 内置 **JSON-RPC 客户端** 调用远程方法；
5. 调用过程自动完成 JSON-RPC 协议序列化/反序列化；
6. 内置支持负载均衡（随机、轮询等）和容错（失败重试、熔断等）。

---