StandardSence/StandardScene.Core/Charge/README_ChargeStationManagement.md

# 充电桩管理系统使用说明

## 📋 概述

充电桩管理系统是一个基于 WinForms 的可视化管理工具，用于管理 AGV 系统中的充电桩设备。

## 🚀 快速开始

### 打开管理窗口

```csharp
// 在代码中打开充电桩管理窗口
var form = new StandardScene.Charge.ChargeStationManagementForm();
form.ShowDialog();

// 或者在按钮点击事件中
private void btnOpenChargeManagement_Click(object sender, EventArgs e)
{
    var form = new StandardScene.Charge.ChargeStationManagementForm();
    form.Show();
}
```

### 添加菜单项（推荐）

在主窗口的菜单栏中添加：

```csharp
// 在主窗口的初始化代码中
var menuItem = new ToolStripMenuItem("充电桩管理");
menuItem.Click += (s, e) => {
    var form = new StandardScene.Charge.ChargeStationManagementForm();
    form.Show();
};
// 将 menuItem 添加到主菜单
```

## 📖 功能说明

### 1. 充电桩列表（左侧面板）

#### 功能特性
- **实时显示**：显示所有充电桩的详细信息
- **颜色标识**：
  - 🟢 **绿色**：充电中
  - 🔴 **红色**：故障
  - ⚫ **灰色**：离线
  - ⚪ **白色**：空闲/其他状态
- **搜索功能**：支持按编号、名称、IP地址搜索
- **双击编辑**：双击列表项可快速编辑

#### 列表字段
| 字段 | 说明 | 示例 |
|-----|------|------|
| 编号 | 充电桩唯一标识 | CS20240115123456 |
| 名称 | 充电桩名称 | 1号充电桩 |
| IP地址 | 设备IP | 192.168.1.100 |
| 端口 | 通信端口 | 502 |
| 电压(V) | 额定电压 | 220.0 |
| 电流(A) | 额定电流 | 32.0 |
| 功率(W) | 计算功率 | 7040.0 |
| 状态 | 当前状态 | 空闲/充电中/故障 |
| 启用 | 是否启用 | 是/否 |
| 站点ID | 关联站点 | 1001 |
| 备注 | 备注信息 | 南区1号充电桩 |

### 2. 充电桩编辑（右侧面板）

#### 必填字段
- ✅ **编号**：自动生成（格式：CS+时间戳+随机数）
- ✅ **名称**：充电桩名称，便于识别
- ✅ **IP地址**：设备IP，必须为有效IP格式
- ✅ **端口**：通信端口（1-65535）
- ✅ **电压**：额定电压（0-1000V）
- ✅ **电流**：额定电流（0-500A）

#### 选填字段
- 📌 **状态**：空闲/充电中/故障/离线/维护中/预约中
- 📌 **启用**：是否启用该充电桩
- 📌 **站点ID**：关联的站点编号（与地图站点关联）
- 📌 **备注**：额外说明信息

#### 自动计算
- ⚡ **功率**：自动计算（电压 × 电流）

### 3. 操作按钮

#### 右侧编辑区
- 🆕 **新增**：清空表单，准备添加新充电桩
- 💾 **保存**：保存当前充电桩信息（新增或更新）
- 🗑️ **删除**：删除当前选中的充电桩
- ❌ **取消**：清空表单

#### 左侧列表区
- 🔄 **刷新**：重新加载数据
- 📤 **导出**：导出充电桩数据为 JSON 或 CSV 文件

## 🔒 数据验证规则

### IP地址验证
```
✅ 有效：192.168.1.100, 10.0.0.1, 172.16.0.1
❌ 无效：192.168.1, 256.1.1.1, abc.def.ghi.jkl
```

### 端口验证
```
✅ 有效：502, 8080, 1234
❌ 无效：0, 70000, -1
```

### 电压验证
```
✅ 有效：220V, 380V, 110V
❌ 无效：-10V, 1500V, 0V
```

### 电流验证
```
✅ 有效：32A, 16A, 63A
❌ 无效：-5A, 600A, 0A
```

### 唯一性验证
- ❌ 编号不能重复
- ❌ IP地址+端口组合不能重复

## 💾 数据存储

### 存储位置
```
项目根目录/Data/ChargeStations.json
```

