zengzy / hhrcs_service · Files

namespace Rcs.Application.Services.PathFind.Models
{
    /// <summary>
    /// 物理拓扑节点 - 代表真实物理空间中的一个位置
    /// 多个厂家地图的节点可以映射到同一个物理节点
    /// @author zzy
    /// </summary>
    public class PhysicalNode
    {
        /// <summary>
        /// 物理节点ID（统一标识）
        /// </summary>
        public Guid PhysicalNodeId { get; set; }

        /// <summary>
        /// 物理节点编码（用于显示，如 "PP1"）
        /// </summary>
        public string PhysicalNodeCode { get; set; } = string.Empty;

        /// <summary>
        /// 物理坐标X（用于展示和匹配校验）
        /// </summary>
        public double PhysicalX { get; set; }

        /// <summary>
        /// 物理坐标Y
        /// </summary>
        public double PhysicalY { get; set; }

        /// <summary>
        /// 是否允许停留/等待
        /// </summary>
        public bool AllowWait { get; set; } = true;

        /// <summary>
        /// 是否允许旋转
        /// </summary>
        public bool AllowRotate { get; set; } = true;

        /// <summary>
        /// 该物理节点在不同厂家地图中的映射
        /// Key: MapId, Value: 映射信息
        /// </summary>
        public Dictionary<Guid, VendorNodeMapping> VendorMappings { get; set; } = new();

        /// <summary>
        /// 出边列表（物理边）
        /// </summary>
        public List<PhysicalEdge> OutEdges { get; set; } = new();

        /// <summary>
        /// 入边列表（物理边）
        /// </summary>
        public List<PhysicalEdge> InEdges { get; set; } = new();
    }

    /// <summary>
    /// 厂家节点映射信息
    /// @author zzy
    /// </summary>
    public class VendorNodeMapping
    {
        /// <summary>
        /// 厂家地图ID
        /// </summary>
        public Guid MapId { get; set; }

        /// <summary>
        /// 地图编码
        /// </summary>
        public string MapCode { get; set; } = string.Empty;

        /// <summary>
        /// 地图版本
        /// </summary>
        public string MapVersion { get; set; } = string.Empty;

        /// <summary>
        /// 厂家地图中的节点ID
        /// </summary>
        public Guid VendorNodeId { get; set; }

        /// <summary>
        /// 厂家地图中的节点编码
        /// </summary>
        public string VendorNodeCode { get; set; } = string.Empty;

        /// <summary>
        /// 厂家坐标X
        /// </summary>
        public double VendorX { get; set; }

        /// <summary>
        /// 厂家坐标Y
        /// </summary>
        public double VendorY { get; set; }

        /// <summary>
        /// 匹配置信度（0-1，用于自动匹配时记录匹配质量）
        /// </summary>
        public double MatchConfidence { get; set; } = 1.0;

        /// <summary>
        /// 是否为手动映射
        /// </summary>
        public bool IsManualMapping { get; set; }
    }

    /// <summary>
    /// 物理拓扑边 - 代表真实物理空间中的一条路径
    /// @author zzy
    /// </summary>
    public class PhysicalEdge
    {
        /// <summary>
        /// 物理边ID（统一标识）
        /// </summary>
        public Guid PhysicalEdgeId { get; set; }

        /// <summary>
        /// 物理边编码
        /// </summary>
        public string PhysicalEdgeCode { get; set; } = string.Empty;

        /// <summary>
        /// 起始物理节点ID
        /// </summary>
        public Guid FromPhysicalNodeId { get; set; }

        /// <summary>
        /// 目标物理节点ID
        /// </summary>
        public Guid ToPhysicalNodeId { get; set; }

        /// <summary>
        /// 边长度（米）
        /// </summary>
        public double Length { get; set; }

        /// <summary>
        /// 是否双向
        /// </summary>
        public bool IsBidirectional { get; set; }

        /// <summary>
        /// 该物理边在不同厂家地图中的映射
        /// Key: MapId, Value: 映射信息
        /// </summary>
        public Dictionary<Guid, VendorEdgeMapping> VendorMappings { get; set; } = new();
    }

    /// <summary>
    /// 厂家边映射信息
    /// @author zzy
    /// </summary>
    public class VendorEdgeMapping
    {
        /// <summary>
        /// 厂家地图ID
        /// </summary>
        public Guid MapId { get; set; }

        /// <summary>
        /// 地图编码
        /// </summary>
        public string MapCode { get; set; } = string.Empty;

        /// <summary>
        /// 厂家地图中的边ID
        /// </summary>
        public Guid VendorEdgeId { get; set; }

        /// <summary>
        /// 厂家地图中的边编码
        /// </summary>
        public string VendorEdgeCode { get; set; } = string.Empty;

        /// <summary>
        /// 厂家地图中的起始节点ID
        /// </summary>
        public Guid VendorFromNodeId { get; set; }

        /// <summary>
        /// 厂家地图中的目标节点ID
        /// </summary>
        public Guid VendorToNodeId { get; set; }

        /// <summary>
        /// 匹配置信度
        /// </summary>
        public double MatchConfidence { get; set; } = 1.0;
    }

    /// <summary>
    /// 物理拓扑图 - 统一的物理空间拓扑表示
    /// @author zzy
    /// </summary>
    public class PhysicalTopology
    {
        /// <summary>
        /// 拓扑ID
        /// </summary>
        public Guid TopologyId { get; set; }

