/*
 * File: D:\shadowed-realms-mobile\ShadowedRealmsMobile\src\server\ShadowedRealms.Shared\DTOs\Combat\MarchSpeedRequestDto.cs
 * Created: 2025-10-23
 * Last Modified: 2025-10-23
 * Description: Request DTO for march speed calculations and modifications
 * Last Edit Notes: Individual file implementation for march speed input validation
 */

using System.ComponentModel.DataAnnotations;

namespace ShadowedRealms.Shared.DTOs.Combat
{
    /// <summary>
    /// Request DTO for march speed calculations and modifications
    /// </summary>
    public class MarchSpeedRequestDto
    {
        /// <summary>
        /// March ID to modify speed for
        /// </summary>
        [Required]
        [Range(1, int.MaxValue)]
        public int MarchId { get; set; }

        /// <summary>
        /// Desired speed multiplier (0.1 to 2.0)
        /// </summary>
        [Required]
        [Range(0.1, 2.0)]
        public decimal SpeedMultiplier { get; set; } = 1.0m;

        /// <summary>
        /// Army composition affecting base speed
        /// </summary>
        [Required]
        public Dictionary<string, long> ArmyComposition { get; set; } = new();

        /// <summary>
        /// Whether to apply VIP speed bonuses
        /// </summary>
        public bool ApplyVipBonuses { get; set; } = true;

        /// <summary>
        /// Whether to apply alliance speed bonuses
        /// </summary>
        public bool ApplyAllianceBonuses { get; set; } = true;

        /// <summary>
        /// Dragon speed skills to apply
        /// </summary>
        public List<string> DragonSpeedSkills { get; set; } = new();

        /// <summary>
        /// Terrain type for speed calculations
        /// </summary>
        [StringLength(50)]
        public string TerrainType { get; set; } = "Normal";

        /// <summary>
        /// Whether march is passing through forest barriers
        /// </summary>
        public bool PassingThroughForest { get; set; } = false;

        /// <summary>
        /// Resources willing to spend for speed increases
        /// </summary>
        public Dictionary<string, long> SpeedResourceBudget { get; set; } = new();

        /// <summary>
        /// Additional speed modification parameters
        /// </summary>
        public Dictionary<string, object> SpeedParameters { get; set; } = new();
    }
}