/*
 * File: D:\shadowed-realms-mobile\ShadowedRealmsMobile\src\server\ShadowedRealms.Shared\DTOs\Combat\InterceptionCalculationRequestDto.cs
 * Created: 2025-10-19
 * Last Modified: 2025-10-19
 * Description: Request DTO for interception opportunities calculation
 * Last Edit Notes: Individual file implementation for interception calculation input validation
 */

using System.ComponentModel.DataAnnotations;

namespace ShadowedRealms.Shared.DTOs.Combat
{
    /// <summary>
    /// Request DTO for interception opportunities calculation
    /// </summary>
    public class InterceptionCalculationRequestDto
    {
        /// <summary>
        /// ID of the attacking player to intercept
        /// </summary>
        [Required]
        [Range(1, int.MaxValue)]
        public int AttackingPlayerId { get; set; }

        /// <summary>
        /// Attack route information
        /// </summary>
        [Required]
        public List<(int X, int Y)> AttackRoute { get; set; } = new();

        /// <summary>
        /// Expected arrival time of attacking forces
        /// </summary>
        public DateTime? EstimatedArrivalTime { get; set; }

        /// <summary>
        /// Additional calculation parameters
        /// </summary>
        public Dictionary<string, object>? CalculationParameters { get; set; }
    }
}