/*
 * File: D:\shadowed-realms-mobile\ShadowedRealmsMobile\src\server\ShadowedRealms.Shared\DTOs\Combat\MarchArrivalRequestDto.cs
 * Created: 2025-10-23
 * Last Modified: 2025-10-23
 * Description: Request DTO for processing march arrivals
 * Last Edit Notes: Individual file implementation for march arrival processing input
 */

using System.ComponentModel.DataAnnotations;

namespace ShadowedRealms.Shared.DTOs.Combat
{
    /// <summary>
    /// Request DTO for processing march arrivals
    /// </summary>
    public class MarchArrivalRequestDto
    {
        /// <summary>
        /// March ID that is arriving
        /// </summary>
        [Required]
        [Range(1, int.MaxValue)]
        public int MarchId { get; set; }

        /// <summary>
        /// Expected arrival coordinates
        /// </summary>
        [Required]
        public Dictionary<string, decimal> ExpectedCoordinates { get; set; } = new();

        /// <summary>
        /// Actions to perform upon arrival
        /// </summary>
        [Required]
        [StringLength(50)]
        public string ArrivalAction { get; set; } = string.Empty;

        /// <summary>
        /// Whether to engage in immediate combat if defenders present
        /// </summary>
        public bool EngageDefenders { get; set; } = true;

        /// <summary>
        /// Combat stance for battle (Aggressive, Defensive, Balanced)
        /// </summary>
        [StringLength(50)]
        public string CombatStance { get; set; } = "Balanced";

        /// <summary>
        /// Dragon tactics to apply in combat
        /// </summary>
        public List<string> DragonTactics { get; set; } = new();

        /// <summary>
        /// Resource collection preferences if applicable
        /// </summary>
        public Dictionary<string, object> ResourcePreferences { get; set; } = new();

        /// <summary>
        /// Whether to attempt stealth approach
        /// </summary>
        public bool UseStealthApproach { get; set; } = false;

        /// <summary>
        /// Additional arrival processing parameters
        /// </summary>
        public Dictionary<string, object> ArrivalParameters { get; set; } = new();
    }
}