/*
 * File: D:\shadowed-realms-mobile\ShadowedRealmsMobile\src\server\ShadowedRealms.Shared\DTOs\Alliance\CoalitionManagementRequestDto.cs
 * Created: 2025-10-22
 * Last Modified: 2025-10-22
 * Description: Request DTO for coalition management operations
 * Last Edit Notes: Initial implementation for coalition administration and coordination input validation
 */

using System.ComponentModel.DataAnnotations;

namespace ShadowedRealms.Shared.DTOs.Alliance
{
    /// <summary>
    /// Request DTO for coalition management operations
    /// </summary>
    public class CoalitionManagementRequestDto
    {
        /// <summary>
        /// Management action to perform
        /// </summary>
        [Required]
        public string Action { get; set; } = string.Empty;

        /// <summary>
        /// Target alliance for management action (if applicable)
        /// </summary>
        public int? TargetAllianceId { get; set; }

        /// <summary>
        /// Updated coalition settings
        /// </summary>
        public Dictionary<string, object>? CoalitionSettings { get; set; }

        /// <summary>
        /// Leadership role assignments
        /// </summary>
        public Dictionary<string, object>? LeadershipAssignments { get; set; }

        /// <summary>
        /// Member alliance permissions and roles
        /// </summary>
        public Dictionary<string, object>? MemberPermissions { get; set; }

        /// <summary>
        /// Coordination and resource sharing settings
        /// </summary>
        public Dictionary<string, object>? CoordinationSettings { get; set; }

        /// <summary>
        /// Coalition objectives updates
        /// </summary>
        public Dictionary<string, object>? UpdatedObjectives { get; set; }

        /// <summary>
        /// Reason for the management action
        /// </summary>
        [StringLength(300)]
        public string? ManagementReason { get; set; }

        /// <summary>
        /// Additional parameters for specific management actions
        /// </summary>
        public Dictionary<string, object>? ActionParameters { get; set; }
    }
}