/*
 * File: D:\shadowed-realms-mobile\ShadowedRealmsMobile\src\server\ShadowedRealms.Shared\DTOs\Alliance\ContestedZoneRequestDto.cs
 * Created: 2025-10-22
 * Last Modified: 2025-10-22
 * Description: Request DTO for contested zone operations and challenges
 * Last Edit Notes: Initial creation following established Alliance DTO patterns
 */

using System.ComponentModel.DataAnnotations;

namespace ShadowedRealms.Shared.DTOs.Alliance
{
    /// <summary>
    /// Request DTO for contested zone operations and challenges
    /// </summary>
    public class ContestedZoneRequestDto
    {
        /// <summary>
        /// Zone to target for contest
        /// </summary>
        [Required]
        public int ZoneId { get; set; }

        /// <summary>
        /// Type of zone operation (Challenge, Reinforce, Withdraw, Scout)
        /// </summary>
        [Required]
        [StringLength(50)]
        public string OperationType { get; set; } = string.Empty;

        /// <summary>
        /// Forces to commit to the operation
        /// </summary>
        public Dictionary<string, int> ForceCommitment { get; set; } = new();

        /// <summary>
        /// Coalition allies to invite for support
        /// </summary>
        public List<int> CoalitionAllies { get; set; } = new();

        /// <summary>
        /// Battle strategy and tactics
        /// </summary>
        [StringLength(500)]
        public string? Strategy { get; set; }

        /// <summary>
        /// Priority level for this operation (1-5)
        /// </summary>
        [Range(1, 5)]
        public int Priority { get; set; } = 3;

        /// <summary>
        /// Maximum duration for the operation in hours
        /// </summary>
        [Range(1, 168)]
        public int MaxDurationHours { get; set; } = 24;

        /// <summary>
        /// Operation parameters and special conditions
        /// </summary>
        public Dictionary<string, object>? OperationParameters { get; set; }
    }
}