QAUP_Management/.kiro/specs/traffic-light-ip-address-enhancement/requirements.md

34 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 需求文档
## 介绍
本功能为现有的QAUP红绿灯集成系统修改消息解析逻辑以正确处理包含IP地址和端口信息的红绿灯消息格式。根据实际的红绿灯消息格式系统需要从TCP连接中识别设备的IP地址和端口信息并修改设备表结构使设备ID字段变为可选以便更灵活地管理红绿灯设备。
## 需求
### 需求 1
**用户故事:** 作为系统管理员我希望红绿灯信号解析器能够从接收到的数据包中识别IP地址和端口信息以便系统能够准确识别每个红绿灯设备的来源。
#### 验收标准
1. 当系统接收到红绿灯数据包时系统应从数据包格式中解析出IP地址信息
2. 当系统接收到红绿灯数据包时,系统应从数据包格式中解析出端口号信息
3. 当解析红绿灯信号时系统应将解析出的IP地址和端口信息与DI信号数据一起处理
4. 当数据包格式为`('IP地址', 端口号) - {DI数据}`时系统应正确提取IP和端口信息
5. 当记录信号处理日志时系统应包含设备的IP地址和端口信息用于调试
6. 当无法从数据包中解析出网络地址信息时系统应记录警告但继续处理DI信号数据
### 需求 2
**用户故事:** 作为数据库管理员我希望红绿灯设备表能够存储IP地址和端口信息并且设备ID字段变为可选以便系统能够基于网络地址管理设备。
#### 验收标准
1. 当修改设备表结构时系统应添加IP地址字段用于存储设备IP
2. 当修改设备表结构时,系统应添加端口字段用于存储设备端口
3. 当修改设备表结构时系统应将设备ID字段改为可选允许NULL
4. 当查询设备信息时系统应支持通过IP地址和端口组合进行查找
5. 当IP地址和端口组合重复时系统应防止创建重复的设备记录