        /// <summary>
        /// 拓扑名称（如 "仓库A-1楼"）
        /// </summary>
        public string TopologyName { get; set; } = string.Empty;

        /// <summary>
        /// 物理节点字典
        /// Key: PhysicalNodeId
        /// </summary>
        public Dictionary<Guid, PhysicalNode> Nodes { get; set; } = new();

        /// <summary>
        /// 物理边字典
        /// Key: PhysicalEdgeId
        /// </summary>
        public Dictionary<Guid, PhysicalEdge> Edges { get; set; } = new();

        /// <summary>
        /// 已关联的厂家地图列表
        /// </summary>
        public List<LinkedVendorMap> LinkedMaps { get; set; } = new();

        /// <summary>
        /// 创建时间
        /// </summary>
        public DateTime CreatedAt { get; set; }

        /// <summary>
        /// 最后更新时间
        /// </summary>
        public DateTime UpdatedAt { get; set; }
    }

    /// <summary>
    /// 关联的厂家地图信息
    /// @author zzy
    /// </summary>
    public class LinkedVendorMap
    {
        /// <summary>
        /// 厂家地图ID
        /// </summary>
        public Guid MapId { get; set; }

        /// <summary>
        /// 地图编码
        /// </summary>
        public string MapCode { get; set; } = string.Empty;

        /// <summary>
        /// 地图版本
        /// </summary>
        public string MapVersion { get; set; } = string.Empty;

        /// <summary>
        /// 制造商/厂家标识
        /// </summary>
        public string Manufacturer { get; set; } = string.Empty;

        /// <summary>
        /// 坐标变换参数
        /// </summary>
        public CoordinateTransform Transform { get; set; } = new();

        /// <summary>
        /// 映射的节点数量
        /// </summary>
        public int MappedNodeCount { get; set; }

        /// <summary>
        /// 映射的边数量
        /// </summary>
        public int MappedEdgeCount { get; set; }

        /// <summary>
        /// 未映射的节点数量（该厂家地图独有的节点）
        /// </summary>
        public int UnmappedNodeCount { get; set; }

        /// <summary>
        /// 关联时间
        /// </summary>
        public DateTime LinkedAt { get; set; }
    }

    /// <summary>
    /// 坐标变换参数（从厂家坐标系到物理坐标系）
    /// Transform: P_physical = Scale * R(θ) * P_vendor + Offset
    /// @author zzy
    /// </summary>
    public class CoordinateTransform
    {
        /// <summary>
        /// X轴偏移
        /// </summary>
        public double OffsetX { get; set; }

        /// <summary>
        /// Y轴偏移
        /// </summary>
        public double OffsetY { get; set; }

        /// <summary>
        /// 旋转角度（弧度）
        /// </summary>
        public double RotationAngle { get; set; }

        /// <summary>
        /// 缩放系数
        /// </summary>
        public double Scale { get; set; } = 1.0;

        /// <summary>
        /// 将厂家坐标转换为物理坐标
        /// </summary>
        public (double X, double Y) ToPhysical(double vendorX, double vendorY)
        {
            var cos = Math.Cos(RotationAngle);
            var sin = Math.Sin(RotationAngle);
            var x = Scale * (cos * vendorX - sin * vendorY) + OffsetX;
            var y = Scale * (sin * vendorX + cos * vendorY) + OffsetY;
            return (x, y);
        }

        /// <summary>
        /// 将物理坐标转换为厂家坐标
        /// </summary>
        public (double X, double Y) ToVendor(double physicalX, double physicalY)
        {
            var dx = physicalX - OffsetX;
            var dy = physicalY - OffsetY;
            var cos = Math.Cos(-RotationAngle);
            var sin = Math.Sin(-RotationAngle);
            var x = (cos * dx - sin * dy) / Scale;
            var y = (sin * dx + cos * dy) / Scale;
            return (x, y);
        }
    }

    /// <summary>
    /// 节点映射结果（用于返回查询结果）
    /// @author zzy
    /// </summary>
    public class NodeMappingResult
    {
        /// <summary>
        /// 物理节点ID
        /// </summary>
        public Guid PhysicalNodeId { get; set; }

        /// <summary>
        /// 查询的厂家节点ID
        /// </summary>
        public Guid VendorNodeId { get; set; }

        /// <summary>
        /// 查询的地图ID
        /// </summary>
        public Guid MapId { get; set; }

        /// <summary>
        /// 是否找到映射
        /// </summary>
        public bool Found { get; set; }

        /// <summary>
        /// 物理节点信息
        /// </summary>
        public PhysicalNode? PhysicalNode { get; set; }
    }

    /// <summary>
    /// 边映射结果
    /// @author zzy
    /// </summary>
    public class EdgeMappingResult
    {
        /// <summary>
        /// 物理边ID
        /// </summary>
        public Guid PhysicalEdgeId { get; set; }

        /// <summary>
        /// 查询的厂家边ID
        /// </summary>
        public Guid VendorEdgeId { get; set; }

        /// <summary>
        /// 查询的地图ID
        /// </summary>
        public Guid MapId { get; set; }

        /// <summary>
        /// 是否找到映射
        /// </summary>
        public bool Found { get; set; }

        /// <summary>
        /// 物理边信息
        /// </summary>
        public PhysicalEdge? PhysicalEdge { get; set; }
    }
}