### 数据格式
```json
[
  {
    "StationId": "CS20240115123456",
    "Name": "1号充电桩",
    "IpAddress": "192.168.1.100",
    "Port": 502,
    "Voltage": 220.0,
    "Current": 32.0,
    "Status": 0,
    "Enabled": true,
    "SiteId": 1001,
    "Remarks": "南区1号充电桩",
    "CreatedTime": "2024-01-15T12:34:56",
    "ModifiedTime": "2024-01-15T14:20:30"
  }
]
```

## 📊 代码集成

### 获取充电桩数据

```csharp
using StandardScene.Charge;

// 获取数据服务实例
var dataService = ChargeStationDataService.Instance;

// 获取所有充电桩
var allStations = dataService.GetAllStations();

// 获取空闲充电桩
var idleStations = dataService.GetIdleStations();

// 根据编号获取充电桩
var station = dataService.GetStationById("CS20240115123456");

// 获取充电中的充电桩数量
int chargingCount = dataService.GetChargingCount();
```

### 添加/更新充电桩

```csharp
// 创建新充电桩
var newStation = new ChargeStation
{
    Name = "2号充电桩",
    IpAddress = "192.168.1.101",
    Port = 502,
    Voltage = 220.0,
    Current = 32.0
};

// 添加
if (dataService.AddStation(newStation, out string errorMsg))
{
    Console.WriteLine("添加成功");
}
else
{
    Console.WriteLine($"添加失败: {errorMsg}");
}

// 更新状态
dataService.UpdateStationStatus("CS20240115123456", ChargeStationStatus.Charging);
```

### 删除充电桩

```csharp
// 删除充电桩
if (dataService.DeleteStation("CS20240115123456", out string errorMsg))
{
    Console.WriteLine("删除成功");
}
else
{
    Console.WriteLine($"删除失败: {errorMsg}");
}
```

## ⚠️ 注意事项

1. **数据持久化**：所有数据自动保存到 JSON 文件，重启后数据不会丢失
2. **线程安全**：数据服务使用单例模式和锁机制，支持多线程访问
3. **状态管理**：充电中的充电桩无法删除，需先停止充电
4. **IP冲突检测**：系统会自动检测IP和端口的冲突
5. **数据备份**：建议定期备份 `Data/ChargeStations.json` 文件

## 🔧 扩展功能建议

### 与充电任务集成

在 `AbstractChargeMission.cs` 中集成充电桩数据：

```csharp
// 在充电任务中获取充电桩信息
private void SelectChargeStation(Car car)
{
    var dataService = ChargeStationDataService.Instance;
    var idleStations = dataService.GetIdleStations();
    
    if (idleStations.Count > 0)
    {
        var nearestStation = FindNearestStation(car, idleStations);
        
        // 更新充电桩状态
        dataService.UpdateStationStatus(
            nearestStation.StationId, 
            ChargeStationStatus.Reserved
        );
        
        // 分配车辆到充电桩
        AssignCarToStation(car, nearestStation);
    }
}

// 充电完成后
private void OnChargeComplete(Car car, ChargeStation station)
{
    var dataService = ChargeStationDataService.Instance;
    dataService.UpdateStationStatus(
        station.StationId, 
        ChargeStationStatus.Idle
    );
}
```

### 监控充电桩状态

```csharp
// 定期检查充电桩在线状态
private void MonitorChargeStations()
{
    var dataService = ChargeStationDataService.Instance;
    var stations = dataService.GetAllStations();
    
    foreach (var station in stations)
    {
        if (station.Enabled)
        {
            bool isOnline = PingStation(station.IpAddress, station.Port);
            
            var newStatus = isOnline 
                ? ChargeStationStatus.Idle 
                : ChargeStationStatus.Offline;
            
            if (station.Status != newStatus)
            {
                dataService.UpdateStationStatus(station.StationId, newStatus);
                Diagnosis.Log($"充电桩 {station.Name} 状态变更: {newStatus}", 
                    "ChargeStation", true);
            }
        }
    }
}
```

## 📞 技术支持

如有问题，请检查：
1. `Data` 文件夹是否有写入权限
2. JSON 文件格式是否正确
3. 日志中的错误信息（标签：`ChargeStation`）

---

**版本**: 1.0.0  
**最后更新**: 2024-01-15  
**作者**: MDCS System