# Gateway 实体变更记录

**变更日期:** 2026-03-04
**Platform 版本:** 1.0.12

---

## 变更概述

Platform 1.0.12 对 Gateway 相关实体进行了重构，主要变化是将实例(Instance)内嵌到集群(Cluster)中，简化了领域模型。

---

## 实体变更

### 1. GwDestination（新增 - 原 GatewayInstance）

**旧名称:** GatewayInstance
**新名称:** GwDestination
**类型:** 值对象（内嵌于 GwCluster）

```csharp
public class GwDestination
{
    public string DestinationId { get; set; }     // 目标标识
    public string Address { get; set; }           // 后端地址
    public string? Health { get; set; }           // 健康检查端点
    public int Weight { get; set; } = 1;          // 权重
    public int HealthStatus { get; set; } = 1;   // 健康状态
    public int Status { get; set; } = 1;         // 状态
}
```

### 2. GwCluster（重构 - 原 GatewayCluster）

**旧名称:** GatewayCluster
**新名称:** GwCluster
**类型:** 聚合根

**主要变化:**
- 包含 `List<GwDestination> Destinations` 作为内嵌集合
- 包含 `GwLoadBalancingPolicy` 负载均衡策略
- 包含 `GwHealthCheckConfig` 健康检查配置
- 包含 `GwSessionAffinityConfig` 会话亲和配置

### 3. GwTenantRoute（重构 - 原 GatewayRoute）

**旧名称:** GatewayRoute
**新名称:** GwTenantRoute
**类型:** 实体

**主要变化:**
- 通过 `ClusterId` 关联到 `GwCluster`
- 包含 `GwRouteMatch` 路由匹配配置
- 支持 `GwLoadBalancingPolicy` 路由级别负载均衡覆盖

---

## 接口变更

### IInstanceStore（已移除）

**状态:** 已移除

**原因:** 实例(Destination)现在是 GwCluster 的内嵌对象，不再需要独立的 IInstanceStore 接口。

### IClusterStore（新增）

```csharp
public interface IClusterStore
{
    // Basic CRUD
    Task<GwCluster?> FindByIdAsync(string? id, CancellationToken cancellationToken = default);
    Task<GwCluster?> FindByClusterIdAsync(string clusterId, CancellationToken cancellationToken = default);
    Task<IList<GwCluster>> GetAllAsync(CancellationToken cancellationToken = default);
    Task<IList<GwCluster>> GetPagedAsync(int page, int pageSize, string? clusterId = null, 
        string? name = null, int? status = null, CancellationToken cancellationToken = default);
    Task<int> GetCountAsync(string? clusterId = null, string? name = null, 
        int? status = null, CancellationToken cancellationToken = default);
    Task<IdentityResult> CreateAsync(GwCluster cluster, CancellationToken cancellationToken = default);
    Task<IdentityResult> UpdateAsync(GwCluster cluster, CancellationToken cancellationToken = default);
    Task<IdentityResult> DeleteAsync(GwCluster cluster, CancellationToken cancellationToken = default);

    // Destination management (NEW)
    Task<GwCluster?> AddDestinationAsync(string clusterId, GwDestination destination, CancellationToken cancellationToken = default);
    Task<GwCluster?> UpdateDestinationAsync(string clusterId, string destinationId, GwDestination destination, CancellationToken cancellationToken = default);
    Task<GwCluster?> RemoveDestinationAsync(string clusterId, string destinationId, CancellationToken cancellationToken = default);
}
```

---

## 架构变化

### 旧架构

```
Route → ClusterId → Instance (独立实体)
```

### 新架构

```
TenantRoute → ClusterId → GwCluster (聚合根) → List<GwDestination>
```

---

## Console 适配需求

由于接口变更，Console 需要进行以下适配：

1. **移除 IInstanceStore 依赖**
   - 移除 `IInstanceStore` 注入
   - 使用 `IClusterStore` 替代

2. **更新 GatewayService**
   - 实例操作改为通过 `IClusterStore.AddDestinationAsync` 等方法
   - 查询实例改为从 `GwCluster.Destinations` 获取

3. **更新数据模型**
   - GatewayInstanceDto → 从 GwDestination 映射
   - GatewayClusterDto → 从 GwCluster 映射

4. **更新 API 端点**
   - `/instances` 相关端点可能需要调整

---

## 相关文件

### Platform 侧
- `Fengling.Platform.Domain/AggregatesModel/GatewayAggregate/GwCluster.cs`
- `Fengling.Platform.Domain/AggregatesModel/GatewayAggregate/GwDestination.cs`
- `Fengling.Platform.Domain/AggregatesModel/GatewayAggregate/GwTenantRoute.cs`
- `Fengling.Platform.Infrastructure/IClusterStore.cs`
- `Fengling.Platform.Infrastructure/ClusterStore.cs`

### Console 侧（需要适配）
- `src/Services/GatewayService.cs` - 需要适配新接口
- `src/Program.cs` - 需要更新依赖注入