코드 리팩토링

재사용성 및 확장성을 고려하여 코드 전반을 리팩토링함

Assets/Scripts/Player/IActionProvider.cs

@@ -1,13 +1,171 @@
+using System.Collections.Generic;
+using UnityEngine;
+
+/// <summary>
+/// Requirement for performing an action (item cost, etc.).
+/// </summary>
+[System.Serializable]
+public struct ActionRequirement
+{
+    /// <summary>
+    /// Item ID required (use -1 if no item required).
+    /// </summary>
+    public int ItemID;
+
+    /// <summary>
+    /// Amount of the item required.
+    /// </summary>
+    public int Amount;
+
+    /// <summary>
+    /// Whether the item is consumed when the action is performed.
+    /// </summary>
+    public bool ConsumeOnUse;
+
+    public ActionRequirement(int itemID, int amount, bool consumeOnUse = true)
+    {
+        ItemID = itemID;
+        Amount = amount;
+        ConsumeOnUse = consumeOnUse;
+    }
+
+    /// <summary>
+    /// No requirement.
+    /// </summary>
+    public static ActionRequirement None => new ActionRequirement(-1, 0, false);
+}
+
+/// <summary>
+/// Describes an action that can be performed.
+/// </summary>
 [System.Serializable]
 public class ActionDescriptor
 {
-    public float duration = 0.5f;
-    public string animTrigger = "Interact";
-    // 필요하다면 여기에 사운드 이펙트나 파티클 정보를 추가할 수 있습니다.
+    /// <summary>
+    /// Display name of the action.
+    /// </summary>
+    public string ActionName = "Action";
+
+    /// <summary>
+    /// Total duration of the action in seconds.
+    /// </summary>
+    public float Duration = 0.5f;
+
+    /// <summary>
+    /// Animation trigger name.
+    /// </summary>
+    public string AnimTrigger = "Interact";
+
+    /// <summary>
+    /// Animation playback speed multiplier.
+    /// </summary>
+    public float AnimSpeed = 1f;
+
+    /// <summary>
+    /// Time within the animation when the effect occurs (for syncing hit with animation).
+    /// </summary>
+    public float ImpactDelay = 0f;
+
+    /// <summary>
+    /// Sound effect to play.
+    /// </summary>
+    public AudioClip SoundEffect;
+
+    /// <summary>
+    /// Particle effect prefab to spawn.
+    /// </summary>
+    public GameObject ParticleEffect;
+
+    /// <summary>
+    /// Stamina cost to perform this action.
+    /// </summary>
+    public float StaminaCost = 0f;
+
+    /// <summary>
+    /// Item requirements for this action.
+    /// </summary>
+    public ActionRequirement[] ItemRequirements;
+
+    /// <summary>
+    /// Whether this action can be repeated by holding the button.
+    /// </summary>
+    public bool CanRepeat = false;
+
+    /// <summary>
+    /// Cooldown time before this action can be performed again.
+    /// </summary>
+    public float Cooldown = 0f;
+
+    /// <summary>
+    /// Create a simple action descriptor.
+    /// </summary>
+    public static ActionDescriptor Simple(string name, float duration, string animTrigger = "Interact")
+    {
+        return new ActionDescriptor
+        {
+            ActionName = name,
+            Duration = duration,
+            AnimTrigger = animTrigger
+        };
+    }
+
+    /// <summary>
+    /// Create an action descriptor for repeatable actions (like mining).
+    /// </summary>
+    public static ActionDescriptor Repeatable(string name, float duration, string animTrigger,
+        float impactDelay, float animSpeed = 1f)
+    {
+        return new ActionDescriptor
+        {
+            ActionName = name,
+            Duration = duration,
+            AnimTrigger = animTrigger,
+            AnimSpeed = animSpeed,
+            ImpactDelay = impactDelay,
+            CanRepeat = true
+        };
+    }
 }
 
-// 명세를 제공하는 인터페이스
+/// <summary>
+/// Interface for objects that can provide action descriptors.
+/// Implement this to define what actions can be performed on or with an object.
+/// </summary>
 public interface IActionProvider
 {
+    /// <summary>
+    /// Get the primary action descriptor for this provider.
+    /// </summary>
     ActionDescriptor GetActionDescriptor();
-}
+
+    /// <summary>
+    /// Get all available actions from this provider.
+    /// Default implementation returns only the primary action.
+    /// </summary>
+    IEnumerable<ActionDescriptor> GetAvailableActions()
+    {
+        yield return GetActionDescriptor();
+    }
+
+    /// <summary>
+    /// Check if a specific action can be performed.
+    /// </summary>
+    /// <param name="performer">The GameObject attempting the action</param>
+    /// <param name="action">The action to check</param>
+    /// <returns>True if the action can be performed</returns>
+    bool CanPerformAction(GameObject performer, ActionDescriptor action)
+    {
+        return true;
+    }
+
+    /// <summary>
+    /// Get the reason why an action cannot be performed.
+    /// </summary>
+    /// <param name="performer">The GameObject attempting the action</param>
+    /// <param name="action">The action to check</param>
+    /// <returns>Reason string, or null if action can be performed</returns>
+    string GetActionBlockedReason(GameObject performer, ActionDescriptor action)
+    {
+        return null;
+    }
+}