/*
 * File: D:\shadowed-realms-mobile\ShadowedRealmsMobile\src\server\ShadowedRealms.Shared\DTOs\Combat\BattleExecutionRequestDto.cs
 * Created: 2025-10-23
 * Last Modified: 2025-10-23
 * Description: Request DTO for battle execution operations
 * Last Edit Notes: Individual file implementation for battle execution input validation
 */

using System.ComponentModel.DataAnnotations;

namespace ShadowedRealms.Shared.DTOs.Combat
{
    /// <summary>
    /// Request DTO for battle execution operations
    /// </summary>
    public class BattleExecutionRequestDto
    {
        /// <summary>
        /// Combat log ID for the battle to execute
        /// </summary>
        [Required]
        [Range(1, int.MaxValue)]
        public int CombatLogId { get; set; }

        /// <summary>
        /// Attacking forces composition
        /// </summary>
        [Required]
        public Dictionary<string, long> AttackingForces { get; set; } = new();

        /// <summary>
        /// Defending forces composition
        /// </summary>
        [Required]
        public Dictionary<string, long> DefendingForces { get; set; } = new();

        /// <summary>
        /// Dragon participation for attacker
        /// </summary>
        public Dictionary<string, object>? AttackerDragon { get; set; }

        /// <summary>
        /// Dragon participation for defender
        /// </summary>
        public Dictionary<string, object>? DefenderDragon { get; set; }

        /// <summary>
        /// Battle type (Field, Castle, Siege, Interception)
        /// </summary>
        [Required]
        [StringLength(50)]
        public string BattleType { get; set; } = string.Empty;

        /// <summary>
        /// Tactical formations and strategies
        /// </summary>
        public Dictionary<string, object> TacticalFormations { get; set; } = new();

        /// <summary>
        /// Terrain bonuses and modifiers
        /// </summary>
        public Dictionary<string, decimal> TerrainModifiers { get; set; } = new();

        /// <summary>
        /// Weather and environmental effects
        /// </summary>
        public Dictionary<string, object> EnvironmentalEffects { get; set; } = new();

        /// <summary>
        /// Alliance bonuses for both sides
        /// </summary>
        public Dictionary<string, object> AllianceBonuses { get; set; } = new();

        /// <summary>
        /// Equipment and gear bonuses
        /// </summary>
        public Dictionary<string, object> EquipmentBonuses { get; set; } = new();

        /// <summary>
        /// Additional battle execution parameters
        /// </summary>
        public Dictionary<string, object> ExecutionParameters { get; set; } = new();
    }
}