namespace Core.Validation;

/// <summary>
/// Interface for all validation rules
/// </summary>
/// <typeparam name="TEntity">Type of entity being validated (Student, Team, StudentEventStatistics, etc.)</typeparam>
public interface IValidationRule<TEntity>
{
    /// <summary>
    /// Execute the validation rule against an entity
    /// </summary>
    /// <param name="entity">Entity to validate</param>
    /// <param name="config">Validation configuration</param>
    /// <returns>Validation warning if rule is violated, null otherwise</returns>
    ValidationWarning? Validate(TEntity entity, ValidationConfiguration config);

    /// <summary>
    /// Determines if this rule applies to the given context
    /// </summary>
    /// <param name="context">Validation context</param>
    /// <returns>True if the rule should be executed in this context</returns>
    bool AppliesTo(ValidationContext context);
}